Adapter Definition

package com.wm.MyAdapter;

public interface MyAdapterConstants {
	
	static final int ADAPTER_MAJOR_CODE = 9001;
 static final String ADAPTER_JCA_VERSION = "1.0";
	static final String ADAPTER_NAME = "MyAdapter";
	static final String ADAPTER_VERSION = "9.12";
			
	//Using next statement creates cyclic class loading dependency issue
	//therefore, the resource bundle class name is fully spelled out
	//static final String ADAPTER_SOURCE_BUNDLE_NAME = MyAdapterResource.class.getName();
 static final String ADAPTER_SOURCE_BUNDLE_NAME =
		"com.wm.MyAdapter.MyAdapterResource";
}

• Your WmAdapter implementation class (MyAdapter) must call the base class constructor (super()). The base class constructor calls several of the implementation class's methods and instantiates your resource bundle.
• The base class constructor calls several of the implementation class's methods after the first call to getInstance. It is vital that they do not invoke another call to getInstance which results in an endlessly recursive call to the constructor, and ultimately crashes the JVM and bring down Integration Server. This must be avoided in static initializers in your resource bundle as some of the resource bundles are keyed on the same string that is returned from MyAdapter.getAdapterName. Do not populate the string in a static initializer. This line of code in a static initializer of a resource bundle produces an undesirable results:

  {MyAdapter.getInstance().getAdapterName() +  
  ADKGLOBAL.RESOURCEBUNDLEKEY_DISPLAYNAME, "My Adapter"}

• When specifying any resource, you must use the fully qualified name of the resource's associated implementation class (rather than an object instance).

In the example, create MyAdapter class:

package com.wm.MyAdapter;

import java.util.Locale;

import com.wm.adk.WmAdapter;
import com.wm.adk.error.AdapterException;
import com.wm.adk.info.AdapterTypeInfo;
import com.wm.adk.log.ARTLogger;

public class MyAdapter extends WmAdapter implements MyAdapterConstants{

	public static MyAdapter _instance = null;
	public static ARTLogger _logger = null;
	
	public MyAdapter() throws AdapterException {		super();	}

	public void fillAdapterTypeInfo(AdapterTypeInfo arg0, Locale arg1) {}
	public String getAdapterJCASpecVersion() {		return ADAPTER_JCA_VERSION; 	}
	public int getAdapterMajorCode() {  return ADAPTER_MAJOR_CODE; 	}
	public String getAdapterName() {		return ADAPTER_NAME; 	}
	public String getAdapterResourceBundleName() { 		return ADAPTER_SOURCE_BUNDLE_NAME;	}
	public String getAdapterVersion() {		return ADAPTER_VERSION;	}
 public static ARTLogger getLogger() { 		return _logger;	}

	
public void initialize() throws AdapterException {
		// TODO Auto-generated method stub
		_logger = new ARTLogger(getAdapterMajorCode(),
				getAdapterName(),
				getAdapterResourceBundleName());
		_logger.logDebug(9999,"My Adapter Initialized");
	}

	public void cleanup() {
		if (_logger != null)
			_logger.close();
	}

	
public static MyAdapter getInstance() {
		// TODO Auto-generated method stub
		if (_instance != null)
			return _instance;
		else {
			synchronized (MyAdapter.class) {
				if (_instance != null) {
					return _instance;
				}
				try {
					_instance = new MyAdapter();
					return _instance;
				} catch (Throwable t) {
					t.printStackTrace();
					return null;
				}
			}
		}
	}
}

ResourceBundleName ResourceBundleName_locale

For example, a default resource bundle and a corresponding locale specific bundle for use in Japan might be named:

MyAdapterResourceBundle  
MyAdapterResourceBundle_ja

Example of getAdapterResourceBundleName method in MyAdapter class:

	
 @Override
	public String getAdapterResourceBundleName() {
		// TODO Auto-generated method stub
		return ADAPTER_SOURCE_BUNDLE_NAME;
	}

Example ofADAPTER_SOURCE_BUNDLE_NAME constant in MyAdapterConstants interface:

	
static final String ADAPTER_SOURCE_BUNDLE_NAME =
		"com.wm.MyAdapter.MyAdapterResource";

• In the adapters administrative interface, select About, the about page appears with the display name, description and copyright.
• In the Integration Server Administrator, select Packages > MyAdapter > Home, the index page appears.

