Тип аннотации 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.