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 when using the InterChange Server integration broker, you must modify the MO_Server_DataHandler meta-object to support the text/namevalue MIME type. For more information, see Modifying the top-level meta-object.

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

Table 63. 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