Information Mapping in the J2C Migration Tool

The J2C migration tool gathers required information from the WSDL files and uses this information to define the outbound interface definition.

Table 1. Information Mapping
Information type Source of information in WSDL file Resultant information in J2C Java™ bean
Java bean interface name The name attribute of the porttype defined in the interface wsdl file. The name of the J2C bean interface is determined by the name attribute of the porttype defined in the interface wsdl file.
Java bean implementation name InterfaceName The Java bean implementation name is constructed using following convention: implName = InterfaceName + Proxy.
Java bean package name The targetNamespace name of the interface wsdl file. The Java bean package name is defined by targetNamespace name of the interface wsdl file.
Project name (of Java, EJB or Web project) the default Project name will be populated based on information from WSDL. The name of the project where the code is derived from the WSDL file, or you can specify a different name.
Connection properties <port/>

Connection properties are obtained from the attributes of ExtensibilityElement defined under port element of the wsdl service file.

Example

<port binding="binding1:CustomerInfoCICSECIBinding name="CustomerInfoCICSECIPort">
<cicseci:address connectionURL="test" password="tester1" serverName="test" username="tester1">
</port>
In the xxxxxxProxy.java file, the connectioninformation will appear in a doclet tag
/**
  * @j2c.managedConnectionFactory-property name="ConnectionURL" value="test" 
  * @j2c.managedConnectionFactory-property name="ServerName" value="test" 
  * @j2c.managedConnectionFactory-property name="UserName" value="tester1" 
  * @j2c.managedConnectionFactory-property name="Password" value="tester1"  
	 */
Type of resource adapter <port/>

The type of resource adapter is obtained from the namespace in the <port/> element of the wsdl service file.

Example (in bold)

<port binding="binding1:LoanBalanceIMSBinding name="LoanBalanceIMSPort">
<ims:address CM0Dedicated="true" JNDILookupName="eis/TEST" dataStoreName="Test">
</port>
Once the migration process determines the type of resource adapter being used, this adapter will be automatically imported into the workspace during migration
JNDILookupName
<port binding="binding1:LoanBalanceIMSBinding name="LoanBalanceIMSPort">
<ims:address CM0Dedicated="true" JNDILookupName="eis/TEST" dataStoreName="Test">
</port>
In the the xxx Proxy.java file, this JNDILookupName appears as follows:
/**
* @j2c.connectionFactory jndi-name="sample/cics/CustomerInfoCICSECIService/CustomerInfoCICSECIPort"
    */
Connection or interaction property that is exposed as an input attribute for a method <operation/>

The connection or interaction property name is obtained from the argument of an element encapsulated by the <operation/> element of the WSDL binding file.

Example

<ims:interactionSpecProperty part="myInImsRequestType" propertyName="imsRequestType"/>
<ims:interactionSpecProperty part="myInInteractionVerb" propertyName="interactionVerb" />
<ims:connectionSpecProperty part="myConUserName" propertyName="userName" />
<ims:connectionSpecProperty part="myConPassword" propertyName="password" />

< / input>
<output name="LoanBalanceInquiryResponse" />
</operation>
In the the xxx Proxy.java file, the connection or interaction spec appears as follows:
/**
	 * @j2c.connectionSpec-property name="userName" argumentBinding="argMyConUserName"
	 * @j2c.connectionSpec-property name="password" argumentBinding="argMyConPassword"
	 * @j2c.connectionSpec-property name="groupName" argumentBinding="argMyConGroupName"
	 * @j2c.connectionSpec-property name="clientID" argumentBinding="argMyConClientID"
	 * @j2c.interactionSpec class="com.ibm.connector2.ims.ico.IMSInteractionSpec"
	 * @j2c.interactionSpec-property name="imsRequestType" argumentBinding="argMyInImsRequestType"
	 * @j2c.interactionSpec-property name="interactionVerb" argumentBinding="argMyInInteractionVerb"
	 * @j2c.interactionSpec-property name="executionTimeout" argumentBinding="argMyInExecutionTimeout"
	 * @j2c.interactionSpec-property name="ltermName" argumentBinding="argMyInLtermName"
	 * @j2c.interactionSpec-property name="mapName" argumentBinding="argMyInMapName"
	 * @j2c.interactionSpec-property name="commitMode" argumentBinding="argMyInCommitMode"
	 * @generated
	 */
Type of the connection or interaction properties <message/>

The type of the connection or interaction properties is derived from <part /> sub-element of the the <message /> element.

Example

<message name="LoanBalanceInquiryRequest">

<part name="lOANBALREQ" type="tns:LOANBALREQ"/ />

<part name="lOANBALREQ" type="tns:LOANBALREQ" ></part>

<part name="myInImsRequestType" type="xsd:int"></part>

<part name="myInInteractionVerb" type="xsd:int" ></part>

<part name="myInExecutionTimeout" type="xsd:int" ></part>

<part name="myInLtermName" type="xsd:string"></part>

<part name="myInMapName" type="xsd:string"></part>

<part name="myInCommitMode" type="xsd:int"></part>

<part name="myConUserName" type="xsd:string"></part>

<part name="myConPassword" type="xsd:string"></part>

<part name="myConGroupName" type="xsd:string"></part>

<part name="myConClientID" type="xsd:string" ></part>

</message>
In the the xxx xxxxInterface.java file, the type of connection or interaction spec properties appears as follows:
/**
 * @generated
 */
public interface xxxxInterface {

	/**
	 * @generated
	 */
	public LOANBALRESP LoanBalanceInquiry(LOANBALREQ lOANBALREQ, int argMyInImsRequestType, int argMyInInteractionVerb, int argMyInExecutionTimeout, java.lang.String argMyInLtermName, java.lang.String argMyInMapName, int argMyInCommitMode, java.lang.String argMyConUserName, java.lang.String argMyConPassword, java.lang.String argMyConGroupName, java.lang.String argMyConClientID) throws javax.resource.ResourceException;
}
Feedback
(C) Copyright IBM Corporation 2000, 2005. All Rights Reserved.