Interface SoapServiceProvider
public interface SoapServiceProvider
Contract for implementations that handles the web services that the extension will be able to execute by returning a list of
WebServiceDefinitions.
Implementations can also add a level of security by overriding the getSecurities() method.
- Since:
- 1.0
-
Method Summary
Modifier and TypeMethodDescriptiongetCustomHeaders(WebServiceDefinition definition, String operation) Gives the capability to create Soap headers given the a service definition and the operation that is being consumed so they can be bundled with the soap requestdefault List<SecurityStrategy>default voidThis method is a hook forSoapServiceProviderinstances to validate the configured parameters and fail gracefully before attempting to create a connection avoiding misleading and confusing error messages.
-
Method Details
-
getWebServiceDefinitions
List<WebServiceDefinition> getWebServiceDefinitions()- Returns:
- a
Listwith all theWebServiceDefinitions that the provider implementation handles.
-
getSecurities
- Returns:
- a
Listwith all the Soap Securities that should be added for the services described by the provider impl.
-
getCustomHeaders
Gives the capability to create Soap headers given the a service definition and the operation that is being consumed so they can be bundled with the soap requestIt returns a
MapwithStringkeys representing the name of the headers andStringvalues representing the actual XML soap header value.- Parameters:
definition- theWebServiceDefinitionof the service being called.operation- the name of the operation that is going to be consumed.- Returns:
- a
Mapof soap headers to be bundled in the generated envelope.
-
validateConfiguration
This method is a hook forSoapServiceProviderinstances to validate the configured parameters and fail gracefully before attempting to create a connection avoiding misleading and confusing error messages.- Throws:
SoapServiceProviderConfigurationException- if any configured parameter has an invalid value.
-