OCT1 Understanding SOAP Homework 3 Demos SOAP in the UDDI framework An example database query Web Service Homework

OCT 1

Understanding SOAP

• Homework 3 Demos• SOAP in the UDDI framework• An example database query Web Service • Homework

OCT 2

.NET Web Services

Web Service

Browser

Browser

Test and Learn

WSDL = Web Services Description Language

WSDL.EXE Proxy code to handlecommunications and marshalling Of parameters

OCT 3

Java (Apache Axis) Web Services

Web Service

Browser

Browser

Test and Learn

WSDL = Web Services Description Language

wsdl2java Proxy code to handlecommunications and marshalling of parameters

OCT 4

Universal Description, Discovery and Integration (UDDI) Overview

Service Provider

WSDL Description of

serviceSOAP Service

UDDI Registry

WSDL Description of

service

SOAP clientService Client

SOAP Document

This slide adapted fromPage 353 of “Java and XML”By McLaughlin

Codes

Searches forGenerates

Interacts with

Registers

Authors Codes

Finds

HPIBMMicrosoft

OCT 5

Today’s TopicService Provider

WSDL Description of

serviceSOAP Service

UDDI Registry

WSDL Description of

service

SOAP clientService Client

SOAP Document

This slide adapted fromPage 353 of “Java and XML”By McLaughlin

Codes

Searches forGenerates

Interacts with

Registers

Authors Codes

Finds

HPIBMMicrosoft

OCT 6

XML OVER HTTP(Understanding SOAP)

We’ll look at a client that communicates with an HTTP serverby using XML.

This example is from an article entitled “XML ThroughThe Wall” by Daniel Nehren. It appears in the April/May 2001 edition of XML Magazine. The code is availableonline at www.xmlmag.com (XM0102DN).

http://www.xmlmag.com/

OCT 7

DBServiceClient

• built with a URL• will accept sql statements• will return result sets• makes use of HTTPServiceClient• makes use of DBServiceRequest

HTTPServiceClient

• knows about HTTP• works with generic requests• knows how to handle sockets and URL’s• returns generic responses

HTTPServiceHandler

• Generic methods needed by all specific handlers• Knows HTTP • Knows about generic responses

DBHandler• Knows how to handle database queries, resultsets, and database responses

Servlet• Takes a generic request• Examines request type• Dynamically loads appropriate handler

OCT 8

Request and Response Messages

Request Document

Response Document

OCT 9

package httpservice; // DBServiceClient.java

public class DBServiceClient{

private Vector resultSet; private String serviceURL;

public static void main(String[] args) { String serviceURL = "http://localhost:8080/servlet/httpservice.HttpService";

// Request a service// from a servlet.// In this case the service// is a database query.

// Hold the retrieved ResultSet// in a Vector of Vectors.

OCT 10

try { DBServiceClient serviceClient = new DBServiceClient(serviceURL); serviceClient.executeSQLStatement("SELECT * FROM TABLE"); System.out.println(serviceClient.getResultSet()); } catch(Exception ex) { System.out.println("something went wrong: " + ex.getMessage()); ex.printStackTrace(System.err); } } public DBServiceClient(String serviceURL) { this.serviceURL = serviceURL; } public Vector getResultSet() { return resultSet; }

// Create the DBService// Client with a URL.// Give it the SQL// and tell it to execute.// Ask for its result set.

OCT 11

public void executeSQLStatement(String statement) throws Exception {

HttpServiceClient client = new HttpServiceClient(serviceURL); DBServiceRequest request = new DBServiceRequest(); request.setSqlStatement(statement); DBServiceResponse response = new DBServiceResponse(client.executeRequest(request));

resultSet = response.getResultSet();

} }

// The DBServiceClient passes a// DBServiceRequest to an// HtpServiceClient.

OCT 12

/** HTTPServiceClient.java * Title: * Description: * Copyright: Copyright (c) Daniel Nehren * Company: Openport Technology Inc. * @author Daniel Nehren * @version 1.0 */package httpservice;import java.net.*;import java.util.*;import java.io.*;import org.w3c.dom.*;import org.apache.xerces.parsers.DOMParser;import org.apache.xerces.*;import org.xml.sax.InputSource;

