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

javax.interceptor
Интерфейс InvocationContext

public interface InvocationContext

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

    @AroundInvoke
    public Object logInvocation(InvocationContext ctx) throws Exception {
       String class = ctx.getMethod().getDeclaringClass().getName();
       String method = ctx.getMethod().getName();
       Logger.global.entering(class, method, ctx.getParameters());
       try {
          Object result = ctx.proceed();
          Logger.global.exiting(class, method, result);
          return result;
       }
       catch (Exception e) {
          Logger.global.throwing(class, method, e);
          throw e;
       }

    }
 
 

С тех пор:

Перехватчики 1.0

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

java.util.Map<java.lang.String,java.lang.Object>	getContextData() Возвращает данные контекста, связанные с этим вызовом или обратным вызовом жизненного цикла.
java.lang.reflect.Method	getMethod() Возвращает метод целевого class, для которого был вызван перехватчик.
java.lang.Object[]	getParameters() Возвращает значения параметра, которые передадут к методу целевого class.
java.lang.Object	getTarget() Возвращает целевой экземпляр.
java.lang.Object	getTimer() Возвращает объект таймера, связанный с вызовом метода тайм-аута на целевом class, или нулевым значением для метода и методов перехватчика обратного вызова жизненного цикла.
java.lang.Object	proceed() Продолжите к следующему перехватчику в цепочке перехватчика.
void	setParameters(java.lang.Object[] params) Устанавливает значения параметра, которые передадут к методу целевого class.

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

getTarget

java.lang.Object getTarget()

Возвращает целевой экземпляр.

Возвраты:

целевой экземпляр

getTimer

java.lang.Object getTimer()

Возвращает объект таймера, связанный с вызовом метода тайм-аута на целевом class, или нулевым значением для метода и методов перехватчика обратного вызова жизненного цикла. Например, когда связано с компонентным тайм-аутом EJB, этот метод возвраты Timer

Возвраты:

объект таймера или нулевое значение

С тех пор:

Перехватчики 1.1

getMethod

java.lang.reflect.Method getMethod()

Возвращает метод целевого class, для которого был вызван перехватчик. Для перехватчиков метода возвращается метод целевого class. Для перехватчиков обратного вызова жизненного цикла возвращается нулевое значение.

Возвраты:

метод, или нулевое значение

getParameters

java.lang.Object[] getParameters()

Возвращает значения параметра, которые передадут к методу целевого class. Если setParameters() был вызван, getParameters() возвращает значения, к которым были установлены параметры.

Возвраты:

значения параметра, как массив

Броски:

java.lang.IllegalStateException - если вызвано в пределах метода обратного вызова жизненного цикла.

setParameters

void setParameters(java.lang.Object[] params)

Устанавливает значения параметра, которые передадут к методу целевого class.

Параметры:

params - значения параметра, как массив

Броски:

java.lang.IllegalStateException - если вызвано в пределах метода обратного вызова жизненного цикла.

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

getContextData

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

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

Возвраты:

данные контекста, как карта

продолжить

java.lang.Object proceed()
                         throws java.lang.Exception

Продолжите к следующему перехватчику в цепочке перехватчика. Возвратите результат следующего метода, вызванного, или нулевое значение, если у метода есть тип возврата пусто.

Возвраты:

возвращаемое значение следующего метода в цепочке

Броски:

java.lang.Exception