oracle.soap.transport.http
Class OracleSOAPHTTPConnection

java.lang.Object
  |
  +--oracle.soap.transport.http.OracleSOAPHTTPConnection

All Implemented Interfaces:

OracleSOAPTransport, org.apache.soap.transport.SOAPTransport

public class OracleSOAPHTTPConnection

extends java.lang.Object

implements OracleSOAPTransport

Field Summary

static java.lang.String	ALLOW_USER_INTERACTION property to set user interaction
static java.lang.String	AUTH_TYPE property used for defining http auth type (basic/digest)
static java.lang.String	CIPHERS property used for defining cipher suites used for HTTPS (colon separated list of cipher suites)
static java.lang.String	PASSWORD property used for defining http password
static java.lang.String	PROXY_AUTH_TYPE property used for defining proxy auth type (basic/digest)
static java.lang.String	PROXY_HOST property used for defining proxy host
static java.lang.String	PROXY_PASSWORD property used for defining proxy password
static java.lang.String	PROXY_PORT property used for defining proxy port
static java.lang.String	PROXY_USERNAME property used for defining proxy username
static java.lang.String	STATUS_LINE property used to get HTTP status line from HTTP headers (getHeaders)
static java.lang.String	USERNAME property used for defining http username
static java.lang.String	WALLET_LOCATION property used for defining wallet location used for HTTPS
static java.lang.String	WALLET_PASSWORD property used for defining wallet password used for HTTPS

Constructor Summary

OracleSOAPHTTPConnection()
Default constructor.

OracleSOAPHTTPConnection(java.util.Properties prop)
Constructor that takes Properties as an arg.

Method Summary

void	close() Closes the connection.
void	finalize()
java.util.Hashtable	getHeaders() Return access to headers generated by the protocol.
java.util.Properties	getProperties() Get the connection properties.
java.io.BufferedReader	receive() Return a buffered reader to receive back the response to whatever was sent to whatever.
void	send(java.net.URL sendTo, java.lang.String action, java.util.Hashtable headers, Envelope env, SOAPMappingRegistry smr, int timeout) This method is used to request that an envelope be posted to the given URL.
void	setProperties(java.util.Properties prop) Set the connection properties.

Methods inherited from class java.lang.Object

clone, equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

ALLOW_USER_INTERACTION

public static final java.lang.String ALLOW_USER_INTERACTION

property to set user interaction

STATUS_LINE

public static final java.lang.String STATUS_LINE

property used to get HTTP status line from HTTP headers (getHeaders)

PROXY_HOST

public static final java.lang.String PROXY_HOST

property used for defining proxy host

PROXY_PORT

public static final java.lang.String PROXY_PORT

property used for defining proxy port

PROXY_AUTH_TYPE

public static final java.lang.String PROXY_AUTH_TYPE

property used for defining proxy auth type (basic/digest)

PROXY_USERNAME

public static final java.lang.String PROXY_USERNAME

property used for defining proxy username

PROXY_PASSWORD

public static final java.lang.String PROXY_PASSWORD

property used for defining proxy password

AUTH_TYPE

public static final java.lang.String AUTH_TYPE

property used for defining http auth type (basic/digest)

USERNAME

public static final java.lang.String USERNAME

property used for defining http username

PASSWORD

public static final java.lang.String PASSWORD

property used for defining http password

WALLET_LOCATION

public static final java.lang.String WALLET_LOCATION

property used for defining wallet location used for HTTPS

WALLET_PASSWORD

public static final java.lang.String WALLET_PASSWORD

property used for defining wallet password used for HTTPS

CIPHERS

public static final java.lang.String CIPHERS

property used for defining cipher suites used for HTTPS (colon separated list of cipher suites)

Constructor Detail

OracleSOAPHTTPConnection

public OracleSOAPHTTPConnection()

Default constructor.

OracleSOAPHTTPConnection

public OracleSOAPHTTPConnection(java.util.Properties prop)

Constructor that takes Properties as an arg.

Parameters:

prop - connection properties

Method Detail

setProperties

public void setProperties(java.util.Properties prop)

Set the connection properties.

Specified by:

setProperties in interface OracleSOAPTransport

Parameters:

prop - connection properties

getProperties

public java.util.Properties getProperties()

Get the connection properties.

Specified by:

getProperties in interface OracleSOAPTransport

Returns:

connection properties

send

public void send(java.net.URL sendTo,
                 java.lang.String action,
                 java.util.Hashtable headers,
                 Envelope env,
                 SOAPMappingRegistry smr,
                 int timeout)
          throws SOAPException

This method is used to request that an envelope be posted to the given URL. The response (if any) must be gotten by calling the receive() function. Soap clients should not use this method directly but use org.apache.soap.rpc.Call instead.

Specified by:

send in interface org.apache.soap.transport.SOAPTransport

Parameters:

sendTo - the URL to send the envelope to

action - the SOAPAction header field value

headers - any other header fields to go to as protocol headers

env - the envelope to send

smr - the XML<->Java type mapping registry (passed on)

ctx - the request SOAPContext

Throws:

SOAPException - with appropriate reason code if problem

receive

public java.io.BufferedReader receive()

Return a buffered reader to receive back the response to whatever was sent to whatever. Soap clients should not use this method directly but use org.apache.soap.rpc.Call instead.

Specified by:

receive in interface org.apache.soap.transport.SOAPTransport

Returns:

a reader to read the results from or null if that's not possible.

getHeaders

public java.util.Hashtable getHeaders()

Return access to headers generated by the protocol. Soap clients should not use this method directly but use org.apache.soap.rpc.Call instead.

Specified by:

getHeaders in interface org.apache.soap.transport.SOAPTransport

Returns:

a hashtable containing all the headers

close

public void close()

Closes the connection. Once this method has been called, the BufferedReader returned by receive method may be closed and should not be used. Calling this method will free resources without having the garbage collector run

Specified by:

close in interface OracleSOAPTransport

finalize

public void finalize()
              throws java.lang.Throwable

Overrides:

finalize in class java.lang.Object