Domino Web Service Application Development for the IBM iSeries Server Step-by-step guide to create your first Web Service application Guide to transform your Domino application for Web Service Tips including how to use SOAP, WSDL, and UDDI Yessong Johng Kim Greene Clayton McDaniel Vinit Saraswat Jing Han Zhao ibm.com/redbooks International Technical Support Organization Domino Web Service Application Development for ~ the IBM iSeries Server November 2002 SG24-6862-00 Note: Before using this information and the product it supports, read the information in “Notices” on page vii. First Edition (November 2002) This edition applies to OS/400 V5R1 (product number 5722-SS1), IBM HTTP Server for iSeries V5R1 (5722-DG1), IBM Developer Kit for Java V5R1 (5722-JV1), WebSphere Application Server 4.02 (5733-WA4), Domino 5.0.10, and WebSphere Development Studio Client for iSeries 4.0. © Copyright International Business Machines Corporation 2002. All rights reserved. Note to U.S. Government Users Restricted Rights -- Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp. Contents Contents . iii Notices . vii Trademarks . viii Preface . ix The team that wrote this redbook. ix Notice . .x Become a published author . .x Comments welcome. xi Chapter 1. Introduction. 1 1.1 Introduction to Web Services . 2 1.1.1 What a Web Service is . 2 1.1.2 Lotus’ strategic plans for Domino and Web Services . 5 1.2 Web Service development and deployment environment. 6 1.2.1 HTTP Server . 7 1.2.2 WebSphere Application Server. 7 1.2.3 WDSc . 7 1.2.4 Domino Server . 8 Chapter 2. Writing my first Web Service application . 9 2.1 Scenario description . 10 2.1.1 Business view . 10 2.1.2 Technology view . 11 2.1.3 StockQuoteApp creation flow . 12 2.2 Developing and deploying the applications. 14 2.2.1 Create a new project in WDSc . 14 2.2.2 Import StockQuoteService class file in Web Project. 20 2.2.3 Create a new Web Service . 24 2.2.4 Test the Web Service under a WDSc test environment . 38 2.2.5 Setting up iSeries environment for deployment . 40 2.2.6 Deployment of Web Service on WebSphere Application Server . 43 2.2.7 Test the WebSphere Application Server deployment of the Web Service . 49 2.3 Analysis of StockQuoteApp Web Service application . 51 2.3.1 Provider Java program: StockQuoteService.java . 51 2.3.2 Deployment Descriptor XML: DDS.XML . 52 2.3.3 SOAP Server components: soapcfg.jar, xsd.bean.runtime.jar . 53 2.3.4 WSDL documents . 53 2.3.5 StockQuoteServiceProxy.java: Web requester Java client . 55 2.3.6 Requester Programs: TestClient.jsp, Result.jsp . 57 2.4 Tips and techniques . 60 Chapter 3. Transforming a Domino application to a Web Service application . 61 3.1 Existing Domino applications — before transformation. 62 3.2 Porting Domino application to Java application . 63 3.2.1 Total transformation flow. 63 3.2.2 Porting tips . 64 3.3 Deploying ported Java application using WDSc . 68 © Copyright IBM Corp. 2002. All rights reserved. iii 3.3.1 ExpertiseLocatorApp creation — step-by-step . 68 3.3.2 Tips on troubleshooting. 92 3.4 Analysis of LWSEK . 93 3.4.1 What you get from it . 93 3.4.2 What we did with LWSEK . 94 3.4.3 Applications we tested . 95 Chapter 4. Consuming Web Services from a Domino application . 97 4.1 Web Service consumption tutorial. 98 4.1.1 Web Service consumer introduction . 98 4.1.2 Basic requirements to be a Web Service consumer . 99 4.1.3 What is SOAPConnect? . 100 4.2 SOAPConnect TempfinderSample . 101 4.2.1 Using TempfinderSample . 101 4.2.2 Understanding TempfinderSample . 102 4.2.3 TempfinderSample runtime flow summary . 106 4.3 Consuming StockQuoteService using SOAPConnect . 107 4.3.1 Customizing StockPortfolioSample. 107 4.3.2 Testing your new consumer . 112 4.3.3 Debugging tips . 114 4.4 Consuming Web Services with a supplied proxy client . 116 4.4.1 What is a proxy client? . 117 4.4.2 StockQuoteServiceProxy class. 117 4.4.3 Web Service consumer Java agent . 119 4.5 Creating a proxy client from a WSDL file . 124 4.5.1 What is a WSDL file? . 124 4.5.2 Finding a WSDL file . 126 4.5.3 Generating a proxy client class with WDSc . 127 4.5.4 Using your new proxy client . 142 Appendix A. Creating your own Web Service application. 147 Scenario description. 148 Business view . 148 Technology view . 148 InventoryAvailabilityService creation: step-by-step guide . ..