Spec-Zone .ru
спецификации, руководства, описания, API
|
|
|||||||||
ПРЕДЫДУЩИЙ КЛАСС СЛЕДУЮЩИЙ КЛАСС | ФРЕЙМЫ НИКАКИЕ ФРЕЙМЫ | ||||||||
СВОДКА: ВЛОЖЕННЫЙ | ПОЛЕ | CONSTR | МЕТОД | ДЕТАЛЬ: ПОЛЕ | CONSTR | МЕТОД |
public interface TransactionSynchronizationRegistry
Этот интерфейс предназначается для использования системными компонентами сервера приложений уровня, такими как менеджеры по персистентности, адаптеры ресурса, так же как компоненты Веб-приложения и EJB. Это обеспечивает возможность зарегистрировать объекты синхронизации в специальной семантике упорядочивания, объединённые объекты ресурса с текущей транзакцией, получить контекст транзакции текущей транзакции, получить текущее состояние транзакции, и отметить текущую транзакцию для отката. Этот интерфейс реализуется сервером приложений объектом службы не сохраняющим состояние. Тот же самый объект может использоваться любым числом компонентов с потокобезопасностью.
В стандартных средах серверов приложений экземпляр, реализовывая этот интерфейс может искаться стандартным именем через JNDI. Стандартное имя java:comp/TransactionSynchronizationRegistry.
Сводка метода | |
---|---|
java.lang.Object |
getResource(java.lang.Object key)
Получите объект из Карты ресурсов, являющихся управляемым для транзакции, связанной с текущим потоком в то время, когда этот метод вызывают. |
boolean |
getRollbackOnly()
Получите rollbackOnly состояние транзакции, связанной с текущим потоком в то время, когда этот метод вызывают. |
java.lang.Object |
getTransactionKey()
Возвратите непрозрачный объект представить транзакцию, связанную с текущим потоком в то время, когда этот метод вызывают. |
int |
getTransactionStatus()
Возвратите состояние транзакции, связанной с текущим потоком в то время, когда этот метод вызывают. |
void |
putResource(java.lang.Object key, java.lang.Object value)
Добавьте или замените объект в Карте ресурсов, являющихся управляемым для транзакции, связанной с текущим потоком в то время, когда этот метод вызывают. |
void |
registerInterposedSynchronization(Synchronization sync)
Зарегистрируйте экземпляр Синхронизации в специальной семантике упорядочивания. |
void |
setRollbackOnly()
Установите rollbackOnly состояние транзакции, связанной с текущим потоком в то время, когда этот метод вызывают. |
Деталь метода |
---|
java.lang.Object getTransactionKey()
Этот объект возвратит тот же самый хэш-код и сравнится равный всем другим объектам, возвращенным, вызывая этот метод от любого компонента, выполняющегося в том же самом контексте транзакции в том же самом сервере приложений.
toString метод возвращает Строку, которая могла бы быть применимой читателем, чтобы полезно понять контекст транзакции. Результат toString иначе не определяется. Определенно, нет никакой гарантии прямой совместимости или обратной совместимости результатов toString.
Объект не обязательно сериализуем, и не имеет никакого определенного поведения вне виртуальной машины откуда, это было получено.
void putResource(java.lang.Object key, java.lang.Object value)
Map.put(Object, Object)
для Карты, которая поддерживает ненулевые ключи и нулевые значения. Например, если уже есть значение, связанное с ключом, оно заменяется параметром, передаваемым по значению.
key
- ключ для записи Карты.value
- значение для записи Карты. IllegalStateException
- если никакая транзакция не является активной. java.lang.NullPointerException
- если ключ параметра является нулем.java.lang.Object getResource(java.lang.Object key)
Map.get(Object)
для Карты, которая поддерживает ненулевые ключи и нулевые значения. Например, возвращенное значение является нулем, если нет никакой записи для ключа параметра или если значение, связанное с ключом, является фактически нулем.
key
- ключ для записи Карты. IllegalStateException
- если никакая транзакция не является активной. java.lang.NullPointerException
- если ключ параметра является нулем.void registerInterposedSynchronization(Synchronization sync)
beforeCompletion обратный вызов будет вызван в контексте транзакции транзакции, связанной с текущим потоком в то время, когда этот метод вызывают. Допустимые методы включают доступ к ресурсам, например, Соединители. Никакой доступ не предоставляется к "пользовательским компонентам" (например, службы таймера или бобовые методы), поскольку они могли бы изменить состояние данных, являющихся управляемым вызывающей стороной, и могли бы изменить состояние данных, которые были уже сброшены другой вызывающей стороной registerInterposedSynchronization. Общий контекст является компонентным контекстом вызывающей стороны registerInterposedSynchronization.
afterCompletion обратный вызов будет вызван в неопределенном контексте. Никакой доступ не разрешается к "пользовательским компонентам" как определено выше. Ресурсы могут быть закрыты, но никакая транзакционная работа не может быть выполнена с ними.
Если этот метод вызывается без активного контекста транзакции, IllegalStateException бросается.
Если этот метод вызывается после того, как обработка двухфазной фиксации запустилась, IllegalStateException бросается.
sync
- экземпляр Синхронизации. IllegalStateException
- если никакая транзакция не является активной.int getTransactionStatus()
void setRollbackOnly()
IllegalStateException
- если никакая транзакция не является активной.boolean getRollbackOnly()
IllegalStateException
- если никакая транзакция не является активной.
|
|||||||||
ПРЕДЫДУЩИЙ КЛАСС СЛЕДУЮЩИЙ КЛАСС | ФРЕЙМЫ НИКАКИЕ ФРЕЙМЫ | ||||||||
СВОДКА: ВЛОЖЕННЫЙ | ПОЛЕ | CONSTR | МЕТОД | ДЕТАЛЬ: ПОЛЕ | CONSTR | МЕТОД |
Авторское право © 2009-2011, Oracle Corporation и/или его филиалы. Все права защищены. Использование подвергается
Сгенерированный на 10-February-2011 12:41