Spec-Zone .ru спецификации, руководства, описания, API

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

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

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

имя

public abstract java.lang.String name

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

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

""

ввести

public abstract java.lang.Class<?> type

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

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

java.lang. Объект. class

mappedName

public abstract java.lang.String mappedName

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

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

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

""

значение

public abstract java.lang.Class<? extends Service> value

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

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

javax.xml.ws. Служба. class

wsdlLocation

public abstract java.lang.String wsdlLocation

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

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

""

поиск

public abstract java.lang.String lookup

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

С тех пор:

JAX-WS 2.2

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

""