Sample Code

Setting Up Java Gateway Examples

To prepare to run sample code, in each of the examples described in this chapter, you must complete the following steps:

1. Start the Java Gateway server (for JMS, start the JMS Gateway server).

2. Start a Terminal session and change to an Ensemble namespace (for JMS examples you need two Terminal sessions).

3. Make sure to run Import code if this is the first time you are running the sample code or if you have modified or recompiled your Java classes.

To prepare to run any of the sample code located under EnsLib.JavaGateway.Test — either for the first time, or after you update or recompile your Java code — you must run the corresponding Import methods found under EnsLib.JavaGateway.InterfaceEnablerOpens in a new tab. This imports the necessary Java classes. The specific sample Import method depends on the type of example you are running. For example:

• To import the sample Java classes provided with Ensemble:

   Do ##class(EnsLib.JavaGateway.InterfaceEnabler).ImportJGSamples(port,host)

  

• To import the JDBC interface:

   Do ##class(EnsLib.JavaGateway.InterfaceEnabler).ImportJDBC(port,host)

  

• To import the InterSystems JBoss Person EJBs, enter the following command (all on one line):

   Do ##class(EnsLib.JavaGateway.InterfaceEnabler).ImportPersonJBoss(PersonEJBJar,
   j2eeJarFile,port,host)
  

  

  Where PersonEJBJar points to the PersonEJB.jar file (as generated by the InterSystems EJB Boss projection) and j2eeJarFile points to the J2EE jar file on your system, for example:

  c:/myj2ee/j2ee.jar

• To import SonicMQ ConnectionFactory (Queue and Topic), allowing connectivity to the SonicMQ JMS Server, enter the following command (all on one line):

   Do ##class(EnsLib.JavaGateway.InterfaceEnabler).ImportSonicJMS(sonicBrokerJar,
   sonicContextJar,port,host)
  

  

  Where sonicBrokerJar points to the Sonic broker.jar file, for example:

  C:/Program Files/SonicSoftware/SonicMQ/lib/broker.jar

  And sonicContextJar points to the Sonic mfcontext.jar file, for example:

  C:/Program Files/SonicSoftware/SonicMQ/lib/mfcontext.jar

• To import all J2EE interfaces (EJB, JCA, JTA, Java XML, JTA, etc.), enter the following command (all on one line):

   Do ##class(EnsLib.JavaGateway.InterfaceEnabler).ImportJ2EE(j2eeJarFile,
   port,host)
  

  

  Where j2eeJarFile points to the J2EE jar file on your system, for example:

  c:/myj2ee/j2ee.jar

In addition to these Import methods, the EnsLib.JavaGateway.InterfaceEnablerOpens in a new tab class provides a convenience method that, given a jar file or a directory name, displays all available classes in that jar file or directory:

 Do ##class(EnsLib.JavaGateway.InterfaceEnabler).Browse(jarName,port,host)

Running Plain Java Examples

The Test() method shows how to use the sample basic classes delivered with Ensemble. To run it, first set up the example, using ImportJGSamples() if you need to import. Then enter:

 Do ##class(EnsLib.JavaGateway.Test).Test(port,host)

The TestArrays() method shows how to use arrays. To run it, first set up the example, using ImportJGSamples() if you need to import. Then enter:

 Do ##class(EnsLib.JavaGateway.Test).TestArrays(port,host)

Running JDBC Examples

The following example establishes a connection with Caché JDBC driver, then executes some standard JDBC code. To run it, first set up the example, using ImportJDBC() if you need to import. Then enter:

 Do ##class(EnsLib.JavaGateway.Test).JDBC(port,host,jdbcPort,jdbcHost)

This sample code should work against any database that has a compliant JDBC driver. Simply replace the connection parameters (JDBC driver class name, URL, username, and password) with appropriate values. See the Class Reference entry for the JDBCOpens in a new tab method for details.

Running EJB Gateway Examples

The following example shows how Caché Basic or ObjectScript code can access a sample Entity Bean (generated by Caché EJB projections) using JBoss version 4.0.1. To run it, first set up the example, using ImportPersonJBoss() if you need to import. Then enter:

 Do ##class(EnsLib.JavaGateway.Test).PersonJBoss(JBossRoot,port, host)

Where JBossRoot points to your JBoss root, for example:

c:/jboss-4.0.1sp1

You can easily modify this example to work against any application server. Simply set the CLASSPATH accordingly and use appropriate connection and context parameters.

Running JMS Gateway Examples

The following examples show how to use Pub/Sub (Topic) and P2P (Queue) JMS Gateways against the SonicMQ JMS Server. The sample Topic/Queue shipped with SonicMQ is used throughout the examples.

The examples below can be modified to work against any JMS Server. Simply set the CLASSPATH accordingly and use appropriate Queue/Topic Connection factories. You must also modify the ImportSonicJMS() method to import corresponding connection factories, and you need to use appropriate sample Topics/Queues.

• JMS Point-to-Point (P2P) Example

• JMS Publish/Subscribe (Pub/Sub) Example

• Java Naming and Directory Interface (JNDI) Example

Stateless Service Mode Example

Here is a simple implementation using GSON which gets the Google directions between two cities and sends them back to Caché in JSON format. For more info on GSON go to: https://code.google.com/p/google-gson/Opens in a new tab.

Java code:

package jsonservice;
import java.io.BufferedReader;
import java.io.ByteArrayInputStream;
import java.io.InputStreamReader;
import java.net.URL;

import com.google.gson.JsonElement;
import com.google.gson.JsonObject;
import com.google.gson.JsonParser;

public class Directions implements com.intersys.gateway.Service {

        public byte[] execute(byte[] args) throws Throwable {
                 JsonElement inputJSON = new JsonParser().parse(new
                                  BufferedReader(new InputStreamReader(new ByteArrayInputStream(args), "UTF-8")));
		JsonObject jsonObject = inputJSON.getAsJsonObject();
		String origin = jsonObject.get("origin").toString();
		String destination = jsonObject.get("destination").toString();

		URL URLsource = new URL("http://maps.googleapis.com/maps/api/directions/json?
				origin="+origin+"&destination="+destination+"&sensor=false");
		BufferedReader in = new BufferedReader(new  InputStreamReader(URLsource.openStream(),"UTF-8"));
		JsonElement outputJSON = new JsonParser().parse(in);
		in.close();
		jsonObject = outputJSON.getAsJsonObject();
		String response = jsonObject.toString();
		return response.getBytes();
	}
}

To invoke the above service from Caché/Ensemble, simply do:

Set classPath=##class(%ListOfDataTypes).%New()
// add GSON to the classpath
Do classPath.Insert("c:/service/gson-1.4.jar")
// add the location of the above Service to the classpath
Do classPath.Insert("c:/service/")
// invoke the service
Write  ##class(%Net.Remote.Gateway).%RemoteService("127.0.0.1",55555,"jsonservice.Directions","{""origin"" : 
                         ""philadelphia"", ""destination"" : ""boston""}",classPath)