Overview

The NameValue data handler is a data-conversion module whose primary role is to convert a business object to and from a string or stream formatted in name-value pairs. A NameValue-formatted string or stream is serialized data with the text/namevalue MIME type. The NameValue data handler can be used to generate a business object file for testing purposes.

The data handler parses serialized data based on named fields. For example, a text file for this data handler contains fields that identify the business object type (BusinessObject=BOname), verb (Verb=verbName), number of attributes (AttributeCount=numericValue), and attribute values (AttributeName=Value). The data handler uses the name-value information to parse the data.

The default top-level connector meta-object (MO_DataHandler_Default) supports the text/namevalue MIME type. Therefore, a connector that is configured to use the MO_DataHandler_Default meta-object can call the NameValue data handler. For an access client to be able to call this data handler, you must modify the MO_Server_DataHandler meta-object to support the text/namevalue MIME type.

The NameValue data handler performs the operations listed in Table 59.

Table 59. Data operations for the NameValue data handler
Data-handler operation For more information
Receives a business object from the caller, converts the business object into a NameValue string or stream, and passes the serialized data to the caller. Converting business objects to NameValue data
Receives a string or stream from the caller, builds a business object, and returns the business object to the caller. Converting NameValue data to business objects

Copyright IBM Corp. 1997, 2003