Inquiry v1 UDDI v1
The Oracle Service Registry basic inquiry demo set contains following demos to assist you in learning the Oracle Service Registry client API.
FindBinding
Demonstrates how to construct and fill the Find_binding object, get an Inquiry stub for the UDDI registry, perform a find_binding call, and display the results.
FindBusiness
Demonstrates how to construct and fill a Find_business object, get an Inquiry stub for the UDDI registry, perform a find_business call and display the results.
FindService
Demonstrates how to construct and fill a Find_service object, get an Inquiry stub for the UDDI registry, perform a find_service call and display the results.
FindTModel
Demonstrates how to construct and fill a Find_tModel object, get an Inquiry stub for the UDDI registry, perform a find_tModel call and display the results.
GetBindingDetail
Demonstrates how to create a Get_bindingDetail object, set the bindingKey of the bindingTemplate to be fetched, get an Inquiry stub for the UDDI registry, perform a get_bindingDetail call, and display the result.
GetBusinessDetail
Demonstrates how to create a Get_businessDetail object, set the businessKey of the businessEntity to be fetched, get an Inquiry stub for the UDDI registry, perform a get_businessDetail call, and display the result.
GetServiceDetail
Demonstrates how to create a Get_serviceDetail object, set the serviceKey of the business service to be fetched, get an Inquiry stub for the UDDI registry, perform a get_serviceDetail call, and display the result.
GetTModeDetail Demonstrates how to create a Get_tModelDetail object, set the tModelKey of the tModel to be
fetched, get an Inquiry stub for the UDDI registry, perform a get_tModelDetail call, and display the result.
Prerequisites and Preparatory Steps: Code
We expect, that you have already installed the Oracle Service Registry and set the REGISTRY_HOME environment variable to its installation location.
To run the Oracle Service Registrys demos, your registry must be running. It is necessary to configure the demos. The configuration system has two levels: global and local. The properties defined
at the global level may be overwritten at the local level. The global properties are located in the file: REGISTRY_HOME\demos\env.properties
Windows: REGISTRY_HOMEdemosenv.properties
UNIX: The values set during the installation of the Oracle Service Registry work out of box, and their modification affects all
demos. If you need to redefine a propertys value for a single demo that is, at the local level, edit the file env.properties in the directory where run.bat run.sh is located. Local properties for BasicInquiry demos are loaded in the file:
REGISTRY_HOME\demos\basic\inquiry\v1\env.properties Windows:
REGISTRY_HOMEdemosbasicinquiryv1env.properties UNIX:
Page 640
Prerequisites and Preparatory Steps: Code
Table 1. Properties Used in Demos
Description Default Value
Name
limit on data returned from registry
5 uddi.demos.result.max_rows
the inquiry Web service port URL
http:localhost:8888registryuddiinquiry uddi.demos.url.inquiry
Presentation and Functional Presentation
This section describes programing pattern used in all demos using the FindTModel demo as an example. You can find its source code in the file:
REGISTRY_HOME\demos\basic\inquiry\v1\src\demo\uddi\v1\inquiry\FindTModel.java Windows:
REGISTRY_HOMEdemosbasicinquiryv1srcdemouddiv1inquiryFindTModel.java UNIX:
The main method is straightforward. It gathers users input tModel name, calls a method to initialize the Find_tModel object, executes the find_tModel UDDI call, and displays the list of found tModels:
String name = UserInput.readStringEnter name, demo; Find_tModel find_tModel = createFindByTModelname, findQualifier;
TModelList result = findTModelfind_tModel; printTModelListresult;
The createFindTModel method is used to create a new instance of the Find_tModel class and initialize it with values from parameters:
public static Find_tModel createFindByTModelString name throws InvalidParameterException {
System.out.printlnname = + name; Find_tModel find = new Find_tModel;
find.setNamename; find.setMaxRowsnew IntegerMAX_ROWS;
find.setGenericConstants.GENERIC_1_0; return find_tModel;
}
The helper method getInquiryStub returns the UDDI Inquiry stub of the web service listening at the URL specified in the URL_INQUIRY property.
public static InquireSoap getInquiryStub throws SOAPException {
you can specify your own URL in property - uddi.demos.url.inquiry String url = DemoProperties.getPropertyURL_INQUIRY,
http:localhost:8888registryuddiinquiry; System.out.printUsing Inquiry at url + url + ..;
InquireSoap inquiry = UDDIInquiryStub.getInstanceurl; System.out.println done;
return inquiry; }
The UDDI API call find_tModel is performed in the method findTModel:
Page 641
Presentation and Functional Presentation
public static TModelList findTModelFind_tModel find_tModel throws UDDIException, SOAPException {
InquireSoap inquiry = getInquiryStub; System.out.printSearch in progress ..;
TModelList tModelList = inquiry.find_tModelfind_tModel; System.out.println done;
return tModelList; }
The list of found tModels is printed with the method printTModelList. One interesting aspect of the Oracle Service Registry client API is that each UDDIObject contains the method toXML, which returns a human-readable, formatted
listing of its XML representation.
public static void printTModelListTModelList tModelList { System.out.println;
TModelInfoArrayList tModelInfoArrayList = tModelList.getTModelInfoArrayList; if tModelInfoArrayList==null {
System.out.printlnNothing found; return;
}
int position = 1; for Iterator iterator = tModelInfoArrayList.iterator; iterator.hasNext; {
TModelInfo tModelTemplate = TModelInfo iterator.next; System.out.printlnTModel +position+ : +tModelTemplate.getTModelKey;
System.out.printlntModelTemplate.toXML; System.out.println;
System.out.println; position++;
} }
Building and Running Demos
This section shows how to build and run the Oracle Service Registry Basic Inquiry demo set. Our example continues with the FindTModel demo.
1. Be sure that the demos are properly configured and the Oracle Service Registry is up and running.
2. Change your working directory to:
REGISTRY_HOME\demos\basic\inquiry\v1 Windows:
REGISTRY_HOMEdemosbasicinquiryv1 UNIX:
3. Build all demos using:
run.bat make Windows:
.run.sh make UNIX:
Note
When compiling demos on Windows platforms, you may see the following text:
Page 642
Building and Running Demos
A subdirectory or file ..\..\common\.\build\classes already exists. This is expected and does not indicate a problem.
4. To get list of all available demos, run
run.bat help Windows:
.run.sh help UNIX:
5. Run a selected demo by executing the run command with the name of the demo as a parameter. For example, to run
the FindTModel demo, invoke run.bat FindBinding
Windows: .run.sh FindBinding
UNIX: The output of this demo will resemble the following:
Running FindTModel demo... Searching for tModel where
Enter name [demo]: name = demo
Using Inquiry at url http:mycomp.com:8888registryuddiinquiry .. done Search in progress .. done
TModel 1 : uuid:13aee5be-8531-343c-98f8-d2d3a9308329 tModelInfo tModelKey=uuid:13aee5be-8531-343c-98f8-d2d3a9308329 xmlns=urn:uddi-
org:api_v1 namedemo:departmentIDname
tModelInfo
TModel 2 : uuid:8af5f49e-e793-3719-92f3-6ab8998eb5a9 tModelInfo tModelKey=uuid:8af5f49e-e793-3719-92f3-6ab8998eb5a9 xmlns=urn:uddi-
org:api_v1 namedemo:hierarchyname
tModelInfo
TModel 3 : uuid:5c1d5d80-a4d4-11d8-91cd-5c1d367091cd tModelInfo tModelKey=uuid:5c1d5d80-a4d4-11d8-91cd-5c1d367091cd xmlns=urn:uddi-
org:api_v1 nameDemo identifiername
tModelInfo
6. To rebuild demos, execute
run.bat clean .run.sh clean
to delete the classes directory and run.bat make
.run.sh make to rebuild the demo classes.
Page 643
Building and Running Demos