OracleAS 10g R3: Build Web Services

Size: px

Start display at page:

Download "OracleAS 10g R3: Build Web Services"

Octavia Simmons
6 years ago
Views:

1 OracleAS 10g R3: Build Web Services Volume I Student Guide D17360GC20 Edition 2.0 July 2006 D46693

2 Author Bijoy Choudhury Technical Contributors and Reviewers Francisco Abedrabbo Mike Lehmann Nick Angelis Demed Lher Anna Atkinson Angela Long Sunitha David Loo Balachandrappa Soren Madsen Saurabh Banerjee Sami Malik Rhonda Bassett Ramaa Mani Scott Brewton Jonathan Maron Mary Bryksa Glenn Maslen Steve Button Kuassi Mensah Darren Calman Monica Mosser Olivier Caudron Krishna Motepalli Douglas Clarke Lynn Munsinger Dai Clegg Debabrata Panda Ken Cooper Vishal Parashar Scott Davies Nagavalli Pataballa D. Scott Davis Tom Pfaeffle Simon W Day Peter Purich Craig Denamur Eric Rajkovic Jacques-Antoine Sandhya Rajput Dube Guus Ramackers Brian Fry Vasudeva Tugdual Grall Rayakuntapalle Craig Hollister Vickie Reed Dan Hynes Mohit Singh Taj-Ul Islam Glenn Stokol Susan Jang Vasiliy A Strelnikov Vijay Jayasheelan Velmurugan Reena John Subramanian Yosuke Katsuki Venkat Tallapragada Istvan Kiss Santoshkumar Vetsa Nick Kritikos Ulrich Vogel John Lang Ted Witiuk Peter Laseau Frances Zhao Copyright 2006, Oracle. All rights reserved. Disclaimer This document contains proprietary information and is protected by copyright and other intellectual property laws. You may copy and print this document solely for your own use in an Oracle training course. The document may not be modified or altered in any way. Except where your use constitutes "fair use" under copyright law, you may not use, share, download, upload, copy, print, display, perform, reproduce, publish, license, post, transmit, or distribute this document in whole or in part without the express authorization of Oracle. The information contained in this document is subject to change without notice. If you find any problems in the document, please report them in writing to: Oracle University, 500 Oracle Parkway, Redwood Shores, California USA. This document is not warranted to be error-free. Restricted Rights Notice If this documentation is delivered to the United States Government or anyone using the documentation on behalf of the United States Government, the following notice is applicable: U.S. GOVERNMENT RIGHTS The U.S. Government s rights to use, modify, reproduce, release, perform, display, or disclose these training materials are restricted by the terms of the applicable Oracle license agreement and/or the applicable U.S. Government contract. Trademark Notice Oracle, JD Edwards, PeopleSoft, and Siebel are registered trademarks of Oracle Corporation and/or its affiliates. Other names may be trademarks of their respective owners. Editors Arijit Ghosh Aju Kumar Atanu Raychaudhury Navratan Singh Richard Wallis Graphic Designer Sanjeev Sharma Publisher Jobi Varghese

3 Contents Preface 1 Introduction to Web Services Objectives 1-2 Course Objectives 1-3 Course Agenda 1-5 What Is a Web Service? 1-7 Web Services 1-8 Service-Oriented Architecture 1-10 Web Services: Architecture 1-11 Identifying Web Service Standards 1-12 Web Services Specifications 1-13 J2EE Web Service APIs 1-14 Java API for XML-Based RPC (JAX-RPC) 1-15 SOAP with Attachments API for Java (SAAJ) 1-16 Java API for XML Registries (JAXR) 1-17 Enterprise Web Services 1-18 Oracle Application Server 10g: Web Services Architecture 1-20 Web Services Development and Management Tools 1-21 Oracle Application Server 10g: Enterprise Manager for Web Service 1-22 Course Environment 1-23 Creating a Database Connection in JDeveloper 1-24 Creating an Application Server Connection in JDeveloper 1-25 Summary 1-26 Practice 1 Overview: Introduction to Web Services Exploring Web Service Technologies Objectives 2-2 SOAP: XML Messaging for Web Services 2-3 Communication with SOAP 2-4 SOAP Messages 2-5 SOAP Messages: Example 2-7 Examining SOAP Messages by Using the Http Analyzer 2-8 Editing SOAP Messages by Using the Http Analyzer 2-9 Web Services Description Language (WSDL) 2-10 iii

