--- old/src/java.xml.ws/share/classes/javax/xml/ws/Endpoint.java 2015-07-09 12:14:03.000000000 +0200 +++ new/src/java.xml.ws/share/classes/javax/xml/ws/Endpoint.java 2015-07-09 12:14:03.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 @@ -37,23 +37,23 @@ * A Web service endpoint. * *

Endpoints are created using the static methods defined in this - * class. An endpoint is always tied to one Binding + * class. An endpoint is always tied to one {@code Binding} * and one implementor, both set at endpoint creation time. * *

An endpoint is either in a published or an unpublished state. - * The publish methods can be used to start publishing + * The {@code publish} methods can be used to start publishing * an endpoint, at which point it starts accepting incoming requests. - * Conversely, the stop method can be used to stop + * Conversely, the {@code stop} method can be used to stop * accepting incoming requests and take the endpoint down. * Once stopped, an endpoint cannot be published again. * - *

An Executor may be set on the endpoint in order + *

An {@code Executor} may be set on the endpoint in order * to gain better control over the threads used to dispatch incoming * requests. For instance, thread pooling with certain parameters - * can be enabled by creating a ThreadPoolExecutor and + * can be enabled by creating a {@code ThreadPoolExecutor} and * registering it with the endpoint. * - *

Handler chains can be set using the contained Binding. + *

Handler chains can be set using the contained {@code Binding}. * *

