org.apache.axis2.datasource.jaxb

Class JAXBDSContext

java.lang.Object

org.apache.axis2.datasource.jaxb.JAXBDSContext

Direct Known Subclasses:

JAXBBlockContext

public class JAXBDSContext
extends Object

Field Summary

Fields

Modifier and Type	Field and Description
static boolean	DEBUG_ENABLED

Constructor Summary

Constructors

Constructor and Description
JAXBDSContext(javax.xml.bind.JAXBContext jaxbContext) "Dispatch" Constructor Use this full constructor when the JAXBContent is provided by the customer.
JAXBDSContext(String contextPackage) Deprecated.
JAXBDSContext(TreeSet<String> packages) Slightly slower constructor
JAXBDSContext(TreeSet<String> packages, String packagesKey) Full Constructor JAXBDSContext (most performant)

Method Summary

Methods

Modifier and Type	Method and Description
protected AttachmentContext	createAttachmentContext()
ClassLoader	getClassLoader()
JAXBUtils.CONSTRUCTION_TYPE	getConstructionType()
TreeSet<String>	getContextPackages()
javax.xml.bind.JAXBContext	getJAXBContext()
javax.xml.bind.JAXBContext	getJAXBContext(ClassLoader cl)
javax.xml.bind.JAXBContext	getJAXBContext(ClassLoader cl, boolean forceArrays)
org.apache.axis2.context.MessageContext	getMessageContext()
Class<?>	getProcessType()
boolean	isxmlList()
void	marshal(Object obj, javax.xml.stream.XMLStreamWriter writer) Marshal the jaxb object
void	setIsxmlList(boolean isxmlList)
void	setMessageContext(org.apache.axis2.context.MessageContext messageContext)
void	setProcessType(Class<?> type) The procesess type to indicate the class of the target of the unmarshaling.
void	setWebServiceNamespace(String namespace)
Object	unmarshal(javax.xml.stream.XMLStreamReader inputReader) Unmarshal the xml into a JAXB object
static Object	unmarshalAsListOrArray(javax.xml.stream.XMLStreamReader reader, javax.xml.bind.Unmarshaller u, Class<?> type) convert the String into a list or array
static Object	unmarshalByElement(javax.xml.bind.Unmarshaller u, javax.xml.stream.XMLStreamReader reader) Preferred way to unmarshal objects
static Object	unmarshalByType(javax.xml.bind.Unmarshaller u, javax.xml.stream.XMLStreamReader reader, Class<?> type, boolean isList, JAXBUtils.CONSTRUCTION_TYPE ctype) The root element being read is defined by schema/JAXB; however its contents are known by schema/JAXB.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

DEBUG_ENABLED

public static final boolean DEBUG_ENABLED

Constructor Detail

JAXBDSContext

public JAXBDSContext(TreeSet<String> packages,
             String packagesKey)

Full Constructor JAXBDSContext (most performant)

Parameters:

packages - Set of packages needed by the JAXBContext.

JAXBDSContext

public JAXBDSContext(TreeSet<String> packages)

Slightly slower constructor

Parameters:

packages -

JAXBDSContext

public JAXBDSContext(String contextPackage)

Deprecated.

Normal Constructor JAXBBlockContext

Parameters:

contextPackage -

JAXBDSContext

public JAXBDSContext(javax.xml.bind.JAXBContext jaxbContext)

"Dispatch" Constructor Use this full constructor when the JAXBContent is provided by the customer.

Parameters:

jaxbContext -

Method Detail

getContextPackages

public TreeSet<String> getContextPackages()

Returns:

Class representing type of the element

getJAXBContext

public javax.xml.bind.JAXBContext getJAXBContext()
                                          throws javax.xml.bind.JAXBException

Throws:

javax.xml.bind.JAXBException

getJAXBContext

public javax.xml.bind.JAXBContext getJAXBContext(ClassLoader cl)
                                          throws javax.xml.bind.JAXBException

