< prev index next >
jaxws/src/java.xml.ws/share/classes/javax/xml/ws/spi/ServiceDelegate.java
Print this page
@@ -1,7 +1,7 @@
/*
- * Copyright (c) 2005, 2015, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2005, 2017, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* This code is free software; you can redistribute it and/or modify it
* under the terms of the GNU General Public License version 2 only, as
* published by the Free Software Foundation. Oracle designates this
@@ -49,20 +49,24 @@
*
* @since 1.6, JAX-WS 2.0
*/
public abstract class ServiceDelegate {
+ /**
+ * Default constructor.
+ */
protected ServiceDelegate() {
}
/**
* The {@code getPort} method returns a proxy. A service client
* uses this proxy to invoke operations on the target
* service endpoint. The {@code serviceEndpointInterface}
* specifies the service endpoint interface that is supported by
* the created dynamic proxy instance.
*
+ * @param <T> Service endpoint interface
* @param portName Qualified name of the service endpoint in
* the WSDL service description
* @param serviceEndpointInterface Service endpoint interface
* supported by the dynamic proxy
* @return Object Proxy instance that
@@ -90,10 +94,11 @@
* uses this proxy to invoke operations on the target
* service endpoint. The {@code serviceEndpointInterface}
* specifies the service endpoint interface that is supported by
* the created dynamic proxy instance.
*
+ * @param <T> Service endpoint interface
* @param portName Qualified name of the service endpoint in
* the WSDL service description
* @param serviceEndpointInterface Service endpoint interface
* supported by the dynamic proxy or instance
* @param features A list of WebServiceFeatures to configure on the
@@ -162,10 +167,11 @@
* where the {@code portName} is retrieved from the
* metadata of the {@code endpointReference} or from the
* {@code serviceEndpointInterface} and the WSDL
* associated with this {@code Service} instance.
*
+ * @param <T> Service endpoint interface.
* @param endpointReference The {@code EndpointReference}
* for the target service endpoint that will be invoked by the
* returned proxy.
* @param serviceEndpointInterface Service endpoint interface.
* @param features A list of {@code WebServiceFeatures} to configure on the
@@ -207,10 +213,11 @@
* 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.
* The returned proxy should not be reconfigured by the client.
*
+ * @param <T> Service endpoint interface
* @param serviceEndpointInterface Service endpoint interface
* @return Object instance that supports the
* specified service endpoint interface
* @throws WebServiceException
* <UL>
@@ -233,10 +240,11 @@
* 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.
* The returned proxy should not be reconfigured by the client.
*
+ * @param <T> Service endpoint interface
* @param serviceEndpointInterface Service endpoint interface
* @param features An array of {@code WebServiceFeatures} to configure on the
* proxy. Supported features not in the {@code features
* } parameter will have their default values.
* @return Object instance that supports the
@@ -284,10 +292,12 @@
/**
* Creates a {@code Dispatch} instance for use with objects of
* the user's choosing.
*
+ * @param <T> type used for messages or message payloads. Implementations are required to
+ * support {@code javax.xml.transform.Source} and {@code javax.xml.soap.SOAPMessage}.
* @param portName Qualified name for the target service endpoint
* @param type The class of object used for messages or message
* payloads. Implementations are required to support
* {@code javax.xml.transform.Source} and {@code javax.xml.soap.SOAPMessage}.
* @param mode Controls whether the created dispatch instance is message
@@ -308,10 +318,12 @@
/**
* Creates a {@code Dispatch} instance for use with objects of
* the user's choosing.
*
+ * @param <T> type used for messages or message payloads. Implementations are required to
+ * support {@code javax.xml.transform.Source} and {@code javax.xml.soap.SOAPMessage}.
* @param portName Qualified name for the target service endpoint
* @param type The class of object used for messages or message
* payloads. Implementations are required to support
* {@code javax.xml.transform.Source} and {@code javax.xml.soap.SOAPMessage}.
* @param mode Controls whether the created dispatch instance is message
@@ -367,10 +379,13 @@
* {@code dispatch = service.createDispatch(portName, type, mode, features);}
* </pre>
* where the {@code portName} is retrieved from the
* WSDL or {@code EndpointReference} metadata.
*
+ * @param <T> type of object used to messages or message
+ * payloads. Implementations are required to support
+ * {@code javax.xml.transform.Source} and {@code javax.xml.soap.SOAPMessage}.
* @param endpointReference The {@code EndpointReference}
* for the target service endpoint that will be invoked by the
* returned {@code Dispatch} object.
* @param type The class of object used to messages or message
* payloads. Implementations are required to support
< prev index next >