CSI 3140 WWW Structures Techniques and Standards Web

CSI 3140 WWW Structures, Techniques and Standards Web Services: JAX-RPC, WSDL, XML Schema, and SOAP

Web Services Concepts w. A web application uses Web technologies to provide functionality to an end user w. A web service uses Web technologies to provide functionality to another software application Guy-Vincent Jourdan : : CSI 3140 : : based on Jeffrey C. Jackson’s slides 2

Web Services Concepts w. Standard web services technologies: n n n Communication via SOAP XML vocabulary documents over HTTP Operations of web service defined by Web Services Definition Language (WSDL) XML vocabulary Data within WSDL defined using XML Schema Guy-Vincent Jourdan : : CSI 3140 : : based on Jeffrey C. Jackson’s slides 3

Web Services Concepts w. Higher-level API’s are often used to automatically generate web services client and server communication software n n We will use the Java API for XML-based Remote Procedure Call (JAX-RPC) Microsoft. NET framework is one popular alternative to JAX-RPC Guy-Vincent Jourdan : : CSI 3140 : : based on Jeffrey C. Jackson’s slides 4

Web Services Concepts w. Web services conceptually are just specialized web applications: HTTP request (SOAP body) Server (Java servlet) Client HTTP response (SOAP body) Guy-Vincent Jourdan : : CSI 3140 : : based on Jeffrey C. Jackson’s slides 5

Web Services Concepts w. Body of web services request is analogous to calling a method Operation name (like method name) Input parameter names Input parameter values Guy-Vincent Jourdan : : CSI 3140 : : based on Jeffrey C. Jackson’s slides 6

Web Services Concepts w. Body of web services response is analogous to value returned by a method Return value data type Return value Guy-Vincent Jourdan : : CSI 3140 : : based on Jeffrey C. Jackson’s slides 7

Web Services Concepts w. WSDL defines web service n n Operations Parameters Return values Communication protocols w. Basically an API for the web service n Facilitates automated client/server software generation Guy-Vincent Jourdan : : CSI 3140 : : based on Jeffrey C. Jackson’s slides 8

Web Services Concepts w. Portions of NWS WSDL Input params Return type Data types defined using XML Schema Operation name Guy-Vincent Jourdan : : CSI 3140 : : based on Jeffrey C. Jackson’s slides 9

Web Services Concepts w. Java Web Services Developer Pack (JWSDP) wscompile tool can implement a Java API from a WSDL Classes and methods generated by wscompile This method automatically handles SOAP request and response Guy-Vincent Jourdan : : CSI 3140 : : based on Jeffrey C. Jackson’s slides 10

Web Services Concepts w. Writing the server for a web service with JWSDP: n n n Write a Java interface defining the API Implement the interface JWSDP generates SOAP and communication handling classes l WSDL l Guy-Vincent Jourdan : : CSI 3140 : : based on Jeffrey C. Jackson’s slides 11

Web Services Concepts w. Example Java interface Guy-Vincent Jourdan : : CSI 3140 : : based on Jeffrey C. Jackson’s slides 12

Web Services Concepts w. Example implementation Guy-Vincent Jourdan : : CSI 3140 : : based on Jeffrey C. Jackson’s slides 13

Web Services Examples Tons of WS available on the internet. w http: //www. webservicex. net as a good collection n n Geo IP: http: //www. webservicex. net/geoipservice. asmx? op=Get. Geo. IP Whois: http: //www. webservicex. net/whois. asmx? op=Get. Who. IS SMS: http: //www. webservicex. net/sendsmsworld. asmx Etc. . w Google: w Amazon n S 3 Guy-Vincent Jourdan : : CSI 3140 : : based on Jeffrey C. Jackson’s slides 14

JWSDP: Server w. Application: currency converter n Three operations: from. Dollars l from. Euros l from. Yen l n n Input: value in specified currency Output: object containing input value and equivalent values in other two currencies Guy-Vincent Jourdan : : CSI 3140 : : based on Jeffrey C. Jackson’s slides 15

JWSDP: Server 1. Write service endpoint interface • May need to write additional classes representing data structures 2. Write class implementing the interface 3. Compile classes 4. Create configuration files and run JWSDP tools to create web service 5. Deploy web service to Tomcat Guy-Vincent Jourdan : : CSI 3140 : : based on Jeffrey C. Jackson’s slides 16

JWSDP: Server w. Service endpoint interface n n Must extend java. rmi. Remote Every method must throw java. rmi. Remote. Exception Parameter/return value data types are restricted No public static final declarations (global constants) Guy-Vincent Jourdan : : CSI 3140 : : based on Jeffrey C. Jackson’s slides 17