An endpoint may have a list of metadata documents, such as WSDL * and XMLSchema documents, bound to it. At publishing time, the @@ -114,8 +114,8 @@ * * @param implementor The endpoint implementor. * @param features A list of WebServiceFeature to configure on the - * endpoint. Supported features not in the features - * parameter will have their default values. + * endpoint. Supported features not in the {@code features + * } parameter will have their default values. * * * @return The newly created endpoint. @@ -135,7 +135,7 @@ * {@link javax.xml.ws.Endpoint#publish(Object)} methods. * * @param bindingId A URI specifying the binding to use. If the bindingID is - * null and no binding is specified via a BindingType + * {@code null} and no binding is specified via a BindingType * annotation then a default SOAP 1.1 / HTTP binding MUST be used. * * @param implementor The endpoint implementor. @@ -156,14 +156,14 @@ * {@link javax.xml.ws.Endpoint#publish(Object)} methods. * * @param bindingId A URI specifying the binding to use. If the bindingID is - * null and no binding is specified via a BindingType + * {@code null} and no binding is specified via a BindingType * annotation then a default SOAP 1.1 / HTTP binding MUST be used. * * @param implementor The endpoint implementor. * * @param features A list of WebServiceFeature to configure on the - * endpoint. Supported features not in the features - * parameter will have their default values. + * endpoint. Supported features not in the {@code features + * } parameter will have their default values. * * @return The newly created endpoint. * @since 1.7, JAX-WS 2.2 @@ -205,9 +205,9 @@ * If the endpoint has been published already or it has been stopped. * * @throws java.lang.SecurityException - * If a java.lang.SecurityManger + * If a {@code java.lang.SecurityManger} * is being used and the application doesn't have the - * WebServicePermission("publishEndpoint") permission. + * {@code WebServicePermission("publishEndpoint")} permission. **/ public abstract void publish(String address); @@ -231,9 +231,9 @@ * @return The newly created endpoint. * * @throws java.lang.SecurityException - * If a java.lang.SecurityManger + * If a {@code java.lang.SecurityManger} * is being used and the application doesn't have the - * WebServicePermission("publishEndpoint") permission. + * {@code WebServicePermission("publishEndpoint")} permission. * **/ public static Endpoint publish(String address, Object implementor) { @@ -258,14 +258,14 @@ * URI schemes. * @param implementor The endpoint implementor. * @param features A list of WebServiceFeature to configure on the - * endpoint. Supported features not in the features - * parameter will have their default values. + * endpoint. Supported features not in the {@code features + * } parameter will have their default values. * @return The newly created endpoint. * * @throws java.lang.SecurityException - * If a java.lang.SecurityManger + * If a {@code java.lang.SecurityManger} * is being used and the application doesn't have the - * WebServicePermission("publishEndpoint") permission. + * {@code WebServicePermission("publishEndpoint")} permission. * @since 1.7, JAX-WS 2.2 */ public static Endpoint publish(String address, Object implementor, WebServiceFeature ... features) { @@ -294,9 +294,9 @@ * If the endpoint has been published already or it has been stopped. * * @throws java.lang.SecurityException - * If a java.lang.SecurityManger + * If a {@code java.lang.SecurityManger} * is being used and the application doesn't have the - * WebServicePermission("publishEndpoint") permission. + * {@code WebServicePermission("publishEndpoint")} permission. **/ public abstract void publish(Object serverContext); @@ -327,9 +327,9 @@ * If the endpoint has been published already or it has been stopped. * * @throws java.lang.SecurityException - * If a java.lang.SecurityManger + * If a {@code java.lang.SecurityManger} * is being used and the application doesn't have the - * WebServicePermission("publishEndpoint") permission. + * {@code WebServicePermission("publishEndpoint")} permission. * @since 1.7, JAX-WS 2.2 */ public void publish(HttpContext serverContext) { @@ -348,14 +348,14 @@ /** * Returns true if the endpoint is in the published state. * - * @return true if the endpoint is in the published state. + * @return {@code true} if the endpoint is in the published state. **/ public abstract boolean isPublished(); /** * Returns a list of metadata documents for the service. * - * @return List<javax.xml.transform.Source> A list of metadata documents for the service + * @return {@code List} A list of metadata documents for the service **/ public abstract List getMetadata(); @@ -372,12 +372,12 @@ public abstract void setMetadata(List metadata); /** - * Returns the executor for this Endpointinstance. + * Returns the executor for this {@code Endpoint}instance. * * The executor is used to dispatch an incoming request to * the implementor object. * - * @return The java.util.concurrent.Executor to be + * @return The {@code java.util.concurrent.Executor} to be * used to dispatch a request. * * @see java.util.concurrent.Executor @@ -385,17 +385,17 @@ public abstract java.util.concurrent.Executor getExecutor(); /** - * Sets the executor for this Endpoint instance. + * Sets the executor for this {@code Endpoint} instance. * * The executor is used to dispatch an incoming request to * the implementor object. * - * If this Endpoint is published using the - * publish(Object) method and the specified server + * If this {@code Endpoint} is published using the + * {@code publish(Object)} method and the specified server * context defines its own threading behavior, the executor * may be ignored. * - * @param executor The java.util.concurrent.Executor + * @param executor The {@code java.util.concurrent.Executor} * to be used to dispatch a request. * * @throws SecurityException If the instance does not support @@ -408,7 +408,7 @@ /** - * Returns the property bag for this Endpoint instance. + * Returns the property bag for this {@code Endpoint} instance. * * @return Map<String,Object> The property bag * associated with this instance. @@ -416,7 +416,7 @@ public abstract Map getProperties(); /** - * Sets the property bag for this Endpoint instance. + * Sets the property bag for this {@code Endpoint} instance. * * @param properties The property bag associated with * this instance. @@ -424,24 +424,24 @@ public abstract void setProperties(Map properties); /** - * Returns the EndpointReference associated with - * this Endpoint instance. + * Returns the {@code EndpointReference} associated with + * this {@code Endpoint} instance. *

- * If the Binding for this bindingProvider is + * If the Binding for this {@code bindingProvider} is * either SOAP1.1/HTTP or SOAP1.2/HTTP, then a - * W3CEndpointReference MUST be returned. + * {@code W3CEndpointReference} MUST be returned. * * @param referenceParameters Reference parameters to be associated with the - * returned EndpointReference instance. - * @return EndpointReference of this Endpoint instance. - * If the returned EndpointReference is of type - * W3CEndpointReference then it MUST contain the - * the specified referenceParameters. + * returned {@code EndpointReference} instance. + * @return EndpointReference of this {@code Endpoint} instance. + * If the returned {@code EndpointReference} is of type + * {@code W3CEndpointReference} then it MUST contain the + * the specified {@code referenceParameters}. * @throws WebServiceException If any error in the creation of - * the EndpointReference or if the Endpoint is + * the {@code EndpointReference} or if the {@code Endpoint} is * not in the published state. - * @throws UnsupportedOperationException If this BindingProvider + * @throws UnsupportedOperationException If this {@code BindingProvider} * uses the XML/HTTP binding. * * @see W3CEndpointReference @@ -452,23 +452,23 @@ /** - * Returns the EndpointReference associated with - * this Endpoint instance. + * Returns the {@code EndpointReference} associated with + * this {@code Endpoint} instance. * * @param clazz Specifies the type of EndpointReference that MUST be returned. * @param referenceParameters Reference parameters to be associated with the - * returned EndpointReference instance. - * @return EndpointReference of type clazz of this - * Endpoint instance. - * If the returned EndpointReference is of type - * W3CEndpointReference then it MUST contain the - * the specified referenceParameters. + * returned {@code EndpointReference} instance. + * @return EndpointReference of type {@code clazz} of this + * {@code Endpoint} instance. + * If the returned {@code EndpointReference} is of type + * {@code W3CEndpointReference} then it MUST contain the + * the specified {@code referenceParameters}. * @throws WebServiceException If any error in the creation of - * the EndpointReference or if the Endpoint is - * not in the published state or if the clazz is not a supported - * EndpointReference type. - * @throws UnsupportedOperationException If this BindingProvider + * the {@code EndpointReference} or if the {@code Endpoint} is + * not in the published state or if the {@code clazz} is not a supported + * {@code EndpointReference} type. + * @throws UnsupportedOperationException If this {@code BindingProvider} * uses the XML/HTTP binding. * * @@ -478,7 +478,7 @@ Element... referenceParameters); /** - * By settng a EndpointContext, JAX-WS runtime knows about + * By settng a {@code EndpointContext}, JAX-WS runtime knows about * addresses of other endpoints in an application. If multiple endpoints * share different ports of a WSDL, then the multiple port addresses * are patched when the WSDL is accessed.