This example is a command line demonstration of how to interact with JUDDI using the juddi-client.
In step 4 is demonstrates how to use the ServiceLocator.

1. Start the jUDDI-server (juddi-tomcat or juddi-bundle)

2. Check the settings of the META-INF/wsdl2uddi-uddi.xml, to make sure the serverName and serverPort are set correctly.

3. Create Joe Publisher and his keyGenerator and then register the services in wsdl/helloworld.wsdl to jUDDI.
it creates a businessEntity with businessKey 'uddi:uddi.joepublisher.com:business_wsdl-business' using
the org.apache.juddi.example.wsdl2uddi.Publish class, which is called using

mvn -Ppublish test

You should see the following output being written to the console:

1. Bring up the hello world endpoint at port 18080
2. Programmatically publish the endpoint to UDDI
Dec 26, 2013 5:53:26 PM org.apache.juddi.v3.client.config.UDDIClient <init>
INFO: jUDDI Client version - 3.2.0.SNAPSHOT
Dec 26, 2013 5:53:26 PM org.apache.juddi.v3.client.config.ClientConfig loadConfiguration
INFO: Reading UDDI Client properties file file:///Users/kstam/osc/apache/dev/juddi-patch/juddi-examples/wsdl2uddi/target/classes/META-INF/wsdl2uddi-uddi.xml
setting up the publisher
root AUTHTOKEN = authtoken:f8d3b465-dca2-4780-ba6a-4ff397784dde
Dec 26, 2013 5:53:27 PM org.apache.juddi.v3.client.config.UDDIClerk register
INFO: Registering tModel with key uddi:uddi.joepublisher.com:keygenerator
Dec 26, 2013 5:53:27 PM org.apache.juddi.v3.client.config.UDDIClerk getAuthToken
WARNING: Hey, I couldn't help but notice that your credentials aren't encrypted. Please consider doing so
publish the business
Dec 26, 2013 5:53:27 PM org.apache.juddi.v3.client.config.UDDIClerk register
INFO: Registering business WSDL-Business with key uddi:uddi.joepublisher.com:business_WSDL-Business
and the wsdl
Retrieving document at 'file:/Users/kstam/osc/apache/dev/juddi-patch/juddi-examples/wsdl2uddi/target/classes/wsdl/helloworld.wsdl'.
Dec 26, 2013 5:53:28 PM org.uddi.JAXBContextUtil getContext
INFO: Creating JAXB Context for org.uddi.api_v3
Dec 26, 2013 5:53:28 PM org.apache.juddi.v3.client.config.UDDIClerk checkForErrorInDispositionReport
INFO: entityKey uddi:uddi.joepublisher.com:service_helloworld was not found in the registry
Dec 26, 2013 5:53:28 PM org.apache.juddi.v3.client.config.UDDIClerk register
INFO: Registering tModel with key uddi:uddi.joepublisher.com:HelloWorld
Dec 26, 2013 5:53:28 PM org.apache.juddi.v3.client.config.UDDIClerk register
INFO: Registering tModel with key uddi:uddi.joepublisher.com:HelloWorldSoapBinding
Dec 26, 2013 5:53:28 PM org.apache.juddi.v3.client.config.UDDIClerk register
INFO: Registering service HelloWorld with key uddi:uddi.joepublisher.com:service_helloworld
Dec 26, 2013 5:53:28 PM org.apache.juddi.v3.client.config.UDDIClerk register
INFO: Registering bindingTemplate with key uddi:uddi.joepublisher.com:binding_localhost_helloworld_helloworldimplport_18080
waiting for calls into the HelloWorldImpl...

This brought up the HelloWorld webservice, on http://localhost:18080/services/helloworld
You can check that it is up by navigating to this url in your browser.

Also you can check created UDDI data structures by browsing to this business using the juddi-gui.

4. Lets check that we can find this business in the registry by running from Queries
using the org.apache.juddi.example.wsdl2uddi.Find class which is called using:

