org.opensaml.ws.soap.client.http

クラス HttpSOAPClient

java.lang.Object

org.opensaml.ws.soap.client.http.HttpSOAPClient

すべての実装されたインタフェース:

SOAPClient

@ThreadSafe
public class HttpSOAPClient
extends Object
implements SOAPClient

SOAP client that uses HTTP as the underlying transport and POST as the binding. NOTE this client does not provide access to a InTransport or OutTransport. Therefore any SecurityPolicy which operates on these object can not be used with this client.

ネストされたクラスの概要

インタフェースから継承されたネストされたクラス/インタフェース org.opensaml.ws.soap.client.SOAPClient

SOAPClient.SOAPRequestParameters

コンストラクタの概要

コンストラクタ

コンストラクタと説明
HttpSOAPClient(org.apache.commons.httpclient.HttpClient client, ParserPool parser) Constructor.

メソッドの概要

メソッド

修飾子とタイプ	メソッドと説明
protected org.apache.commons.httpclient.methods.PostMethod	createPostMethod(String endpoint, HttpSOAPRequestParameters requestParams, Envelope message) Creates the post method used to send the SOAP request.
protected org.apache.commons.httpclient.methods.RequestEntity	createRequestEntity(Envelope message, Charset charset) Creates the request entity that makes up the POST message body.
protected void	evaluateSecurityPolicy(SOAPMessageContext messageContext) Evaluates the security policy associated with the given message context.
protected void	processFaultResponse(org.apache.commons.httpclient.methods.PostMethod httpMethod, SOAPMessageContext messageContext) Processes a SOAP fault, as determined by an HTTP 500 status code, response.
protected void	processSuccessfulResponse(org.apache.commons.httpclient.methods.PostMethod httpMethod, SOAPMessageContext messageContext) Processes a successful, as determined by an HTTP 200 status code, response.
void	send(String endpoint, SOAPMessageContext messageContext) Sends a message and waits for a response.
protected Envelope	unmarshallResponse(InputStream responseStream) Unmarshalls the incoming response from a POST request.

クラスから継承されたメソッド java.lang.Object

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

コンストラクタの詳細

HttpSOAPClient

public HttpSOAPClient(org.apache.commons.httpclient.HttpClient client,
              ParserPool parser)

Constructor.

パラメータ:

client - Client used to make outbound HTTP requests. This client SHOULD employ a MultiThreadedHttpConnectionManager and may be shared with other objects.

parser - pool of XML parsers used to parse incoming responses

メソッドの詳細

send

public void send(String endpoint,
        SOAPMessageContext messageContext)
          throws SOAPException,
                 SecurityException

Sends a message and waits for a response.

定義:

send インタフェース内 SOAPClient

パラメータ:

endpoint - the endpoint to which to send the message

messageContext - the message context containing the outbound SOAP message

例外:

SOAPClientException - thrown if there is a problem sending the message or receiving the response or if the response is a SOAP fault

SecurityException - thrown if the response does not meet any security policy associated with the message context

SOAPException

createPostMethod

protected org.apache.commons.httpclient.methods.PostMethod createPostMethod(String endpoint,
                                                                HttpSOAPRequestParameters requestParams,
                                                                Envelope message)
                                                                     throws SOAPClientException

Creates the post method used to send the SOAP request.

パラメータ:

endpoint - endpoint to which the message is sent

requestParams - HTTP request parameters

message - message to be sent

戻り値:

the post method to be used to send this message

例外:

SOAPClientException - thrown if the message could not be marshalled

createRequestEntity

protected org.apache.commons.httpclient.methods.RequestEntity createRequestEntity(Envelope message,
                                                                      Charset charset)
                                                                           throws SOAPClientException

Creates the request entity that makes up the POST message body.

パラメータ:

message - message to be sent

charset - character set used for the message

戻り値:

request entity that makes up the POST message body

例外:

SOAPClientException - thrown if the message could not be marshalled

processSuccessfulResponse

protected void processSuccessfulResponse(org.apache.commons.httpclient.methods.PostMethod httpMethod,
                             SOAPMessageContext messageContext)
                                  throws SOAPClientException

Processes a successful, as determined by an HTTP 200 status code, response.

パラメータ:

httpMethod - the HTTP method used to send the request and receive the response

messageContext - current messages context

例外:

SOAPClientException - thrown if there is a problem reading the response from the PostMethod

processFaultResponse

protected void processFaultResponse(org.apache.commons.httpclient.methods.PostMethod httpMethod,
                        SOAPMessageContext messageContext)
                             throws SOAPClientException,
                                    SOAPFaultException

Processes a SOAP fault, as determined by an HTTP 500 status code, response.

パラメータ:

httpMethod - the HTTP method used to send the request and receive the response

messageContext - current messages context

例外:

SOAPClientException - thrown if the response can not be read from the PostMethod

SOAPFaultException - an exception containing the SOAP fault

unmarshallResponse

protected Envelope unmarshallResponse(InputStream responseStream)
                               throws SOAPClientException

Unmarshalls the incoming response from a POST request.

パラメータ:

responseStream - input stream bearing the response

戻り値:

the response

例外:

SOAPClientException - thrown if the incoming response can not be unmarshalled into an Envelope

evaluateSecurityPolicy

protected void evaluateSecurityPolicy(SOAPMessageContext messageContext)
                               throws SOAPClientException

Evaluates the security policy associated with the given message context. If no policy resolver is registered or no policy is located during the resolution process then no policy is evaluated. Note that neither the inbound or outbound message transport is available.

パラメータ:

messageContext - current message context

例外:

SOAPClientException - thrown if there is a problem resolving or evaluating a security policy