--- old/src/java.xml.ws/share/classes/javax/xml/ws/EndpointReference.java 2015-07-09 12:14:04.000000000 +0200
+++ new/src/java.xml.ws/share/classes/javax/xml/ws/EndpointReference.java 2015-07-09 12:14:04.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 @@
*
endpointReference
+ * {@code endpointReference}
* is invalid
* serviceEndpointInterface
+ * {@code serviceEndpointInterface}
* is specified
*