OpenFusion RTOrb Java Edition Examples

The OpenFusion RTOrb Java Edition product includes the examples described below.

The examples are pre-compiled in the distribution and reside in the <OFJ_DIR>/lib/endorsed/ofj.jar file. See the RTOrb Java Edition Product Guide for information about how to build the examples yourself.

Two scripts are provided in the <OFJ_DIR>/bin directory to help run the examples:

• The run script is used to start OpenFusion CORBA services (for example, the NameService) and non Real-time examples. The CORBA Hello example is currently the only non Real-time example.
• The runrt script is used to start Real-time examples. This script sets the default size for scoped and immortal memory to an appropriate value for that real-time JVM. The value should be increased if you need to send large messages.

The following environment variables must be set in order to run the examples, using the runrt script, on all supported real-time JVMs:

• Add <JAVA_HOME>/bin to the PATH.
• Add <OFJ_DIR>/bin to the PATH.

Note: It is recommended to run the code utilising the supplied scripts. If you wish to build the examples then the following must be added to the CLASSPATH.

• <OFJ_DIR>/lib/endorsed/ofj.jar

where <JAVA_HOME> is the directory where the real-time JVM is installed and <OFJ_DIR> is the directory where RTOrb Java Edition is installed. For more information about the environment variables, see the RTOrb Java Edition Product Guide.

The following additional environment variables may be neccessary depending upon user execution privileges in order to run the examples, using the runrt script, on the Sun Java Real-time System:

• OFJ_PRE_OPTS=pfexec

CORBA

• Hello Example

The Hello example is the simplest OpenFusion RTOrb Java Edition application. It is a non Real-time example that executes a basic client / server application using the OpenFusion RTOrb Java Edition ORB.

• Connections Example

The Connections example shows the creation of a private connection to a remote server by the Real-time ORB.

• Priority Example

The Priority example shows the mapping of a CORBA priority and the setting of that priority using RTCurrent.

• Priority Models Example

The Priority Models example shows the use of the client propogated and server declared models of execution.

• RTHello Example

The Real-time Hello example executes a basic client / server application using Real-time Specification for Java thread constructs and Real-time CORBA APIs.

• Threadpools Example

The Threadpools example shows the use of a Threadpool with three lanes. It also demonstrates the use of explicit binding.

• RTMutex Example

The RTMutex example demonstrates the use of the org.omg.RTCORBA.Mutex interface by the server implementation. Mutex is a locality constrained interface that provides a means of coordinating contention for system resources.

• Priority Banded Connections Examples

The Priority Banded Connections examples demonstrate the use of the PriorityBandedConnectionPolicy on the server side and the client side.

• Demo

The demo exists to demonstrate the OpenFusion RTOrb Java Edition using NoHeapRealtimeThreads in ImmortalMemory.

Java

• Immortal Memory Example

The Immortal Memory Example shows the creation of a Java object in ImmortalMemory using a RealtimeThread.

• No Heap Real-time Thread Example

The No Heap Real-time Thread Example shows the creation of a NoHeapRealtimeThread using ImmortalMemory.

• Real-time Thread Example

The Real-time Thread example shows the creation of a RealtimeThread from a non Real-time thread.

Top