com.ibm.websphere.sib

Class SIDataGraphFactory

java.lang.Object

com.ibm.websphere.sib.SIDataGraphFactory

public abstract class SIDataGraphFactory
extends java.lang.Object

A singleton SIDataGraphFactory is created at static initialization and is subsequently used for the creation of all DataGraphs.

Constructor Summary

Constructors

Constructor and Description
SIDataGraphFactory()

Method Summary

Methods

Modifier and Type	Method and Description
abstract commonj.sdo.DataGraph	createDataGraph(byte[] bytes, java.lang.String format) Create a new SDO version 1 DataGraph by parsing the bytes according to the indicated format.
abstract commonj.sdo.DataGraph	createDataGraph(java.lang.String format) Create a new SDO version 1 DataGraph.
static SIDataGraphFactory	getInstance() Get the singleton SIDataGraphFactory which is to be used for creating SDO DataGraph instances.

Methods inherited from class java.lang.Object

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

Constructor Detail

SIDataGraphFactory

public SIDataGraphFactory()

Method Detail

getInstance

public static SIDataGraphFactory getInstance()

Get the singleton SIDataGraphFactory which is to be used for creating SDO DataGraph instances.

Returns:

The SIDataGraphFactory

createDataGraph

public abstract commonj.sdo.DataGraph createDataGraph(java.lang.String format)
                                               throws SIMessageDomainNotSupportedException,
                                                      SIDataGraphSchemaNotFoundException,
                                                      SIDataGraphException

Create a new SDO version 1 DataGraph.

Parameters:

format - The message format describing the DataGraph model.

Returns:

DataGraph The new SDO data graph. Null is returned if the format parameter is SIApiConstants.JMS_FORMAT ("JMS:")

Throws:

java.lang.NullPointerException - is thrown if the format parameter is null.

SIMessageDomainNotSupportedException - is thrown if the message domain indicated by the format is not supported.

SIDataGraphSchemaNotFoundException - may be thrown if a schema needed to create the DataGraph is not available.

SIDataGraphException - may be thrown if the DataGraph can not be created for any other reason. The linked Exception(s) indicate the underlying problem.

createDataGraph

public abstract commonj.sdo.DataGraph createDataGraph(byte[] bytes,
                                    java.lang.String format)
                                               throws SIMessageDomainNotSupportedException,
                                                      SIDataGraphSchemaNotFoundException,
                                                      SIDataGraphFormatMismatchException,
                                                      SIDataGraphException

Create a new SDO version 1 DataGraph by parsing the bytes according to the indicated format.

Parameters:

bytes - an array of bytes containing a serialized datagraph consistent with the supplied format parameter

format - the message format describing the DataGraph model.

Returns:

The new SDO data graph. Null is returned if the format parameter is "JMS:"

Throws:

SIMessageDomainNotSupportedException

SIDataGraphSchemaNotFoundException

SIDataGraphFormatMismatchException

SIDataGraphException