21
Package oracle.soap.util.xml

This chapter documents package package oracle.soap.util.xml. This package contains the classes that provide support for Oracle SOAP in the XDK for Java.

Oracle SOAP is an implementation of the Simple Object Access Protocol. Oracle SOAP is based on the SOAP open source implementation developed by the Apache Software Foundation.

This chapter contains these sections:

• Package oracle.soap.util.xml Description
• Package oracle.soap.util.xml Summary
• Class XmlUtils

---

Package oracle.soap.util.xml Description

The Simple Object Access Protocol (SOAP) is a transport protocol for sending and receiving requests and responses across the Internet. It is based on XML and HTTP. Oracle SOAP is based on the SOAP open source implementation developed by the Apache Software Foundation.

SOAP is transport protocol-independent and operating system-independent. It provides the standard XML message format for all applications. SOAP uses the XML Schema standard of the World Wide Web Consortium (W3C).

Package oracle.soap.util.xml contains class XmlUtils, which implements the API for SOAP clients to generate the XML documents that compose a request for a SOAP service and handle the SOAP response. Oracle SOAP processes requests from any client that sends a valid SOAP request.

---

Package oracle.soap.util.xml Summary

Package oracle.soap.util.xml contains class oracle.soap.util.xml.OracleSOAPHTTPConnection, which implements Oracle- specific transport extensions in OracleSOAPTransport.

Table 21-1  Members in class Class XmlUtils

Member	Description
Constructor	--
XmlUtils	Default constructor.
Methods	--
extractServiceId	Get the service id from the envelope.
extractMethodName	Get the method name from the envelope.
parseXml(String)	Parse the given XML file and return the XML document.
parseXml(Reader)	Parse the given XML source and return the XML document
parseXml(InputStream)	Parse the contents of the XML InputStream and return the XML document
createDocument	Create a Document.

---

Class XmlUtils

Class oracle.soap.util.xml.XmlUtils

java.lang.Object
   |
   +----oracle.soap.util.xml.XmlUtils

public class XmlUtils

Extends Object.

---

Constructors

XmlUtils

public XmlUtils()

Default constructor.

---

Methods

extractServiceId

public static String extractServiceId(Envelope envelope) throws SOAPException

Get the service id from the envelope. It is the namespace URI of the first body entry.

Throws

SOAPException if unable to get service URI from envelope.

extractMethodName

public static String extractMethodName(Envelope envelope) throws SOAPException

Get the method name from the envelope. It is the name of the first body entry.

Throws

SOAPException if unable to get method name from envelope.

parseXml

public static Document parseXml(String filename)
                          throws SOAPException

Parse the given XML file and return the XML document.

Parameters

filename - The full path to the XML file.

Throws

SOAPException if file not found or parse error.

parseXml

public static Document parseXml(Reader reader)
                           throws SOAPException

Parse the given XML source and return the XML document.

Parameters

reader - Reader for XML.

Throws

SOAPException if file not found or parse error.

parseXml

public static Document parseXml(InputStream is)
                           throws SOAPException

Parse the contents of the XML InputStream and return the XML document.

Parameters

is - input stream source

Throws

SOAPException if there are parse errors or IO errors.

createDocument

public static Document createDocument()
                         throws SOAPException

Create a Document.

Throws

SOAPException if cannot create Document.