Skip navigation links

oracle.webservices.provider
Interface ProviderConfig

public interface ProviderConfig

Configuration related information for the Provider. <p/> This information provides access to Provider instance details. This may include access to information from deployment descriptors, and may entail communication with the container.

Field Summary

static String	BINDING_TYPE_SOAP11 The Binding type indicating that SOAP 1.1 binding should be generated for the service
static String	BINDING_TYPE_SOAP12 The Binding type indicating that a SOAP1.2 binding should be generated
static String	PROPAGATE_DYNAMIC_ENDPOINTS The property key for requesting propagation of dynamic endpoints (endpoints created as a results of a ProviderConfig.addService() invocation) to the other nodes in the configuratioon group.
static String	VALIDATE_SOAP_SCHEMA The property key for requesting validation of incoming soap requests.

Method Summary

void	addService(String pathInfo, Definition definition, QName wsdlPort, QName serviceName, Object policy) Add a service from inside the provider implementation.
void	addService(String pathInfo, Definition definition, QName portType, QName wsdlPort, QName serviceName, Object policy) Add a service from inside the provider implementation.
void	addService(String pathInfo, Definition definition, QName portType, QName wsdlPort, QName serviceName, Object policy, String bindingType) Add a service from inside the provider implementation.
void	addService(String pathInfo, InputStream wsdlStream, String wsdlBaseURI, QName wsdlPort, QName serviceName, Object policy) Add a service from inside the provider implementation.
void	addService(String pathInfo, InputStream wsdlStream, String wsdlBaseURI, QName portType, QName wsdlPort, QName serviceName, Object policy) Add a service from inside the provider implementation.
void	addService(String pathInfo, URL wsdlURL, QName wsdlPort, QName serviceName, Object policy) Add a service from inside the provider implementation.
void	addService(String pathInfo, URL wsdlURL, QName portType, QName wsdlPort, QName serviceName, Object policy) Add a service from inside the provider implementation.
boolean	containsProperty(String name) Check whether a particular property was provided.
ConnectionConfig	getConnectionConfig()
Object	getContainerContext() Return the Context of the provider container.
DynamicEndpointNameHelper	getDynamicEndpointNameHelper(String pathInfo, String portName) Get the DynamicEndpointNameHelper configured for the specified provider endpoint.
Model	getModel(String pathInfo)
Model	getModel(String pathInfo, MddsErrorHandler errHandler)
String	getProperty(String name) Get the property value corresponding to the property name.
Iterator	getPropertyNames() Return the list of properties defined for this configuration.
Iterator	getProviderEndpointPaths() Get the collection of dynamically added provider endpoint paths.
ProviderInterceptorPipeline	getProviderInterceptorPipeline(String pathInfo) Get the ProviderInterceptorPipeline configured for the specified provider endpoint.
String	getProviderName() Return the provider name.
ServiceInvocationInfo	getServiceInvocationInfo()
oracle.j2ee.ws.common.management.DatabindingStatisticsCollector	getStatsCollector()
Definition	getWSDL(String pathInfo) Returns the WSDL Definition for the given endpoint.
String	getWSDLLocation() Return the WSDL location.
QName	getWSDLPort() Return the WSDL Port QName.
QName	getWSDLPort(String pathInfo) Return the WSDL Port QName for the specified pathInfo.
QName	getWSDLService() Return the WSDL Service QName.
QName	getWSDLService(String pathInfo) Return the WSDL Service QName for the specified pathInfo.
URL	getWSDLURL(String pathInfo) Get the URL for the WSDL definition associated with the specified provider endpoint path.
boolean	isMtomSupport()
boolean	isMtomSupport(String pathInfo)
boolean	isStreamRequestAttachments()
boolean	isStreamRequestAttachments(String pathInfo)
boolean	isStreamResponseAttachments()
boolean	isStreamResponseAttachments(String pathInfo)
void	removeProperty(String name) Remove the specified property.
void	removeService(String pathInfo) Remove a service associated with a given pathInfo.
void	setConnectionConfig(ConnectionConfig connectionConfig)
void	setMtomSupport(boolean mtom)
void	setMtomSupport(String pathInfo, boolean mtom)
void	setProperty(String name, String value) Set a property.
void	setServiceInvocationInfo(ServiceInvocationInfo svcInvocationInfo)
void	setStreamRequestAttachments(boolean streamRequestAttachments)
void	setStreamRequestAttachments(String pathInfo, boolean streamRequestAttachments)
void	setStreamResponseAttachments(boolean streamResponseAttachments)
void	setStreamResponseAttachments(String pathInfo, boolean streamResponseAttachments)

