< prev index next >

src/java.xml.ws/share/classes/javax/xml/ws/WebServiceRef.java

Print this page

        

*** 1,7 **** /* ! * Copyright (c) 2005, 2014, 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 * under the terms of the GNU General Public License version 2 only, as * published by the Free Software Foundation. Oracle designates this --- 1,7 ---- /* ! * 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 * under the terms of the GNU General Public License version 2 only, as * published by the Free Software Foundation. Oracle designates this
*** 32,42 **** import java.lang.annotation.ElementType; import java.lang.annotation.Retention; import java.lang.annotation.RetentionPolicy; /** ! * The <code>WebServiceRef</code> annotation is used to * define a reference to a web service and * (optionally) an injection target for it. * It can be used to inject both service and proxy * instances. These injected references are not thread safe. * If the references are accessed by multiple threads, --- 32,42 ---- import java.lang.annotation.ElementType; import java.lang.annotation.Retention; import java.lang.annotation.RetentionPolicy; /** ! * The {@code WebServiceRef} annotation is used to * define a reference to a web service and * (optionally) an injection target for it. * It can be used to inject both service and proxy * instances. These injected references are not thread safe. * If the references are accessed by multiple threads,
*** 45,78 **** * * <p> * Web service references are resources in the Java EE 5 sense. * The annotations (for example, {@link Addressing}) annotated with * meta-annotation {@link WebServiceFeatureAnnotation} ! * can be used in conjunction with <code>WebServiceRef</code>. * The created reference MUST be configured with annotation's web service * feature. * * <p> * For example, in the code below, the injected ! * <code>StockQuoteProvider</code> proxy MUST * have WS-Addressing enabled as specifed by the * {@link Addressing} * annotation. * * <pre><code> * public class MyClient { ! * @Addressing ! * @WebServiceRef(StockQuoteService.class) * private StockQuoteProvider stockQuoteProvider; * ... * } * </code></pre> * * <p> * If a JAX-WS implementation encounters an unsupported or unrecognized ! * annotation annotated with the <code>WebServiceFeatureAnnotation</code> ! * that is specified with <code>WebServiceRef</code>, an ERROR MUST be given. * * @see javax.annotation.Resource * @see WebServiceFeatureAnnotation * * @since 1.6, JAX-WS 2.0 --- 45,78 ---- * * <p> * Web service references are resources in the Java EE 5 sense. * The annotations (for example, {@link Addressing}) annotated with * meta-annotation {@link WebServiceFeatureAnnotation} ! * can be used in conjunction with {@code WebServiceRef}. * The created reference MUST be configured with annotation's web service * feature. * * <p> * For example, in the code below, the injected ! * {@code StockQuoteProvider} proxy MUST * have WS-Addressing enabled as specifed by the * {@link Addressing} * annotation. * * <pre><code> * public class MyClient { ! * {@literal @}Addressing ! * {@literal @}WebServiceRef(StockQuoteService.class) * private StockQuoteProvider stockQuoteProvider; * ... * } * </code></pre> * * <p> * If a JAX-WS implementation encounters an unsupported or unrecognized ! * annotation annotated with the {@code WebServiceFeatureAnnotation} ! * that is specified with {@code WebServiceRef}, an ERROR MUST be given. * * @see javax.annotation.Resource * @see WebServiceFeatureAnnotation * * @since 1.6, JAX-WS 2.0
*** 89,99 **** * the default is the JavaBeans property name corresponding * to the method. For class annotations, there is no default * and this MUST be specified. * * The JNDI name can be absolute(with any logical namespace) or relative ! * to JNDI <code>java:comp/env</code> namespace. */ String name() default ""; /** * The Java type of the resource. For field annotations, --- 89,99 ---- * the default is the JavaBeans property name corresponding * to the method. For class annotations, there is no default * and this MUST be specified. * * The JNDI name can be absolute(with any logical namespace) or relative ! * to JNDI {@code java:comp/env} namespace. */ String name() default ""; /** * The Java type of the resource. For field annotations,
*** 104,118 **** */ Class<?> type() default Object.class; /** * A product specific name that this resource should be mapped to. ! * The name of this resource, as defined by the <code>name</code> * element or defaulted, is a name that is local to the application * component using the resource. (When a relative JNDI name * is specified, then it's a name in the JNDI ! * <code>java:comp/env</code> namespace.) Many application servers * provide a way to map these local names to names of resources * known to the application server. This mapped name is often a * <i>global</i> JNDI name, but may be a name of any form. * <p> * Application servers are not required to support any particular --- 104,118 ---- */ Class<?> type() default Object.class; /** * A product specific name that this resource should be mapped to. ! * The name of this resource, as defined by the {@code name} * element or defaulted, is a name that is local to the application * component using the resource. (When a relative JNDI name * is specified, then it's a name in the JNDI ! * {@code java:comp/env} namespace.) Many application servers * provide a way to map these local names to names of resources * known to the application server. This mapped name is often a * <i>global</i> JNDI name, but may be a name of any form. * <p> * Application servers are not required to support any particular
*** 122,132 **** */ String mappedName() default ""; /** * The service class, always a type extending ! * <code>javax.xml.ws.Service</code>. This element MUST be specified * whenever the type of the reference is a service endpoint interface. */ // 2.1 has Class value() default Object.class; // Fixing this raw Class type correctly in 2.2 API. This shouldn't cause // any compatibility issues for applications. --- 122,132 ---- */ String mappedName() default ""; /** * The service class, always a type extending ! * {@code javax.xml.ws.Service}. This element MUST be specified * whenever the type of the reference is a service endpoint interface. */ // 2.1 has Class value() default Object.class; // Fixing this raw Class type correctly in 2.2 API. This shouldn't cause // any compatibility issues for applications.
< prev index next >