Class EndpointReference

Constructor Detail

• EndpointReference

  protected EndpointReference()

Method Detail

• readFrom

  public static EndpointReference readFrom(Source eprInfoset)

  Factory method to read an EndpointReference from the infoset contained in eprInfoset. This method delegates to the vendor specific implementation of the Provider.readEndpointReference(javax.xml.transform.Source) method.

  Parameters:

  eprInfoset - The EndpointReference infoset to be unmarshalled

  Returns:

  the EndpointReference unmarshalled from eprInfoset never null

  Throws:

  WebServiceException - if an error occurs while creating the EndpointReference from the eprInfoset

  IllegalArgumentException - if the null eprInfoset value is given.

• writeTo

  public abstract void writeTo(Result result)

  write this EndpointReference to the specified infoset format

  Parameters:

  result - for writing infoset

  Throws:

  WebServiceException - if there is an error writing the EndpointReference to the specified result.

  IllegalArgumentException - If the null result value is given.

• getPort

  public <T> T getPort(Class<T> serviceEndpointInterface,
              WebServiceFeature... features)

  The getPort method returns a proxy. If there are any reference parameters in the EndpointReference instance, 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 EndpointReference instance 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 from this EndpointReference or from annotations on the serviceEndpointInterface. For this method to successfully return a proxy, WSDL metadata MUST be available and the EndpointReference instance MUST contain an implementation understood serviceName metadata.

  Because this port is not created from a Service object, handlers will not automatically be configured, and the HandlerResolver and Executor cannot be get or set for this port. The BindingProvider().getBinding().setHandlerChain() method can be used to manually configure handlers for this port.

  Parameters:

  serviceEndpointInterface - Service endpoint interface

  features - An array of WebServiceFeatures to configure on the proxy. Supported features not in the features parameter will have their default values.

  Returns:

  Object Proxy instance that supports the specified service endpoint interface

  Throws:

  WebServiceException -

  • If there is an error during creation of the proxy
  • If there is any missing WSDL metadata as required by this method
  • If this endpointReference is invalid
  • If an illegal serviceEndpointInterface is specified
  • If a feature is enabled that is not compatible with this port or is unsupported.

  See Also:

  Proxy, WebServiceFeature

• toString

  public String toString()

  Displays EPR infoset for debugging convenience.

  Overrides:

  toString in class Object

  Returns:

  a string representation of the object.