The JavaTM Web Services Tutorial
Home
TOC
PREV TOP NEXT

Using the Registry Browser

The Registry Browser is both a working example of a JAXR client and a GUI tool that enables you to search registries and submit data to them. You can examine the source code, as described in Implementing a JAXR Client.

The Registry Browser allows access to any registry, but includes the following registries as preset URLs:

Starting the Browser

To start the browser, go to the bin directory of your Java WSDP installation or place this directory in your path.

If you want to use the browser with an external registry, you must specify proxy information on the browser command line.

If you are using the Registry Server, you specify no command line arguments. For the Registry Server, you must also make sure to start Tomcat and the Xindice database before you start the browser; see Setting Up the Registry Server for details.

To use the same proxy server for both HTTP and HTTPS access, specify the proxy host and proxy port as follows. The port is usually 8080. The following commands show how to start the browser on a UNIX system and a Microsoft Windows system, respectively:

jaxr-browser.sh httpHost httpPort
 
jaxr-browser httpHost httpPort
 

For example, if your proxy host is named websys and it is in the south subdomain, you would enter

jaxr-browser websys.south 8080
 

To use different proxy servers for HTTP and HTTPS access, specify the hosts and ports as follows. (If you do not know whether you need two different servers, specify just one. It is relatively uncommon to need two.)

jaxr-browser.sh httpHost httpPort httpsHost httpsPort
 
jaxr-browser httpHost httpPort httpsHost httpsPort
 

To start the browser with no command line arguments, you use one of the following commands:

jaxr-browser.sh
 
jaxr-browser
 

After the browser starts, enter the URL of the registry you want to use in the Registry Location combo box, or select a URL from the drop-down menu in the combo box. The menu allows you to choose among the IBM and Microsoft registries and the Registry Server.

There may be a delay of a few seconds while a busy cursor is visible.

When the busy cursor disappears, you have a connection to the URL. However, you do not establish a connection to the registry itself until you perform a query or update, so the browser will not report an invalid URL until then.

The browser contains two main panes, Browse and Submissions.

Querying a Registry

You use the Browse pane to query a registry.


Note: In order to perform queries on the Microsoft registry, you must be connected to the inquire URL. To perform queries on the IBM registry, you may be connected to either the inquiryapi URL or the publishapi URL.

Querying by Name

To search for organizations by name, perform the following steps.

  1. Click the Browse tab if it is not already selected.
  2. In the Find By panel on the left side of the Registry Browser window, do the following:
    1. Select Name in the Find By combo box if it is not already selected.
    2. Enter a string in the text field.
    3. Press Enter or click the Search button in the toolbar.

After a few seconds, the organizations whose names begin with the text string appear in the right side of the Registry Browser window. An informational dialog box appears if no matching organizations are found.

Double-click on an organization to show its details. An Organization dialog box appears. In this dialog box, you can click Show Services to display the Services dialog box for the organization. In the Services dialog box, you can click Show ServiceBindings to display the ServiceBindings dialog box for that service.

Querying by Classification

To query a registry by classification, perform the following steps.

  1. Select Classification in the Find By combo box.
  2. In the Classifications pane that appears below the combo box, double-click a classification scheme.
  3. Continue to double-click until you reach the node you want to search on.
  4. Click the Search button in the toolbar.

After a few seconds, one or more organizations in the chosen classification may appear in the right side of the Registry Browser window. An informational dialog box appears if no matching organizations are found.

Managing Registry Data

You use the Submissions pane to add or delete registry data.


Note: The Registry Browser does not allow you to modify existing data. You can edit an existing organization's data, but when you submit the data, a new organization is created.

To get to the Submissions pane, do either of the following:

If you click Delete RegistryObject, an authentication dialog box appears. To delete the organization, enter your user name and password and click OK. To close the window without deleting the organization, click Cancel.

Adding an Organization

To enter or modify information about an organization, use the Organization panel on the left side of the Submissions pane.

Use the Organization Information fields as follows:

Use the Primary Contact Information fields as follows:

For information on adding or removing classifications, see Adding and Removing Classifications.

Adding Services to an Organization

To add or modify information about an organization's services, Use the Services panel on the right side of the Submissions pane.

To add a service, click the Add Services button in the toolbar. A subpanel for the service appears in the Services panel. Click the Add Services button more than once to add more services in the Services panel.

Each service subpanel has the following components:

Use these components as follows:

Adding Service Bindings to a Service

To add service bindings for a service, click the Edit Bindings button in a service subpanel in the Submissions pane. The Edit ServiceBindings dialog box appears.

If there are no existing service bindings when the dialog box first appears, it contains an empty Service Bindings panel and two buttons, Add Binding and Done. If the service already has service bindings, the Service Bindings panel contains a subpanel for each service binding.

Click Add Binding to add a service binding. Click Add Binding more than once to add multiple service bindings.

After you click Add Binding, a new service binding subpanel appears. It contains three text fields and a Remove Binding button.

Use the text fields as follows:

Use the Remove Binding button to remove the service binding from the service.

Click Done to close the dialog box when you have finished adding or removing service bindings.

Adding and Removing Classifications

To add classifications to, or remove classifications from, an organization or service, use a Classifications panel. A Classifications panel appears in an Organization panel or service subpanel.

To add a classification:

  1. Click Add.
  2. In the Select Classifications dialog, double-click one of the classification schemes.
    • If you clicked ntis-gov:naics, you can add the classification at any level of the taxonomy hierarchy. When you reach the level you want, click Add.
    • If you clicked Geography, locate the appropriate leaf node (the country) and click Add.

The classification appears in a table in the Classifications panel below the buttons.

Follow these steps more than once to add multiple classifications to the organization or service.

Click Close to dismiss the window when you have finished.

To remove a classification, select the appropriate table row in the Classifications panel and click Remove. The classification disappears from the table.

Submitting the Data

When you have finished entering the data you want to add or modify, click the Submit button in the toolbar.

An authentication dialog box appears. To continue with the submission, enter your user name and password and click OK. To close the window without submitting the data, click Cancel.

Stopping the Browser

To stop the Registry Browser, choose Exit from the File menu.

Home
TOC
PREV TOP NEXT