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

javax.annotation.sql
Тип аннотации DataSourceDefinition

@Target(value=TYPE)
@Retention(value=RUNTIME)
public @interface DataSourceDefinition

Аннотация, используемая, чтобы определить контейнер DataSource и быть зарегистрированным в JNDI. DataSource может быть сконфигурирован, устанавливая элементы аннотации для обычно используемого DataSource свойства. Дополнительные стандартные и специфичные для поставщика свойства могут быть определены, используя properties элемент.

Источник данных будет зарегистрирован под именем указанный в name элемент. Это может быть определено, чтобы быть в любом допустимом Java EE пространство имен, и определит доступность источника данных от других компонентов.

Реализация драйвера JDBC class соответствующего типа, также DataSource, ConnectionPoolDataSource, или XADataSource, должен быть обозначен className элемент. Доступность драйвера class будет принята во времени выполнения.

url свойство не должно быть определено в соединении с другими стандартными свойствами для того, чтобы определить связь к базе данных. Если url свойство определяется наряду с другим стандартом DataSource свойства такой как serverName и portNumber, более определенные свойства будут иметь приоритет и url будет проигнорирован.

Поставщики не обязаны поддерживать свойства, которые обычно не применяются к определенному типу источника данных. Например, определение transactional свойство, чтобы быть true но предоставляя значение для className это реализует источник данных class кроме XADataSource возможно, не поддерживается.

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

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

Примеры:

   @DataSourceDefinition(name="java:global/MyApp/MyDataSource",
      className="com.foobar.MyDataSource",
      portNumber=6689,
      serverName="myserver.com",
      user="lance",
      password="secret"
   )
 
 

Используя a URL:

  @DataSourceDefinition(name="java:global/MyApp/MyDataSource",
    className="org.apache.derby.jdbc.ClientDataSource",
    url="jdbc:derby://localhost:1527/myDB",
    user="lance",
    password="secret"
 )
 

Поиск в качестве примера DataSource от EJB:

 @Stateless
 public class MyStatelessEJB {
   @Resource(lookup="java:global/MyApp/myDataSource")
    DataSource myDB;
      ...
 }
 

С тех пор:

Общие Аннотации 1.1

См. Также:

DataSource, XADataSource, ConnectionPoolDataSource

Необходимая Сводка Элемента

java.lang.String	имя класса Имя class реализации DataSource, которое реализует: javax.sql.DataSource или javax.sql.XADataSource или javax.sql.ConnectionPoolDataSource.
java.lang.String	имя JNDI называют, которым будет зарегистрирован источник данных.

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

java.lang.String	databaseName Имя базы данных на сервере.
java.lang.String	описание Описание этого источника данных
int	initialPoolSize Число соединений, которые должны быть созданы, когда пул соединения инициализируется.
int	isolationLevel Уровень изоляции для соединений.
int	loginTimeout Устанавливает максимальное время в секундах, которые этот источник данных будет ожидать, пытаясь соединить с базой данных.
int	maxIdleTime Число секунд, что физическое соединение должно остаться неиспользованным в пуле перед соединением, закрывается для пула соединения.
int	maxPoolSize Максимальное количество соединений, которые должны быть одновременно выделены для пула соединения.
int	maxStatements Общее количество операторов, которые пул соединения должен сохранить открытым.
int	minPoolSize Минимальное число соединений, которые должны быть выделены для пула соединения.
java.lang.String	пароль Пароль, чтобы использовать для аутентификации соединения.
int	номер порта Номер порта, где сервер прислушивается к запросам.
java.lang.String[]	свойства Используемый, чтобы определить Поставщика определенные свойства и реже используемый DataSource свойства, такие как:
java.lang.String	имя сервера Имя сервера базы данных.
boolean	транзакционный Набор к false если соединения не должны участвовать в транзакциях.
java.lang.String	url URL JDBC.
java.lang.String	пользователь Имя пользователя, чтобы использовать для аутентификации соединения.

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

имя

public abstract java.lang.String name

JNDI называют, которым будет зарегистрирован источник данных.

С тех пор:

1.1

имя класса

public abstract java.lang.String className

Имя class реализации DataSource, которое реализует: javax.sql.DataSource или javax.sql.XADataSource или javax.sql.ConnectionPoolDataSource.

С тех пор:

1.1

описание

public abstract java.lang.String description

Описание этого источника данных

С тех пор:

1.1

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

""

url

public abstract java.lang.String url

URL JDBC. Если url свойство определяется наряду с другим стандартом DataSource свойства такой как serverName и portNumber, более определенные свойства будут иметь приоритет и url будет проигнорирован.

С тех пор:

1.1

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

""

пользователь

public abstract java.lang.String user

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

С тех пор:

1.1

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

""

пароль

public abstract java.lang.String password

Пароль, чтобы использовать для аутентификации соединения.

С тех пор:

1.1

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

""

databaseName

public abstract java.lang.String databaseName

Имя базы данных на сервере.

С тех пор:

1.1

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

""

номер порта

public abstract int portNumber

Номер порта, где сервер прислушивается к запросам.

С тех пор:

1.1

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

-1

имя сервера

public abstract java.lang.String serverName

Имя сервера базы данных.

С тех пор:

1.1

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

"localhost"

isolationLevel

public abstract int isolationLevel

Уровень изоляции для соединений. Уровень изоляции должен быть одним из следующего:

• Соединение. TRANSACTION_NONE,
• Соединение. НЕЗАФИКСИРОВАННЫЙ TRANSACTION_READ_,
• Соединение. TRANSACTION_READ_COMMITTED,
• Соединение. TRANSACTION_REPEATABLE_READ,
• Соединение. TRANSACTION_SERIALIZABLE

Значение по умолчанию специфично для поставщика.

С тех пор:

1.1

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

-1

транзакционный

public abstract boolean transactional

Набор к false если соединения не должны участвовать в транзакциях.

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

С тех пор:

1.1

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

истина

initialPoolSize

public abstract int initialPoolSize

Число соединений, которые должны быть созданы, когда пул соединения инициализируется.

Значение по умолчанию специфично для поставщика

С тех пор:

1.1

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

-1

maxPoolSize

public abstract int maxPoolSize

Максимальное количество соединений, которые должны быть одновременно выделены для пула соединения.

Значение по умолчанию специфично для поставщика.

С тех пор:

1.1

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

-1

minPoolSize

public abstract int minPoolSize

Минимальное число соединений, которые должны быть выделены для пула соединения.

Значение по умолчанию специфично для поставщика.

С тех пор:

1.1

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

-1

maxIdleTime

public abstract int maxIdleTime

Число секунд, что физическое соединение должно остаться неиспользованным в пуле перед соединением, закрывается для пула соединения.

Значение по умолчанию специфично для поставщика

С тех пор:

1.1

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

-1

maxStatements

public abstract int maxStatements

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

Значение по умолчанию специфично для поставщика

С тех пор:

1.1

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

-1

свойства

public abstract java.lang.String[] properties

Используемый, чтобы определить Поставщика определенные свойства и реже используемый DataSource свойства, такие как:

• dataSourceName
• networkProtocol
• propertyCycle
• roleName

Свойства определяются, используя формат: propertyName=propertyValue с одним свойством на элемент массива.

С тех пор:

1.1

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

{}

loginTimeout

public abstract int loginTimeout

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

Значение по умолчанию специфично для поставщика.

С тех пор:

1.1

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

0