--- old/src/java.xml.ws/share/classes/javax/xml/ws/EndpointReference.java 2015-07-08 13:25:20.000000000 +0200 +++ new/src/java.xml.ws/share/classes/javax/xml/ws/EndpointReference.java 2015-07-08 13:25:20.000000000 +0200 @@ -1,5 +1,5 @@ /* - * Copyright (c) 2005, 2012, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2005, 2015, 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 @@ -44,35 +44,35 @@ * need not be concerned with its contents. The web service * developer should use this class strictly as a mechanism to * reference a remote web service endpoint. See the {@link Service} APIs - * that clients can use to that utilize an EndpointReference. + * that clients can use to that utilize an {@code EndpointReference}. * See the {@link javax.xml.ws.Endpoint}, and * {@link javax.xml.ws.BindingProvider} APIs on how - * EndpointReferences can be created for published + * {@code EndpointReferences} can be created for published * endpoints. *

* Concrete implementations of this class will represent - * an EndpointReference for a particular version of Addressing. + * an {@code EndpointReference} for a particular version of Addressing. * For example the {@link W3CEndpointReference} is for use * with W3C Web Services Addressing 1.0 - Core Recommendation. * If JAX-WS implementors need to support different versions * of addressing, they should write their own - * EndpointReference subclass for that version. + * {@code EndpointReference} subclass for that version. * This will allow a JAX-WS implementation to create - * a vendor specific EndpointReferences that the + * a vendor specific {@code EndpointReferences} that the * vendor can use to flag a different version of * addressing. *

* Web service developers that wish to pass or return - * EndpointReference in Java methods in an + * {@code EndpointReference} in Java methods in an * SEI should use - * concrete instances of an EndpointReference such - * as the W3CEndpointReference. This way the + * concrete instances of an {@code EndpointReference} such + * as the {@code W3CEndpointReference}. This way the * schema mapped from the SEI will be more descriptive of the * type of endpoint reference being passed. *

* JAX-WS implementors are expected to extract the XML infoset - * from an EndpointReferece using the - * {@link EndpointReference#writeTo} + * from an {@code EndpointReferece} using the + * {@link EndpointReference#writeTo} * method. *

* JAXB will bind this class to xs:anyType. If a better binding @@ -92,68 +92,68 @@ /** * Factory method to read an EndpointReference from the infoset contained in - * eprInfoset. This method delegates to the vendor specific + * {@code eprInfoset}. This method delegates to the vendor specific * implementation of the {@link javax.xml.ws.spi.Provider#readEndpointReference} method. * - * @param eprInfoset The EndpointReference infoset to be unmarshalled + * @param eprInfoset The {@code EndpointReference} infoset to be unmarshalled * - * @return the EndpointReference unmarshalled from eprInfoset - * never null + * @return the EndpointReference unmarshalled from {@code eprInfoset} + * never {@code null} * @throws WebServiceException * if an error occurs while creating the - * EndpointReference from the eprInfoset + * {@code EndpointReference} from the {@code eprInfoset} * @throws java.lang.IllegalArgumentException - * if the null eprInfoset value is given. + * if the {@code null} {@code eprInfoset} value is given. */ public static EndpointReference readFrom(Source eprInfoset) { return Provider.provider().readEndpointReference(eprInfoset); } /** - * write this EndpointReference to the specified infoset format + * write this {@code EndpointReference} to the specified infoset format * * @param result for writing infoset * @throws WebServiceException * if there is an error writing the - * EndpointReference to the specified result. + * {@code EndpointReference} to the specified {@code result}. * * @throws java.lang.IllegalArgumentException - * If the null result value is given. + * If the {@code null} {@code result} value is given. */ public abstract void writeTo(Result result); /** - * The getPort method returns a proxy. If there + * The {@code getPort} method returns a proxy. If there * are any reference parameters in the - * EndpointReference instance, then those reference + * {@code 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 parameter {@code serviceEndpointInterface} specifies * the service endpoint interface that is supported by the * returned proxy. - * The EndpointReference instance specifies the + * The {@code 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 + * the WSDL Metadata from this {@code EndpointReference} or from + * annotations on the {@code 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. + * {@code EndpointReference} instance MUST contain an implementation understood + * {@code 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() + * Because this port is not created from a {@code Service} object, handlers + * will not automatically be configured, and the {@code HandlerResolver} + * and {@code Executor} cannot be get or set for this port. The + * {@code BindingProvider().getBinding().setHandlerChain()} * method can be used to manually configure handlers for this port. * * * @param serviceEndpointInterface Service endpoint interface - * @param features An array of WebServiceFeatures to configure on the - * proxy. Supported features not in the features - * parameter will have their default values. + * @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 Proxy instance that supports the * specified service endpoint interface * @throws WebServiceException @@ -163,10 +163,10 @@ *

  • If there is any missing WSDL metadata * as required by this method *
  • If this - * endpointReference + * {@code endpointReference} * is invalid *
  • If an illegal - * serviceEndpointInterface + * {@code serviceEndpointInterface} * is specified *
  • If a feature is enabled that is not compatible with * this port or is unsupported.