|
IBM WebSphere Application ServerTM Release 7 |
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectcom.ibm.websphere.wsaddressing.EndpointReferenceManager
public abstract class EndpointReferenceManager
This abstract class is used to create EndpointReferences.
It may also be used by the target Web services to acquire the WS-Addressing reference parameters associated with an incoming message.
Field Summary | |
---|---|
protected static EndpointReferenceManager |
_endpointReferenceManager
|
Constructor Summary | |
---|---|
EndpointReferenceManager()
|
Method Summary | |
---|---|
protected abstract EndpointReference |
createConcreteEndpointReference(javax.xml.namespace.QName serviceName,
java.lang.String endpointName)
|
protected abstract EndpointReference |
createConcreteEndpointReference(javax.xml.namespace.QName serviceName,
java.lang.String endpointName,
java.rmi.Remote statefulSessionBean)
|
static EndpointReference |
createEndpointReference(javax.xml.namespace.QName serviceName,
java.lang.String endpointName)
This method creates an WS-Addressing EndpointReference based on an WSDL service name and endpoint (WSDL 1.1 port name). |
static EndpointReference |
createEndpointReference(javax.xml.namespace.QName serviceName,
java.lang.String endpointName,
java.rmi.Remote statefulSessionBean)
This method creates a WS-Addressing EndpointReference which is |
protected static EndpointReferenceManager |
getEPRManager()
|
static java.lang.String |
getReferenceParameterFromMessageContext(javax.xml.namespace.QName name)
This method is intended for use by Web service applications requiring access to WS-Addressing [reference parameters] that appear on the inbound message. |
Methods inherited from class java.lang.Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Field Detail |
---|
protected static final EndpointReferenceManager _endpointReferenceManager
Constructor Detail |
---|
public EndpointReferenceManager()
Method Detail |
---|
protected abstract EndpointReference createConcreteEndpointReference(javax.xml.namespace.QName serviceName, java.lang.String endpointName) throws EndpointReferenceCreationException
EndpointReferenceCreationException
protected abstract EndpointReference createConcreteEndpointReference(javax.xml.namespace.QName serviceName, java.lang.String endpointName, java.rmi.Remote statefulSessionBean) throws EndpointReferenceCreationException
EndpointReferenceCreationException
protected static EndpointReferenceManager getEPRManager()
public static EndpointReference createEndpointReference(javax.xml.namespace.QName serviceName, java.lang.String endpointName) throws EndpointReferenceCreationException
This method creates an WS-Addressing EndpointReference based on an WSDL service name and endpoint (WSDL 1.1 port name).
In order for this method to generate the URI correctly, the local part of the WSDL service name passed as a parameter must be the same as the webservice-description-name in the webservice deployment descriptor webservices.xml. (If the webservices.xml file is generated by tools they will be the same.)
The [metadata] of the created EndpointReference will be based on the endpoint information passed on input to this method.
Where the deployment allows, requests targeted at endpoint references generated by this method will be workload managed. Session and context affinity constraints will be honored within the workload managed environment.
serviceName
- The QName representing the service that the newly created EPR
will representendpointName
- The String representing the endpoint in the service that the
newly created EPR will represent. In WSDL 1.1, this equates to
the port name.
EndpointReferenceCreationException
- thrown if there was a problem
creating the EndpointReference.
For example, if it is not possible to establish a unique URI for
this endpoint, this exception will be thrown.public static EndpointReference createEndpointReference(javax.xml.namespace.QName serviceName, java.lang.String endpointName, java.rmi.Remote statefulSessionBean) throws EndpointReferenceCreationException
This method creates a
WS-Addressing EndpointReference which is
This method should be used to create an EndpointReference in preference to the createEndpointReference(QName serviceName, String endpointName) method, if:
The newly created EndpointReference is based on an WSDL service name, endpoint (WSDL 1.1 port name) and, optionally, a stateful session bean (that implements the endpoint).
If the endpoint represented by the
EndpointReference is not a stateful session bean, the additional parameter in this method should be
set to null. This will ensure that,
when the EndpointReference is used as the target for a request, affinity is maintained
with the node on which the endpoint has been created (i.e. that the EndpointReference will not
be workload managed). On zOS, affinity will
If the endpoint represented by the EndpointReference is a stateful session bean, the stateful session bean should be passed as the additional parameter to this method. This method ensures that, when the EndpointReference is used as the target for a request, affinity is maintained with the stateful session bean. If high availability for stateful session beans is enabled, the EndpointReference returned from this method will remain valid even if the stateful session bean is failed over.
In order for this method to generate the URI correctly, the local part of the WSDL service name passed as a parameter must be the same as the webservice-description-name in the webservice deployment descriptor webservices.xml. (If the webservices.xml file is generated by tools they will be the same.)
The [metadata] of the created EndpointReference will be based on the endpoint information passed on input to this method.
serviceName
- The QName representing the service that the newly created EPR
will representendpointName
- The String representing the endpoint in the service that the
newly created EPR will represent. In WSDL 1.1, this equates to
the port name.statefulSessionBean
- the stateful session bean with which
affinity is to be maintained, or null.
EndpointReferenceCreationException
- thrown if there was a problem
creating the EndpointReference.
For example, if it is not possible to establish a unique URI for
this endpoint, this exception will be thrown.public static java.lang.String getReferenceParameterFromMessageContext(javax.xml.namespace.QName name) throws ReferenceParameterCreationException
This method is intended for use by Web service applications requiring access to WS-Addressing [reference parameters] that appear on the inbound message. It returns a Reference Parameter identified by its QName.
Note that:
For access to [reference parameters] which do not have a String value, the com.ibm.wsspi.wsaddressing.EndpointReferenceManager.getSOAPElementReferenceParameterFromMessageContext method can be used.
This method is intended for use at the Web service only. It is not available to the client.
name
- The QName identifying the reference parameters to be returned
ReferenceParameterCreationException
- if there was a problem
creating the reference parameter (for example,
if there is no available SOAP Message Context).
|
IBM WebSphere Application ServerTM Release 7 |
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |