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

javax.ejb
Интерфейс EJBContext

Все Известные Подынтерфейсы:

EntityContext, MessageDrivenContext, SessionContext

public interface EJBContext

Интерфейс EJBContext предоставляет экземпляру доступ к обеспеченному контейнером контексту времени выполнения экземпляра корпоративного компонента.

Этот интерфейс расширяется SessionContext, EntityContext, и MessageDrivenContext интерфейсы, чтобы обеспечить дополнительные методы, определенные для предприятия, соединяют интерфейсом с бобовым типом.

С тех пор:

EJB 1.0

См. Также:

SessionContext, MessageDrivenContext, EntityContext

Сводка метода

java.security.Identity	getCallerIdentity() Осуждаемый. Используйте Принципал getCallerPrincipal () вместо этого.
java.security.Principal	getCallerPrincipal() Получите java.security.Principal это идентифицирует вызывающую сторону.
java.util.Map<java.lang.String,java.lang.Object>	getContextData() Возвращает данные контекста, связанные с этим вызовом или обратным вызовом жизненного цикла.
EJBHome	getEJBHome() Получите удаленный домашний интерфейс корпоративного компонента.
EJBLocalHome	getEJBLocalHome() Получите локальный домашний интерфейс корпоративного компонента.
java.util.Properties	getEnvironment() Осуждаемый. Используйте контекст именования JNDI java:comp/env для среды корпоративного компонента доступа.
boolean	getRollbackOnly() Тест, если транзакция была отмечена для отката только.
TimerService	getTimerService() Получите доступ к Службе Таймера EJB.
UserTransaction	getUserTransaction() Получите интерфейс установления границ транзакции.
boolean	isCallerInRole(java.security.Identity role) Осуждаемый. Используйте булев isCallerInRole (Представьте roleName в виде строки), вместо этого.
boolean	isCallerInRole(java.lang.String roleName) Тест, если у вызывающей стороны есть данная роль безопасности.
java.lang.Object	lookup(java.lang.String name) Поиск ресурс в пределах java: пространство имен.
void	setRollbackOnly() Отметьте текущую транзакцию для отката.

Деталь метода

getEJBHome

EJBHome getEJBHome()
                   throws java.lang.IllegalStateException

Получите удаленный домашний интерфейс корпоративного компонента.

Возвраты:

Удаленный домашний интерфейс корпоративного компонента.

Броски:

java.lang.IllegalStateException - если у корпоративного компонента нет удаленного домашнего интерфейса.

getEJBLocalHome

EJBLocalHome getEJBLocalHome()
                             throws java.lang.IllegalStateException

Получите локальный домашний интерфейс корпоративного компонента.

Возвраты:

Локальный домашний интерфейс корпоративного компонента.

Броски:

java.lang.IllegalStateException - если у корпоративного компонента нет локального домашнего интерфейса.

С тех пор:

EJB 2.0

getEnvironment

java.util.Properties getEnvironment()

Осуждаемый. Используйте контекст именования JNDI java:comp/env для среды корпоративного компонента доступа.

Получите свойства среды корпоративного компонента.

Отметьте: Если у корпоративного компонента нет никаких свойств среды, этот метод возвращает пустое java.util.Properties объект. Этот метод никогда не возвращается null.

Возвраты:

Свойства среды для корпоративного компонента.

getCallerIdentity

java.security.Identity getCallerIdentity()

Осуждаемый. Используйте Принципал getCallerPrincipal () вместо этого.

Получите java.security.Identity из вызывающей стороны. Этот метод осуждается в EJB 1.1. Контейнеру позволяют всегда возвращаться null от этого метода. Корпоративный компонент должен использовать getCallerPrincipal метод вместо этого.

Возвраты:

Identity объект, который идентифицирует вызывающую сторону.

getCallerPrincipal

java.security.Principal getCallerPrincipal()
                                           throws java.lang.IllegalStateException

Получите java.security.Principal это идентифицирует вызывающую сторону.

Возвраты:

Principal объект, который идентифицирует вызывающую сторону. Этот метод никогда не возвращается null.

Броски:

IllegalStateException - Контейнер выдает исключение, если экземпляру не позволяют вызвать этот метод.

С тех пор:

EJB 1.1

isCallerInRole

boolean isCallerInRole(java.security.Identity role)

Осуждаемый. Используйте булев isCallerInRole (Представьте roleName в виде строки), вместо этого.

Тест, если у вызывающей стороны есть данная роль.

Этот метод осуждается в EJB 1.1. Корпоративный компонент должен использовать isCallerInRole(String roleName) метод вместо этого.

Параметры:

role - java.security.Identity из роли, которая будет протестирована.

Возвраты:

Истина, если у вызывающей стороны есть указанная роль.

isCallerInRole

boolean isCallerInRole(java.lang.String roleName)
                       throws java.lang.IllegalStateException

Тест, если у вызывающей стороны есть данная роль безопасности.

Параметры:

roleName - Имя роли безопасности. Роль должна быть одной из ролей безопасности, которая определяется в дескрипторе развертывания.

Возвраты:

Истина, если у вызывающей стороны есть указанная роль.

Броски:

IllegalStateException - Контейнер выдает исключение, если экземпляру не позволяют вызвать этот метод.

С тех пор:

EJB 1.1

getUserTransaction

UserTransaction getUserTransaction()
                                   throws java.lang.IllegalStateException

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

Возвраты:

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

Броски:

IllegalStateException - Контейнер выдает исключение, если экземпляру не позволяют использовать UserTransaction интерфейс (то есть экземпляр имеет боб с управляемыми контейнером транзакциями).

setRollbackOnly

void setRollbackOnly()
                     throws java.lang.IllegalStateException

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

Броски:

IllegalStateException - Контейнер выдает исключение, если экземпляру не позволяют использовать этот метод (то есть экземпляр имеет боб с управляемыми бобом транзакциями).

getRollbackOnly

boolean getRollbackOnly()
                        throws java.lang.IllegalStateException

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

Возвраты:

Истина, если текущая транзакция отмечается для отката, ложь иначе.

Броски:

IllegalStateException - Контейнер выдает исключение, если экземпляру не позволяют использовать этот метод (то есть экземпляр имеет боб с управляемыми бобом транзакциями).

getTimerService

TimerService getTimerService()
                             throws java.lang.IllegalStateException

Получите доступ к Службе Таймера EJB.

Броски:

IllegalStateException - Контейнер выдает исключение, если экземпляру не позволяют использовать этот метод (например, если боб является stateful бобом сеанса),

С тех пор:

EJB 2.1

поиск

java.lang.Object lookup(java.lang.String name)
                        throws java.lang.IllegalArgumentException

Поиск ресурс в пределах java: пространство имен. Имена, обращающиеся к записям в пределах частного компонентного пространства имен, можно передать как неполные строки. В этом случае поиск будет относительно "java:comp/env/". Например, принятие корпоративного компонента определяет ejb-local-ref с ejb-ref-name "ejb/BarRef" следующие два звонка EJBContext.lookup эквивалентны: ejbContext.lookup("ejb/BarRef"); ejbContext.lookup("java:comp/env/ejb/BarRef");

Параметры:

name - Имя записи

Броски:

IllegalArgumentException - Контейнер выдает исключение, если имя не соответствует запись в пределах среды компонента.

С тех пор:

EJB 3.0

getContextData

java.util.Map<java.lang.String,java.lang.Object> getContextData()

Возвращает данные контекста, связанные с этим вызовом или обратным вызовом жизненного цикла. Если нет никаких данных контекста, пустого Map<String,Object> объект будет возвращен.

С тех пор:

EJB 3.1