Registry Client  Locate

This section describes how to prepare your own client distribution. A client created this way allows you to access the Oracle Service Registry API through a SOAP interface.

Client Package  Locate

[Note]Note

CLIENT_HOME refers to the directory in which the Oracle Service Registry Client distribution will be created.

REGISTRY_HOME refers to the directory in which Oracle Service Registry is installed

To create a client application distribution follow these steps:

  1. Make sure Oracle Service Registry is successfully installed.

  2. In the CLIENT_HOME directory, create a subdirectory named lib.

    Copy the following files from REGISTRY_HOME/lib to CLIENT_HOME/lib

    activation.jar
    builtin-serialization.jar
    core_services_client.jar
    jaas.jar
    jaxm.jar
    jaxrpc.jar
    jetty.jar                    
    runner.jar
    saaj.jar
    security-ng.jar
    security2-ng.jar
    security_providers_client.jar
    wasp.jar
    wsdl_api.jar
    xercesImpl.jar
    xml-apis.jar
    xmlParserApis.jar
                    
  3. In the CLIENT_HOME directory, create a subdirectory named dist.

    Copy the following files from REGISTRY/dist to CLIENT_HOME/dist:

    account_client.jar
    admin_utils_client.jar
    approval_client_v3.jar
    approval_content_checker_client_v3.jar
    approval_management_client.jar
    approval_production_client_v3.jar
    category_client_v3.jar
    configurator_client.jar
    configurator_cluster_client.jar
    group_client.jar
    permission_client.jar
    replication_client_v3.jar
    statistics_client.jar
    taxonomy_client_v3.jar
    taxonomy_client_v31.jar    
    transformer_kr_client.jar
    uddiclient_api_ext.jar
    uddiclient_api_v1.jar
    uddiclient_api_v2.jar
    uddiclient_api_v3.jar
    uddiclient_api_v3_ext.jar
    uddiclient_core.jar
    uddiclient_custody_v3.jar
    uddiclient_subscription_listener_v3.jar
    uddiclient_subscription_v3.jar
    uddiclient_validate_values_v1.jar
    uddiclient_validate_values_v2.jar
    uddiclient_value_set_caching_v3.jar
    uddiclient_value_set_validation_v3.jar
    wsdl2uddi_client_v2.jar
    wsdl2uddi_client_v3.jar
    xml2uddi_client_v3.jar                    
    xsd2uddi_client_v3.jar                    
    xslt2uddi_client_v3.jar                       
                    
  4. In the CLIENT_HOME directory, create a subdirectory named conf. Copy the following files from REGISTRY_HOME/conf to CLIENT_HOME/conf:

    clientconf.xml
    log4j.config
                    
[Note]Note

If you want to use the https connection in Oracle Service Registry, you must import the certificate file into clientconf.xml using the PStoreTool. This file contains the certificate of the Oracle Service Registry installation by default.

[Tip]Tip

You do not have to copy client files to directories that have specific names (lib, dist, and conf). All client files can be copied to the flat directory CLIENT_HOME, for example. If you do this, however, replace CONF_DIRECTORY, DIST_DIRECTORY, and LIB_DIRECTORY with CLIENT_HOME in this section's instructions.

JARs on the Client Classpath  Locate

For each client package, the associated .jar files must be added to the classpath. These .jar files are listed in the appropriate sections below.

Oracle Service Registry Runtime  Locate

To enable the Oracle Service Registry Runtime client package, add these .jar files to the classpath.

activation.jar
builtin-serialization.jar;
core_services_client.jar;
jaas.jar;
jaxm.jar;
jaxrpc.jar
runner.jar
saaj.jar;
security-ng.jar;
security2-ng.jar;
security_providers_client.jar;
wasp.jar;
wsdl_api.jar
xercesImpl.jar;
xml-apis.jar;
xmlParserApis.jar;
        
UDDI API Client v1  Locate

To enable the UDDI API (v1) client package, add these .jar files to the classpath. For more information on this client package, please see UDDI Version 1

uddiclient_api_v1.jar
uddiclient_core.jar
        

UDDI API Client v2  Locate

To enable the UDDI API (v2) client package, add these .jar files to the classpath. For more information on this client package, please see UDDI Version 2.

uddiclient_api_v2.jar
uddiclient_core.jar

UDDI API Client v3  Locate

To enable the UDDI API (v3) client package, add these .jar files to the classpath. For more information on this client packages, please see UDDI Version 3.

uddiclient_api_v3.jar
uddiclient_core.jar
        

UDDI API Client v3 ext X  Locate

To enable the UDDI API (v3, ext X) client package, add these .jar files to the classpath.

uddiclient_api_v3_ext.jar
uddiclient_api_v3.jar
uddiclient_core.jar
    

Account Client  Locate

To enable the Account client package, add these .jar files to the classpath. For more information on this client package, please see Account.

account_client.jar
uddiclient_core.jar

Admin Utilities Client  Locate

To enable the Admin Utilities client package, add these .jar files to the classpath. For more information on this client package, please see Administration Utilities.

admin_utils_client.jar
uddiclient_api_v3.jar
uddiclient_core.jar
    

Approval Client v3  Locate

To enable the Approval (v3) client package, add these .jar files to the classpath. For more information on this client package, please seeApproval.

approval_client_v3.jar
uddiclient_api_v3.jar
uddiclient_api_v2.jar
uddiclient_core.jar
        

Approval Content Checker Client v3  Locate

To enable the v3 Approval Content Checker client package, add these .jar files to the classpath.

