Тип аннотации WebServiceRef

@Target(value={TYPE,METHOD,FIELD})
 @Retention(value=RUNTIME)
 @Documented
public @interface WebServiceRef

Аннотация WebServiceRef используется для определения ссылки на веб-сервис и (необязательно) целевого объекта для инъекции. Она может использоваться для инъекции как экземпляров сервиса, так и прокси. Эти инжектированные ссылки не являются потокобезопасными. Если к ссылкам обращаются несколько потоков, для поддержки нескольких потоков можно использовать обычные методы синхронизации.

Ссылки на веб-сервисы являются ресурсами в смысле Java EE 5. Аннотации (например, Addressing), помеченные мета-аннотацией WebServiceFeatureAnnotation, могут использоваться совместно с WebServiceRef. Созданная ссылка ДОЛЖНА быть настроена с веб-функцией аннотации.

Например, в коде ниже инжектированный StockQuoteProvider прокси ДОЛЖЕН иметь включенный WS-Addressing, как указано аннотацией Addressing.

public class MyClient {
       @Addressing
       @WebServiceRef(StockQuoteService.class)
       private StockQuoteProvider stockQuoteProvider;
       ...
    }

Если реализация JAX-WS сталкивается с неподдерживаемой или нераспознанной аннотацией, помеченной аннотацией WebServiceFeatureAnnotation, которая указана WebServiceRef, то ДОЛЖНО быть выдано сообщение об ОШИБКЕ.

Элементы

name

public abstract String name

Имя ресурса в JNDI. Для аннотаций полей, значение по умолчанию — имя поля. Для аннотаций методов, значение по умолчанию — имя свойства JavaBeans, соответствующее методу. Для аннотаций классов, значение по умолчанию отсутствует и оно ДОЛЖНО быть указано. Имя JNDI может быть абсолютным (с любым логическим пространством имён) или относительным к пространству имён JNDI java:comp/env.

Значение по умолчанию:

""

type

public abstract Class<?> type

Тип ресурса в Java. Для аннотаций полей, значение по умолчанию — тип поля. Для аннотаций методов, значение по умолчанию — тип свойства JavaBeans. Для аннотаций классов, значение по умолчанию отсутствует и оно ДОЛЖНО быть указано.

Значение по умолчанию:

java.lang.Object.class

mappedName

public abstract String mappedName

Значение по умолчанию:

""

value

public abstract Class<? extends Service> value

Класс сервиса, всегда тип, расширяющий javax.xml.ws.Service. Этот элемент ДОЛЖЕН быть указан, когда тип ссылки — интерфейс точки входа сервиса.

Значение по умолчанию:

javax.xml.ws.Service.class

wsdlLocation

public abstract String wsdlLocation

URL, указывающий на документ WSDL для веб-сервиса. Если не указано, используется расположение WSDL, указанное аннотациями на типе ресурса.

Значение по умолчанию:

""

lookup

public abstract String lookup

Переносная имя поиска JNDI, которое разрешается до целевой ссылки на веб-сервис.

С момента:

JAX-WS 2.2

Значение по умолчанию:

""