Whole document tree

Getting Started with Java IDL: Using Stringified Object References

To invoke an operation on a CORBA object, a client application needs a reference to the object. You can get such references in a number of ways, such as calling ORB.resolve_initial_references() or using another CORBA object (like the name service). In previous sections of this tutorial, you used both of these methods to get an initial object reference.

Often, however, there is no naming service available in the distributed environment. In that situation, CORBA clients use a stringified object reference to find their first object.

In this lesson, you will learn how to create a stringified object reference as a part of the server startup, and how the client gets that reference and destringifies it for use as a real object reference.

The steps in this lesson are:

1. Making a Stringified Object Reference
2. Getting a Stringified Object Reference
3. Destringifying the Object Reference
4. Compiling and Running a Stringified Hello World

To see completed versions of the source code, follow the links to HelloServer.java and HelloClient.java.

Making a Stringified Object Reference

1. Create a new directory at the same level as the Hello directory named HelloString. Copy Hello.idl to this directory.

2. Copy HelloServer.java from the Hello directory to the HelloString directory. Name it HelloServerString.java, and make the following changes in this file.

3. Because the new server will write a file to disk, you need to add an import statement. Add the following:

   import java.io.*; // needed for output to the file system.
   

4. The new server won't use the naming service, so you don't need the CosNaming packages. Delete these lines from the code:

   import org.omg.CosNaming.*;                       // not needed for stringified version
   import org.omg.CosNaming.NamingContextPackage.*;  // remove from code
   

5. Delete the code that gets the initial naming context and resolves the reference to a Hello object:

         // Get the root naming context
         org.omg.CORBA.Object objRef = orb.resolve_initial_references("NameService");
         NamingContext ncRef = NamingContextHelper.narrow(objRef);
         
         // Bind the object reference in naming
         NameComponent nc = new NameComponent("Hello", " ");
         NameComponent path[] = {nc};
         ncRef.rebind(path, helloRef);
   

6. Call the ORB's object_to_string() method and pass it the reference to the servant object. This returns the object reference in a string form that can be saved in a file on disk.

         String ior = orb.object_to_string(helloRef);
   

7. Build the path to the file that will be stored, using system properties to determine the path structure and syntax.

         String filename = System.getProperty("user.home")+
               System.getProperty("file.separator")+"HelloIOR";
   

8. Use standard Java operations to write the stringified ior to disk:

         FileOutputStream fos = new FileOutputStream(filename);
         PrintStream ps = new PrintStream(fos);
         ps.print(ior);
         ps.close();
   

9. Save and close HelloServerString.java.

Note to Windows users: You should substitute backslashes (\) for the slashes (/) in all paths in this document.

1. Copy HelloClient.java from the Hello directory to the HelloString directory. Name it HelloClientString.java, and make the following changes in this file.

2. Because the new client will read a file from the disk, you need to change the import statements. Add the following:

   import java.io.*; // needed for input from the file system.
   

3. The new client won't use the naming service, so you don't need the CosNaming package. Delete this line from the code:

   import org.omg.CosNaming;*  // not needed for stringified version
   

4. Delete the code that gets the initial naming context and registers the servant with the naming service:

         // Get the root naming context
         org.omg.CORBA.Object objRef = orb.resolve_initial_references("NameService");
         NamingContext ncRef = NamingContextHelper.narrow(objRef);
         
         // Resolve the object reference in naming
         NameComponent nc = new NameComponent("Hello", " ");
         NameComponent path[] = {nc};
         Hello helloRef = HelloHelper.narrow(ncRef.resolve(path));
   

5. Use standard Java operations to read the file that has the object reference. Note that client and server programs must know the name of the file and where it is stored.

         String filename = System.getProperty("user.home")+
               System.getProperty("file.separator")+"HelloIOR";
         FileInputStream fis = new FileInputStream(filename);
         DataInputStream dis = new DataInputStream(fis);
         String ior = dis.readLine();
   

The HelloClientString application now has a String object containing the stringified object reference.

Destringifying the Object Reference

To destringify the object reference in ior, call the standard ORB method:

      org.omg.CORBA.Object obj = orb.string_to_object(ior);

Finally, narrow the CORBA object to its proper type, so that the client can invoke on it:

      Hello helloRef = HelloHelper.narrow(obj);

Compiling and running the new version of Hello World requires most of the same steps as for the naming service version.

Compiling Hello World

1. Change to the HelloString directory.

2. Compile the IDL file. Enter the compiler command:

      
   	idlj -fall Hello.idl
   

3. Run the Java compiler on your source code:

   javac *.java
   

4. Correct any errors in your files and recompile if necessary. (You can copy the files from HelloServer.java and HelloClient.java if you have trouble finding any typographical errors.)

HelloServerString.class, HelloServantString.class, and HelloClientString.class are generated to the HelloString directory.

Running Hello World

To be certain that you are running your own server, check that all Hello server and name server processes have been stopped. Stop them if they are running.

1. From an MS-DOS system prompt (Windows) or command shell (UNIX), start the Hello server with the stringified object reference:

   java HelloServerString -ORBInitialPort 1050 &
   

2. From another prompt or shell, run the Hello application client with the stringified object reference:

   java HelloClientString  -ORBInitialPort 1050 &
   

3. The client prints the string from the server to the command line:

   Hello world!!

Initialization: Obtaining Initial Object References

Explains the various ways of getting an initial object reference