OCT 13

// This class encapsulates all the interaction with an HttpService public class HttpServiceClient{ private static final String HTTP_VERSION = "1.0"; private static final String HTTP_POST_REQUEST = "POST"; private static final String HEADER_HOST = "Host"; private static final String HEADER_CONTENT_TYPE = "Content-Type"; private static final String XML_MIME_TYPE = "text/xml"; private static final String HEADER_CONTENT_LENGTH = "Content-Length"; private static final int DEFAULT_PORT = 80;

OCT 14

private String serviceUrl; // URL of server private int returnCode; // From server private String returnMessage; // From server private Reader responsePayload; // From server

public HttpServiceClient( String serviceUrl) { this.serviceUrl = serviceUrl; }

public ServiceResponse executeRequest(ServiceRequest request) throws HttpServiceException { try

//executeRequest takes//a ServiceRequest. A DBService//Request “is a” ServiceRequest.//It returns a ServiceResponse.

OCT 15

{ // Take the request from the ServiceRequest object String data = request.serializeRequestToString("utf-8"); // Send HTTP headers and the request to the servlet. // The HTTP headers are transmitted within postRequest(). // The XML request is inside ‘data’. postRequest(data);

// postRequest sets the member ResponsePayload Reader that is // pointing to the server’s payload

//check for failures if(returnCode != 200) throw new HttpServiceException(returnMessage);

OCT 16

//Build a DOM tree around the responsePayload ReaderInputSource source = new InputSource(responsePayload);DOMParser parser = new DOMParser();parser.parse(source);

// At this point we have DOM tree representing the response// We want to give this tree some methods…ServiceResponse serviceResponse = new ServiceResponse(parser.getDocument());

// We can look at the response tree as a StringString theResponse = serviceResponse.serializeResponseToString("utf-8");

System.out.println(theResponse);return serviceResponse;}

Even though this responseis a DBServiceResponse,here we treat it as a ServiceResponse.

OCT 17

catch(Exception ex){ ex.printStackTrace(System.err); throw new HttpServiceException(ex.getMessage()); }}

// Send the request to the servletprivate void postRequest(String payload) throws HttpServiceException { PrintWriter out = null; BufferedReader in = null; URL url = null;

OCT 18

