Connecting jBase Server
This section helps you to connect to jBASE server and access it.
jRemote Packages
jRemote API is available to the following development platforms:
- Java version of jRemote is distributed as a Java Archive (jar) file (jremote.jar). This archive must be located in your CLASSPATH in order to be used by a java application. The jRemote class library is defined under the com.jbase.jremote namespace. Please read the appropriate class library (javadoc) documentation for more information about this API.
- Microsoft .NET C# version of jRemote is distributed as a static library assembly (jremote.lib). The jRemote class library is defined under the com.jbase.jremote namespace. Please read the appropriate class library documentation for more information about this API.
jAgent
jBASE jAgent is a server-side jBASE component, which must be listening on a user-defined TCP port on the remote jBASE instance. It accepts socket connections to process incoming requests from Client Applications implementing the jRemote Client API. See TAFC Agent user guide for more information on how to configure and start jAgent.
Connecting to jBASE
jRemote connection handles are obtained through the JConnectionFactory interface. This interface is implemented by the jRemote’s DefaultJConnectionFactory class and it provides several getConnection() methods to establish a new connection with a remote jBASE instance. See API documentation for more information.
Some of these methods accept the java.util.Properties or System.NameValueCollection object as a parameter and are used to supply connection properties (The available connection properties are highlighted in blue).
A second option to supply connection properties is to use the getter and setter methods implemented in DefaultJConnectionFactory. The samples included in this section use the getter and setter methods.
The following connection properties are used to specify the target host:
- host [Default value: localhost] - Specifies the host address
- port [Default value: 20002] - Specifies the port number
Java
try {
DefaultJConnectionFactory cxf = new DefaultJConnectionFactory();
cxf.setHost("127.0.0.1");
cxf.setPort(20002); //Port should match the port jAgent is listening on
JConnection cx = cxf.getConnection();
return cx;
} catch (JRemoteException e) {
// error
}
C#
try {
DefaultJConnectionFactory cxf = new DefaultJConnectionFactory();
cxf.Host = "127.0.0.1";
cxf.Port = 20002; //This should match jAgent’s port
JConnection cx = cxf.getConnection();
return cx;
} catch (JRemoteException e) {
// error
}
In this topic
