Document directory
- Installing thejUDDI UDDI Server and Publishing WSDL, Part 2
- Publishing WSDL
Installing thejUDDI UDDI Server and Publishing WSDL, Part 2 Publishing WSDL
ByJoel Barnum, Descriptor Systems.
Introduction
In this article, you will learn how to publish a service's WSDL to the jUDDIserver. This article assumes that you have already completed the steps in Part 1, where you install and configure jUDDI.
This article further assumes that you are familiar with SOAP, WSDL and UDDI, asthese topics will not be written Ed here.
Blatant, shameless plug: If you areNotFamiliar with SOAP, WSDL and UDDI, Irecommend that you get some Web services training from Descriptor Systems. Youcan find more information at www.descriptor.com. Thanks!
Here are the software packages you will need, in addition to the packages youinstalled in Part 1:
- The Apache Axis Web services runtime. You can download Axis from the Apache website. I used version 1.4.
Installing and tracing ing Axis
1. Install Apache Axis according to the instructions on the Apachewebsite.
2. Ensure thatyou can view the WSDL for the sample Stock Quote Service by opening a Webbrowser and entering the URL:
3. http://localhost:8080/axis/StockQuoteService.jws?wsdl
Publishingthe Stock Quote Service's WSDL in UDDI
Inthis section, you will use the jUDDI console to publish a service in UDDI.
1. To start the jUDDI console, open a Web browserand enter the URL:
2. http://localhost:8080/juddi/console/
This Web page shows a rudimentaryadministration console to interact with the jUDDI server.
3. Since you are going to publish to the registry, you must first authenticate. When you configured jUDDI, the database scriptdefined credentials for a UDDI user namedJdoeWith an empty password.
Follow these steps to obtain an authenticationtoken:
A. In the jUDDI console, click on the linkGet_authTokenUnderUDDI Publish APICategory. This will open a form when which you can enter the SOAP message for the get_authToken UDDI request.
Please examine the provided template for theSOAP message. Note that "***" are placeholders into which you canenter data.
B. Find the "***"UserIDAnd change the valueJdoe. SetCredAttribute to an empty string sincethis user has no password.
Click the Submit button -- the console shoulddisplay the response message in the lower part of the form.
C. In the response, inAuthInfoElement, there shoshould be a string thatstartsAuthInfo. Thisstring is your authentication token that you must provide with any furtherpublishing commands.
Use the mouse to highlight the text withinAuthInfoElement (includingAuthInfo:Text) and then start Notepad and pastethe authentication token into Notepad.
4. Next, let's publishBusiness entity. In the jUDDIconsole, on the right side of the window, click the link labeledSave_businessUnderUDDI Publish APICategory. Again, the console willdisplay a SOAP message with "***" placeholders into which you canenter data.
5. You now need to fill in all of the "***" Before t forUseTypeField. You can use the followingvalues:
6. authInfo Copy and paste the authorization token from the last step
7. name Goliath, Inc.
8. description A big company
9. personName Bill Jones
10. phone 555-1212
11. email bill@goliath.com
When you are finished, press the Submit buttonand study the response message.
What is the business key that the registrygenerated for Goliath? Copy and paste it to Notepad.
12. Next, let's create a tModel for the sampleStock Quote service provided by Axis. Follow these steps:
A. First, ensure that the WSDL for the service isavailable. Start another Web browser window and enter:
b. http://localhost:8080/axis/StockQuoteService.jws?wsdl
C. In the jUDDI console, on the right side of thewindow, click the link labeledSave_tModelUnderUDDI publish APICategory. Again, the console willdisplay a SOAP message with "***" placeholders into which you canenter data.
Enter the following into the "***" (you can leave fields not mentioned here "***"):
authInfo Paste the authorization token from Notepad
name http://localhost:8080/axis/StockQuoteService.jws?wsdl
overviewURL http://localhost:8080/axis/StockQuoteService.jws?wsdl
Category Bag
------------
tModelKey UUID:C1ACF26D-9672-4404-9D70-39B756E62AB4
keyName uddi-org:types
keyValue wsdlSpec
Press the Submit button.
Looking at the response, what's the uniquetModel key that was assigned by the server? Copy and paste it into Notepad.
D. Here's a discussion of the data you entered:
§Name, By convention, is the target namespace of the service as specified in the WSDL
§Overviewurl, By convention, is the network addressable URL of the WSDL
§ ThisTmodelkeyIs a well known value that we attachas a category to indicate that our tModel references WSDL.KeynameAndKeyValueAre also part of this convention.
13. Finally, we can createBusiness ServiceAnd associatedBinding Template. Follow thesesteps:
A. In the jUDDI console, on the right side of thewindow, click the link labeledSave_serviceUnderUDDI publish APICategory. Again, the console willdisplay a SOAP message with "***" placeholders into which you canenter data.
Enter the following into the "***" (you can leave fields not mentioned here "***"):
authInfo Paste the authorization token from Notepad
businessKey Paste the business key from Notepad
name Stock Quote Service
accessPoint http://localhost:8080/axis/StockQuoteService.jws
tModelKey Paste the tModel key from Notepad
overviewURL http://localhost:8080/axis/StockQuoteService.jws?wsdl
Press the submit button.
Looking at the response, what's the uniqueservice key that was assigned by the server? Copy and paste it into notepad. Also paste the generated binding key into notepad
B. Here's a discussion of the data you entered:
§BusinesskeyTies this service back to Goliath, Inc.
§Accesspoint, By convention, is the service's endpoint URL
§ ThisTmodelkeyTies the service and binding templateto the tModel you created earlier
14. You have now registered your service into theuddi registry. A client application cocould now look up the service, perhapssearching by tModel name, and then locate the WSDL.
Source: http://www.descriptor.com/articles/web-services/juddi-p2.html