Copyright © Cloud Software Group, Inc. All Rights Reserved

XML To Java

Activity

The XML to Java activity allows you to create an instance of a Java object based on data from an XML document. The XML schema for providing input to the Java object is created from the Java object or Java Schema specified on the Configuration tab of this activity. The specified Java class must meet the following requirements:

•	The Java class must have a public default constructor (that is, a constructor with no arguments).

•	The Java class must be serializable (that is, the class must implement or be a subclass of a class that implements java.io.Serializable).

See Java Schema for a description of the conversion rules.

If the class does not have a public data member and only has a Java bean accessor that retrieves the data, the input schema contains an element for the accessor, but the resulting Java object has no value set for the member. For example, the object has a method declared as public int getID(), but there is no method for setting the ID and the data member ID is not public. In this case, there is an element named ID in this activity’s input schema, but mapping a value to the element does not result in setting the ID member of the output Java object because there is no public mechanism for setting the data.

Sequenced elements and mapping of enumeration to simple type schemas is supported in the XML to Java activity.

For more information, see , Sequenced Elements and , Enumeration.

Configuration

The Configuration tab has the following fields.

Field	Global Var?	Description
Name	No	The name to appear as the label for the resource.
Description	No	Short description of the activity.
Use Java Schema	No	Specifies whether you want to use a Java Schema shared configuration resource to configure this activity or whether you want to specify a Java class file. When unchecked the Java Class field appears. When checked, the Java Schema: and Class: fields appear.
Java Schema:	No	Only available when the Use Java Schema field is checked. This field specifies a Java Schema shared configuration resource. This resource is used to specify the schema used to convert the XML schema to the Java object.
Java Class:	No	When Use Java Schema is checked, this is the class in the Java Schema to use. Use the Show Class Browser button to bring up the dialog to choose the Java class.

Input

See TIBCO ActiveMatrix BusinessWorks Process Design for more information about mapping and transforming input data.

The input for the activity is the following.

Input Item	Datatype	Description
XML Schema	varies	The XML schema that you want to convert to a Java object. The content of this schema depends upon the Java class or Java Schema defined on the Configuration tab. The elements appear in the schema in alphabetical order.

Output

The output for the activity is the following.

Output Item	Datatype	Description
<declaringClass>	Java Object	A Java object that is created out of the XML schema.

Error Output

The Error Output tab lists the possible exceptions that can be thrown by this activity. See TIBCO ActiveMatrix BusinessWorks Error Codes for more information about error codes and corrective action to take.

Exception	Thrown When...
XMLToJavaConversionException	An error occurred when converting the XML schema to a Java object.

 

Copyright © Cloud Software Group, Inc. All Rights Reserved