SAS 9.1.3 Integration Technologies » Developer's Guide


Developing Java Clients
Installation and JRE Requirements
Security
Using the IOM Server
Using the Java Connection Factory
Connecting with Directly Supplied Server Attributes
Connecting with Server Attributes Read from a SAS Metadata Server
Connecting with Server Attributes Read from an LDAP Server
Connecting with Server Attributes Read from the Information Service
Language Service Example
Logging Java Connection Factory Activities
Using Failover
Using Load Balancing
Using Connection Pooling
Pooling with Directly Supplied Server Attributes
Pooling with Server Attributes Read from a Metadata Server
Pooling with Server Attributes Read from the Information Service
Returning Connections to the Java Connection Factory
Using Java CORBA Stubs for IOM Objects
Getting a JDBC Connection Object
Using the Java Workspace Factory
Using SAS Foundation Services
IOM and CORBA Class Documentation
Java Clients

Using the IOM Server

This section introduces the steps necessary to construct and execute a Java application that uses the IOM server. As you become more familiar with Java client programming for the IOM server, you can build on these steps to exploit the more sophisticated features of the IOM server.

With SAS 9 Integration Technologies, Java clients can access an IOM server using the Java Connection Factory interface of the new Connection Service. The Java Connection Factory interface can access metadata from either of the following:
  • a metadata server (SAS Metadata Server or LDAP server).
  • server parameters supplied directly in the source code. (You can supply a ManualConnectionFactoryConfiguration object directly in the source code. For details, see Connecting with Directly Supplied Server Properties).

If you are using a SAS Metadata Server or supplying server parameters directly in the source code, the Connection Service can connect to SAS Workspace Servers, other metadata servers, SAS OLAP Servers, and SAS Stored Process Servers.

Note: If you are using an LDAP server, the Connection Service interface can only connect to workspace servers. Under LDAP, Integration Technologies does not support access to other types of IOM servers.

Note: The Version 8 Workspace Factory interface is still supported. However, it is recommended that you use the Java Connection Factory interface in order to take advantage of the new features available with SAS 9 Integration Technologies.

Using a Metadata Server with the Connection Service

If you are using a metadata server, the first step in developing and running a client program is to make sure you have access to a properly configured server. You can access a server by reading the connection information from a metadata server:

As is the case in client development, you can start with a basic server configuration and then move into more a sophisticated configuration over time.

After the IOM server has been configured, you can begin developing a Java client for the IOM server.

Connecting a Java Client to an IOM Server

With SAS 9 Integration Technologies, Java clients can use the Java Connection Factory interface to access an IOM server as follows:

  1. From the Java Connection Factory, obtain a connection to an IOM server. Then, obtain the remote object reference connected to that IOM server and narrow it to the appropriate remote interface.

  2. Use Java CORBA stubs for IOM objects and JDBC connection objects to exploit the power of SAS in the IOM server.

  3. Return the Connection to the Java Connection Factory for disconnection or reuse.

Java clients can also still use the Workspace Factory to access an IOM server as follows:

  1. From the Workspace Factory, obtain a Workspace remote object reference connected to an IOM server.

  2. Use Java CORBA stubs for IOM objects and JDBC connection objects to exploit the power of SAS in the IOM server.

  3. Return the Workspace object to the Workspace Factory for disconnection or reuse.

To get started, you can put together a simple client application by composing the examples given for each step. Then you can continue to read the additional documentation that is provided and learn about Java client programming for the IOM server in greater detail.