Arthur Ryman IBM Rational Developing Web Services with Eclipse

Abstract The recently created Web Tools Platform Project extends Eclipse with a set of Open Source Web service development tools and APIs. This talk gives an overview of the project and focuses on its Web services support. The project is divided into two subprojects: Web Standard Tools and J2EE Standard Tools. The Web Standard Tools subproject contains support for XML Web Services, including tools based on standards defined by W3C, OASIS, WS-I and others. The J2EE Standard Tools subproject contains support for standards defined by JCP, such as JAX-RPC and JSR-109, and for reference implementations of these standards, such as Apache Axis. The project contains both a set of tools for Web service developers and a set of APIs for Web service tool creators. The talk includes a demonstration of the tools. This is an Introductory Level talk. It assumes some knowledge of Eclipse, Java, XML, and Web services.

My Background Software Development Manager at IBM Toronto Lab Focus on Web Service, XML, and J2EE Tools Rational Application Developer V6 WebSphere Studio Application Developer V4, V5 VisualAge for Java V1, V2, V3 Leader of Web Standard Tools subproject, Eclipse Web Tools Platform project Editor of W3C WSDL 2.0 Core Language specification Committer on Apache Woden Project

Topics Eclipse Web Tools Platform (WTP) Project WTP Web Service Tools Web Service Programming Examples Call for Participation

Eclipse Web Tools Platform Project

See: Extends the Eclipse Platform with tools and APIs for Web and J2EE application development Formally launched in June 2004 Has two subprojects: Web Standard Tools (WST) J2EE Standard Tools (JST) Includes tools for HTML, XML, Web Services, J2EE, Data Includes Server tools for integrating application servers, e.g. Tomcat, Geronimo, JBoss, WebSphere, WebLogic

IETF W3C OASIS WS-I ECMA ANSI De Jure Standards De Facto Standards Web Technologies Java Technologies WST HTML, XML, XSLT, CSS, JS, WSDL, SOAP, UDDI JST Servlet, JSP, EJB, JAX-RPC, JDBC, JAXP, JSF, J2EE PHPStruts Hibernate Spring JDOSQL JCP Apache ObjectWeb SourceForge WTP Subproject Scopes

JST ServletEJBJSP J2EE WS J2EE Project J2EE Server WST HTMLServerXMLWSDataInternet Eclipse Tools EMFJEMGEF Eclipse Platform ResourceDebugJDT WTP Architecture

WTP Roadmap WTP 0.7, July 2005 – End User Tools WTP 1.0, December 2005 – Platform APIs WTP 1.5, June 2006 – Java EE 5.0

Eclipse Core GEF JDT/CDTTeam TPTP CM, Merge, Traceability…. Model Services (UML2 ext, other Meta-Models, Code Gen APIs, …) EMF UML2 Eclipse Analyst Architect Developer Tester Deployment Manager Project Manager Web Tools others IBM Software Development Platform and Eclipse

The IBM Software Development Platform Customer Extensions 3rd Party ISV Tools Rational Software Architect Rational Web/App Developer Rational Functional & Manual Tester Rational Performance Tester Rational Team Unifying Platform Tivoli Configuration Manager WebSphere Business Integration Modeler & Monitor Rational Software Modeler WebSphere Business Integration Modeler & Monitor Rational Software Modeler Tivoli Monitoring WebSphere Tools WebSphere Tools Analyst Architect Developer Tester Deployment Manager Project Manager Executive Rational Portfolio Manager

WTP Web Services Tools

Web Service Tools in WTP: WST Web Standard Tools Web Service Explorer WSDL/XSD Editor Web Service Wizard WS-I Test Tools

Web Service Tools in WTP: JST J2EE Standard Tools J2EE Explorer JAX-RPC JSR 109 Axis 1.2.1

Web Services Explorer: Discovery and Publish Web Services Discovery Search UDDI Registries Navigate WSIL Documents Import WSDL into development project Test Dynamic invocation based on WSDL View SOAP messages Publish Publish WSDL into UDDI Registries

Web Services Explorer Demo 1)Open Web Services Explorer 2)Open XMethods UDDI Registry 3)Find all stock quote services 4)Select Stock Quote service 5)Open WSDL page and GetQuote for IBM 6)Import WSDL into Workbench StockQuoteClient project as StockQuote.wsdl StockQuote.wsdl

WSDL/XSD Editor: Design Web Services Graphical and Source editing modes Seamless integration for editing inline XSD Content Assist Pop-up actions Binding Wizard Validator, including WS-I profiles Extendible for WSDL extension elements

WSDL Editor Demo 1)Open StockQuote.wsdl in WSDL EditorStockQuote.wsdl 2)Go into graphical view of XML schema for messages 3)Navigate into GetQuote element 4)Switch to Source tab 5)Navigate using linked Outline and Properties views

Web Services Wizard: Create and Access Web Services Supports generate/deploy/test/publish lifecycle Configures project, server, and SOAP engine Highly extensible SOAP engines Code generators Test facilities

Web Services Wizard: Create and Access Web Services Code generation WSDL to client proxy WSDL to server skeleton Java to WSDL Test facilities JSP test client Web Service Explorer