try { // Establish URL and port url = new URL(serviceUrl); int port = url.getPort () < 0 ? DEFAULT_PORT : url.getPort(); // Establish a socket Socket soket = new Socket (url.getHost (), port); out = new PrintWriter (soket.getOutputStream ()); in = new BufferedReader ( new InputStreamReader (soket.getInputStream ())); } // The handle in is a Reader pointing to the server’s // HTTP response

OCT 19

catch (Exception ex) { throw new HttpServiceException ("error opening socket: " + ex.getMessage ());}out.print (HTTP_POST_REQUEST + " " + url.getFile() + " HTTP/" + HTTP_VERSION + "\r\n");out.print (HEADER_HOST + ": " + url.getHost () + ':' + url.getPort () + "\r\n");out.print (HEADER_CONTENT_TYPE + ": " + XML_MIME_TYPE + "\r\n");out.print (HEADER_CONTENT_LENGTH + ": “ + payload.length () + "\r\n");out.print ("\r\n");out.print (payload);out.print ("\r\n\r\n");out.flush ();

// Send HTTP headers followed// by payload to the socket.// The payload is a serialized// request object.

OCT 20

// Look for the response from the servlet

try // First, look at the status line { String statusLine = in.readLine(); System.out.println(statusLine); parseStatusLine(statusLine); // Sets members returnCode } // and returnMessage catch (Exception ex) { throw new HttpServiceException ( "error parsing HTTP status line: " + ex.getMessage ()); }

// The Reader in now points past the HTTP status line

OCT 21

// Skip all headers till we get our payload try { String headerLine = null; while ((headerLine = in.readLine ()) != null) { System.out.println(headerLine); if (headerLine.length () == 0) break; } } // The Reader is now pointing at XML catch (Exception ex) { throw new HttpServiceException ( "error reading HTTP headers: " +ex.getMessage ()); }

OCT 22

//what remains of the input Stream is our payload // Assign in to the responsePayload member responsePayload = in; } // End of PostRequest method // responsePayload is a Reader and we can pass a // Reader to an InputSource

OCT 23

private void parseStatusLine(String statusLine) throws Exception { StringTokenizer st = new StringTokenizer (statusLine); st.nextToken ();

returnCode = Integer.parseInt (st.nextToken ()); StringBuffer retMessage = new StringBuffer ();

// We have an HTTP status line as input. Use this routine// to capture the return code and the return message.

OCT 24

while (st.hasMoreTokens ()) // Read the status line { retMessage.append (st.nextToken ()); if (st.hasMoreTokens ()) { retMessage.append (" "); } } returnMessage = retMessage.toString (); }

}

OCT 25

The ServiceRequest Object Holds a Tree

What does the tree look like?

http-request requestType request

text node application specific may be a text node or a full subtree representing a complex request

OCT 26

The DBServiceRequest Object Holds a Tree


http-request requestType request

text node sql-statement text node containing the sql statment

A DBServiceRequest “is a” ServiceRequest…

OCT 27

The ServiceResponse Object Holds a Tree


http-response responseMessage responseCode response

text node Text Node Application specific Application response. specific It might be a text node or a complex tree.

OCT 28

The DBServiceResponse Object Holds a Tree


http-response responseMessage responseCode response

text node Text Node Application specific

Result-set

Result-count row row

col name=“colname” col name = “another”

aValue aValue

A DBServiceResponse “is a”ServiceResponse

OCT 29

We can assign an XML tree useful methods by wrapping it ina class. Object

Application specific methods Internal statemanipulated with the DOM API

OCT 30

/** ServiceRequest.java * Title: * Description: * Copyright: Copyright (c) Daniel Nehren * Company: Openport Technology Inc. * @author Daniel Nehren * @version 1.0 */package httpservice;

import java.io.*;import org.w3c.dom.*;import org.apache.xerces.dom.*;import org.apache.xml.serialize.*;

OCT 31

/* Class ServiceRequest.java identifies the XML requests Here is an example for a correct XML request:

<http-request> <requestType>[type of request. a Text Node]</requestType> <request> [ application specific, can be anElement or a text Node ] </request> </http-request> The requestType will be a String from which we can recover the Handler class ex: requestType='DataBaseService' -> class=[package].DataBaseServiceHandler.class More on this later when we look on the server side. */ // We’ll have methods to expose the tree in a convenient way.

OCT 32

public class ServiceRequest{ public final static String REQUEST_TYPE_TAG_NAME = "requestType"; public final static String REQUEST_TAG_NAME = "request"; public final static String ROOT_TAG_NAME = "http-request";

// Define some constants to label a request tree.

OCT 33

// We need a handle to the tree protected Document dom;

// Create with an existing Document public ServiceRequest(Document request) { dom = request; } // Or, create an empty request tree (with labels) public ServiceRequest() { dom = new DocumentImpl(); // Get an empty Document initializeRequest(); // Add labels }

OCT 34

//initializes an empty request private void initializeRequest() { Element root = dom.createElement(ROOT_TAG_NAME); dom.appendChild(root);

Element eRequestType = dom.createElement( REQUEST_TYPE_TAG_NAME); eRequestType.appendChild(dom.createTextNode(""));

root.appendChild(eRequestType);

Element eRequest = dom.createElement( REQUEST_TAG_NAME); root.appendChild(eRequest); }

OCT 35

public String getRequestType() throws HttpServiceException{ try { return getTextAttribute(REQUEST_TYPE_TAG_NAME); } catch(Exception ex) { ex.printStackTrace(System.err); throw new HttpServiceException("Invalid Request Format."); }

}

//We want some convenient, application specific ways to access//the tree…

OCT 36

public void setRequestType(String requestType) throws HttpServiceException { try { setTextAttribute(REQUEST_TYPE_TAG_NAME, requestType); } catch(Exception ex) { ex.printStackTrace(System.err); throw new HttpServiceException("Invalid Request Format."); }

}

// And make changes to the tree…

OCT 37

public Node getRequest() throws HttpServiceException { try { Node request = ((NodeList)dom.getElementsByTagName( REQUEST_TAG_NAME)).item(0); return request.getFirstChild().cloneNode(true); } catch(Exception ex) { ex.printStackTrace(System.err); throw new HttpServiceException("Invalid Request Format."); } }

//Someone might need a copy of the request. Which might be//a large tree itself so we set deep = true…

OCT 38

public Element createElementNode(String elementName) { return dom.createElement(elementName); }

public Text createTextNode(String value) { return dom.createTextNode(value); }

// Allow users to create their own elements and text nodes…

OCT 39

// Allow users to pass us a request tree (or replace an old one)…public void setRequest(Node request) throws HttpServiceException { try { Node requestElement = ((NodeList)dom.getElementsByTagName( REQUEST_TAG_NAME)).item(0); Node oldRequest = requestElement.getFirstChild(); if(oldRequest != null) requestElement.removeChild(oldRequest); requestElement.appendChild(request); } catch(Exception ex) { ex.printStackTrace(System.err); throw new HttpServiceException("Invalid Request Format."); } }

OCT 40

// Provide a collapsed view of the tree that anyone can read… public byte[] serializeRequestToByteArray(String encoding) throws HttpServiceException { try { return serializeDOM(encoding).toByteArray(); } catch(Exception ex) { ex.printStackTrace(System.err); throw new HttpServiceException("Error during serialization"); } }

OCT 41

// Provide a collapsed view as a Java Stringpublic String serializeRequestToString(String encoding) throws HttpServiceException { try { return serializeDOM(encoding).toString(); } catch(Exception ex) { ex.printStackTrace(System.err); throw new HttpServiceException("Error during serialization"); } }

OCT 42

private ByteArrayOutputStream serializeDOM(String encoding) throws HttpServiceException { try { ByteArrayOutputStream bytes = new ByteArrayOutputStream (4096) ; PrintWriter out = new PrintWriter ( new OutputStreamWriter (bytes,encoding), true) ; OutputFormat of = new OutputFormat(dom,encoding,true); XMLSerializer serializer = new XMLSerializer(out,of); serializer.serialize(dom); out.close(); return bytes; }

// A private utility routine that handles serialization issues

OCT 43

catch(Exception ex) { ex.printStackTrace(System.err); throw new HttpServiceException("Error during serialization"); } }

OCT 44

// Given the tag name return the text underneathprotected String getTextAttribute(String name) { Node textAttributeNode = ((NodeList)dom.getElementsByTagName(name)).item(0); Node textAttribute = textAttributeNode.getFirstChild(); if(textAttribute.getNodeType() == Node.TEXT_NODE) return textAttribute.getNodeValue(); else return null; }

OCT 45

protected void setTextAttribute(String name, String value) { if (value == null) value =""; Node textAttributeNode = ((NodeList)dom.getElementsByTagName(name)).item(0); Node textAttribute = textAttributeNode.getFirstChild(); textAttribute.setNodeValue(value);

} // A little test driver public static void main(String args[]) {

System.out.println("Running test");ServiceRequest sr = new ServiceRequest();

}}

