< prev index next >

src/java.xml.ws/share/classes/javax/xml/ws/spi/Provider.java

Print this page


   1 /*
   2  * Copyright (c) 2005, 2014, Oracle and/or its affiliates. All rights reserved.
   3  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
   4  *
   5  * This code is free software; you can redistribute it and/or modify it
   6  * under the terms of the GNU General Public License version 2 only, as
   7  * published by the Free Software Foundation.  Oracle designates this
   8  * particular file as subject to the "Classpath" exception as provided
   9  * by Oracle in the LICENSE file that accompanied this code.
  10  *
  11  * This code is distributed in the hope that it will be useful, but WITHOUT
  12  * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
  13  * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
  14  * version 2 for more details (a copy is included in the LICENSE file that
  15  * accompanied this code).
  16  *
  17  * You should have received a copy of the GNU General Public License version
  18  * 2 along with this work; if not, write to the Free Software Foundation,
  19  * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
  20  *
  21  * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
  22  * or visit www.oracle.com if you need additional information or have any


 271      *
 272      * @since 1.6, JAX-WS 2.1
 273      **/
 274     public abstract <T> T getPort(EndpointReference endpointReference,
 275             Class<T> serviceEndpointInterface,
 276             WebServiceFeature... features);
 277 
 278     /**
 279      * Factory method to create a {@code W3CEndpointReference}.
 280      *
 281      * <p>
 282      * This method can be used to create a {@code W3CEndpointReference}
 283      * for any endpoint by specifying the {@code address} property along
 284      * with any other desired properties.  This method
 285      * can also be used to create a {@code W3CEndpointReference} for
 286      * an endpoint that is published by the same Java EE application.
 287      * To do so the {@code address} property can be provided or this
 288      * method can automatically determine the {@code address} of
 289      * an endpoint that is published by the same Java EE application and is
 290      * identified by the {@code serviceName} and
 291      * {@code portName} propeties.  If the {@code address} is
 292      * {@code null} and the {@code serviceName} and
 293      * {@code portName} do not identify an endpoint published by the
 294      * same Java EE application, a
 295      * {@code javax.lang.IllegalStateException} MUST be thrown.
 296      *
 297      * @param address Specifies the address of the target endpoint
 298      * @param serviceName Qualified name of the service in the WSDL.
 299      * @param portName Qualified name of the endpoint in the WSDL.
 300      * @param metadata A list of elements that should be added to the
 301      * {@code W3CEndpointReference} instances {@code wsa:metadata}
 302      * element.
 303      * @param wsdlDocumentLocation URL for the WSDL document location for
 304      * the service.
 305      * @param referenceParameters Reference parameters to be associated
 306      * with the returned {@code EndpointReference} instance.
 307      *
 308      * @return the {@code W3CEndpointReference} created from
 309      *          {@code serviceName}, {@code portName},
 310      *          {@code metadata}, {@code wsdlDocumentLocation}
 311      *          and {@code referenceParameters}. This method


   1 /*
   2  * Copyright (c) 2005, 2015, Oracle and/or its affiliates. All rights reserved.
   3  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
   4  *
   5  * This code is free software; you can redistribute it and/or modify it
   6  * under the terms of the GNU General Public License version 2 only, as
   7  * published by the Free Software Foundation.  Oracle designates this
   8  * particular file as subject to the "Classpath" exception as provided
   9  * by Oracle in the LICENSE file that accompanied this code.
  10  *
  11  * This code is distributed in the hope that it will be useful, but WITHOUT
  12  * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
  13  * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
  14  * version 2 for more details (a copy is included in the LICENSE file that
  15  * accompanied this code).
  16  *
  17  * You should have received a copy of the GNU General Public License version
  18  * 2 along with this work; if not, write to the Free Software Foundation,
  19  * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
  20  *
  21  * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
  22  * or visit www.oracle.com if you need additional information or have any


 271      *
 272      * @since 1.6, JAX-WS 2.1
 273      **/
 274     public abstract <T> T getPort(EndpointReference endpointReference,
 275             Class<T> serviceEndpointInterface,
 276             WebServiceFeature... features);
 277 
 278     /**
 279      * Factory method to create a {@code W3CEndpointReference}.
 280      *
 281      * <p>
 282      * This method can be used to create a {@code W3CEndpointReference}
 283      * for any endpoint by specifying the {@code address} property along
 284      * with any other desired properties.  This method
 285      * can also be used to create a {@code W3CEndpointReference} for
 286      * an endpoint that is published by the same Java EE application.
 287      * To do so the {@code address} property can be provided or this
 288      * method can automatically determine the {@code address} of
 289      * an endpoint that is published by the same Java EE application and is
 290      * identified by the {@code serviceName} and
 291      * {@code portName} properties.  If the {@code address} is
 292      * {@code null} and the {@code serviceName} and
 293      * {@code portName} do not identify an endpoint published by the
 294      * same Java EE application, a
 295      * {@code javax.lang.IllegalStateException} MUST be thrown.
 296      *
 297      * @param address Specifies the address of the target endpoint
 298      * @param serviceName Qualified name of the service in the WSDL.
 299      * @param portName Qualified name of the endpoint in the WSDL.
 300      * @param metadata A list of elements that should be added to the
 301      * {@code W3CEndpointReference} instances {@code wsa:metadata}
 302      * element.
 303      * @param wsdlDocumentLocation URL for the WSDL document location for
 304      * the service.
 305      * @param referenceParameters Reference parameters to be associated
 306      * with the returned {@code EndpointReference} instance.
 307      *
 308      * @return the {@code W3CEndpointReference} created from
 309      *          {@code serviceName}, {@code portName},
 310      *          {@code metadata}, {@code wsdlDocumentLocation}
 311      *          and {@code referenceParameters}. This method


< prev index next >