Spec-Zone.ru › OpenJDK 8

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


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

Аннотация Resource отмечает ресурс, необходимый для приложения. Данную аннотацию можно применить к классу компонента приложения, а также к полям или методам этого класса. Когда аннотация применяется к полю или методу, контейнер введёт экземпляр запрошенного ресурса в компонент приложения при инициализации компонента. Если аннотация применяется к классу компонента, она объявляет ресурс, который приложение будет искать во время выполнения.

Несмотря на то, что эта аннотация не помечена как унаследованная, инструментарий развертывания должен проверять все суперклассы любого класса компонента, чтобы обнаружить все применения этой аннотации во всех суперклассах. Все такие экземпляры аннотаций определяют ресурсы, необходимые компоненту приложения. Обратите внимание, что эта аннотация может присутствовать в закрытых полях и методах суперклассов; в этих случаях контейнер также обязан выполнить инъекцию.

С:
Общие аннотации 1.0

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

Модификатор и тип Дополнительный элемент и описание
Resource.AuthenticationType authenticationType

Тип аутентификации, который следует использовать для этого ресурса.

String description

Описание этого ресурса.

String lookup

Имя ресурса, на который указывает ссылка.

String mappedName

Имя ресурса, специфичное для продукта, которому должен быть сопоставлен этот ресурс.

String name

Имя ресурса в JNDI.

boolean shareable

Указывает, можно ли разделять этот ресурс между этим компонентом и другими компонентами.

Class<?> type

Тип Java ресурса.

Элементы

name

public abstract String name

Имя ресурса в JNDI. Для аннотаций полей значение по умолчанию — имя поля. Для аннотаций методов значение по умолчанию — имя свойства JavaBeans, соответствующее методу. Для аннотаций класса значение по умолчанию отсутствует, и оно должно быть указано.

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

lookup

public abstract String lookup

Имя ресурса, на который указывает ссылка. Оно может ссылаться на любой совместимый ресурс, используя глобальные имена JNDI.

С:
Общие аннотации 1.1
Значение по умолчанию:
""

type

public abstract Class<?> type

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

Значение по умолчанию:
java.lang.Object.class

authenticationType

public abstract Resource.AuthenticationType authenticationType

Тип аутентификации, который следует использовать для этого ресурса. Это может быть указано для ресурсов, представляющих фабрику подключений любого поддерживаемого типа, и не должно быть указано для ресурсов других типов.

Значение по умолчанию:
javax.annotation.Resource.AuthenticationType.CONTAINER

shareable

public abstract boolean shareable

Указывает, можно ли разделять этот ресурс между этим компонентом и другими компонентами. Это может быть указано для ресурсов, представляющих фабрику подключений любого поддерживаемого типа, и не должно быть указано для ресурсов других типов.

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

mappedName

public abstract String mappedName

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

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

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

description

public abstract String description

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

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

© 1993, 2020, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API