com.google.api.ads.common.lib.soap.jaxws

Class JaxWsHandler

java.lang.Object

com.google.api.ads.common.lib.soap.SoapClientHandler<BindingProvider>

com.google.api.ads.common.lib.soap.jaxws.JaxWsHandler

All Implemented Interfaces:

SoapClientHandlerInterface<BindingProvider>

public class JaxWsHandler
extends SoapClientHandler<BindingProvider>

SOAP Client Handler implementation for use with JAX-WS.

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	JaxWsHandler(com.google.inject.Provider<JaxWsSoapContextHandler> contextHandlerProvider)

Method Summary

Modifier and Type	Method and Description
void	clearHeaders(BindingProvider soapClient) Clears all of the SOAP headers from the given SOAP client.
BindingProvider	createSoapClient(SoapServiceDescriptor soapServiceDescriptor) Creates a SOAP client using a SOAP service descriptor.
SOAPHeaderElement	createSoapHeaderElement(QName qName) JAX-WS does not support use of this method.
String	getEndpointAddress(BindingProvider soapClient)
Object	getHeader(BindingProvider soapClient, String headerName) Returns a SOAP header from the given SOAP client, if it exists.
RemoteCallReturn	invokeSoapCall(SoapCall<BindingProvider> soapCall) Invoke a SOAP call.
void	putAllHttpHeaders(BindingProvider soapClient, Map<String,String> headersMap)
void	setCompression(BindingProvider soapClient, boolean compress) Set whether SOAP requests should use compression.
void	setEndpointAddress(BindingProvider soapClient, String endpointAddress) Sets the endpoint address of the given SOAP client.
void	setHeader(BindingProvider soapClient, String namespace, String headerName, Object headerValue)
void	setHeaderChildString(BindingProvider soapClient, String headerName, String childNamespace, String childName, String childValue) Adds a child text node named childName to the existing header named headerName.
void	setRequestTimeout(BindingProvider bindingProvider, int timeout) Sets properties into the message context to alter the timeout on App Engine.

Methods inherited from class com.google.api.ads.common.lib.soap.SoapClientHandler

getSoapClientMethod, invoke, processSoapArguments

Methods inherited from class java.lang.Object

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

Constructor Detail

JaxWsHandler

@Inject
protected JaxWsHandler(com.google.inject.Provider<JaxWsSoapContextHandler> contextHandlerProvider)

Parameters:

contextHandlerProvider - a provider which produces context handlers

Method Detail

setEndpointAddress

public void setEndpointAddress(BindingProvider soapClient,
                               String endpointAddress)

Sets the endpoint address of the given SOAP client.

Parameters:

soapClient - the SOAP client to set the endpoint address for

endpointAddress - the target endpoint address

getHeader

public Object getHeader(BindingProvider soapClient,
                        String headerName)

Returns a SOAP header from the given SOAP client, if it exists.

Parameters:

soapClient - the SOAP client to check for the given header

headerName - the name of the header being looked for

Returns:

the header element, if it exists

clearHeaders

public void clearHeaders(BindingProvider soapClient)

Clears all of the SOAP headers from the given SOAP client.

Parameters:

soapClient - the client to remove the headers from

setHeader

public void setHeader(BindingProvider soapClient,
                      String namespace,
                      String headerName,
                      Object headerValue)

See Also:

SoapClientHandlerInterface.setHeader(Object, String, String, Object)

setHeaderChildString

public void setHeaderChildString(BindingProvider soapClient,
                                 String headerName,
                                 String childNamespace,
                                 String childName,
                                 String childValue)

Adds a child text node named childName to the existing header named headerName.

Parameters:

soapClient - the binding provider

headerName - the name of the existing header

childNamespace - the namespace of the new child

childName - the name of the new child

childValue - the value of the new child

Throws:

NullPointerException - if no header exists named headerName

putAllHttpHeaders

public void putAllHttpHeaders(BindingProvider soapClient,
                              Map<String,String> headersMap)

See Also:

SoapClientHandlerInterface.putAllHttpHeaders(Object, Map)

setCompression

public void setCompression(BindingProvider soapClient,
                           boolean compress)

Set whether SOAP requests should use compression.

Parameters:

soapClient - the client to set compression settings for

compress - whether or not to use compression

createSoapClient

public BindingProvider createSoapClient(SoapServiceDescriptor soapServiceDescriptor)
                                 throws ServiceException

Creates a SOAP client using a SOAP service descriptor.

Parameters:

soapServiceDescriptor - the descriptor to use for creating a client

Returns:

the SOAP client for this descriptor

Throws:

ServiceException - thrown if the SOAP client cannot be created

setRequestTimeout

public void setRequestTimeout(BindingProvider bindingProvider,
                              int timeout)

Sets properties into the message context to alter the timeout on App Engine.

invokeSoapCall

public RemoteCallReturn invokeSoapCall(SoapCall<BindingProvider> soapCall)

Invoke a SOAP call.

Parameters:

soapCall - the call to make to a SOAP web service

Returns:

information about the SOAP response

getEndpointAddress

public String getEndpointAddress(BindingProvider soapClient)

See Also:

SoapClientHandlerInterface.getEndpointAddress(Object)

createSoapHeaderElement

public SOAPHeaderElement createSoapHeaderElement(QName qName)

JAX-WS does not support use of this method.

See Also:

SoapClientHandlerInterface.createSoapHeaderElement(QName)