--- old/src/java.xml.ws/share/classes/javax/xml/ws/WebServiceContext.java 2015-07-09 12:14:10.000000000 +0200 +++ new/src/java.xml.ws/share/classes/javax/xml/ws/WebServiceContext.java 2015-07-09 12:14:10.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 @@ -32,14 +32,14 @@ /** - * A WebServiceContext makes it possible for + * A {@code WebServiceContext} makes it possible for * a web service endpoint implementation class to access * message context and security information relative to * a request being served. * - * Typically a WebServiceContext is injected + * Typically a {@code WebServiceContext} is injected * into an endpoint implementation class using the - * Resource annotation. + * {@code Resource} annotation. * * @since 1.6, JAX-WS 2.0 * @@ -48,7 +48,7 @@ public interface WebServiceContext { /** - * Returns the MessageContext for the request being served + * Returns the {@code MessageContext} for the request being served * at the time this method is called. Only properties with * APPLICATION scope will be visible to the application. * @@ -68,7 +68,7 @@ * Returns the Principal that identifies the sender * of the request currently being serviced. If the * sender has not been authenticated, the method - * returns null. + * returns {@code null}. * * @return Principal The principal object. * @@ -85,11 +85,11 @@ * Returns a boolean indicating whether the * authenticated user is included in the specified * logical role. If the user has not been - * authenticated, the method returns false. + * authenticated, the method returns {@code false}. * - * @param role A String specifying the name of the role + * @param role A {@code String} specifying the name of the role * - * @return a boolean indicating whether + * @return a {@code boolean} indicating whether * the sender of the request belongs to a given role * * @throws IllegalStateException This exception is thrown @@ -99,20 +99,20 @@ public boolean isUserInRole(String role); /** - * Returns the EndpointReference for this + * Returns the {@code EndpointReference} for this * endpoint. *

- * If the {@link Binding} for this bindingProvider is + * If the {@link 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. + * returned {@code EndpointReference} instance. * @return EndpointReference of the endpoint associated with this - * WebServiceContext. - * If the returned EndpointReference is of type - * W3CEndpointReference then it MUST contain the - * the specified referenceParameters. + * {@code WebServiceContext}. + * If the returned {@code EndpointReference} is of type + * {@code W3CEndpointReference} then it MUST contain the + * the specified {@code referenceParameters}. * * @throws IllegalStateException This exception is thrown * if the method is called while no request is @@ -125,24 +125,24 @@ public EndpointReference getEndpointReference(Element... referenceParameters); /** - * Returns the EndpointReference associated with + * Returns the {@code EndpointReference} associated with * this endpoint. * - * @param clazz The type of EndpointReference that + * @param clazz The type of {@code EndpointReference} that * MUST be returned. * @param referenceParameters Reference parameters to be associated with the - * returned EndpointReference instance. - * @return EndpointReference of type clazz of the endpoint - * associated with this WebServiceContext 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 the endpoint + * associated with this {@code WebServiceContext} instance. + * If the returned {@code EndpointReference} is of type + * {@code W3CEndpointReference} then it MUST contain the + * the specified {@code referenceParameters}. * * @throws IllegalStateException This exception is thrown * if the method is called while no request is * being serviced. - * @throws WebServiceException If the clazz type of - * EndpointReference is not supported. + * @throws WebServiceException If the {@code clazz} type of + * {@code EndpointReference} is not supported. * * @since 1.6, JAX-WS 2.1 **/