Accessing Data with the Attachmate J2EE Connector

The Attachmate J2EE connector implementation returns Record objects, which mimic a hierarchical XML structure and use combinations of MappedRecords and IndexedRecords. (Input or output data is referred to as a Record.)

Record Type Description
Mapped
  • Map directly to elements of complexType.
  • Any element that is complexType and has maxOccurs greater than 1 will be represented as an IndexedRecord with each entry containing a MappedRecord. All elements of simpleType will map to that type in Java (only string types are supported in the Synapta Services Builder at this time).
  • Each child element is a key into the MappedRecord.
  • Can contain maps to other MappedRecords, IndexedRecords, or a Java string.
Indexed
  • Map directly to any element with maxOccurs greater than 1.
  • Any element that is complexType and has maxOccurs greater than 1 will be represented as an IndexedRecord with each entry containing a MappedRecord. All elements of simpleType will map to that type in Java (only string types are supported in the Synapta Services Builder at this time).
  • Can contain entries to MappedRecords or Java strings.

The RecordFactory is part of the J2EE connector architecture. To obtain a particular Record from the RecordFactory, you must ask for it by name. The format of the name is:

TASK/MODE[/CHILD]

where TASK is the name of the task you are going to execute, MODE is either input or output, and CHILD is an optional child record.

For example, if you have a task named "test" and you want to get the input record, use the name "test/input". If the root element of the task "test input" has a child element, "bar," that is complexType, and therefore a MappedRecord, you access that Record as "test/input/bar".

Note The actual name of the root element is never specified and is assumed to be the first top-level element in the task schema.
Related Topics
Bullet Using J2EE Connector Architecture
Bullet Deploying J2EE Session EJBs
Bullet Integrating your J2EE Session EJB with an Application
Bullet How to Provide Tasks in a J2EE App Server
  Attachmate