// Given the tag name we can set the text underneath

OCT 46

// DBServiceRequest.javapackage httpservice;

import org.w3c.dom.*;

/* * class that extends ServiceRequest to simplify aDBService request * handling * This is a valid DBService request * <slq-statement> * [a Text Node with the Sql Statement] * <slq-statement> */

OCT 47

public class DBServiceRequest extends ServiceRequest{

public final static String SERVICE_NAME = "DBService";

public final static String SQL_STATEMENT_TAG_NAME = "sql-statement";

public DBServiceRequest() // Build the base class tree { // and add some labels super(); initializeParameters(); }

OCT 48

public DBServiceRequest(Document request) { super(request); }

// And for a ServiceRequest Document with a member called dom public DBServiceRequest(ServiceRequest request) { dom = request.dom; }

// Provide constructors

// For any Document

OCT 49

public void setSqlStatement(String sql) { setTextAttribute(SQL_STATEMENT_TAG_NAME,sql); }

// Allow access to the SQL public String getSqlStatement() { return getTextAttribute(SQL_STATEMENT_TAG_NAME); }

// Use a base class method to set this request’s SQL statement

OCT 50

private void initializeParameters() { Element eDBRequest = null; try { setRequestType(SERVICE_NAME); eDBRequest = createElementNode( SQL_STATEMENT_TAG_NAME); } catch(Exception ex) {} eDBRequest.appendChild(dom.createTextNode("")); try { setRequest(eDBRequest); } catch(Exception ex) {} }}

