getBO() - public

Converts serialized data to a business object.

Syntax

public BusinessObjectInterface getBO(Object serializedData, 
    Object config);
public BusinessObjectInterface getBO(String serializedData, 
    Object config);
public BusinessObjectInterface getBO(InputStream serializedData,
    Object config);
public BusinessObjectInterface getBO(byte[] serializedData,
    Object config);
public void getBO(Object serializedData, 
    BusinessObjectInterface theBusObj, Object config);

Parameters

serializedData
Is a reference to the serialized data.

theBusObj
Is the business object to populate with data.

config
Is an optional object that contains additional configuration information for the data handler.

Return values

The first four forms return a business object populated with the data from the input Object, String, InputStream, or byte-array object. The fifth form populates the specified business object with the data from the serialized data.

Exceptions

Exception
Thrown if the method is unable to convert the serialized data to a business object.

NotImplementedException
Thrown if the public version of the getBO() method is not implemented.

Notes

This getBO() method is the public method to perform string-to-business-object conversion. The DataHandler base class includes the abstract forms of getBO() (as described on page getBO() - abstract), which must be implemented as part of the data-handler class. This public version of getBO() defines a set of utility methods that allow a component (such as a connector or access client) to specify the serializedData as an Object, String, or InputStream objects, or as a byte array. The method converts the specified serialized data to a Reader object and then calls one of the abstract getBO() methods to convert the Reader object to a business object.

The public getBO() method has the following forms:

For information on the config argument, see its description under the abstract form of getBO() (as described on page getBO() - abstract).

See also

getBO() - abstract

Copyright IBM Corp. 1997, 2003