Web Service Client Wizard Demo 1)Run Web Service Client Wizard to generate Java proxy and JSP test page with TCP/IP monitor 2)Wizard adds Web application to Tomcat 5.0 server and installs Axis SOAP engine 3)Select methods to include in JSP test page 4)Test getQuote() method using IBM 5)View SOAP messages in TCP/IP monitor

WS-I Test Tools: Test Interoperability of Web Services Developed in Eclipse Web Service Validation Tools (WSVT) Project Supports WS-I Basic Profile 1.0/1.1, Simple SOAP Binding Profile 1.0, Attachments Profile 1.0 WSDL 1.1 Validator SOAP 1.1 Message Monitor/Analyzer

WS-I SOAP Message Monitor/Analyzer

WS-I Test Tools Demo 1)Specify level of WS-I compliance in Preferences page 2)Save SOAP messages from TCP/IP to a WS- I log file 3)Specify WSDL file that describes messages 4)View WS-I errors and warnings in Problems view

J2EE Web Services: Deploy Web Services Web Services appear as first class objects in J2EE Explorer Content assist for deployment descriptor source editors JAX-RPC code generators JSR 109 support Axis adaptor

Web Service Programming Examples

Development Scenarios Accessing Web Services Creating Web Services Bottom-Up Top-Down

Accessing Web Services The preceding demo generated a JSP test client for the Stock Quote service Well now code a JSP client application that accesses it The Web Service wizard generated JAX-RPC compliant client code and a convenience wrapper Well use this code in our client

JAX-RPC Client Code

package NET.webserviceX.www targetNamespace=" StockQuoteLocator.java – Service locator StockQuoteLocator.java StockQuote.java – Service interface StockQuote.java StockQuoteSoap.java – Remote interface StockQuoteSoap.java StockQuoteSoapStub.java – Client stub wrapper for Call object StockQuoteSoapStub.java StockQuoteSoapProxy.java – Client proxy convenience wrapper StockQuoteSoapProxy.java

Web Client Version 1: getQuote.jsp getQuote.jsp 1)Create a JSP 1)get a query parameter, symbol, 2)create a service proxy, and 3)invoke the getQuote operation 2)Select getQuote.jsp and invoke Run As->Run on ServergetQuote.jsp 1)The Web app is added to the server, 2)the server is started, and 3)a Web browser is opened on the appropriate URL for getQuote.jsp getQuote.jsp

Processing XML This service has a poorly designed interface XML is returned as an escaped string No schema for result The client needs to parse the result to extract the price, etc. Client application can parse XML using: DOM, SAX, Java data binding code (JAXB, etc.), or server-side XSLT For fun, well use browser-side XSLT

Web Client Version 2: getQuote-xsl.jsp getQuote-xsl.jsp 1)View example of XML response ibm- quote.xmlibm- quote.xml 2)Create XSLT StockQuotes.xslStockQuotes.xsl 1)Generate to get symbol 2)Generate to present stock quote 3)Create JSP getQuote-xsl.jspgetQuote-xsl.jsp 1)Insert processing instruction 2)Return unparsed XML 4)Run on Server to view result

Bottom-Up Web Service Creation Any reasonable Java class can be easily deployed as a Web service This approach is very appealing to Java programmers since it lets them be immediately productive The WSDL is generated from the Java The result is acceptable if the methods use tame argument types, however object graphs are problematic Top-Down design is recommended to achieve the cleanest and most interoperable Web service interfaces

Bottom-Up Service: BUService 1)Create a new Web project: BUService 2)Create a data object to represent the result: BUStock.java BUStock.java 3)Create a business object to take a symbol and return a stock quote for it: BUQuoter.javaBUQuoter.java 4)Use the Web service wizard to deploy it. Use rpc- encoded style for fun so we can see WS-I errors. Generate and monitor a JSP test client. 5)Test the service, view the messages in the monitor, and validate the SOAP messages for WS- I conformance. Note the errors caused by rpc- encoded style.

Top-Down Web Service Creation Business is transacted by exchanging documents – purchase orders, receipts, application forms, insurance claims, building permits, etc. For best interoperability, treat Web services as document interchange, not distributed objects Model documents using XSD, and operations using WSDL Generate Java from WSDL

Top-Down Service: TDService 1)Create a new Web project: TDService 2)Create an XML schema for the Stock quote result: TDStock.xsd TDStock.xsd 3)Create a WSDL for the quote service with an operation that takes a symbol and returns a quote: TDQuoter.wsdl. Use the WSDL Binding wizard to generate document-literal SOAP binding style this time.TDQuoter.wsdl 4)Use the Web service wizard to generate the service. 5)Fill in the implementation of the service: TDQuoterSOAPImpl.java TDQuoterSOAPImpl.java 6)Create a new Web project: TDServiceClient 7)Select /wsdl/TDQuoterSOAP.wsdl, create a JSP test client, and monitor the service. 8)Test the service and validate the SOAP messages for WS-I conformance. There should be no errors this time.

Summary The Eclipse Web Tools project has a rich, extensible set of Web service tools Explorer, Graphical WSDL and XSD editors, Wizard, WS-I Test Tools Discovery, explore, and access remote services Create services from Java (bottom-up) Create services from WSDL and XSD (top- down) Check for WS-I conformance

Call for Participation Become a WTP user and tell your friends Test WTP and report bugs Write tutorials, articles Fix bugs Contribute enhancements Become a committer Develop plug-ins based on WTP Attend EclipseCon 2006EclipseCon 2006