JWSDP: Server w Allowable parameter/return value data types n n n Java primitives (int, boolean, etc. ) Primitive wrapper classes (Integer, etc. ) String, Date, Calendar, Big. Decimal, Big. Integer java. xml. namespace. QName, java. net. URI Struct: class consisting entirely of public instance variables Array of any of the above Guy-Vincent Jourdan : : CSI 3140 : : based on Jeffrey C. Jackson’s slides 18

JWSDP: Server w. Struct for currency converter app (data type for return values) Guy-Vincent Jourdan : : CSI 3140 : : based on Jeffrey C. Jackson’s slides 19

JWSDP: Server w. Service endpoint interface Guy-Vincent Jourdan : : CSI 3140 : : based on Jeffrey C. Jackson’s slides 20

JWSDP: Server 1. Write service endpoint interface • May need to write additional classes representing data structures 2. Write class implementing the interface 3. Compile classes 4. Create configuration files and run JWSDP tools to create web service 5. Deploy web service to Tomcat Guy-Vincent Jourdan : : CSI 3140 : : based on Jeffrey C. Jackson’s slides 21

JWSDP: Server w. Class Cur. Con. Impl contains methods, for example: Guy-Vincent Jourdan : : CSI 3140 : : based on Jeffrey C. Jackson’s slides 22

JWSDP: Server 1. Write service endpoint interface • May need to write additional classes representing data structures 2. Write class implementing the interface 3. Compile classes 4. Create configuration files and run JWSDP tools to create web service 5. Deploy web service to Tomcat Guy-Vincent Jourdan : : CSI 3140 : : based on Jeffrey C. Jackson’s slides 23

JWSDP: Server w. Configuration file input to wscompile to create server Namespaces used in WSDL (normally, unique URL’s at your Web site) Guy-Vincent Jourdan : : CSI 3140 : : based on Jeffrey C. Jackson’s slides 24

JWSDP: Server w. Configuration file for web service Guy-Vincent Jourdan : : CSI 3140 : : based on Jeffrey C. Jackson’s slides 25

JWSDP: Server w. Configuration file for web service Context path Like servlet in web. xml Like servlet-mapping in web. xml Guy-Vincent Jourdan : : CSI 3140 : : based on Jeffrey C. Jackson’s slides 26

JWSDP: Server w. Also need a minimal web. xml Guy-Vincent Jourdan : : CSI 3140 : : based on Jeffrey C. Jackson’s slides 27

JWSDP: Server w. Run jar and wsdeploy to create a Web Archive (WAR) file converter. war n Name must match url. Pattern. Base value Guy-Vincent Jourdan : : CSI 3140 : : based on Jeffrey C. Jackson’s slides 28

JWSDP: Server 1. Write service endpoint interface • May need to write additional classes representing data structures 2. Write class implementing the interface 3. Compile classes 4. Create configuration files and run JWSDP tools to create web service 5. Deploy web service to Tomcat Guy-Vincent Jourdan : : CSI 3140 : : based on Jeffrey C. Jackson’s slides 29

JWSDP: Server w. Just copy converter. war to Tomcat webapps directory n n May need to use Manager app to deploy Enter converter. war in “WAR or Directory URL” text box Guy-Vincent Jourdan : : CSI 3140 : : based on Jeffrey C. Jackson’s slides 30

JWSDP: Server w. Testing success: n Visit http: //localhost: 8080/converter/currency Guy-Vincent Jourdan : : CSI 3140 : : based on Jeffrey C. Jackson’s slides 31

JWSDP: Client w. Goal: write a JSP-based client n n Input: currency and value Output: table of equivalent values Guy-Vincent Jourdan : : CSI 3140 : : based on Jeffrey C. Jackson’s slides 32

JWSDP: Client w. Configuration file input to wscompile to create client Guy-Vincent Jourdan : : CSI 3140 : : based on Jeffrey C. Jackson’s slides 33

JWSDP: Client w. Directory structure (wscompile generates content of classes and src) Guy-Vincent Jourdan : : CSI 3140 : : based on Jeffrey C. Jackson’s slides 34

JWSDP: Client w. Starting point for writing a client (if the web service author does not explain how): n n In the WSDL, find the name attribute of the service element Look in Java file with this name to see how to obtain a proxy object for the service Data type of proxy object Method called to obtain object Guy-Vincent Jourdan : : CSI 3140 : : based on Jeffrey C. Jackson’s slides 35

JWSDP: Client w. Obtaining the proxy object: n n Java file consisting of service name followed by _Impl defines a class implementing the proxygenerating interface Client code begins with method call on this class: Guy-Vincent Jourdan : : CSI 3140 : : based on Jeffrey C. Jackson’s slides 36

