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

To run the BEA AquaLogic Service Registry's demos, your registry must be running. To start the BEA AquaLogic Service 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 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 env.properties. This file is located in the same directory as the file run.sh ( run.bat). Local level properties for the Taxonomy demo is loaded from the file:

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

The main method of this demo is straightforward. It gathers user's input, logs the user in the BEA AquaLogic Service Registry, creates an object of Save_taxonomy, sends it to UDDI registry over SOAP and displays the result.

String user = UserInput.readString("Enter user name", "admin");
String password = UserInput.readString("Enter password", "changeit");
String name = UserInput.readString("Enter name", "Demo identifier");
String description = UserInput.readString("Enter description", "Saved by SaveTaxonomy demo");
System.out.println();

UDDI_Security_PortType security = getSecurityStub();
String authInfo = getAuthInfo(user, password, security);
Save_taxonomy save = createSaveTaxonomy(name, description, authInfo);
TaxonomyDetail result = saveTaxonomy(save);
printTaxonomyDetail(result);
discardAuthInfo(authInfo, security);

When saving taxonomy, you must first create a tModel, that will represent it. You can set your publisher assigned tModelKey and other properties. The only mandatory property is name. You don't need to specify taxonomy related keyedReferences in categoryBag, they shall be set in Taxonomy.

The Categorization is used to define usage of the taxonomy. Valid values are identifier, categorization, categorizationGroup and relationship. The compatibility marks tModel with information, in which UDDI structures it can be used.

This example creates an unchecked identifier, that can be used only in categoryBags of business entities and tModels.

public static Save_taxonomy createSaveTaxonomy(String name, String description, String authInfo)
  throws InvalidParameterException {
    System.out.println("name = " + name);
    System.out.println("description = " + description);

    TModel tModel = new TModel();
    tModel.setName(new Name(name));
    tModel.addDescription(new Description(description));

    Taxonomy taxonomy = new Taxonomy(tModel);
    taxonomy.setCheck(Boolean.FALSE);
    taxonomy.addCategorization(Categorization.identifier);
    taxonomy.addCompatibility(Compatibility.businessEntity);
    taxonomy.addCompatibility(Compatibility.tModel);

    Save_taxonomy save = new Save_taxonomy();
    save.addTaxonomy(taxonomy);
    save.setAuthInfo(authInfo);

    return save;
}

The helper method getTaxonomyStub() returns the Taxonomy stub of the Web service listening at the URL specified by the URL_TAXONOMY property.

public static TaxonomyApi getTaxonomyStub() throws SOAPException {
    String url = DemoProperties.getProperty(URL_TAXONOMY, "http://localhost:8080/uddi/taxonomy");
    System.out.print("Using Taxonomy at url " + url + " ..");
    TaxonomyApi taxonomy = TaxonomyStub.getInstance(url);
    System.out.println(" done");
    return taxonomy;
}

The Taxonomy API call save_taxonomy is performed in the method saveTaxonomy().

public static TaxonomyDetail saveTaxonomy(Save_taxonomy save)
  throws UDDIException, SOAPException {
    TaxonomyApi taxonomy = getTaxonomyStub();
    System.out.print("Save in progress ...");
    TaxonomyDetail taxonomyDetail = taxonomy.save_taxonomy(save);
    System.out.println(" done");
    return taxonomyDetail;
}
      

The returned TaxonomyDetail object is displayed in printTaxonomyDetail method.

public static void printTaxonomyDetail(TaxonomyDetail taxonomyDetail) {
    System.out.println();

    TaxonomyArrayList taxonomyArrayList = taxonomyDetail.getTaxonomyArrayList();
    int position = 1;
    for (Iterator iterator = taxonomyArrayList.iterator(); iterator.hasNext();) {
        Taxonomy taxonomy = (Taxonomy) iterator.next();
        System.out.println("Taxonomy " + position + " : " + taxonomy.getTModel().getTModelKey());
        System.out.println(taxonomy.toXML());
        System.out.println();
        System.out.println("********************************************************");
        position++;
    }
}
      

This section shows, how to build and run the BEA AquaLogic Service Registry Advanced Taxonomy demo set. Let's continue with our SaveTaxonomy demo.