com.att.inno.env.jaxb

Class JAXBData<T>

java.lang.Object

com.att.inno.env.jaxb.JAXBData<T>

Type Parameters:

T -

All Implemented Interfaces:

Data<T>

public final class JAXBData<T>
extends Object
implements Data<T>

Data

Data facilitates lazy marshaling of data with a pre-determined marshaling mechanism.

It stores either Object (defined by Generic <T>) or String.

On asking for Object of type <T>, it will respond with the object if it exists, or unmarshal the string and pass the result back.

On asking for String, it will respond with the String if it exists, or marshal the String and pass the result back.

Nested Class Summary

Nested classes/interfaces inherited from interface com.att.inno.env.Data

Data.TYPE

Field Summary

Fields inherited from interface com.att.inno.env.Data

FRAGMENT, PRETTY

Method Summary

Modifier and Type	Method and Description
T	asObject() Respond with the Object of type <T> if it exists, or unmarshal from String and pass the result back.
T	asObject(EnvJAXB env) Respond with the Object of type <T> if it exists, or unmarshal from String and pass the result back.
String	asString() Respond with the String if it exists, or marshal the String and pass the result back.
String	asString(EnvJAXB env) Respond with the String if it exists, or marshal the String and pass the result back.
void	direct(InputStream input, OutputStream output)
InputStream	getInputStream()
Class<T>	getTypeClass() Return the Class Type supported by this DataObject
Data<T>	in(Data.TYPE type)
Data<T>	load(InputStream is)
Data<T>	load(Reader rdr)
Data<T>	load(String str)
Data<T>	load(T t)
Data<T>	option(int option) Set a particular option on an existing Out if int is negative, it should remove the option
Data<T>	out(Data.TYPE type)
Data<T>	to(OutputStream os)
JAXBData<T>	to(Writer writer)
String	toString() For Debugging Convenience, we marshal to String if possible.

Methods inherited from class java.lang.Object

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

Method Detail

asString

public String asString(EnvJAXB env)
                throws APIException

Respond with the String if it exists, or marshal the String and pass the result back.

Explicitly use a specific Env for logging purposes

Parameters:

env -

Returns:

String

Throws:

APIException

asString

public String asString()
                throws APIException

Respond with the String if it exists, or marshal the String and pass the result back. However, use the Env the Data Object was created with.

Specified by:

asString in interface Data<T>

Returns:

String

Throws:

APIException

to

public Data<T> to(OutputStream os)
           throws APIException,
                  IOException

Specified by:

to in interface Data<T>

Throws:

APIException

IOException

to

public JAXBData<T> to(Writer writer)
               throws APIException,
                      IOException

Specified by:

to in interface Data<T>

Throws:

APIException

IOException

getInputStream

public InputStream getInputStream()
                           throws APIException

Throws:

APIException

asObject

public T asObject(EnvJAXB env)
           throws APIException

Respond with the Object of type <T> if it exists, or unmarshal from String and pass the result back.

Explicitly use a specific Env for logging purposes

Parameters:

env -

Returns:

T

Throws:

APIException

asObject

public T asObject()
           throws APIException

Respond with the Object of type <T> if it exists, or unmarshal from String and pass the result back.

However, use the Env the Data Object was created with.

Specified by:

asObject in interface Data<T>

Returns:

T

Throws:

APIException

getTypeClass

public Class<T> getTypeClass()

Return the Class Type supported by this DataObject

Specified by:

getTypeClass in interface Data<T>

Returns:

Class<T>

toString

public String toString()

For Debugging Convenience, we marshal to String if possible. Behavior is essentially the same as asString(), except asString() throws an APIException.

Since toString() must not throw exceptions, the function just catches and prints an error, which is probably not the behavior desired.

Therefore, use "asString()" where possible in actual Transactional code.

Overrides:

toString in class Object

See Also:

Object.toString()

load

public Data<T> load(T t)
             throws APIException

Specified by:

load in interface Data<T>

Throws:

APIException

load

public Data<T> load(String str)
             throws APIException

Specified by:

load in interface Data<T>

Throws:

APIException

load

public Data<T> load(InputStream is)
             throws APIException

Specified by:

load in interface Data<T>

Throws:

APIException

load

public Data<T> load(Reader rdr)
             throws APIException

Specified by:

load in interface Data<T>

Throws:

APIException

direct

public void direct(InputStream input,
                   OutputStream output)
            throws APIException,
                   IOException

Specified by:

direct in interface Data<T>

Throws:

APIException

IOException

out

public Data<T> out(Data.TYPE type)

Specified by:

out in interface Data<T>

in

public Data<T> in(Data.TYPE type)

Specified by:

in in interface Data<T>

option

public Data<T> option(int option)

Description copied from interface: Data

Set a particular option on an existing Out if int is negative, it should remove the option

Specified by:

option in interface Data<T>