IBM WebSphere Application ServerTM
Release 8

com.ibm.websphere.sib
Class SIDataGraphFactory

java.lang.Object
  extended by 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
SIDataGraphFactory()
           
 
Method Summary
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

IBM WebSphere Application ServerTM
Release 8