mvn -Pfind test

Should result in the following output:

Dec 26, 2013 5:54:51 PM org.apache.juddi.v3.client.config.UDDIClient <init>
INFO: jUDDI Client version - 3.2.0.SNAPSHOT
Dec 26, 2013 5:54:52 PM org.apache.juddi.v3.client.config.ClientConfig loadConfiguration
INFO: Reading UDDI Client properties file file:///Users/kstam/osc/apache/dev/juddi-patch/juddi-examples/wsdl2uddi/target/classes/META-INF/wsdl2uddi-uddi.xml
Do a find business using the businessKey uddi:uddi.joepublisher.com:business_wsdl-business
Found business with name WSDL-Business
Number of services: 1
Service Name        = 'HelloWorld'
Service Key         = 'uddi:uddi.joepublisher.com:service_helloworld'
Service Description = 'The Hello World Service registered using WSDL2UDDI'
BindingTemplates: 1
--BindingTemplate 0:
  bindingKey          = uddi:uddi.joepublisher.com:binding_localhost_helloworld_helloworldimplport_18080
  accessPoint useType = endPoint
  accessPoint value   = http://localhost:18080/services/helloworld
  description         = The Hello World Binding registered using WSDL2UDDI
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------


So we got one Service, which one binding. Note that the descriptions were provided in the wsdl file
using <wsdl:documentation> elements.

4. For extra credit we can use the ServiceLocator to obtain an accessPoint for service
'uddi:uddi.joepublisher.com:service_helloworld'. And we then use this information to call
this WebService Endpoint. In this example we use the code in the
org.apache.juddi.example.wsdl2uddi.Call class, which is called using

 mvn -Pcall test
 
 You should see the following output:
 
 Dec 26, 2013 5:59:51 PM org.apache.juddi.v3.client.config.UDDIClient <init>
