Jan. 8, 2011, 10:57 p.m.
posted by reo
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. You can examine the source code, as described in Implementing a JAXR Client (page 326).
Before you run the Registry Browser, start Tomcat. See Starting Tomcat (page 62) for details.
To start the browser, go to the bin directory of your Java WSDP installation or place this directory in your path.
To start the browser on a UNIX system, enter the following command:
On a Microsoft Windows system, enter the following command:
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. 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.
1 Querying a Registry
You use the Browse pane to query a registry.
Querying by Name
To search for organizations by name, perform the following steps.
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.
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.
2 Managing Registry Data
You use the Submissions pane to add, modify, or delete registry data.
To get to the Submissions pane, do either of the following:
If you click Delete RegistryObject, an authorization dialog box appears. To delete the organization, enter your username 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 (page 341).
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:
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 authorization dialog box appears. To continue with the submission, enter your username and password and click OK. To close the window without submitting the data, click Cancel.