# The Site Name
debug=on
optimize=off
deprecation=off
webM.home=C:/softwareag/912
server.home=${webM.home}/IntegrationServer
package=MyAdapter
instance_name=default
srcdir=${server.home}/instances/${instance_name}/packages/${package}/code/source
destdir=${server.home}/instances/${instance_name}/packages/${package}/code/classes

<?xml version="1.0"?>
<project name="Adapter using ADK" default="deploy" basedir=".">
	<property file="build.properties" />
	<!-- classes belonging to this package -->
	<path id="this.package.classpath">
		<fileset dir="${server.home}/instances/${instance_name}/packages/${package}/">
			<include name="code/classes"/>
		</fileset>
	</path>

	<!-- All classes that need to be found by this script -->
	<path id="total.classpath">
		<pathelement location="${server.home}/instances/${instance_name}/packages/WmART/code/jars/wmart.jar"/>
		<pathelement location="${server.home}/lib/wm-isserver.jar"/>
		<pathelement location="${webM.home}/common/lib/wm-isclient.jar"/>
		<pathelement location="${webM.home}/common/lib/glassfish/gf.jakarta.resource.jar"/>
		<pathelement location="${server.home}/instances/${instance_name}/packages/WmART/code/classes/"/>		
		<path refid="this.package.classpath"/>
	</path>
	

<!-- Compile the java files of this package -->
	<target name="createclasses" depends="init">
		<echo>Creating classes</echo>
		<mkdir dir="${destdir}/"/>
		<javac debug="${debug}" optimize="${optimize}"
			deprecation="${deprecation}" srcdir="${srcdir}"
			destdir="${destdir}">
			<classpath>
				<path refid="total.classpath"/>
			</classpath>
		</javac>
	</target>

	<!-- Execute jcode -->
	<target name="execjcode" depends="createclasses">
		<echo>Deploying classes</echo>
		<exec executable="${server.home}/instances/${instance_name}/bin/jcode"
				vmlauncher="false" failonerror="true">
			<arg value="fragall" />
			<arg value="${package}" />
		</exec>
	</target>

	<!-- delete .class files built in this package -->
	<target name="cleanclasses">
		<echo>Cleaning classes</echo>
		<mkdir dir="${destdir}"/>
		<delete quiet="false">
			<fileset dir="${destdir}" includes="**/*.class"/>
		</delete>
	</target>
	
	<!-- if this package depends on classes found in other packages,
		add targets to build those classes here. -->
	<target name="init">
		<tstamp/>
	</target>	
	
	<target name="packageDependencies" depends="" />
	<target name="clean" depends="cleanclasses" />
	<target name="classes" depends="cleanclasses, createclasses" />
	<target name="deploy" depends="execjcode" />
	<target name="all" depends="packageDependencies, cleanclasses, execjcode" />
	<target name="remake" depends="packageDependencies, cleanclasses, createclasses" />

</project>

The JAR files required to compile your source code are as follows:

• IBMwebMethods_directory\common\lib\wm-isclient.jar
• IBMwebMethods_directory\common\lib\glassfish\gf.jakarta.resource.jar
• Integration Server_directory\lib\wm-isserver.jar
• Integration Server_directory\instances\<instance_name>\packages\WmART\code\jars\wmart.jar

The folder containing the class files required to compile your source code is as follows:

• Integration Server_directory\instances\<instance_name>\packages\WmART\code\classes

IBMwebMethods_directory is the folder in which IBM webMethods components are installed and Integration Server_directory is the folder in which Integration Server is installed.

ant classes

• In the Properties > StartUp/Shutdown Services > Startup Services, add the startup service created.
• In the Properties > StartUp/Shutdown Services > Shutdown Services, add the shutdown service created.

set SUSPEND_MODE=n

rem @echo off
set TARGET="C:\softwareag\912\IntegrationServer\instances\default\packages\MyAdapter\code\source"
set JAVA_MIN_MEM=64M
set JAVA_MAX_MEM=64M
set JAVA_MEMSET=-ms%JAVA_MIN_MEM% -mx%JAVA_MAX_MEM%
set JAVA_DBG="C:\softwareag\912\jvm\jvm\bin\jdb"
set ARGS=com.sun.jdi.SocketAttach:hostname=localhost,port=10033
%JAVA_DBG% -sourcepath %TARGET% -connect %ARGS%