INFO: jUDDI Client version - 3.2.0.SNAPSHOT
Dec 26, 2013 5:59:51 PM org.apache.juddi.v3.client.config.ClientConfig loadConfiguration
INFO: Reading UDDI Client properties file file:///Users/kstam/osc/apache/dev/juddi-patch/juddi-examples/wsdl2uddi/target/classes/META-INF/wsdl2uddi-uddi.xml
The clientside of a runtime lookup usually knows the serviceKey.
To get updated binding information you should use the ServiceLocator with a live cache.
Created Cache in 1 [milliseconds]
Now adding a listener to the cache...
Dec 26, 2013 5:59:51 PM org.apache.juddi.v3.client.mapping.ServiceLocator initCache
INFO: Creating a UDDICLientCache
Retrieving document at 'jar:file:/Users/kstam/.m2/repository/org/apache/juddi/juddi-client/3.2.0-SNAPSHOT/juddi-client-3.2.0-SNAPSHOT.jar!/org/apache/juddi/v3/client/mapping/UDDIClientSubscriptionListener.wsdl'.
Dec 26, 2013 5:59:51 PM org.apache.juddi.v3.client.config.UDDIClerk getAuthToken
WARNING: Hey, I couldn't help but notice that your credentials aren't encrypted. Please consider doing so
Dec 26, 2013 5:59:52 PM org.uddi.JAXBContextUtil getContext
INFO: Creating JAXB Context for org.uddi.api_v3
Dec 26, 2013 5:59:52 PM org.apache.juddi.v3.client.config.UDDIClerk checkForErrorInDispositionReport
INFO: entityKey uddi:uddi.joepublisher.com:service_uddiclientsubscriptionlistenerservice was not found in the registry
Dec 26, 2013 5:59:52 PM org.apache.juddi.v3.client.config.UDDIClerk register
INFO: Registering tModel with key uddi:uddi.joepublisher.com:UDDI_SubscriptionListener_PortType
Dec 26, 2013 5:59:52 PM org.apache.juddi.v3.client.config.UDDIClerk register
INFO: Registering tModel with key uddi:uddi.joepublisher.com:UDDI_SubscriptionListener_PortTypeBinding
Dec 26, 2013 5:59:52 PM org.apache.juddi.v3.client.config.UDDIClerk register
INFO: Registering service UDDIClientSubscriptionListenerService with key uddi:uddi.joepublisher.com:service_uddiclientsubscriptionlistenerservice
Dec 26, 2013 5:59:52 PM org.apache.juddi.v3.client.config.UDDIClerk register
INFO: Registering bindingTemplate with key uddi:uddi.joepublisher.com:binding_localhost_uddiclientsubscriptionlistenerservice_uddiclientsubscriptionlistenerimplport_18079
Dec 26, 2013 5:59:52 PM org.apache.juddi.v3.client.mapping.UDDIServiceCache publishAndRegisterHttpCallbackEndpoint
INFO: Bringing up a UDDIClientSubscriptionListenerImpl on Endpoint http://localhost:18079/subscriptionlistener_uddi_client
Dec 26, 2013 5:59:53 PM org.apache.juddi.v3.client.mapping.UDDIServiceCache publishAndRegisterHttpCallbackEndpoint
INFO: Registering a CallbackSubscription to this endpoint using bindingKey uddi:uddi.joepublisher.com:binding_localhost_uddiclientsubscriptionlistenerservice_uddiclientsubscriptionlistenerimplport_18079
Dec 26, 2013 5:59:53 PM org.apache.juddi.v3.client.config.UDDIClerk register
INFO: Registering subscription with key uddi:uddi.joepublisher.com:service_cache_localhost
Add Listener to Cache in 1847 [milliseconds]
1. UDDI Lookup - Elapsed time: 18[milliseconds] Endpoint=http://localhost:18080/services/helloworld
2. Cache Lookup - Elapsed time: 0[milliseconds] Endpoint=http://localhost:18080/services/helloworld
*************** Service reply: Hello Judy
Dec 26, 2013 5:59:53 PM org.apache.juddi.v3.client.config.UDDIClerk unRegisterSubscription
INFO: UnRegistering subscription with key uddi:uddi.joepublisher.com:service_cache_localhost
Dec 26, 2013 5:59:53 PM org.apache.juddi.v3.client.config.UDDIClerk unRegisterBinding
INFO: UnRegistering binding key uddi:uddi.joepublisher.com:binding_localhost_uddiclientsubscriptionlistenerservice_uddiclientsubscriptionlistenerimplport_18079
Dec 26, 2013 5:59:53 PM org.apache.juddi.v3.client.config.UDDIClerk unRegisterService
INFO: UnRegistering the service uddi:uddi.joepublisher.com:service_uddiclientsubscriptionlistenerservice
Dec 26, 2013 5:59:53 PM org.apache.juddi.v3.client.config.UDDIClerk unRegisterTModel
INFO: UnRegistering tModel key uddi:uddi.joepublisher.com:uddi_subscriptionlistener_porttypebinding
Dec 26, 2013 5:59:53 PM org.apache.juddi.v3.client.config.UDDIClerk unRegisterTModel
INFO: UnRegistering tModel key uddi:uddi.joepublisher.com:uddi_subscriptionlistener_porttype
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
 
This shows that the UDDI lookup took 18 milliseconds; while Cache lookup was much faster. Note that while
it is check to obtain a regular Cache it is more expensive to obtain a LiveCache. A LiveCache brings up
a WS Endpoint, and registers this Endpoint with the UDDI Server. If there is an change to any of the UDDI
services it calls back into this Endpoint which invalidates the cache.

5. Finally to remove all data structures call 

mvn -Pdelete test

This cleans up the business and the wsdl2uddi data structures.

6. You can now <cntr>-c out of the mvn -Ppublish test, to take down the HelloWorld Service.