% java
-cp <jar-file>
<security-policy-property>
<rmi-codebase-property>
com.sun.jini.example.browser.Browser
[ -admin ] [group,...]
java -cp /files/jini1_0/lib/jini-examples.jar
-Djava.security.policy=/files/jini1_0/example/browser/policy
-Djava.rmi.server.codebase=http://host:8080/jini-examples-dl.jar
com.sun.jini.example.browser.Browser
Where /files was the directory into which you extracted
the 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.
To select a lookup service for browsing, pick one from the Registrar menu.
To restrict the set of lookup services to just the public ones (those in group ""), select Find Public from the File menu. To restrict the set of lookup services to just those in specific groups, select Find Groups... from the File menu, and then enter one or more group names in the pop-up dialog box, separated by spaces or commas. You can use the name "public" to refer to the group "".
To restrict yourself to a single Jini Lookup service, and automatically select it for browsing, select Find One... from the File menu, and then enter the name of the host where the lookup service resides, optionally followed by a port number.
To go back to finding all Jini Lookup services, select Find All from the File menu.
Once you have selected a lookup service for browsing, the text area changes to show you the total number of services currently registered with the lookup service. As new services register or existing services unregister, this text will change automatically.
You begin with an empty template, which matches everything in the lookup service. To narrow down the set of services that match, select from the Services and Attributes menus.
The Services menu shows service types that can be added to your current template to refine your search. When you select one, it appears in the text area to show you what your new template contains, and the revised number of matching services is shown. You can then go back to the Services menu to select additional types, or to de-select existing choices.
The Attributes menu shows attribute set classes (with package prefixes removed) that can be added to your current template to refine your search. When you select one, it appears in the text area to show you what your new template contains, the revised number of matching services is shown, and that menu item changes to a pull-aside menu. You can go back to the Attributes menu to select additional attribute set classes, or traverse a pull-aside menu to see the names of attributes, each of which is itself a pull-aside menu. You can traverse these to see the possible values for the attributes, and select one to further refine your search. You can de-select existing attribute choices, and you can de-select the "(match)" menu item to de-select the entire attribute set class.
At any time while a lookup service is selected, you can select Show Matches from the File menu, and a complete list of all matching services is shown in the text area. You can also select Reset from the File menu to reset the template to the initial (empty) state.
By default, the Services menu only shows interface types. You can select Service classes from the Options menu to see classes instead. By default, only the most-derived types are shown, but you can select Service supertypes from the Options menu to see supertypes as well. Similarly, by default only the most-derived attribute set classes are shown in the Attributes menu, but you can select Attribute supertypes from the Options menu to see superclasses as well.
If you start the browser with the -admin command-line
option, then the text area is split into two panes. Groups, templates,
and the number of matches are shown in the upper pane, and matching
services are shown in the lower pane. Administrable services are shown
with a blue icon, non-administrable services are shown with a gray
icon. To see details about a particular service, double-click it.
This will bring up an editor window, showing the attribute set
classes. Double-click on one to expand the view to include its
attribute values, double-click it again to collapse the view. Those
attribute sets and attributes with blue icons can be edited, those with
gray icons cannot. Double-click on an attribute to change its value.
Select Add attribute... from the Edit menu to add an attribute set. Click on an attribute set and then select Remove attribute from the Edit menu to delete an attribute set. Select Show Info from the File menu to see details about service ID and service types.
If the service supports the JoinAdmin interface, then
you can use Joining groups... and Joining locators...
from the Admin menu to control which lookup groups and lookup
locators the service uses for lookup discovery and join.
If the service is itself a lookup service that supports the
DiscoveryAdmin interface, then you can use Member
groups... from the Admin menu to control which groups the
lookup service is a member of, and you can use Unicast port...
from the Admin menu to control which unicast port the lookup
service uses for its lookup locator.
If the service supports the DestroyAdmin interface,
then you can use Destroy from the Admin menu to
permanently destroy the service.