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 BEA AquaLogic Service 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 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 the 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 WSDL2UDDI demos are loaded from the file:

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

The main method is very short. After gathering the user's input, it gets the security stub and authorizes the user. The resulting authInfo string is a secret key passed to the Publish request, which is created and initialized in the createPublish() method.

The user's choice of WSDL is published to the selected businessEntity within the publishWSDL() method.

When successful, the WsdlDetail object is returned from the UDDI registry and printed.

The last step is to discard the authInfo string, so that no malicious user can use it to compromise another user's account.

String businessKey = UserInput.readString("Enter businessKey",
	      "d7222f66-08aa-3a6e-a299-2ed4ac785682");
String url = UserInput.readString("Enter WSDL URL",
              "http://localhost:8080/uddi/doc/demos/EmployeeList.wsdl");
System.out.println();

UDDI_Security_PortType security = getSecurityStub();
String authInfo = getAuthInfo(user, password, security);
Publish_wsdl publish = createPublish(businessKey, url, authInfo);
WsdlDetail result = publishWSDL(publish);
printWsdlDetail(result);
discardAuthInfo(authInfo, security);

The helper method getSecurityStub() returns the UDDI Security stub of the Web service listening at the URL specified by the URL_SECURITY property.

public static UDDI_Security_PortType getSecurityStub()
  throws SOAPException {
    // you can specify your own URL in property - uddi.demos.url.security
    String url = DemoProperties.getProperty(URL_SECURITY,
                            "http://localhost:8080/uddi/security");
    System.out.print("Using Security at url " + url + " ..");
    UDDI_Security_PortType security = UDDISecurityStub.getInstance(url);
    System.out.println(" done");
    return security;
}

Similarly, the helper method getWsdl2uddiStub() returns the WSDL2UDDI stub of the Web service listening at URL specified by the URL_WSDL2UDDI property.

public static Wsdl2uddiApi getWsdl2uddiStub() throws SOAPException {
    // you can specify your own URL in property - uddi.demos.url.wsdl2uddi
    String url = DemoProperties.getProperty(URL_WSDL2UDDI,
                                           "http://localhost:8080/uddi/wsdl2uddi");
    System.out.print("Using WSDL2UDDI at url " + url + " ..");
    Wsdl2uddiApi inquiry = Wsdl2uddiStub.getInstance(url);
    System.out.println(" done");
    return inquiry;
}

The getAuthInfo() method is used to authorize the user against the UDDI registry and to get the secret authInfo key.

public static String getAuthInfo(String userName,
	                       String password, UDDI_Security_PortType security)
    throws InvalidParameterException, UDDIException {
    System.out.print("Logging in ..");
    AuthToken authToken = security.get_authToken(new Get_authToken(userName, password));
    System.out.println(" done");
    return authToken.getAuthInfo();
}

The discardAuthInfo() method invalidates the secret authInfo key, so that it cannot be reused.

public static DispositionReport discardAuthInfo(String authInfo,
	                                                       UDDI_Security_PortType security)
  throws InvalidParameterException, UDDIException {
    System.out.print("Logging out ..");
    DispositionReport dispositionReport = security.discard_authToken(new Discard_authToken(authInfo));
    System.out.println(" done");
    return dispositionReport;
}

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

public static Publish_wsdl createPublish(String businessKey,
	                                                   String url, String authInfo)
  throws InvalidParameterException {
    System.out.println("businessKey = " + businessKey);
    System.out.println("url = " + url);

    WsdlMapping wsdlMapping = new WsdlMapping();
    wsdlMapping.setBusinessKey(businessKey);
    Wsdl wsdl = new Wsdl(url);
    WsdlDetail wsdlDetail = new WsdlDetail(wsdl, wsdlMapping);
    Publish_wsdl publish = new Publish_wsdl(wsdlDetail, authInfo);
    return publish;
}

The WSDL2UDDI API call Publish_wsdl is performed in the method publishWSDL().

public static WsdlDetail publishWSDL(Publish_wsdl save)
  throws UDDIException, SOAPException {
    Wsdl2uddiApi publishing = getWsdl2uddiStub();
    System.out.print("Save in progress ...");
    WsdlDetail wsdlDetail = publishing.publish_wsdl(save);
    System.out.println(" done");
    return wsdlDetail;
}

The returned WsdlDetail is displayed by the printWsdlDetail() method.

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

public static void printWsdlDetail(WsdlDetail wsdlDetail) {
    System.out.println();
    System.out.println(wsdlDetail.toXML());
}

This section shows, how to build and run the BEA AquaLogic Service Registry Basic Publishing demo set. Let's continue with our SaveBusiness demo.