Using the GUI to Start the Book-Buyer Example

Please Note: The GUI provided with this example is not a supported product. It is a tool to assist you in the successful execution of this example by limiting the amount of typing you have to do. This GUI may or may not be included in future releases. Release notes for this example can be found here.

Before Starting

• rmid
  The RMI activation daemon. rmid is required for activatable objects, like the transaction manager.

• rmiregistry
  The RMI registry service. The book buyer clients use the RMI registry to locate one another, and optionally, other services.

• Jini^TM Lookup service
  A Jini registry service. The book buyer clients can use Jini Lookup services to locate a transaction manager and a space.

• Transaction Manager
  A Jini service that manages transactions.

• JavaSpaces^TM service
  An implementation of JavaSpaces technology. You will need the name of the JavaSpaces service that the clients should contact.

For instructions on how to start these services, please refer to:

• Starting Services   To start these services from the command line
  or
• Starting Services GUI    To start these services using a GUI interface

[ Back To Top ]

Starting the GUI

% java -cp /files/jini1_0/lib/space-examples.jar  com.sun.jini.example.books.StartBooks

Where /files was the directory into which you extracted the Jini system software and the Outrigger software distributions. The -cp option to the java command specifies a class path to search for class files. For more information on options to the java command, click here.

[ Back To Top ]

Tabbed Panels in Brief

• Registry Services - This panel allows you to configure the registry port and lookup group(s) you'll use to locate services and clients.

• JavaSpaces - This panel allows you to specify for the clients: a policy file to use, the path to the necessary jar files, the http server to use, and the name of the space to use.

• Run it All! - This panel allows you to start and stop the the clients: the books seller, the book buyer, and the book watcher.

[ Back To Top ]

Details on Tabbed Panels

Registry Services Tabbed Panel

• RMI Registry - This button must be selected to use the RMI registry.
  • Registry Port - This field allows you to specify the port that should be used for RMI registry lookup requests. If no port is specified, the value defaults to 1099.

• Lookup Services - This button must be selected to use Jini Lookup services.
  • Lookup Groups - This field allows you to specify one or more lookup groups for the client(s) to join. The default value is "public".

• NONE - This button allows you to deselect RMI registry or Jini Lookup services. Note that the example code cannot work properly without the clients using at least the RMI registry.

JavaSpaces Tabbed Panel

• Location of Spaces Policy File - This field must be modified to contain the absolute path to a security policy file.

• Books Jar File - This field must be modified to contain the absolute path to the space-examples.jar file where the book client classes exist.

• Books Client Jar File URL - This field must be modified to contain the URL to classes that will be downloaded from the examples to the space.

• JavaSpaces Name - This field must contain the name of the JavaSpaces service that was started from either the command line or the supplied GUI.

Run It All! Tabbed Panel

• Start Buyer and Stop Buyer - These buttons allow you start or stop a Book Buyer client.

• Start Seller and Stop Seller - These buttons allow you start or stop a Book Seller client.

• Start Watcher and Stop Watcher - These buttons allow you start or stop a Watcher client.

[ Back To Top ]

Running the Example

The runnable clients are:

• Watcher - Keeps track of what is read from, written to, and taken from a space.
• Seller - Allows the user to write information into a space about books that are for sale.
• Buyer - Allows the user to read and take book entries from a space.

[ Back To Top ]