Java Application Servers

Only available with Corda® 7 Enterprise.

The Java* version of the Corda Embedder can be used to embed Corda images within Web pages served by most Java Application Servers. Access the Corda Embedder using both Java Server Pages and Java Servlets. The Java Corda Embedder even includes a Java Tag Library interface.

Note: Use of the Java Tag Library interface may require additional installation steps. See Java Tag Library for details.

While installation procedures for the Java Corda Embedder vary by Java Application Server, installation typically involves including <product_root>\Server\dev_tools\embedder\java\CordaEmbedder.jar in the Web application server's classpath. This file contains all of the classes necessary to use the Corda Embedder in a Java environment.

Listed below are instructions for several of the more common Web application servers. If yours is not listed, consult the Web application server's documentation.

Before you read on, copy the CordaEmbedder.jar file to a location accessible to the Web application server.

For instructions on using the Corda Embedder in JSP pages, see Java Server Pages in the Corda 7 Developer Reference or JSP in the Corda 7 Highwire™ Guide.

For instructions on using the Corda Embedder in Java Servlets, see Java Servlets in the Corda 7 Developer Reference or Java Servlets in the Corda 7 Highwire Guide.

iPlanet / Sun ONE

These instructions apply to the iPlanet /Sun series of Web application servers.

To add Corda Embedder to iPlanet or Sun One application servers.

  1. Begin by logging in to the iPlanet or Sun One Web Administration Page.

    Access this by going to http://localhost:8888 on the computer running the server.

  2. Once you are logged in, choose the server which you want to alter from the pull-down list and press the Manage button.

  3. For iPlanet 6.0 and newer, click the Java tab.

    For versions older than 6.0, click the Servlets tab. Make sure that you have enabled JSPs and Servlets for the server by selecting Yes for the following settings: Activate the Servlet Engine? and Enable JSP? (only the first setting needs to be enabled for Servlets).

  4. Select the Configure JVM Attributes from the left sidebar.

  5. Add the absolute path to the CordaEmbedder.jar file to the end of the Classpath variable. If other files are already in this list, be sure to add a semi-colon (or colon for Linux- and UNIX-compatible systems) before the path to CordaEmbedder.jar.

  6. Restart the iPlanet/Sun One server.

JRun

These instructions apply to JRun application servers.

To add Corda Embedder to JRun

  1. Copy the CordaEmbedder.jar file to your JRun installation's server\lib directory (e.g., C:\Program Files\Allaire\JRun\servers\lib).

    This puts the Corda Embedder in JRun's common classpath. If you want to add the CordaEmbedder.jar on an application-by-application basis, copy it to the classpath of the Web application you want to use it with. For example, if the server is named default and the Web application is named default_app, you would copy it to C:\JRun\servers\default\default_app\WEB-INF\lib\.

    With JRun 4, copy CordaEmbedder.jar to \SERVER-INF instead of \WEB-INF (e.g., C:\JRun\servers\default\default_app\SERVER-INF\lib\.

  2. Restart JRun.

Tomcat

These instructions apply to Apache Tomcat application servers.

To add Corda Embedder to Tomcat

  1. Copy the CordaEmbedder.jar file into your Tomcat installation's \lib folder (e.g., C:\Program Files\Tomcat\server\lib).

    Note: Newer versions of Tomcat may have a \shared\lib folder instead of \server\lib. Copy CordaEmbedder.jar into whichever folder is present in your Tomcat installation.

    2. This puts the Corda Embedder in Tomcat's common classpath. If you want to add the CordaEmbedder.jar on an application-by-application basis, copy it to the classpath of the Web application you want to use it with. For example, if the Web application is named App1, copy it to /Tomcat/webapps/App1/WEB-INF/lib.

  2. Restart Tomcat.

WebLogic

These instructions apply to WebLogic application servers.

To add Corda Embedder to WebLogic

  1. Copy the CordaEmbedder.jar file to the WEB-INF\lib subdirectory within the root directory of the Web application.

    On Microsoft* Windows*, for example, the root directory is usually C:\bea\wlserver6.1\config\mydomain\applications\DefaultWebApp_myserver.

  2. Restart WebLogic.

WebObjects

These instructions apply to WebObjects servers.

To add Corda Embedder to WebObjects

In this process, we'll add the path to the CordaEmbedder.jar file to the Build classpath, and the Deploy classpath.

  1. Open the /Supporting Files/Makefile.preamble file in a text editor.

  2. Search for the OTHER_CLASSPATH variable.

  3. Add the path to the CordaEmbedder.jar file to this variable.

    For example, this line might read as follows:

    OTHER_CLASSPATH = /Applications/Corda60/dev_tools/embedder/java/CordaEmbedder.jar

    This adds the Corda Embedder to the Build classpath.

  4. Save this file and close it.

  5. Open the /Supporting Files/CustomInfo.plist file in a text editor.

  6. Search for the NSJavaUserPath variable.

  7. Add the path to the CordaEmbedder.jar file to this variable.

    For example, this line might read as follows:

    NSJavaUserPath = /Applications/Corda60/dev_tools/embedder/java/CordaEmbedder.jar

    This adds the Corda Embedder to the Deploy classpath.

  8. Save this file and close it.

  9. Restart WebObjects .

WebSphere

These instructions apply to WebSphere application servers.

To add Corda Embedder to WebSphere

  1. Open the WebSphere administration console.

  2. Expand the WebSphere Administrative Domain tree on the left side.

  3. Several machine names should appear. Select the name of the machine from which you want to deliver Corda Server- enabled Web pages.

  4. Select the appropriate Web server.

    By default, every machine running WebSphere has a server named Default Server; in most cases you want to select this server.

  5. Select a servlet engine (e.g., Default Servlet Engine).

  6. Finally, select the appropriate Web application within the servlet engine (e.g., default_app).

  7. After selecting a Web application, click the Advanced tab.

    This displays the Classpath, containing a list of JAR and ZIP files used by this Web application.

  8. Click the button to the right of Classpath and browse to the location of CordaEmbedder.jar .

    Be sure the Files of Type box at the bottom of the browsing dialog is set to Jar Files (.jar)).

    After you select the file from this dialog, the CordaEmbedder.jar file should appear in the list of jar and zip files in the classpath.

  9. Click Apply

    After pushing Apply, the newly added jar file should appear in the bottom list, Classpaths in Use. At this point, you know that the jar file was successfully added to the Web application.