Field Detail

VALIDATE_SOAP_SCHEMA

static final String VALIDATE_SOAP_SCHEMA

The property key for requesting validation of incoming soap requests. <p/> If this property value is set to "true", then the container will validate the incoming SOAP requests against the WSDL definition's types schema.

See Also:

Constant Field Values

PROPAGATE_DYNAMIC_ENDPOINTS

static final String PROPAGATE_DYNAMIC_ENDPOINTS

The property key for requesting propagation of dynamic endpoints (endpoints created as a results of a ProviderConfig.addService() invocation) to the other nodes in the configuratioon group. <p/> If this property value is set to "true", then the endpoint created in the target instance will be propagated to the other members of the same configuration group.

See Also:

Constant Field Values

BINDING_TYPE_SOAP11

static final String BINDING_TYPE_SOAP11

The Binding type indicating that SOAP 1.1 binding should be generated for the service

See Also:

Constant Field Values

BINDING_TYPE_SOAP12

static final String BINDING_TYPE_SOAP12

The Binding type indicating that a SOAP1.2 binding should be generated

See Also:

Constant Field Values

Method Detail

addService

void addService(String pathInfo,
                URL wsdlURL,
                QName wsdlPort,
                QName serviceName,
                Object policy)
                throws ProviderException

Add a service from inside the provider implementation.

Parameters:

pathInfo - Extra path information associated with the URL the client sent when it made this request. The extra path information follows the servlet path but precedes the query string and will start with a "/" character. Should not be null.

wsdlURL - The URL of WSDL. Can be 'file://' or 'http://'. Should not be null.

wsdlPort - QName of the WSDL port. Can be null.

serviceName - QName of the WSDL service. Can be null.

policy - Policy file. Can be null.

Throws:

ProviderException

addService

void addService(String pathInfo,
                URL wsdlURL,
                QName portType,
                QName wsdlPort,
                QName serviceName,
                Object policy)
                throws ProviderException

Add a service from inside the provider implementation.

Parameters:

pathInfo - Extra path information associated with the URL the client sent when it made this request. The extra path information follows the servlet path but precedes the query string and will start with a "/" character. Should not be null.

wsdlURL - The URL of WSDL. Can be 'file://' or 'http://'. Should not be null.

portType - The port type.

wsdlPort - QName of the WSDL port. Can be null.

serviceName - QName of the WSDL service. Can be null.

policy - Policy file. Can be null.

Throws:

ProviderException

addService

void addService(String pathInfo,
                Definition definition,
                QName wsdlPort,
                QName serviceName,
                Object policy)
                throws ProviderException

Add a service from inside the provider implementation.

Parameters:

pathInfo - Extra path information associated with the URL the client sent when it made this request. The extra path information follows the servlet path but precedes the query string and will start with a "/" character. Should not be null.

definition - The wsdl Definition (JSR 110) for the service.

wsdlPort - QName of the WSDL port. Can be null.

serviceName - QName of the WSDL service. Can be null.

policy - Policy file. Can be null.

Throws:

ProviderException

addService

void addService(String pathInfo,
                Definition definition,
                QName portType,
                QName wsdlPort,
                QName serviceName,
                Object policy)
                throws ProviderException

Add a service from inside the provider implementation.

Parameters:

pathInfo - Extra path information associated with the URL the client sent when it made this request. The extra path information follows the servlet path but precedes the query string and will start with a "/" character. Should not be null.

