com.whitestein.lsps.engine

Class WebServiceCaller

java.lang.Object

com.whitestein.lsps.engine.WebServiceCaller

public class WebServiceCaller
extends Object

Calls a web service. This class should be overridden in case that application need some specific behavior related to http authentication, http headers, response processing, error processing, etc.

Author:

bhl

Constructor Summary

Constructors

Constructor and Description
WebServiceCaller()

Method Summary

Modifier and Type	Method and Description
protected WsResponseObject	executeMethod(org.apache.http.client.methods.HttpPost method, org.apache.http.client.protocol.HttpClientContext context, SSLContext sslContext) executes the given method using provided http client.
protected org.apache.http.client.methods.HttpPost	getMethodToExecute(WsRequestObject request) Creates method to be execute for webservice call.
protected Map<String,String>	getResponseHeadersMap(org.apache.http.HttpResponse response)
WsResponseObject	performCall(WsRequestObject request) Performs a web service call.
protected WsResponseObject	processError(Exception error) Process error which occured during the webservice call.
protected org.apache.http.client.protocol.HttpClientContext	setupAuthentication(org.apache.http.client.methods.HttpPost method, WsRequestObject request) Setup authentication for the given method and http client.

Methods inherited from class java.lang.Object

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

Constructor Detail

WebServiceCaller

public WebServiceCaller()

Method Detail

getMethodToExecute

protected org.apache.http.client.methods.HttpPost getMethodToExecute(WsRequestObject request)
                                                              throws UnsupportedEncodingException

Creates method to be execute for webservice call. Sets the request entity with correct encoding, sets soap action http header and sets request http headers specified in request

Parameters:

request -

Returns:

created method

Throws:

UnsupportedEncodingException

executeMethod

protected WsResponseObject executeMethod(org.apache.http.client.methods.HttpPost method,
                                         org.apache.http.client.protocol.HttpClientContext context,
                                         SSLContext sslContext)
                                  throws IOException

executes the given method using provided http client. After the execution, the check of the response content type is performed.

Parameters:

method -

context -

sslContext -

Returns:

wsResponse;

Throws:

IOException

IllegalArgumentException - if the response content type is not "text/xml"

setupAuthentication

protected org.apache.http.client.protocol.HttpClientContext setupAuthentication(org.apache.http.client.methods.HttpPost method,
                                                                                WsRequestObject request)

Setup authentication for the given method and http client. This method should be overriden if any custom authentication behaviour is needed.

Parameters:

method -

request -

Returns:

HttpClientContext

performCall

public WsResponseObject performCall(WsRequestObject request)

Performs a web service call.

Parameters:

request -

Returns:

response object

processError

protected WsResponseObject processError(Exception error)

Process error which occured during the webservice call.

Parameters:

error -

Returns:

response object that contains information about the error

getResponseHeadersMap

protected Map<String,String> getResponseHeadersMap(org.apache.http.HttpResponse response)

Parameters:

response -

Returns:

map containing all response http headers