+

Search Tips   |   Advanced Search

 

UDDI EJB Interface (Deprecated)

 

Use the EJB application programming interface (API) of the UDDI registry component to publish, find, and delete UDDI entries. The UDDI EJB interface is deprecated in WAS Version 6.0 and later versions, and supports UDDI version 2 API requests only.

The client classes that are required for the EJB interface are contained in app_server_root/UDDIReg/clients/uddiejbclient.jar. You can read the Java documentation for these classes at the Javadoc welcome page.

The EJB API is contained in two stateless session beans, one for the inquiry API (com.ibm.uddi.ejb.InquiryBean) and one for the publish API (com.ibm.uddi.ejb.PublishBean), whose public methods form an EJB interface for the UDDI registry. All the public methods on the InquiryBean class correspond to UDDI V2 inquiry API functions, and all the public methods on the PublishBean class correspond to UDDI Version 2 publish API functions. Not all UDDI V2 API functions are implemented, for example get_authToken, discard_authToken, get_businessDetailExt.

In each interface, there are groups of overloaded methods that correspond to the operations in the UDDI 2.0 specification. There is a separate method for each major variation in function. For example, the single UDDI operation find_business is represented by ten variations of findBusiness methods, with different variations to find by name, find by categoryBag argument, and so on.

The arguments for the EJB interface methods are Java objects in thee com.ibm.uddi.datatypes packag. Generally, there is a one-to-one correspondence between classes in this package and elements of the UDDI V2 XML schema. Exceptions to this correspondence are, for example, where UDDI XML elements can be represented by a single String. See the Java documentation for package com.ibm.uddi.datatypes for more information, at Javadoc welcome page.

The methods on the EJB InquiryBean class map to the EJB inquiry role, and those of the EJB PublishBean class map to the EJB publish role. The EJB inquiry and publish roles protect the EJB interface, as described in Access control for UDDI registry interfaces. If the role mapping is such that a method requires a WAS authenticated user ID, a client program can supply the user ID and password, either when prompted by WAS, or by providing application code that logs in to the default realm using the user ID and password. Use the sas.client.props configuration file to determine how to specify the user ID and password (see Configure security with scripting ).

Using the EJB client In this section, it is assumed that both WebSphere Application Server and the UDDI registry are installed, and that they are both running. You cannot use the EJB client from a machine that does not have WAS installed.

  1. Set up your environment to communicate with WAS:

    [AIX] [HP-UX] [Linux] [Solaris] . app_server_root/bin/setupCmdLine.sh (note the space between the period and app_server_root)

    [Windows] app_server_root/bin/setupCmdLine.bat

  2. Verify that your CLASSPATH includes the uddiejbclient.jar file (from the app_server_root/UDDIReg/clients directory), and the code for your client.

  3. Compile your EJB client programs:

    [AIX] [HP-UX] [Linux] [Solaris] $JAVA_HOME/bin/javac -extdirs $WAS_EXT_DIRS:$JAVA_HOME/jre/lib/ext -classpath $WAS_CLASSPATH:$CLASSPATH yourcode.java

    [Windows] %JAVA_HOME%/bin/javac -extdirs $WAS_EXT_DIRS:%JAVA_HOME%/jre/lib/ext -classpath %WAS_CLASSPATH%:%CLASSPATH% yourcode.java

  4. Run the compiled programs:

    [AIX] [HP-UX] [Linux] [Solaris] $JAVA_HOME/bin/java -Djava.ext.dirs=$WAS_EXT_DIRS:$JAVA_HOME/jre/lib/ext -Dwas.install.root=$WAS_HOME -Dserver.root=$WAS_HOME $CLIENTSAS $CLIENTSOAP -cp $WAS_CLASSPATH:$WAS_HOME/UDDIReg/clients/uddiejbclient.jar:$CLASSPATH <class name> <args>

    [Windows] %JAVA_HOME%\bin\java -Djava.ext.dirs=%WAS_EXT_DIRS%;%JAVA_HOME%\jre\lib\ext -Dwas.install.root=%WAS_HOME% -Dserver.root=%WAS_HOME% %CLIENTSAS% %CLIENTSOAP% -cp %WAS_CLASSPATH%;%WAS_HOME%\UDDIReg\clients\uddiejbclient.jar:%CLASSPATH% <class name> <args>

Ensure that your PATH statement starts with app_server_root/java/bin.


 

Related tasks


UDDI registry client programming

 

Reference topic