Returns:

get the JAXBContext

Throws:

javax.xml.bind.JAXBException

getJAXBContext

public javax.xml.bind.JAXBContext getJAXBContext(ClassLoader cl,
                                        boolean forceArrays)
                                          throws javax.xml.bind.JAXBException

Parameters:

ClassLoader -

forceArrays - boolean (if true, then JAXBContext will automatically contain arrays)

Returns:

get the JAXBContext

Throws:

javax.xml.bind.JAXBException

setWebServiceNamespace

public void setWebServiceNamespace(String namespace)

getProcessType

public Class<?> getProcessType()

Returns:

RPC Declared Type

setProcessType

public void setProcessType(Class<?> type)

The procesess type to indicate the class of the target of the unmarshaling. This method should only be used in the cases where the element being unmarshaled is not known to the JAXBContext (examples include RPC/Literal processing and Doc/Literal Wrapped processing with a non-element wrapper class)

Parameters:

type -

getConstructionType

public JAXBUtils.CONSTRUCTION_TYPE getConstructionType()

isxmlList

public boolean isxmlList()

setIsxmlList

public void setIsxmlList(boolean isxmlList)

getMessageContext

public org.apache.axis2.context.MessageContext getMessageContext()

setMessageContext

public void setMessageContext(org.apache.axis2.context.MessageContext messageContext)

getClassLoader

public ClassLoader getClassLoader()

createAttachmentContext

protected AttachmentContext createAttachmentContext()

unmarshal

public Object unmarshal(javax.xml.stream.XMLStreamReader inputReader)
                 throws javax.xml.bind.JAXBException

Unmarshal the xml into a JAXB object

Parameters:

inputReader -

Returns:

Throws:

javax.xml.bind.JAXBException

marshal

public void marshal(Object obj,
           javax.xml.stream.XMLStreamWriter writer)
             throws javax.xml.bind.JAXBException

Marshal the jaxb object

Parameters:

obj -

writer -

am - AttachmentMarshaller, optional Attachment

Throws:

javax.xml.bind.JAXBException

unmarshalByType

public static Object unmarshalByType(javax.xml.bind.Unmarshaller u,
                     javax.xml.stream.XMLStreamReader reader,
                     Class<?> type,
                     boolean isList,
                     JAXBUtils.CONSTRUCTION_TYPE ctype)
                              throws javax.xml.ws.WebServiceException

The root element being read is defined by schema/JAXB; however its contents are known by schema/JAXB. Therefore we use unmarshal by the declared type (This method is used to unmarshal rpc elements)

Parameters:

u - Unmarshaller

reader - XMLStreamReader

type - Class

Returns:

Object

Throws:

javax.xml.ws.WebServiceException

unmarshalAsListOrArray

public static Object unmarshalAsListOrArray(javax.xml.stream.XMLStreamReader reader,
                            javax.xml.bind.Unmarshaller u,
                            Class<?> type)
                                     throws IllegalAccessException,
                                            ParseException,
                                            NoSuchMethodException,
                                            InstantiationException,
                                            DatatypeConfigurationException,
                                            InvocationTargetException,
                                            javax.xml.bind.JAXBException

convert the String into a list or array

Type Parameters:

T -

Parameters:

jaxb -

type -

Returns:

Throws:

IllegalAccessException

ParseException

NoSuchMethodException

InstantiationException

DatatypeConfigurationException

InvocationTargetException

javax.xml.bind.JAXBException

unmarshalByElement

public static Object unmarshalByElement(javax.xml.bind.Unmarshaller u,
                        javax.xml.stream.XMLStreamReader reader)
                                 throws javax.xml.ws.WebServiceException

Preferred way to unmarshal objects

Parameters:

u - Unmarshaller

reader - XMLStreamReader

Returns:

Object that represents an element

Throws:

javax.xml.ws.WebServiceException