// Add the SQL part of the// tree.

OCT 51

//ServiceResponse.java

package httpservice;import java.io.*;

import org.w3c.dom.*;import org.apache.xerces.dom.*;import org.apache.xml.serialize.*;

// The response from the// server is an XML tree

OCT 52

/* An XML response

<http-response> <responseMessage> [the response Messasge. 'OK' ,'Error' or 'Exception'] </responseMessage>

<responseCode> [an application specific return code. A text Node with a numeric value ] </responseCode>

<response> [ application specific response can be anElement or a text Node ] [ if an Exception or Error it will be a text node with the error message] </response>

</http-response>

OCT 53

public class ServiceResponse{

public final static String RESPONSE_MESSAGE_TAG_NAME = "responseMessage"; public final static String RESPONSE_CODE_TAG_NAME = "responseCode"; public final static String RESPONSE_TAG_NAME = "response"; public final static String ROOT_TAG_NAME = "http-response";

// The tree’s tag names

OCT 54

protected Document dom;

public ServiceResponse(Document response) { dom = response; }

public ServiceResponse() { dom = new DocumentImpl(); initializeResponse(); }

// Same idea as before…

OCT 55

//initializes an empty response private void initializeResponse() { Element root = dom.createElement(ROOT_TAG_NAME); dom.appendChild(root); Element eResponseMessage = dom.createElement( RESPONSE_MESSAGE_TAG_NAME); eResponseMessage.appendChild(dom.createTextNode("")); Element eResponseCode = dom.createElement( RESPONSE_CODE_TAG_NAME); eResponseCode.appendChild(dom.createTextNode("0")); root.appendChild(eResponseMessage); root.appendChild(eResponseCode); Element eResponse = dom.createElement( RESPONSE_TAG_NAME); root.appendChild(eResponse); } Add tags.

OCT 56

public String getResponseMessage() throws HttpServiceException { try { return getTextAttribute( RESPONSE_MESSAGE_TAG_NAME); } catch(Exception ex) { ex.printStackTrace(System.err); throw new HttpServiceException("Invalid Response Format."); }

}

OCT 57

public void setResponseMessage(String responseMessage) throws HttpServiceException

{ try { setTextAttribute(RESPONSE_MESSAGE_TAG_NAME,

responseMessage); } catch(Exception ex) { ex.printStackTrace(System.err); throw new HttpServiceException("Invalid Response Format."); }

}

OCT 58

public int getResponseCode() throws HttpServiceException { try {

Integer value = new Integer(getTextAttribute( RESPONSE_CODE_TAG_NAME)); return value.intValue(); } catch(Exception ex) { ex.printStackTrace(System.err); throw new HttpServiceException("Invalid Response Format."); }

}

OCT 59

public void setResponseCode(int responseCode) throws HttpServiceException { try { setTextAttribute(RESPONSE_CODE_TAG_NAME, String.valueOf(responseCode)); } catch(Exception ex) { ex.printStackTrace(System.err); throw new HttpServiceException("Invalid Response Format."); }

}

OCT 60

public Node getResponse() throws HttpServiceException { try { Node response = ((NodeList)dom.getElementsByTagName( RESPONSE_TAG_NAME)).item(0); return response.getFirstChild().cloneNode(true); } catch(Exception ex) { ex.printStackTrace(System.err); throw new HttpServiceException("Invalid Response Format."); } }

OCT 61

public Element createElementNode(String elementName) { return dom.createElement(elementName); }

public Text createTextNode(String value) { return dom.createTextNode(value); }

OCT 62

public void setResponse(Node response) throws HttpServiceException { try { //just in case they create the element from somewhere else Node reponseElement = ((NodeList)dom.getElementsByTagName( RESPONSE_TAG_NAME)).item(0); Node oldResponse = reponseElement.getFirstChild(); if(oldResponse != null) reponseElement.removeChild(oldResponse); reponseElement.appendChild(response); } catch(Exception ex){ ex.printStackTrace(System.err); throw new HttpServiceException("Invalid Response Format."); } }

OCT 63

public byte[] serializeResponseToByteArray(String encoding) throws HttpServiceException { try { return serializeDOM(encoding).toByteArray(); } catch(Exception ex) { ex.printStackTrace(System.err); throw new HttpServiceException("Error during serialization"); } }

OCT 64

public String serializeResponseToString(String encoding) throws HttpServiceException { try { return serializeDOM(encoding).toString(); } catch(Exception ex) { ex.printStackTrace(System.err); throw new HttpServiceException("Error during serialization"); } }

OCT 65

private ByteArrayOutputStream serializeDOM(String encoding) throws HttpServiceException { try { ByteArrayOutputStream bytes = new ByteArrayOutputStream (4096) ; PrintWriter out = new PrintWriter ( new OutputStreamWriter (bytes,encoding), true) ; OutputFormat of = new OutputFormat(dom,encoding,true); XMLSerializer serializer = new XMLSerializer(out,of); serializer.serialize(dom); out.close(); return bytes; }

OCT 66

catch(Exception ex) { ex.printStackTrace(System.err); throw new HttpServiceException("Error during serialization"); } }

OCT 67

protected String getTextAttribute(String name) { Node textAttributeNode = ((NodeList)dom.getElementsByTagName(name)).item(0); Node textAttribute = textAttributeNode.getFirstChild(); if(textAttribute.getNodeType() == Node.TEXT_NODE) return textAttribute.getNodeValue(); else return null; }

OCT 68

protected void setTextAttribute(String name, String value) { if(value == null) value = ""; Node textAttributeNode = ((NodeList)dom.getElementsByTagName(name)).item(0); Node textAttribute = textAttributeNode.getFirstChild(); textAttribute.setNodeValue(value);

}}

OCT 69

// DBServiceResponse.java

package httpservice;

import java.util.*;import org.w3c.dom.*;

And again, a database response is a particular type of response…

OCT 70

/* A class that extends ServiceRequest to simplify DBService response handling. This is a valid response:

<result-set> <results-count>[number of results] </result-count> <row> <col name='name'> [the row value] </col> </row> ... </result-set>*/

