declare namespace javax {
namespace xml {
namespace ws {
namespace spi {
/**
* Service provider for ServiceDelegate
and
* Endpoint
objects.
*
* @since JAX-WS 2.0
*/
// @ts-ignore
abstract class Provider extends java.lang.Object {
/**
* Creates a new instance of Provider
*/
// @ts-ignore
constructor()
/**
* A constant representing the property used to lookup the
* name of a Provider
implementation
* class.
*/
// @ts-ignore
public static readonly JAXWSPROVIDER_PROPERTY: java.lang.String | string
/**
* Creates a new provider object.
*
* The algorithm used to locate the provider subclass to use consists * of the following steps: *
*
META-INF/services/javax.xml.ws.spi.Provider
* exists, then its first line, if present, is used as the UTF-8 encoded
* name of the implementation class.
* java.util.Properties.load(InputStream)
method and it contains
* an entry whose key is javax.xml.ws.spi.Provider
, then the value of
* that entry is used as the name of the implementation class.
* javax.xml.ws.spi.Provider
* is defined, then its value is used as the name of the implementation class.
*
* @param wsdlDocumentLocation A URL pointing to the WSDL document
* for the service, or
* @param wsdlDocumentLocation A URL pointing to the WSDL document
* for the service, or
* This method can be used to create a
* This method can be used to create a null
if there isn't one.
* @param serviceName The qualified name of the service.
* @param serviceClass The service class, which MUST be either
* javax.xml.ws.Service
or a subclass thereof.
* @return The newly created service delegate.
*/
// @ts-ignore
public abstract createServiceDelegate(wsdlDocumentLocation: java.net.URL, serviceName: javax.xml.namespace.QName, serviceClass: java.lang.Classnull
if there isn't one.
* @param serviceName The qualified name of the service.
* @param serviceClass The service class, which MUST be either
* javax.xml.ws.Service
or a subclass thereof.
* @param features Web Service features that must be configured on
* the service. If the provider doesn't understand a feature,
* it must throw a WebServiceException.
* @return The newly created service delegate.
* @since JAX-WS 2.2
*/
// @ts-ignore
public createServiceDelegate(wsdlDocumentLocation: java.net.URL, serviceName: javax.xml.namespace.QName, serviceClass: java.lang.ClasseprInfoset
.
* @param eprInfoset infoset for EndpointReference
* @return the EndpointReference
unmarshalled from
* eprInfoset
. This method never returns null
.
* @throws WebServiceException If there is an error creating the
* EndpointReference
from the specified eprInfoset
.
* @throws NullPointerException If the null
* eprInfoset
value is given.
* @since JAX-WS 2.1
*/
// @ts-ignore
public abstract readEndpointReference(eprInfoset: javax.xml.transform.Source): javax.xml.ws.EndpointReference
/**
* The getPort method returns a proxy. If there
* are any reference parameters in the
* endpointReference
, then those reference
* parameters MUST appear as SOAP headers, indicating them to be
* reference parameters, on all messages sent to the endpoint.
* The parameter serviceEndpointInterface
specifies
* the service endpoint interface that is supported by the
* returned proxy.
* The parameter endpointReference
specifies the
* endpoint that will be invoked by the returned proxy.
* In the implementation of this method, the JAX-WS
* runtime system takes the responsibility of selecting a protocol
* binding (and a port) and configuring the proxy accordingly from
* the WSDL metadata of the
* serviceEndpointInterface
and the EndpointReference
.
* For this method
* to successfully return a proxy, WSDL metadata MUST be available and the
* endpointReference
MUST contain an implementation understood
* serviceName
metadata.
* @param endpointReference the EndpointReference that will
* be invoked by the returned proxy.
* @param serviceEndpointInterface Service endpoint interface
* @param features A list of WebServiceFeatures to configure on the
* proxy. Supported features not in the features
*
parameter will have their default values.
* @return Object Proxy instance that supports the
* specified service endpoint interface
* @throws WebServiceException
*
*
* @see WebServiceFeature
* @since JAX-WS 2.1
*/
// @ts-ignore
public abstract getPortendpointReference
* is illegal
* serviceEndpointInterface
* is specified
* W3CEndpointReference
.
* W3CEndpointReference
* for any endpoint by specifying the address
property along
* with any other desired properties. This method
* can also be used to create a W3CEndpointReference
for
* an endpoint that is published by the same Java EE application.
* To do so the address
property can be provided or this
* method can automatically determine the address
of
* an endpoint that is published by the same Java EE application and is
* identified by the serviceName
and
* portName
propeties. If the address
is
* null
and the serviceName
and
* portName
do not identify an endpoint published by the
* same Java EE application, a
* javax.lang.IllegalStateException
MUST be thrown.
* @param address Specifies the address of the target endpoint
* @param serviceName Qualified name of the service in the WSDL.
* @param portName Qualified name of the endpoint in the WSDL.
* @param metadata A list of elements that should be added to the
* W3CEndpointReference
instances wsa:metadata
* element.
* @param wsdlDocumentLocation URL for the WSDL document location for
* the service.
* @param referenceParameters Reference parameters to be associated
* with the returned EndpointReference
instance.
* @return the W3CEndpointReference
created from
* serviceName
, portName
,
* metadata
, wsdlDocumentLocation
* and referenceParameters
. This method
* never returns null
.
* @throws java.lang.IllegalStateException
*
*
* @throws WebServiceException If an error occurs while creating the
* address
, serviceName
and
* portName
are all null
.
* serviceName
service is null
and the
* portName
is NOT null
.
* address
property is null
and
* the serviceName
and portName
do not
* specify a valid endpoint published by the same Java EE
* application.
* serviceName
is NOT null
* and is not present in the specified WSDL.
* portName
port is not null
and it
* is not present in serviceName
service in the WSDL.
* wsdlDocumentLocation
is NOT null
* and does not represent a valid WSDL.
* W3CEndpointReference
.
* @since JAX-WS 2.1
*/
// @ts-ignore
public abstract createW3CEndpointReference(address: java.lang.String | string, serviceName: javax.xml.namespace.QName, portName: javax.xml.namespace.QName, metadata: java.util.ListW3CEndpointReference
.
* Using this method, a W3CEndpointReference
instance
* can be created with extension elements, and attributes.
* Provider
implementations must override the default
* implementation.
* W3CEndpointReference
* for any endpoint by specifying the address
property along
* with any other desired properties. This method
* can also be used to create a W3CEndpointReference
for
* an endpoint that is published by the same Java EE application.
* To do so the address
property can be provided or this
* method can automatically determine the address
of
* an endpoint that is published by the same Java EE application and is
* identified by the serviceName
and
* portName
propeties. If the address
is
* null
and the serviceName
and
* portName
do not identify an endpoint published by the
* same Java EE application, a
* javax.lang.IllegalStateException
MUST be thrown.
* @param address Specifies the address of the target endpoint
* @param interfaceName the wsam:InterfaceName
element in the
* wsa:Metadata
element.
* @param serviceName Qualified name of the service in the WSDL.
* @param portName Qualified name of the endpoint in the WSDL.
* @param metadata A list of elements that should be added to the
* W3CEndpointReference
instances wsa:metadata
* element.
* @param wsdlDocumentLocation URL for the WSDL document location for
* the service.
* @param referenceParameters Reference parameters to be associated
* with the returned EndpointReference
instance.
* @param elements extension elements to be associated
* with the returned EndpointReference
instance.
* @param attributes extension attributes to be associated
* with the returned EndpointReference
instance.
* @return the W3CEndpointReference
created from
* serviceName
, portName
,
* metadata
, wsdlDocumentLocation
* and referenceParameters
. This method
* never returns null
.
* @throws java.lang.IllegalStateException
*
*
* @throws WebServiceException If an error occurs while creating the
* address
, serviceName
and
* portName
are all null
.
* serviceName
service is null
and the
* portName
is NOT null
.
* address
property is null
and
* the serviceName
and portName
do not
* specify a valid endpoint published by the same Java EE
* application.
* serviceName
is NOT null
* and is not present in the specified WSDL.
* portName
port is not null
and it
* is not present in serviceName
service in the WSDL.
* wsdlDocumentLocation
is NOT null
* and does not represent a valid WSDL.
* wsdlDocumentLocation
is NOT null
but
* wsdli:wsdlLocation's namespace name cannot be got from the available
* metadata.
* W3CEndpointReference
.
* @since JAX-WS 2.2
*/
// @ts-ignore
public createW3CEndpointReference(address: java.lang.String | string, interfaceName: javax.xml.namespace.QName, serviceName: javax.xml.namespace.QName, portName: javax.xml.namespace.QName, metadata: java.util.ListProvider
implementations must override the
* default implementation.
* @param address A URI specifying the address and transport/protocol
* to use. A http: URI MUST result in the SOAP 1.1/HTTP
* binding being used. Implementations may support other
* URI schemes.
* @param implementor A service implementation object to which
* incoming requests will be dispatched. The corresponding
* class MUST be annotated with all the necessary Web service
* annotations.
* @param features A list of WebServiceFeatures to configure on the
* endpoint. Supported features not in the features
*
parameter will have their default values.
* @return The newly created endpoint.
* @since JAX-WS 2.2
*/
// @ts-ignore
public createAndPublishEndpoint(address: java.lang.String | string, implementor: java.lang.Object | any, ...features: javax.xml.ws.WebServiceFeature[]): javax.xml.ws.Endpoint
/**
* Creates an endpoint object with the provided binding, implementation
* object and web service features. Provider
implementations
* must override the default implementation.
* @param bindingId A URI specifying the desired binding (e.g. SOAP/HTTP)
* @param implementor A service implementation object to which
* incoming requests will be dispatched. The corresponding
* class MUST be annotated with all the necessary Web service
* annotations.
* @param features A list of WebServiceFeatures to configure on the
* endpoint. Supported features not in the features
*
parameter will have their default values.
* @return The newly created endpoint.
* @since JAX-WS 2.2
*/
// @ts-ignore
public createEndpoint(bindingId: java.lang.String | string, implementor: java.lang.Object | any, ...features: javax.xml.ws.WebServiceFeature[]): javax.xml.ws.Endpoint
/**
* Creates an endpoint object with the provided binding, implementation
* class, invoker and web service features. Containers typically use
* this to create Endpoint objects. Provider
* implementations must override the default implementation.
* @param bindingId A URI specifying the desired binding (e.g. SOAP/HTTP).
* Can be null.
* @param implementorClass A service implementation class that
* MUST be annotated with all the necessary Web service
* annotations.
* @param invoker that does the actual invocation on the service instance.
* @param features A list of WebServiceFeatures to configure on the
* endpoint. Supported features not in the features
*
parameter will have their default values.
* @return The newly created endpoint.
* @since JAX-WS 2.2
*/
// @ts-ignore
public createEndpoint(bindingId: java.lang.String | string, implementorClass: java.lang.Class