javax.xml.ws

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

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

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

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

Например, в коде ниже, введенный StockQuoteProvider прокси НУЖНО БЫЛО включить Адресации WS как specifed Addressing аннотация.

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

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

С тех пор:

JAX-WS 2.0

См. Также:

Resource, WebServiceFeatureAnnotation

Дополнительная Сводка Элемента

Дополнительные Элементы

Модификатор и Тип	Дополнительный Элемент и Описание
Строка	поиск Переносимое имя поиска JNDI, которое решает к целевой ссылке веб-сервиса.
Строка	mappedName Собственное имя продукта, на которое должен быть отображен этот ресурс.
Строка	имя Имя JNDI ресурса.
Class<?>	ввести Тип Java ресурса.
Class<? extends Service>	значение Класс службы, alwiays расширение типа javax.xml.ws.Service.
Строка	wsdlLocation URL, указывающий на документ WSDL для веб-сервиса.

Деталь элемента

имя

public abstract String name

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

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

""

ввести

public abstract Class<?> type

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

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

java.lang. Object.class

mappedName

public abstract String mappedName

Собственное имя продукта, на которое должен быть отображен этот ресурс. Имя этого ресурса, как определено name элемент или принимал значение по умолчанию, имя, которое локально для компонента приложения, используя ресурс. (Когда относительное имя JNDI определяется, тогда это - имя в JNDI java:comp/env пространство имен.) Много серверов приложений обеспечивают способ отобразить эти локальные имена к именам ресурсов, известных серверу приложений. Это отображенное имя часто является глобальным именем JNDI, но может быть именем любой формы.

Серверы приложений не обязаны поддерживать любую определенную форму или тип отображенного имени, ни возможность использовать отображенные имена. Отображенное имя зависимо от продукта и часто зависимо от установки. Нет смысла в отображенном имени переносимо.

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

""

значение

public abstract Class<? extends Service> value

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

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

javax.xml.ws. Service.class

wsdlLocation

public abstract String wsdlLocation

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

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

""

поиск

public abstract String lookup

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

С тех пор:

JAX-WS 2.2

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

""