This article is Part One of a series presenting the UDDI functions provided by SAP Web AS Java 6.40. This issue focuses on publishing a Web service and Web service definition to the SAP public registry using the J2EE Engine UDDI client.
20 Jul 2004
One of the great benefits of using Web services is the possibility of exposing and discovering them and their functionality worldwide. Therefore, if you are a company that provides Web services and you want to make them available on the Internet, then all you have to do is to publish your service in a service directory. In this way, another company that wants to use a Web service can discover it, create a Web service client, and use the functions provided. SAP Web Application Server Java provides publishing, searching and retrieving Web services and Web service definitions in a Universal Description, Discovery and Integration (UDDI) directory. For more information about UDDI and the registries that SAP provides, see uddi.sap.com.
No matter how you created your Web service – using the SAP NetWeaver™ Developer Studio or another application – you have to deploy it on the J2EE Engine. To do this, use the NetWeaver Developer Studio, the Software Delivery Manager (SDM), or the Visual Administrator, depending on your particular case.
The UDDI client is a Web-based tool but it uses the Web Services framework to access other servers and services. To use the tool, you have to configure the HTTP proxy host and port values. Here, you have to use the Visual Administrator – the Settings tab of the Web Services Container Service.
The last requirement is a user account for the SAP public UDDI registry. To create one, visit uddi.sap.com, enter the UDDI@SAP Registry User Interface, and follow the Sign In instructions. The UDDI client connects to the SAP registry via SSL connection; that is why you have to install the SAP Java Cryptographic Toolkit, which you can find at the Service Marketplace (service.sap.com/download under Download -> SAP Cryptographic Software).
Publishing a Web Service Definition
SAP NetWeaver Developer Studio helps you create a Web service using a step-by-step wizard and gives you the opportunity to create all the elements such as the Virtual Interface, Web Service Definition (WSD), Web Service, and Web Service Configuration individually. During this process, after you have created the WSD, you can publish the Web service definition in a UDDI registry using the UDDI tab. In addition, you need to know the user name and password for connecting to the J2EE Engine; the user must be assigned to the “administrators” security role. By default, this is Administrator with sap.
The UDDI tool is loaded and you have to select Publish Service Definition. Enter your user name and password for the SAP UDDI registry and in the next step, create a name for the WSD, description, identifiers, and categories. Choose Publish.
This publishes the Web service definition successfully as a tModel in the SAP public registry.
Publishing a Web Service
Publishing a Web service is as easy as publishing a Web Service Definition (WSD). First, you have to create a business entity containing specific information such as contacts, identifiers, and categories. To perform this action, you have to load the UDDI tool from a Web browser window pointing to http://<host>:<port>/uddiclient. The default is http://localhost:50000/uddiclient.
Choose Publish Business Entity in the displayed window and enter the necessary data.
Figure 1. UDDI Tool
Now you are ready to publish your Web service. It takes only a few minutes to complete this action. Again using the Visual Administrator, select your service and choose Publish. The UDDI client tool is loaded, and this time you have to choose Publish Service. If you are not using the Visual Administrator to select the service and you reloaded the UDDI tool from the Web browser instead, then you will have to configure the Address Point manually – this is the endpoint location. Enter information about the service such as name, description, categories, and then choose Publish.
These are the simple steps necessary for publishing a Web service.
You can find detailed information about the UDDI client and its functions at help.sap.com, under SAP NetWeaver -> Release '04 -> English/German -> SAP NetWeaver -> Application Platform (SAP Web Application Server) -> Java Technology in SAP Web Application Server -> Development Manual -> Developing Business Logic -> Web Services -> UDDI.