Home TOC |
![]() ![]() ![]() |
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:
http://www-3.ibm.com/services/uddi/v2beta/inquiryapi
(the IBM query registry)https://www-3.ibm.com/services/uddi/v2beta/protect/publishapi
(the IBM publishing registry)http://uddi.rte.microsoft.com/inquire
(the Microsoft query registry)https://uddi.rte.microsoft.com/publish
(the Microsoft publishing registry)http://localhost:8080/registry-server/RegistryServerServlet
(the Registry Server, if installed on your own system)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.shhttpHost
httpPort
jaxr-browserhttpHost
httpPort
For example, if your proxy host is named
websys
and it is in thesouth
subdomain, you would enterjaxr-browser websys.south 8080To 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.shhttpHost
httpPort httpsHost httpsPort
jaxr-browserhttpHost
httpPort httpsHost httpsPort
To start the browser with no command line arguments, you use one of the following commands:
jaxr-browser.sh jaxr-browserAfter 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 theinquire
URL. To perform queries on the IBM registry, you may be connected to either theinquiryapi
URL or thepublishapi
URL.
Querying by Name
To search for organizations by name, perform the following steps.
- Click the Browse tab if it is not already selected.
- In the Find By panel on the left side of the Registry Browser window, do the following:
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.
- Select Classification in the Find By combo box.
- In the Classifications pane that appears below the combo box, double-click a classification scheme.
- Continue to double-click until you reach the node you want to search on.
- 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:
- Click the Submissions tab.
- If you used the Browse pane to locate an organization whose data you wish to edit as the basis for a new organization, right-click on the organization and choose either Edit RegistryObject or Delete RegistryObject from the pop-up menu. In order to add or delete data, you need to be connected to a registry that allows you to publish data. If you were previously using a URL that only allows queries, change the URL to the publish URL.
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:
- Name: Enter the name of the organization.
- Id: You cannot enter or modify data in this field; the ID value is returned by the registry after you submit the data.
- Description: Enter a description of the organization.
Use the Primary Contact Information fields as follows:
- Name: Enter the name of the primary contact person for the organization.
- Phone: Enter the primary contact's phone number.
- Email: Enter the primary contact's email address.
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:
- Name field: Enter a name for the service.
- Id field: You cannot enter or modify data in this field; the ID value is returned by the registry after you submit the data.
- Description field: Enter a description of the service.
- Click the Edit Bindings button to add or edit service bindings for the service. An Edit ServiceBindings dialog box appears.
- Click the Remove Service button to remove this service from the organization. The service subpanel disappears from the Services panel.
- To add or remove classifications, use the Classifications panel.
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:
- Description: Enter a description of the service binding.
- Access URI: Enter the URI used to access the service.
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.
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 |
![]() ![]() ![]() |