We expect, that you have already installed the BEA AquaLogic Service Registry registry and set the REGISTRY_HOME environment variable to its installation location.

To run BEA AquaLogic Service Registry's demos, your UDDI registry must be running. To start the registry, execute the serverstart script:

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:

The values set during the installation of the BEA AquaLogic Service Registry work out of box, and their modification affects all demos. If you need to redefine the value of some property 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 level properties for Basic/Inquiry demos are loaded in the file:

This section describes the programing pattern used in all demos using the FindTModel demo as an example. You can find its source code in the file:

The main method is straightforward. It gathers user's 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.readString("Enter name", "demo%");
Find_tModel find_tModel = createFindByTModel(name, findQualifier);
TModelList result = findTModel(find_tModel);
printTModelList(result);

The createFindTModel() method is used to create new instance of the Find_tModel class and initialize it with values from parameters:

public static Find_tModel createFindByTModel(String name)
  throws InvalidParameterException {
    System.out.println("name = " + name);
    Find_tModel find = new Find_tModel();
    find.setName(new Name(name));
    find.setMaxRows(new Integer(MAX_ROWS));
    find.setGeneric(Constants.GENERIC_2_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 UDDI_Inquiry_PortType getInquiryStub()
  throws SOAPException {
    // you can specify your own URL in property - uddi.demos.url.inquiry
    String url = DemoProperties.getProperty(URL_INQUIRY, "http://localhost:8080/uddi/inquiry");
    System.out.print("Using Inquiry at url " + url + " ..");
    UDDI_Inquiry_PortType inquiry = UDDIInquiryStub.getInstance(url);
    System.out.println(" done");
    return inquiry;
}

The UDDI API call find_tModel is performed in the method findTModel:

public static TModelList findTModel(Find_tModel find_tModel)
  throws UDDIException, SOAPException {
    UDDI_Inquiry_PortType inquiry = getInquiryStub();
    System.out.print("Search in progress ..");
    TModelList tModelList = inquiry.find_tModel(find_tModel);
    System.out.println(" done");
    return tModelList;
}

The list of found tModels is printed with the method printTModelList. One interesting aspect of the BEA AquaLogic Service Registry client API is that each UDDIObject contains method toXML(), which returns a human-readable, formatted listing of its XML representation.

public static void printTModelList(TModelList tModelList) {
    System.out.println();

    TModelInfoArrayList tModelInfoArrayList = tModelList.getTModelInfoArrayList();
        if (tModelInfoArrayList==null) {
        System.out.println("Nothing found");
        return;
    }

    int position = 1;
    for (Iterator iterator = tModelInfoArrayList.iterator(); iterator.hasNext();) {
        TModelInfo tModelTemplate = (TModelInfo) iterator.next();
        System.out.println("TModel "+position+" : "+tModelTemplate.getTModelKey());
        System.out.println(tModelTemplate.toXML());
        System.out.println();
        System.out.println("********************************************************");
        position++;
    }
}

This section shows how to build and run the BEA AquaLogic Service Registry Basic Inquiry demo set. Our example continues with the FindTModel demo.