definition - The wsdl Definition (JSR 110) for the service.

portType - the wsdl port type.

wsdlPort - QName of the WSDL port. Can be null.

serviceName - QName of the WSDL service. Can be null.

policy - Policy file. Can be null.

Throws:

ProviderException

addService

void addService(String pathInfo,
                Definition definition,
                QName portType,
                QName wsdlPort,
                QName serviceName,
                Object policy,
                String bindingType)
                throws ProviderException

Add a service from inside the provider implementation.

Parameters:

pathInfo - Extra path information associated with the URL the client sent when it made this request. The extra path information follows the servlet path but precedes the query string and will start with a "/" character. Should not be null.

definition - The wsdl Definition (JSR 110) for the service.

portType - the wsdl port type.

wsdlPort - QName of the WSDL port. Can be null.

serviceName - QName of the WSDL service. Can be null.

policy - Policy file. Can be null.

bindingType - The type of the binding to be generated. Currently supported are: BINDING_TYPE_SOAP11, BINDING_TYPE_SOAP12

Throws:

ProviderException

addService

void addService(String pathInfo,
                InputStream wsdlStream,
                String wsdlBaseURI,
                QName wsdlPort,
                QName serviceName,
                Object policy)
                throws ProviderException

Add a service from inside the provider implementation.

Parameters:

pathInfo - Extra path information associated with the URL the client sent when it made this request. The extra path information follows the servlet path but precedes the query string and will start with a "/" character. Should not be null.

wsdlStream - The WSDL input stream.

wsdlBaseURI - The base URI for the WSDL.

wsdlPort - QName of the WSDL port. Can be null.

serviceName - QName of the WSDL service. Can be null.

policy - Policy file. Can be null.

Throws:

ProviderException

addService

void addService(String pathInfo,
                InputStream wsdlStream,
                String wsdlBaseURI,
                QName portType,
                QName wsdlPort,
                QName serviceName,
                Object policy)
                throws ProviderException

Add a service from inside the provider implementation.

Parameters:

pathInfo - Extra path information associated with the URL the client sent when it made this request. The extra path information follows the servlet path but precedes the query string and will start with a "/" character. Should not be null.

wsdlStream - The WSDL input stream.

wsdlBaseURI - The base URI for the WSDL.

portType - The port type.

wsdlPort - QName of the WSDL port. Can be null.

serviceName - QName of the WSDL service. Can be null.

policy - Policy file. Can be null.

Throws:

ProviderException

removeService

void removeService(String pathInfo)

Remove a service associated with a given pathInfo.

Parameters:

pathInfo - The pathInfo of the service to remove.

getContainerContext

Object getContainerContext()

Return the Context of the provider container.

Returns:

Object. Returns the ServletContext if the provider is hosted by a servlet container

getProviderName

String getProviderName()

Return the provider name.

Returns:

String. Returns the provider name.

getWSDLLocation

String getWSDLLocation()

Return the WSDL location.

Returns:

String. Returns the location of WSDL file if provided in the deployment configuration file. If not, null is returned.

getWSDLPort

QName getWSDLPort()

Return the WSDL Port QName.

Returns:

QName. Returns the Port QName of WSDL file if provided in the deployment configuration file. If not, null is returned.

getWSDLPort

QName getWSDLPort(String pathInfo)

Return the WSDL Port QName for the specified pathInfo.

Returns:

Returns the Port QName of WSDL file if provided in the deployment configuration file or dynamically added by the Provider implementation. If not, null.

getWSDLService

QName getWSDLService()

Return the WSDL Service QName.

Returns:

QName. Returns the Service QName of WSDL file if provided in the deployment configuration file. If not, null is returned.

getWSDLService

QName getWSDLService(String pathInfo)

Return the WSDL Service QName for the specified pathInfo.

Returns:

Returns the Service QName of WSDL file if provided in the deployment configuration file or dynamically added by the Provider implementation. If not, null.

containsProperty

boolean containsProperty(String name)