4 Mapping of a Java Method to WSDL 2-12 Defining the Structure of Content in SOAP Body 2-14 RPC-Style Web Services 2-15 Document-Style Web Services 2-16 RPC-Style SOAP Request Message Structure 2-17 Document-Style SOAP Request Message Structure (document/literal) 2-18 Document-Style SOAP Request Message Structure (document/wrapped) 2-20 Alternative Web Service Communications Strategies 2-21 Web Services Invocation Framework (WSIF) 2-22 Representational State Transfer (REST) 2-24 The UDDI Registry 2-25 UDDI Registry 2-26 Using UDDI 2-27 Searching for a Web Service Using UDDI 2-28 What Is Oracle Service Registry? 2-29 Deploying and Testing a Web Service 2-30 Summary 2-31 Practice 2 Overview: Exploring Web Service Technologies Developing Web Services Objectives 3-2 Web Service Development Approach 3-3 Bottom-Up Approach 3-4 Top-Down Approach 3-5 The WebServicesAssembler (WSA) Tool 3-6 Developing a Web Service by Using the Bottom-Up Approach 3-7 Defining an Interface 3-8 Defining a Stateless Java Class 3-9 Generating the Web Service Artifacts 3-10 Deploying and Binding the Web Service 3-12 Accessing and Testing the Deployed Web Service 3-13 Testing the Deployed Web Service 3-14 Examining the SOAP Messages 3-15 Invoking the Web Service with a Java Client Application 3-16 Generating the Web Service Client Artifacts 3-17 Coding the Client Application 3-19 Compiling and Running the Client Application 3-20 Developing a Web Service by Using the Top-Down Approach 3-22 Defining an XSD Schema 3-24 Oracle JDeveloper 10g XSD Editor 3-25 Creating the WSDL Document 3-26 iv

5 Oracle JDeveloper 10g WSDL Editor 3-28 Creating the Web Service by Using Oracle JDeveloper 10g 3-29 Generating the Web Service Artifacts 3-31 Deploying the Web Service 3-34 Generating the Web Service Client Proxy 3-35 Testing the Web Service 3-36 Identifying Web Service Technologies 3-37 Troubleshooting a Web Service 3-38 Summary 3-40 Practice 3 Overview: Developing Web Services Developing a Web Service by Using the JSR-181 Annotations Objectives 4-2 What Are Annotations? 4-3 Web Service Metadata for Java Platform (JSR-181) 4-4 Examining the JSR-181 Processor Model 4-5 Describing JSR-181 Annotations 4-6 Sample Annotated Java Web Service File 4-7 Developing a Web Service by Using JSR-181 Annotations 4-8 Creating an Annotated Java Class 4-9 Generating Web Service Artifacts 4-11 Examining the Generated WSDL Document 4-12 Deploying the Web Service 4-13 Exposing EJB 3.0 as a Web Service 4-14 Creating the Service Endpoint Interface 4-15 Creating the Endpoint Class (Session Bean) 4-16 Invoking the Web Service 4-17 Summary 4-18 Practice 4 Overview: Developing a Web Service Using Annotations (JSR-181) Developing Database Web Services Objectives 5-2 What Is a Database Web Service? 5-3 Database Call-In 5-4 Database Call-Out 5-5 Generating Wrapper Classes by Using JPublisher 5-6 Configuring Data Source by Using Application Server Control 5-7 Publishing SQL Query as a Web Service 5-8 Deploying the Web Service 5-9 Testing the Generated Web Service 5-10 Generating a Client and Invoking the Database Web Service 5-12 v

6 Web Service Client Code 5-13 Publishing a Web Service by Using Oracle JDeveloper 10g 5-14 Creating a PL/SQL Package 5-15 Publishing the PL/SQL Package as a Web Service by Using Oracle JDeveloper 10g 5-16 Generating the Web Service Client Proxy 5-21 Invoking the Web Service 5-23 Summary 5-25 Practice 5 Overview: Developing a Database Web Service Securing a Web Service with WS-Security Objectives 6-2 Need for Web Service Security 6-3 Web Service Security Approaches 6-4 Protocol-Based Security Architecture 6-6 Message-Based Security Architecture 6-7 What Is WS-Security? 6-8 WS-Security Fundamentals 6-9 Oracle Application Server 10g WS-Security Architecture 6-11 Configuring WS-Security for a Web Service 6-12 Configuring WS-Security for a Web Service by Using Oracle Enterprise Manager 10g 6-14 Edit Security Configuration: Keystore and Identity Certificates 6-15 Edit Security Configuration: Inbound Policies 6-17 Edit Security Configuration: Outbound Policies 6-19 Configuring WS-Security for a Web Service by Using Oracle JDeveloper 10g 6-20 Testing WS-Security for a Normal Client 6-21 Configuring WS-Security for a Client by Using Oracle JDeveloper 10g 6-22 Sample Secure SOAP Request Message 6-24 Testing WS-Security for a Secure Client 6-25 Summary 6-26 Practice 6 Overview: Securing a Web Service with WS-Security Managing Web Service Quality of Service Objectives 7-2 What Is WS-Reliability? 7-3 Web Service Quality of Service (QoS) 7-4 Managing Quality of Service for Web Services 7-6 WS-Reliability Messaging Model 7-7 WS-Reliability Message Ordering Model 7-8 WS-Reliability SOAP Message Structure 7-9 vi