approval_content_checker_client_v3.jar
uddiclient_core.jar
        

Approval Management Client   Locate

To enable the Approval Management client package, add these .jar files to the classpath.

approval_management_client.jar
uddiclient_core.jar
        

Category Client v3  Locate

To enable the Category (v3) client package, add these .jar files to the classpath. For more information on this client package, please see Category

category_client_v3.jar
uddiclient_api_v3.jar
uddiclient_core.jar
       

Group Client  Locate

To enable the Group client package, add these .jar files to the classpath. For more information on this client package, please see Group.

group_client.jar
account_client.jar
uddiclient_core.jar
                

Permission Client  Locate

To enable the Permission client package, add these .jar files to the classpath. For more information on this client package, please see Permission.

permission_client.jar
account_client.jar
uddiclient_core.jar
        

Replication Client v3  Locate

To enable the Replication (v3) client package, add these .jar files to the classpath. For more information on this client package, please see Replication.

replication_client_v3.jar
uddiclient_core.jar
        

Statistics Client  Locate

To enable the Statistics client package, add these .jar files to the classpath. For more information on this client package, please see Statistics.

statistics_client.jar
uddiclient_core.jar
        

Taxonomy Client v3  Locate

To enable the v3 Taxonomy client package, add these .jar files to the classpath. For more information on this client package, please see Taxonomy.

taxonomy_client_v3.jar
taxonomy_client_v31.jar
uddiclient_api_v3.jar
uddiclient_core.jar
        

UDDI Custody Client v3  Locate

To enable the v3 UDDI Custody client package, add these .jar files to the classpath. For more information on this client package, please see Custody.

uddiclient_custody_v3.jar
uddiclient_api_v3.jar
uddiclient_core.jar
        

UDDI Subscription Client v3  Locate

To enable the v3 UDDI Subscription client package, add these .jar files to the classpath. For more information on this client package, please see Subscription.

uddiclient_subscription_v3.jar
uddiclient_api_v3.jar
uddiclient_core.jar
        

UDDI Subscription Listener Client v3  Locate

To enable the v3 UDDI Subscription Listener client package, add these .jar files to the classpath. For more information on this client package, please see Subscription.

uddiclient_subscription_listener_v3.jar
uddiclient_subscription_v3.jar
uddiclient_api_v3.jar
uddiclient_core.jar
                

UDDI Validate Values Client v1  Locate

To enable the UDDI Validate Values (v1) client package, add these .jar files to the classpath. For more information on this client package, please see Validation.

uddiclient_validate_values_v1.jar
uddiclient_api_v1.jar
uddiclient_core.jar
                

UDDI Validate Values v2  Locate

To enable the UDDI Validate Values (v2) client package, add these .jar files to the classpath. For more information on this client package, please see Validation.

uddiclient_validate_values_v2.jar
uddiclient_api_v2.jar
uddiclient_core.jar
        

UDDI Value Set Caching Client v3  Locate

To enable the UDDI Value Set Caching (v3) client package, add these .jar files to the classpath.

uddiclient_value_set_caching_v3.jar
uddiclient_api_v3.jar
uddiclient_core.jar
        

UDDI Value Set Validation Client v3  Locate

To enable the UDDI Value Set Validation (v3) client package, add these .jar files to the classpath. For more information on this client package, please see Validation.

uddiclient_value_set_validation_v3.jar
uddiclient_api_v3.jar
uddiclient_core.jar
        

WSDL2UDDI Client v2   Locate

To enable the WSDL2UDDI (v2) client package, add these .jar files to the classpath. For more information on this client package, please see WSDL Publishing

wsdl2uddi_client_v2.jar
uddiclient_api_v2.jar
uddiclient_core.jar
        

WSDL2UDDI Client v3  Locate

To enable the WSDL2UDDI (v3) client package, add these .jar files to the classpath. For more information on this client package, please see WSDL Publishing

wsdl2uddi_client_v3.jar
uddiclient_api_v3.jar
uddiclient_core.jar
        

Resources publishing (XML, XSD, XSLT) Client   Locate

To enable the client package, add these .jar files to the classpath.

uddiclient_api_v3.jar
uddiclient_core.jar
xml2uddi_client_v3.jar                    
xsd2uddi_client_v3.jar                    
xslt2uddi_client_v3.jar                                        
        

Classpath Examples  Locate

To run your Oracle Service Registry client code you must add a config directory, wasp.jar, and client's jars to the classpath.

[Note]Note

CLIENT_HOME=. CONF_DIRECTORY=CLIENT_HOME\conf DIST_DIRECTORY=CLIENT_HOME\dist LIB_DIRECTORY=CLIENT_HOME\lib

  • If you want to use only UDDI Version 3:

    CONF_DIRECTORY;LIB_DIRECTORY\wasp.jar;DIST_DIRECTORY\uddiclient_api_v3.jar
            

  • If you want to use only UDDI Version 3 and UDDI Subscription Version 3:

    CONF_DIRECTORY;LIB_DIRECTORY\wasp.jar;DIST_DIRECTORY\uddiclient_api_v3.jar%;
    DIST_DIRECTORY\uddiclient_subscription_v3.jar
            

  • If you want to use only UDDI Version 3, UDDI Subscription Version 3, and Taxonomy:

    CONF_DIRECTORY;LIB_DIRECTORY\wasp.jar;DIST_DIRECTORY\uddiclient_api_v3.jar%;
    DIST_DIRECTORY\uddiclient_subscription_v3.jar;DIST_DIRECTORY\taxonomy_client_v3.jar