JWSDP: Client w. Using the proxy object: Guy-Vincent Jourdan : : CSI 3140 : : based on Jeffrey C. Jackson’s slides 37

JWSDP: Client w. Structs will be represented as Java. Beans classes, regardless of how they are defined on the server Guy-Vincent Jourdan : : CSI 3140 : : based on Jeffrey C. Jackson’s slides 38

JWSDP: Client w. Bean obtaining and calling proxy object: Guy-Vincent Jourdan : : CSI 3140 : : based on Jeffrey C. Jackson’s slides 39

JWSDP: Client w. JSP document using the bean: Call to get. Ex. Values() Call to get. Euros() Guy-Vincent Jourdan : : CSI 3140 : : based on Jeffrey C. Jackson’s slides 40

WSDL Example WSDL namespaces Namespaces specified in config files XML Schema NS w. Target namespace: namespace for names (e. g. , of operations) defined by the WSDL Guy-Vincent Jourdan : : CSI 3140 : : based on Jeffrey C. Jackson’s slides 41

WSDL Example Namespace for data type definitions (ns 2 in rest of document) Defines struct using XML Schema Guy-Vincent Jourdan : : CSI 3140 : : based on Jeffrey C. Jackson’s slides 42

WSDL Example Data type defined by XML Schema Output messages (response data types) Input messages (parameter lists) Guy-Vincent Jourdan : : CSI 3140 : : based on Jeffrey C. Jackson’s slides 43

WSDL Example Guy-Vincent Jourdan : : CSI 3140 : : based on Jeffrey C. Jackson’s slides 44

WSDL Example Implement the operations using SOAP encoding of data structures and RPC (JWSDP defaults) Guy-Vincent Jourdan : : CSI 3140 : : based on Jeffrey C. Jackson’s slides 45

WSDL Example Replaced by server when WSDL is visited Guy-Vincent Jourdan : : CSI 3140 : : based on Jeffrey C. Jackson’s slides 46

WSDL Example w. Summary: n n n types uses XML Schema to define data types message elements define parameter lists and return types using types and XML Schema port. Type defines abstract API for operation’s using message’s binding specifies how message’s will be communicated and operation’s called service associates URL with binding Guy-Vincent Jourdan : : CSI 3140 : : based on Jeffrey C. Jackson’s slides 47

XML Schema w. How do we send a Java double value to a web service using XML? n n n Is scientific notation allowed? How large can the value be? Etc. w. What if we want to send an object? n And what if the object contains references to other objects? Guy-Vincent Jourdan : : CSI 3140 : : based on Jeffrey C. Jackson’s slides 48

XML Schema w. XML Schema addresses such questions n Defines a number of simple data types, including Range of allowed values l How values are represented as strings l n Provides facilities for defining data structures in terms of simple types or other data structures w. Can also be used in place of XML DTD Guy-Vincent Jourdan : : CSI 3140 : : based on Jeffrey C. Jackson’s slides 49

XML Schema w. Built-in data types n Built-in type Types corresponding to Java primitive types: boolean, byte, int, double, etc. l String representations much as Java w Exception: can use 0 for false, 1 for true l n No char; use string instead XML DTD types (ID, CDATA, etc. ) Guy-Vincent Jourdan : : CSI 3140 : : based on Jeffrey C. Jackson’s slides 50

XML Schema w. Built-in data types n n n integer and decimal (arbitrary precision) dates, times, and related subtypes URLs XML namespace qualified names binary data some restricted forms of the above, e. g. , non. Negative. Integer Guy-Vincent Jourdan : : CSI 3140 : : based on Jeffrey C. Jackson’s slides 51

XML Schema w. XML Schema namespace defining built-in types is called the document namespace n Standard prefix for this namespace is xsd Guy-Vincent Jourdan : : CSI 3140 : : based on Jeffrey C. Jackson’s slides 52

XML Schema w. Plus Java primitive types (int, etc. ) Guy-Vincent Jourdan : : CSI 3140 : : based on Jeffrey C. Jackson’s slides 53

XML Schema w. Mapping from XML Schema data types to Java: n n n Primitives: one-for-one mapping date, time, date. Time: map to Calendar most others: map to String Guy-Vincent Jourdan : : CSI 3140 : : based on Jeffrey C. Jackson’s slides 54

XML Schema w. Elements in the document namespace can declare user-defined data types w Two XML Schema data types: n n Complex: requires markup to represent within an XML document Simple: can be represented as character data Guy-Vincent Jourdan : : CSI 3140 : : based on Jeffrey C. Jackson’s slides 55