7 Configuring WS-Reliability for a Web Service 7-10 Server-Side WS-Reliability Configuration 7-11 Port-Level Reliability Elements 7-12 Operation-Level Reliability Elements 7-13 Configuring WS-Reliability for a Web Service by Using Oracle Enterprise Manager 10g 7-14 Configuring WS-Reliability for a Web Service by Using Oracle JDeveloper 10g 7-16 Testing WS-Reliability for a Nonreliable Client 7-18 Configuring WS-Reliability for a Client by Using Oracle JDeveloper 10g 7-19 Viewing the SOAP Message 7-20 Testing the Web Service for WS-Reliability 7-21 Summary 7-23 Practice 7 Overview: Managing Web Service Quality of Service Auditing and Logging Web Service SOAP Content Objectives 8-2 What Is Auditing? 8-3 Processing Audit Messages 8-4 Configuring the Server for Auditing 8-5 Configuring Auditing for a Web Service by Using Application Server Control 8-6 Creating a Client for the Web Service by Using Oracle JDeveloper 10g 8-8 Viewing the Audit Logs 8-9 What Is Logging? 8-11 Processing Logging Messages 8-12 Configuring Logging for a Web Service by Using Application Server Control 8-13 Configuring the XPath Expression 8-15 Creating a New Namespace 8-16 Configuring the Response and Fault Attributes for Logging 8-17 Viewing the Logging Information 8-18 Summary 8-20 Practice 8 Overview: Auditing and Logging Web Service SOAP Content Advanced Web Service Features Objectives 9-2 What Is Web Services Interoperability? 9-3 Interoperable Web Services 9-4 Testing for WS-Interoperability 9-5 Configuring a WS-I Tester in Oracle JDeveloper 10g 9-6 Analyzing the WSDL for WS-I Compliance 9-7 Reading the Conformance Report 9-8 Analyzing the Messages of a Web Service 9-10 vii

8 Working with Message Attachments 9-11 Developing a Web Service with Attachments 9-13 Creating the Java Class 9-14 Examining the Generated WSDL 9-15 Modifying the Client-Side Proxy 9-16 Examining the SOAP Messages 9-17 Assembling a REST Web Service 9-18 Creating the Java Class 9-19 Generating the Web Service by Using Oracle JDeveloper 10g 9-20 Testing the Web Service 9-21 Web Service Invocation Framework (WSIF) 9-23 WSIF Architecture 9-24 The WSIF Architecture 9-25 WSIF Bindings in a WSDL 9-26 The WSIF Bindings in a WSDL 9-27 Configuring WSIF Endpoints in the WSDL 9-28 Creating a WSIF Client 9-29 Summary 9-31 Practice 9 Overview: Advanced Web Services Features 9-32 A Practices B Practice Solutions C Publishing Web Services with UDDI Objectives C-2 What Is UDDI? C-3 How Is UDDI Used? C-4 UDDI: Types of Information C-5 UDDI Specification C-6 UDDI Data Structure C-7 UDDI Registration: Example C-8 <tmodel> C-9 How WSDL Relates to UDDI Data Structure C-11 UDDI Programmer s API C-13 Inquiry API C-14 Publishing API C-15 Java-Based UDDI APIs C-16 Oracle UDDI Implementation C-17 Oracle Support to Access UDDI C-18 UDDI Publishing and Browsing with Oracle Enterprise Manager C-19 viii

9 Oracle UDDI Registry User Management C-20 UDDI Support in Oracle JDeveloper 10g C-21 Oracle UDDI Java Client API C-22 Java Client Consuming Web Services C-23 Summary C-24 D Developing a JMS-Based Web Service Objectives D-2 What Is a Messaging System? D-3 What Is Java Message Service? D-4 JMS Messaging Domains D-5 JMS Application Architecture D-6 What Is a Message-Driven Bean? D-7 Life Cycle of a Message-Driven Bean D-8 JMS Endpoint Web Service Architecture D-9 Developing a JMS Endpoint Web Service D-11 Creating a Queue by Using Oracle Enterprise Manager 10g D-13 Creating a Message-Driven Bean D-14 Generating the Web Service Artifacts by Using Oracle JDeveloper 10g D-15 Creating the Web Service Client D-16 Monitoring the JMS Destination by Using Oracle Enterprise Manager 10g D-17 Summary D-18 E Exploring SOAP and WSDL Objectives E-2 SOAP Message: Envelope E-3 SOAP Message: Header E-5 SOAP Message: Body E-7 SOAP: Example E-9 WSDL File: definitions E-10 WSDL File: types E-11 WSDL File: message E-12 WSDL File: porttype E-14 WSDL File: binding E-15 WSDL File: service E-16 Summary E-17 Index ix

E Oracle 10g Java Bootcamp II v1

E Oracle 10g Java Bootcamp II v1 Volume I Student Guide D22061GC10 Edition 1.0 October 2005 D22332 Author Lynn Munsinger Sunitha Patel Technical Contributors and Reviewers Anna Atkinson Scott Brewton Kenneth