* published by the Free Software Foundation. Oracle designates this * particular file as subject to the "Classpath" exception as provided * by Oracle in the LICENSE file that accompanied this code. * This code is distributed in the hope that it will be useful, but WITHOUT * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License * version 2 for more details (a copy is included in the LICENSE file that * accompanied this code). * You should have received a copy of the GNU General Public License version * 2 along with this work; if not, write to the Free Software Foundation, * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA. * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA * or visit www.oracle.com if you need additional information or have any * A <code>WebServiceContext</code> 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 <code>WebServiceContext</code> is injected * into an endpoint implementation class using the * <code>Resource</code> annotation. * @see javax.annotation.Resource * Returns the <code>MessageContext</code> for the request being served * at the time this method is called. Only properties with * APPLICATION scope will be visible to the application. * @return MessageContext The message context. * @throws IllegalStateException This exception is thrown * if the method is called while no request is * @see javax.xml.ws.handler.MessageContext.Scope * @see java.lang.IllegalStateException * Returns the Principal that identifies the sender * of the request currently being serviced. If the * sender has not been authenticated, the method * returns <code>null</code>. * @return Principal The principal object. * @throws IllegalStateException This exception is thrown * if the method is called while no request is * @see java.security.Principal * @see java.lang.IllegalStateException * 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 <code>false</code>. * @param role A <code>String</code> specifying the name of the role * @return a <code>boolean</code> indicating whether * the sender of the request belongs to a given role * @throws IllegalStateException This exception is thrown * if the method is called while no request is * Returns the <code>EndpointReference</code> for this * If the {@link Binding} for this <code>bindingProvider</code> is * <code>W3CEndpointReference</code> MUST be returned. * @param referenceParameters Reference parameters to be associated with the * returned <code>EndpointReference</code> instance. * @return EndpointReference of the endpoint associated with this * <code>WebServiceContext</code>. * If the returned <code>EndpointReference</code> is of type * <code>W3CEndpointReference</code> then it MUST contain the * the specified <code>referenceParameters</code>. * @throws IllegalStateException This exception is thrown * if the method is called while no request is * @see W3CEndpointReference * Returns the <code>EndpointReference</code> associated with * @param clazz The type of <code>EndpointReference</code> that * @param referenceParameters Reference parameters to be associated with the * returned <code>EndpointReference</code> instance. * @return EndpointReference of type <code>clazz</code> of the endpoint * associated with this <code>WebServiceContext</code> instance. * If the returned <code>EndpointReference</code> is of type * <code>W3CEndpointReference</code> then it MUST contain the * the specified <code>referenceParameters</code>. * @throws IllegalStateException This exception is thrown * if the method is called while no request is * @throws WebServiceException If the <code>clazz</code> type of * <code>EndpointReference</code> is not supported.