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
Уровень изоляции для соединений. Уровень изоляции должен быть одним из следующего:

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

С тех пор:
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 свойства, такие как:

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

С тех пор:
1.1
Значение по умолчанию:
{}

loginTimeout

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

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

С тех пор:
1.1
Значение по умолчанию:
0


Представьте ошибку или функцию

Авторское право © 2009-2011, Oracle Corporation и/или его филиалы. Все права защищены. Использование подвергается срокам действия лицензии.

Сгенерированный на 10-February-2011 12:41


Spec-Zone.ru - all specs in one place



free hit counter