java.lang.Object
- net.sf.saxon.expr.JPConverter

Direct Known Subclasses:

JPConverter.ExternalObjectWrapper, JPConverter.FromBigDecimal, JPConverter.FromBigInteger, JPConverter.FromBoolean, JPConverter.FromBooleanArray, JPConverter.FromByte, JPConverter.FromByteArray, JPConverter.FromCharacter, JPConverter.FromCharArray, JPConverter.FromCollection, JPConverter.FromDate, JPConverter.FromDouble, JPConverter.FromDoubleArray, JPConverter.FromFloat, JPConverter.FromFloatArray, JPConverter.FromInstant, JPConverter.FromInt, JPConverter.FromIntArray, JPConverter.FromLocalDate, JPConverter.FromLocalDateTime, JPConverter.FromLong, JPConverter.FromLongArray, JPConverter.FromObject, JPConverter.FromObjectArray, JPConverter.FromOffsetDateTime, JPConverter.FromQName, JPConverter.FromSequence, JPConverter.FromSequenceIterator, JPConverter.FromShort, JPConverter.FromShortArray, JPConverter.FromSource, JPConverter.FromString, JPConverter.FromUnicodeString, JPConverter.FromURI, JPConverter.FromXdmValue, JPConverter.FromZonedDateTime, JPConverter.VoidConverter
```
public abstract class JPConverter
extends java.lang.Object
```
This class together with its embedded subclasses handles conversion from Java values to XPath values.
The general principle is to allocate a specific JPConverter at compile time wherever possible. If there is insufficient type information to make this feasible, a general-purpose JPConverter is allocated, which in turn allocates a more specific converter at run-time to do the actual work.

Nested Class Summary

Nested Classes
Modifier and Type	Class	Description
`static class`	`JPConverter.ExternalObjectWrapper`
`static class`	`JPConverter.FromBigDecimal`
`static class`	`JPConverter.FromBigInteger`
`static class`	`JPConverter.FromBoolean`
`static class`	`JPConverter.FromBooleanArray`
`static class`	`JPConverter.FromByte`
`static class`	`JPConverter.FromByteArray`
`static class`	`JPConverter.FromCharacter`
`static class`	`JPConverter.FromCharArray`
`static class`	`JPConverter.FromCollection`
`static class`	`JPConverter.FromDate`
`static class`	`JPConverter.FromDouble`
`static class`	`JPConverter.FromDoubleArray`
`static class`	`JPConverter.FromFloat`
`static class`	`JPConverter.FromFloatArray`
`static class`	`JPConverter.FromInstant`
`static class`	`JPConverter.FromInt`
`static class`	`JPConverter.FromIntArray`
`static class`	`JPConverter.FromLocalDate`
`static class`	`JPConverter.FromLocalDateTime`
`static class`	`JPConverter.FromLong`
`static class`	`JPConverter.FromLongArray`
`static class`	`JPConverter.FromObject`
`static class`	`JPConverter.FromObjectArray`
`static class`	`JPConverter.FromOffsetDateTime`
`static class`	`JPConverter.FromQName`
`static class`	`JPConverter.FromSequence`
`static class`	`JPConverter.FromSequenceIterator`
`static class`	`JPConverter.FromShort`
`static class`	`JPConverter.FromShortArray`
`static class`	`JPConverter.FromSource`
`static class`	`JPConverter.FromString`
`static class`	`JPConverter.FromUnicodeString`
`static class`	`JPConverter.FromURI`
`static class`	`JPConverter.FromXdmValue`
`static class`	`JPConverter.FromZonedDateTime`
`static class`	`JPConverter.VoidConverter`

Constructor Summary

Constructors
Constructor Description

JPConverter()

Method Summary

All Methods Static Methods Instance Methods Abstract Methods Concrete Methods
Modifier and Type	Method	Description
`static JPConverter`	`allocate(java.lang.Class<?> javaClass, java.lang.reflect.Type genericType, Configuration config)`	Allocate a Java-to-XPath converter for a given class of Java objects
`abstract GroundedValue`	`convert(java.lang.Object object, XPathContext context)`	Convert a Java object to an equivalent XPath value
`int`	`getCardinality()`	Get the cardinality of the XPath value that will result from the conversion
`abstract ItemType`	`getItemType()`	Get the item type of the XPath value that will result from the conversion

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Constructor Detail
  - JPConverter
```
public JPConverter()
```
- Method Detail
  - allocate
```
public static JPConverter allocate(java.lang.Class<?> javaClass,
                                   java.lang.reflect.Type genericType,
                                   Configuration config)
```
    Allocate a Java-to-XPath converter for a given class of Java objects
    
    Parameters:
    
    javaClass - the class of the Java object to be converted (this may be the static type or the dynamic type, depending when the converter is allocated)
    
    genericType - the generic type of the Java object; may be null if unknown
    
    config - the Saxon Configuration
    
    Returns:
    
    a suitable converter
  - convert
```
public abstract GroundedValue convert(java.lang.Object object,
                                      XPathContext context)
                               throws XPathException
```
    Convert a Java object to an equivalent XPath value
    
    Parameters:
    
    object - the java object to be converted
    
    context - the XPath dynamic evaluation context
    
    Returns:
    
    the XPath value resulting from the conversion
    
    Throws:
    
    XPathException - if the conversion is not possible or if it fails
  - getItemType
```
public abstract ItemType getItemType()
```
    Get the item type of the XPath value that will result from the conversion
    
    Returns:
    
    the XPath item type
  - getCardinality
```
public int getCardinality()
```
    Get the cardinality of the XPath value that will result from the conversion
    
    Returns:
    
    the cardinality of the result

Class JPConverter

Nested Class Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Constructor Detail

JPConverter

Method Detail

allocate

convert

getItemType

getCardinality