OCT 71

public class DBServiceResponse extends ServiceResponse{

public final static String RESULT_SET_TAG_NAME = "result-set"; public final static String RESULT_COUNT_TAG_NAME = "results-count"; public final static String ROW_TAG_NAME = "row"; public final static String COL_TAG_NAME = "col";

OCT 72

public DBServiceResponse() { super(); initializeParameters(); }

public DBServiceResponse(Document response) { super(response);

} public DBServiceResponse(ServiceResponse response) { dom = response.dom; }

OCT 73

private void initializeParameters() { Element eResultset = dom.createElement( RESULT_SET_TAG_NAME); Element eCount = dom.createElement( RESULT_COUNT_TAG_NAME); eCount.appendChild(dom.createTextNode("-1")); eResultset.appendChild(eCount);

try { setResponse(eResultset); } catch(Exception ex) {} }

Hang nodes off eResultsetand hang that element fromthe response node by callingbase class method.

OCT 74

public int getResultsCount() { String value = getTextAttribute( RESULT_COUNT_TAG_NAME); return new Integer(value).intValue(); }

public void setResultsCount(int count) { setTextAttribute( RESULT_COUNT_TAG_NAME,String.valueOf(count)); }

OCT 75

public void setResultSet(Vector results) {

// point to result-set tag Element eResult = (Element) ((NodeList) dom.getElementsByTagName( RESULT_SET_TAG_NAME)).item(0);

// clean up if there are previous results NodeList prevResult = dom.getElementsByTagName( ROW_TAG_NAME); for(int kk=0; kk< prevResult.getLength(); kk++) { dom.removeChild(prevResult.item(kk)); }

OCT 76

// The column titles are in the first vector Vector columns = (Vector)results.elementAt(0);

// remove titles from vector results.removeElementAt(0);

int cols = columns.size(); int rows = results.size();

Vector row;

columns

results

OCT 77

for(int ii =0; ii < rows; ii++) { row = (Vector) results.elementAt(ii);

Element eRow = dom.createElement(ROW_TAG_NAME); Element eCol; for(int jj=0; jj < cols; jj++) { eCol = dom.createElement(COL_TAG_NAME); eCol.setAttribute("name",(String) columns.elementAt(jj)); eCol.appendChild(dom.createTextNode((String) row.elementAt(jj))); eRow.appendChild(eCol); } eResult.appendChild(eRow); } }

OCT 78

public Vector getResultSet() { NodeList rows = dom.getElementsByTagName( ROW_TAG_NAME); Vector results = new Vector(); int numRows = rows.getLength(); if( numRows == 0) return results;

results.addElement(getColumns(rows.item(0))); for(int ii = 0; ii < numRows; ii++) { results.addElement(getRowValues(rows.item(ii))); } return results; }

OCT 79

private Vector getColumns(Node row) { Vector columns = new Vector(); NodeList cols = row.getChildNodes(); for(int ii =0; ii < cols.getLength();ii++) { if(cols.item(ii).getNodeType() == Node.ELEMENT_NODE) { Element eCol = (Element) cols.item(ii); columns.addElement(eCol.getAttribute("name")); } }

return columns; }

OCT 80

private Vector getRowValues(Node nRow) { Vector row = new Vector(); NodeList vals = nRow.getChildNodes(); for(int ii =0; ii < vals.getLength(); ii++) { if(vals.item(ii).getNodeType() == Node.ELEMENT_NODE) { Element eCol = (Element) vals.item(ii); if(eCol.hasChildNodes()) row.addElement(eCol.getFirstChild().getNodeValue()); else row.addElement(""); } } return row; }}