Check whether a particular property was provided. Properties can be supplied through a configuration file, oracle-webservices.xml, or dynamically set by the provider implementation (e.g. in the init() method).

Parameters:

name - Name of the property of interest.

Returns:

true if the specified property exists.

getProperty

String getProperty(String name)

Get the property value corresponding to the property name.

Parameters:

name - Name of the property of interest.

Returns:

The value of the property if it exists; Otherwise, null.

getPropertyNames

Iterator getPropertyNames()

Return the list of properties defined for this configuration.

Returns:

An Iterator for the list of property names.

removeProperty

void removeProperty(String name)

Remove the specified property.

Parameters:

name - The name of property to be removed.

setProperty

void setProperty(String name,
                 String value)

Set a property. Used to communicate with the container.

Parameters:

name - The name of a property

value - The associated property value

getWSDLURL

URL getWSDLURL(String pathInfo)

Get the URL for the WSDL definition associated with the specified provider endpoint path.

Parameters:

pathInfo - The path associated with a dynamically added provider endpoint (see Provider.addService). Specify null to get the URL for the WSDL definition associated with this provider by its deployment descriptor (oracle-webservices.xml) entry.

Returns:

The WSDL URL for the provider endpoint, or null if no WSDL is associated with the specified path.

getProviderInterceptorPipeline

ProviderInterceptorPipeline getProviderInterceptorPipeline(String pathInfo)

Get the ProviderInterceptorPipeline configured for the specified provider endpoint.

Parameters:

pathInfo - The pathInfo for the endpoint of interest.

getDynamicEndpointNameHelper

DynamicEndpointNameHelper getDynamicEndpointNameHelper(String pathInfo,
                                                       String portName)

Get the DynamicEndpointNameHelper configured for the specified provider endpoint.

getStatsCollector

oracle.j2ee.ws.common.management.DatabindingStatisticsCollector getStatsCollector()

getProviderEndpointPaths

Iterator getProviderEndpointPaths()

Get the collection of dynamically added provider endpoint paths.

Returns:

An Iterator for the collection of paths.

getWSDL

Definition getWSDL(String pathInfo)

Returns the WSDL Definition for the given endpoint.

Parameters:

pathInfo - the pathInfo for a dynanmic endpoint or null for the static endpoint.

Returns:

the WSDL definition.

getModel

Model getModel(String pathInfo)
               throws IOException,
                      MddsException,
                      WSDLException

Throws:

IOException

MddsException

WSDLException

getModel

Model getModel(String pathInfo,
               MddsErrorHandler errHandler)
               throws IOException,
                      MddsException,
                      WSDLException

Throws:

IOException

MddsException

WSDLException

isStreamRequestAttachments

boolean isStreamRequestAttachments()

setStreamRequestAttachments

void setStreamRequestAttachments(boolean streamRequestAttachments)

isStreamRequestAttachments

boolean isStreamRequestAttachments(String pathInfo)

setStreamRequestAttachments

void setStreamRequestAttachments(String pathInfo,
                                 boolean streamRequestAttachments)

isStreamResponseAttachments

boolean isStreamResponseAttachments()

setStreamResponseAttachments

void setStreamResponseAttachments(boolean streamResponseAttachments)

isStreamResponseAttachments

boolean isStreamResponseAttachments(String pathInfo)

setStreamResponseAttachments

void setStreamResponseAttachments(String pathInfo,
                                  boolean streamResponseAttachments)

isMtomSupport

boolean isMtomSupport()

setMtomSupport

void setMtomSupport(boolean mtom)

isMtomSupport

boolean isMtomSupport(String pathInfo)

setMtomSupport

void setMtomSupport(String pathInfo,
                    boolean mtom)

getServiceInvocationInfo

ServiceInvocationInfo getServiceInvocationInfo()

setServiceInvocationInfo

void setServiceInvocationInfo(ServiceInvocationInfo svcInvocationInfo)

setConnectionConfig

void setConnectionConfig(ConnectionConfig connectionConfig)

getConnectionConfig

ConnectionConfig getConnectionConfig()

Skip navigation links