net.sf.saxon.xqj
Class StandardObjectConverter

java.lang.Object
  extended by net.sf.saxon.xqj.StandardObjectConverter
All Implemented Interfaces:
ObjectConverter

public class StandardObjectConverter
extends Object
implements ObjectConverter

This class provides all the conversion methods used to convert data between XDM values and Java values in the XQJ API. At one time the XQJ specification defined such a class, and it has been retained in the Saxon implementation.

This handler implements the mappings defined in the XQJ specification. In addition, it defines the following mappings, which are applied after those defined in XQJ:

For fromObject:


Constructor Summary
StandardObjectConverter(SaxonXQDataFactory factory)
          CreateCharacter an instance of the class
 
Method Summary
 Item convertToItem(Object value)
          Convert a Java object to a Saxon Item
 Item convertToItem(Object value, XQItemType type)
          Convert a Java object to an Item, when a required type has been specified.
 Object toObject(XQItemAccessor xqItemAccessor)
          Convert an Item to a Java object
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

StandardObjectConverter

public StandardObjectConverter(SaxonXQDataFactory factory)
CreateCharacter an instance of the class

Parameters:
factory - the factory object
Method Detail

toObject

public Object toObject(XQItemAccessor xqItemAccessor)
                throws XQException
Description copied from interface: ObjectConverter
Convert an Item to a Java object

Specified by:
toObject in interface ObjectConverter
Parameters:
xqItemAccessor - the XQJ object representing the item to be converted
Returns:
the Java object that results from the conversion
Throws:
XQException

convertToItem

public Item convertToItem(Object value)
                   throws XQException
Convert a Java object to a Saxon Item

Specified by:
convertToItem in interface ObjectConverter
Parameters:
value - the Java object
Returns:
the corresponding Item
Throws:
XQException

convertToItem

public Item convertToItem(Object value,
                          XQItemType type)
                   throws XQException
Convert a Java object to an Item, when a required type has been specified. Note that Saxon only calls this method when none of the standard conversions defined in the XQJ specification is able to handle the object.

Specified by:
convertToItem in interface ObjectConverter
Parameters:
value - the supplied Java object
type - the required XPath data type
Returns:
the Item that results from the conversion
Throws:
XQException - if the Java object cannot be converted to an XQItem


Copyright (c) 2004-2011 Saxonica Limited. All rights reserved.