XML Schema w. User-defined data types are declared in the types element of a WSDL n Example: Exchange. Value w. In WSDL, user-defined types can be used n n To define other data types within types element To specify data types of parameters and return values in message elements Guy-Vincent Jourdan : : CSI 3140 : : based on Jeffrey C. Jackson’s slides 56

XML Schema Guy-Vincent Jourdan : : CSI 3140 : : based on Jeffrey C. Jackson’s slides 57

XML Schema w. An XML schema is markup that n n Is written according to the XML Schema vocabulary Defines an XML vocabulary w. A schema document is an XML document consisting entirely of an XML schema w. A document conforming with an XML schema vocabulary is call an instance of the schema Guy-Vincent Jourdan : : CSI 3140 : : based on Jeffrey C. Jackson’s slides 58

XML Schema w. Root element of the markup of an XML schema is schema w. Define data types with elements: n n complex. Type simple. Type w. An XML schema can also define other vocabulary aspects (allowed elements, element content) that we won’t cover Guy-Vincent Jourdan : : CSI 3140 : : based on Jeffrey C. Jackson’s slides 59

XML Schema w. One way to define simple types: restrict an existing simple base type Base type Guy-Vincent Jourdan : : CSI 3140 : : based on Jeffrey C. Jackson’s slides 60

XML Schema w Built-in types all have facets, that is, aspects that can be restricted n n enumeration is a facet that applies to all built-in types except boolean length, min. Length, max. Length apply to stringlike types (e. g. , string, QName, any. URI) min. Inclusive, max. Inclusive, min. Exclusive, max. Exclusive apply to numeric and time-oriented types total. Digits, fraction. Digits apply to numeric types Guy-Vincent Jourdan : : CSI 3140 : : based on Jeffrey C. Jackson’s slides 61

XML Schema w. Restricting multiple facets: Guy-Vincent Jourdan : : CSI 3140 : : based on Jeffrey C. Jackson’s slides 62

XML Schema wpattern facet n n applies to most types (except a few DTD) specifies regular expression Guy-Vincent Jourdan : : CSI 3140 : : based on Jeffrey C. Jackson’s slides 63

XML Schema w. Other simple types n Union: combine two or more types n Lists of values of simple type Guy-Vincent Jourdan : : CSI 3140 : : based on Jeffrey C. Jackson’s slides 64

XML Schema w. Complex type n Defined in an XML schema n Used in an instance document Guy-Vincent Jourdan : : CSI 3140 : : based on Jeffrey C. Jackson’s slides 65

XML Schema w. Complex type can be used in placed of XML DTD content specification n sequence element is equivalent to , operator in DTD Guy-Vincent Jourdan : : CSI 3140 : : based on Jeffrey C. Jackson’s slides 66

XML Schema Guy-Vincent Jourdan : : CSI 3140 : : based on Jeffrey C. Jackson’s slides 67

XML Schema w. Instance namespace n Normally associated with prefix xsi w. Used within instance documents to n define null-valued elements n define data types Guy-Vincent Jourdan : : CSI 3140 : : based on Jeffrey C. Jackson’s slides 68

SOAP Guy-Vincent Jourdan : : CSI 3140 : : based on Jeffrey C. Jackson’s slides 69

SOAP Guy-Vincent Jourdan : : CSI 3140 : : based on Jeffrey C. Jackson’s slides 70

SOAP w. Alternate form Guy-Vincent Jourdan : : CSI 3140 : : based on Jeffrey C. Jackson’s slides 71

SOAP w. SOAP encoding of arrays in WSDL Guy-Vincent Jourdan : : CSI 3140 : : based on Jeffrey C. Jackson’s slides 72

SOAP w. Array in SOAP document Guy-Vincent Jourdan : : CSI 3140 : : based on Jeffrey C. Jackson’s slides 73

SOAP w. If SOAP is sent via HTTP, request must include SOAPAction header field n n Either empty or a URI Can be used to pass operation rather than embedding in body of message Guy-Vincent Jourdan : : CSI 3140 : : based on Jeffrey C. Jackson’s slides 74

Web Services Technologies w. Other implementation of JAX-RPC and/or Java-based web services n n Apache Axis IBM Web. Sphere w. Microsoft support for web services: . NET w. PHP also has web services tools Guy-Vincent Jourdan : : CSI 3140 : : based on Jeffrey C. Jackson’s slides 75

Web Services Technologies w. Universal Discovery, Description, and Integration (UDDI) n Technology for creating directories of web services w. Web Services-Interoperability Organization (WS-I) Basic Profile n n Specification of how web services should be used to enhance interoperability Must use XML Schema and literal encoding (rather than SOAP encoding) Guy-Vincent Jourdan : : CSI 3140 : : based on Jeffrey C. Jackson’s slides 76