Pure Java Rendezvous Programs


TIBCO Enterprise Message Service is shipped with the tibrvjms.jar file that you can include in your TIBCO Rendezvous applications. This JAR file includes the implementation of the com.tibco.tibrv.TibrvJMSTransport class. This class extends the com.tibco.tibrv.TibrvNetTransport class and allows your pure Java Rendezvous programs to communicate directly with the EMS server instead of through rva.

To use the TibrvJMSTransport class, your application must include tibrvjms.jar (included with TIBCO Enterprise Message Service) and tibrvjweb.jar (included with TIBCO Rendezvous).

You can use TibrvJMSTransport only in Rendezvous applications. This class is not intended for use in your EMS Java clients.
Both TIBCO Rendezvous and TIBCO Enterprise Message Service must be purchased, installed, and configured before creating pure Java Rendezvous applications that use the TibrvJMSTransport class.

The TibrvJMSTransport class provides Rendezvous reliable communication only. Other types of communication, such as certified messaging, are not supported by this transport.

Applications using this transport can send messages to a topic on an EMS server that has the same topic name as the subject of the message. EMS topics receiving Rendezvous messages sent by way of the TibrvJMSTransport do not need to specify the import property. This transport cannot be used to send messages to JMS queues.

For more information about TibrvNetTransport and how to create use transports in TIBCO Rendezvous Java programs, see TIBCO Rendezvous documentation. Table 13 describes the additional methods of TibrvJMSTransport.

Table 13 TibrvJMSTransport class (Sheet 1 of 2)
Method
Description
TibrvJMSTransport()
throws TibrvException
 
TibrvJMSTransport(
   String serverURL)
throws TibrvException
 
TibrvJMSTransport(
   String serverURL,
   String clientId,
   String userName,
   String password)
throws TibrvException
 
TibrvJMSTransport(
   String serverURL,
   String clientId,
   String userName,
   String password,
   Hashtable sslParameters,
   boolean emulateReconnect)
throws TibrvException
Constructor for creating a TibrvJMSTransport.
If no parameters are passed, the transport assumes the server is running on the same machine with the default listener port.
You can also pass the serverURL to connect to the TIBCO Enterprise Message Service server at the specified location.
You may also pass the clientID of your client connection, and a username and a password to use to connect to the server.
SSL parameters govern the connection between the Rendezvous Java client and tibemsd.
When emulateReconnect is true, the first argument can be a list of server URLs, and the recoverConnection method attempts to reconnect to one of them.
destroy()
Destroys the transport and all associated listeners.
toString()
Returns a string representation of this transport.
setPersistentDelivery(
   boolean persistent)
Sets the TIBCO Enterprise Message Service persistent delivery mode for messages sent or received on this transport.
isPersistentDelivery()
Returns true if persistent delivery mode is set for this transport.
recoverConnection()
throws TibrvException
Reconnect to a server. Try servers in sequence, starting with the most recently connected server. If the call cannot connect to any server, it throws an exception.
getCurrentConnectedServer()
Return a string identifying the server to which the transport is currently connected.


TIBCO Enterprise Message Service™ User’s Guide
Software Release 4.3, February 2006
Copyright © TIBCO Software Inc. All rights reserved
www.tibco.com