OCT 81

// HTTPService.java


import javax.servlet.*;import javax.servlet.http.*;import java.io.*;import java.util.*;

import org.w3c.dom.*;import org.apache.xerces.parsers.DOMParser;import org.apache.xerces.*;import org.xml.sax.InputSource;

// A servlet to handle requests

OCT 82

public class HttpService extends HttpServlet{ private final static String PACKAGE_NAME = "httpservice";

public void init(ServletConfig config) throws ServletException { super.init(config); } public void doGet(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException { throw new ServletException( "This application only responds to a POST request"); }

OCT 83

public void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException { try {

// get the XML payload and parse it into a Document Document dom; DOMParser parser = new DOMParser(); InputSource input = new InputSource(request.getInputStream()); parser.parse(input); dom = parser.getDocument(); // we have DOM Tree but we don’t know the request type

OCT 84

ServiceRequest serviceRequest = new ServiceRequest(dom); String requestType = serviceRequest.getRequestType(); // The handler is chosen at runtime… Class handlerClass = Class.forName( PACKAGE_NAME + "." + requestType + "Handler");

HttpServiceHandler handler = (HttpServiceHandler) handlerClass.newInstance(); handler.setup(request,response); handler.handleRequest(serviceRequest);

// Build the serviceRequest Object

OCT 85

} catch(Exception ex) { ex.printStackTrace(); throw new ServletException(ex); }

} /**Clean up resources*/ public void destroy() { }}

OCT 86

// HttpServiceHandler


import javax.servlet.*;import javax.servlet.http.*;import java.io.*;import java.util.*;

import org.w3c.dom.*;

/** * This is the abstract base class for all Service Handler classes. * The only abstract method is processRequest. * The HttpService will call setup and then handleRequest. * handle request will call the process request method */

OCT 87

public abstract class HttpServiceHandler{

protected HttpServletRequest req; protected HttpServletResponse res;

public HttpServiceHandler() { }

public void setup(HttpServletRequest request, HttpServletResponse response) { req = request; res = response; }

OCT 88

// All our services will send this responsepublic void sendResponse(ServiceResponse response) throws HttpServiceException { try { res.setContentType("text/xml"); byte[] data = response.serializeResponseToByteArray("utf-8"); res.setContentLength(data.length); res.getOutputStream().write(data); } catch(Exception ex) { ex.printStackTrace(System.err); throw new HttpServiceException(ex.getMessage()); } }

The service handlerpasses this in.This is the HttpServletResponse object

Serialized Response object.

OCT 89

public void handleRequest(ServiceRequest request) throws HttpServiceException { // call the specific handler’s method and then call sendResponse sendResponse(processRequest(request)); }

// This method needs to be completed by the specific handler protected abstract ServiceResponse processRequest( ServiceRequest request) throws HttpServiceException;

}

OCT 90

package httpservice; // DBServiceHandler.java

import java.util.*;import java.sql.*;

public class DBServiceHandler extends HttpServiceHandler{ public ServiceResponse processRequest(ServiceRequest req) throws HttpServiceException { DBServiceRequest request = new DBServiceRequest(req);

String sql = request.getSqlStatement(); DBServiceResponse response = new DBServiceResponse(); Connection connection;

response.setResponseCode(200); response.setResponseMessage("OK");

OCT 91

Vector resultSet = new Vector(); Vector row = new Vector(); row.add("Col1"); row.add("Col2"); row.add("Col3"); resultSet.add(row);

row = new Vector(); row.add("Val11"); row.add("Val12"); row.add("Val13"); resultSet.add(row);

For demonstration only.Oracle database exampleProvided below.

Database result set accessed now.

OCT 92



response.setResultSet(resultSet); response.setResultsCount(3);

return response;

Now pass the Vector thatcontains the result set to theresponse document.

Return a ServiceResponsedocument.

OCT 93

/* Connect to Oracle try { Class.forName("oracle.jdbc.driver.OracleDriver"); String connectionString = "jdbc:oracle:thin:@fender.openport.com:1521:iplp"; connection = DriverManager.getConnection ( connectionString ,"op1","op1");

}

OCT 94

catch(ClassNotFoundException ex) { ex.printStackTrace(System.err); response.setResponseCode(400); response.setResponseMessage("Oracle driver not found"); return response; } catch(SQLException ex2) { ex2.printStackTrace(System.err); response.setResponseCode(400); response.setResponseMessage("Could Not Connect “ + “To Database!"); return response; }

OCT 95

String theSql = sql.trim().toUpperCase(); ResultSet resultSet;

try { Statement statement = connection.createStatement(); if(theSql.startsWith("SELECT")) { resultSet = statement.executeQuery(theSql); Vector theResults = parseResultSet(resultSet); response.setResultsCount(theResults.size() - 1); response.setResultSet(theResults); } else { statement.executeUpdate(theSql); response.setResultsCount(-1); response.setResultSet(new Vector()); } }

Do a queryand get a resultset. Parse the resultset to a Vector.

OCT 96

catch(SQLException ex) { response.setResponseCode(400); response.setResponseMessage(ex.getMessage()); return response; }

response.setResponseCode(200); response.setResponseMessage("OK");

String res = response.serializeResponseToString("utf-8"); System.out.println(res);

return response; */ }

OCT 97

private Vector parseResultSet(ResultSet resultSet) throws SQLException { Vector results = new Vector(); ResultSetMetaData metaData = resultSet.getMetaData(); int count = metaData.getColumnCount(); int ii; Vector row = new Vector(count);

for(ii= 0; ii < count; ii++) { row.addElement(metaData.getColumnName(ii + 1)); }

OCT 98

results.addElement(row); String value; while(resultSet.next()) { row = new Vector(count); for(ii =0; ii < count; ii++) { value = resultSet.getString(ii + 1); row.addElement(value == null ? "":value); } results.addElement(row); } return results; }}

OCT 99

Homework

• Carefully trace the construction of a DBServiceRequest object.

• Carefully trace the construction of a DBServiceResponse object.

• We have looked at a system that provides SQL services. Specifically, what steps would we need to complete to add additional services to this system?

Documents

OCT1 Understanding SOAP Homework 3 Demos SOAP in the UDDI framework An example database query Web Service Homework