net.gdface.utils

类 BaseInterfaceDecorator<I,T>

java.lang.Object

net.gdface.utils.BaseInterfaceDecorator<I,T>

类型参数:

I - 接口类型

T - 接口实现类型

所有已实现的接口:

java.lang.reflect.InvocationHandler, Delegator<T>, InterfaceDecoratorProbe

直接已知子类:

InterfaceDecorator, InterfaceNonimplDecorator

public abstract class BaseInterfaceDecorator<I,T>
extends java.lang.Object
implements java.lang.reflect.InvocationHandler, Delegator<T>, InterfaceDecoratorProbe

实现接口实例的代理类
应用层可以根据需要继承此类重写invoke(Object, Method, Object[])方法, 也可以通过注册侦听器InterfaceDecoratorProbe在方法调用时实现应用逻辑

作者:

guyadong

嵌套类概要

从接口继承的嵌套类/接口 net.gdface.utils.InterfaceDecoratorProbe

InterfaceDecoratorProbe.DefaultProbe

字段概要

字段

限定符和类型	字段和说明
protected T	delegate
protected java.lang.Class<I>	interfaceClass

构造器概要

构造器

限定符	构造器和说明
protected	BaseInterfaceDecorator(java.lang.Class<I> interfaceClass, T delegate) 构造方法
protected	BaseInterfaceDecorator(java.lang.Class<I> interfaceClass, T delegate, boolean allowBreak) 构造方法
protected	BaseInterfaceDecorator(T delegate) 简化版构造函数 当delegate只实现了一个接口时,自动推断接口类型

方法概要

限定符和类型	方法和说明
void	beforeInvoke(java.lang.Object proxy, java.lang.reflect.Method method, java.lang.Object[] args) 顺序调用listeners中的所有侦听器对象的 InterfaceDecoratorProbe.beforeInvoke(Object, Method, Object[])方法, allowBreak为true时,允许侦听器抛出异常,中断调用,否则输出错误日志
T	delegate()
protected abstract java.lang.Object	doInvoke(java.lang.Object proxy, java.lang.reflect.Method method, java.lang.Object[] args)
java.lang.Class<I>	getInterfaceClass() 返回代理的接口类
java.lang.Object	invoke(java.lang.Object proxy, java.lang.reflect.Method method, java.lang.Object[] args) 执行接口方法调用，在调用前，调用成功后，调用发生异常，调用结束时执行所有注册的侦听器(InterfaceDecoratorProbe)
void	onComplete(java.lang.Object proxy, java.lang.reflect.Method method, java.lang.Object[] args, java.lang.Object result) 顺序调用listeners中的所有侦听器对象的 InterfaceDecoratorProbe.onComplete(Object, Method, Object[], Object)方法
void	onDone(java.lang.Object proxy, java.lang.reflect.Method method, java.lang.Object[] args) 顺序调用listeners中的所有侦听器对象的 InterfaceDecoratorProbe.onDone(Object, Method, Object[])方法
void	onError(java.lang.Object proxy, java.lang.reflect.Method method, java.lang.Object[] args, java.lang.Throwable error) 顺序调用listeners中的所有侦听器对象的 InterfaceDecoratorProbe.onError(Object, Method, Object[], Throwable)方法
I	proxyInstance() 根据当前对象创建新的接口实例
boolean	registerListener(InterfaceDecoratorProbe listener) 注册侦听器 重复注册返回false
boolean	registerListener(InterfaceDecoratorProbe listener, boolean header) 注册侦听器 重复注册返回false
static void	setDebug(boolean debug)
boolean	unregisterListener(InterfaceDecoratorProbe listener) 卸载指定的侦听器

从类继承的方法 java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

字段详细资料

interfaceClass

protected final java.lang.Class<I> interfaceClass

delegate

protected final T delegate

构造器详细资料

BaseInterfaceDecorator

protected BaseInterfaceDecorator(java.lang.Class<I> interfaceClass,
                                 T delegate)

构造方法

参数:

interfaceClass - 接口类

delegate - 实现接口的类,如果子类用不delegate字段可以为null

BaseInterfaceDecorator

protected BaseInterfaceDecorator(java.lang.Class<I> interfaceClass,
                                 T delegate,
                                 boolean allowBreak)

构造方法

参数:

interfaceClass - 接口类

delegate - 实现接口的类,如果子类用不delegate字段可以为null

allowBreak - 为true时允许 beforeInvoke(Object, Method, Object[])抛出异常

BaseInterfaceDecorator

protected BaseInterfaceDecorator(T delegate)

简化版构造函数
当delegate只实现了一个接口时,自动推断接口类型

参数:

delegate -

方法详细资料

setDebug

public static void setDebug(boolean debug)

doInvoke

protected abstract java.lang.Object doInvoke(java.lang.Object proxy,
                                             java.lang.reflect.Method method,
                                             java.lang.Object[] args)
                                      throws java.lang.Throwable

抛出:

java.lang.Throwable

invoke

public java.lang.Object invoke(java.lang.Object proxy,
                               java.lang.reflect.Method method,
                               java.lang.Object[] args)
                        throws java.lang.Throwable

执行接口方法调用，在调用前，调用成功后，调用发生异常，调用结束时执行所有注册的侦听器(InterfaceDecoratorProbe)

指定者:

invoke 在接口中 java.lang.reflect.InvocationHandler

抛出:

java.lang.Throwable

getInterfaceClass

public final java.lang.Class<I> getInterfaceClass()

返回代理的接口类

返回:

接口类

proxyInstance

public final I proxyInstance()

根据当前对象创建新的接口实例

返回:

接口实例

另请参阅:

Proxy.newProxyInstance(ClassLoader, Class[], InvocationHandler)

delegate

public T delegate()

指定者:

delegate 在接口中 Delegator<T>

返回:

返回代理对象

registerListener

public boolean registerListener(InterfaceDecoratorProbe listener)

注册侦听器
重复注册返回false

参数:

listener - 要注册的侦听器

返回:

注册成功返回true,否则返回false

registerListener

public boolean registerListener(InterfaceDecoratorProbe listener,
                                boolean header)

注册侦听器
重复注册返回false

参数:

listener - 要注册的侦听器

header - 为true添加到队列头部,否则顺序添加到尾部

返回:

注册成功返回true,否则返回false

unregisterListener

public boolean unregisterListener(InterfaceDecoratorProbe listener)

卸载指定的侦听器

参数:

listener -

返回:

卸载成功返回true,否则返回false

beforeInvoke

public void beforeInvoke(java.lang.Object proxy,
                         java.lang.reflect.Method method,
                         java.lang.Object[] args)
                  throws java.lang.Exception

顺序调用listeners中的所有侦听器对象的 InterfaceDecoratorProbe.beforeInvoke(Object, Method, Object[])方法, allowBreak为true时,允许侦听器抛出异常,中断调用,否则输出错误日志

指定者:

beforeInvoke 在接口中 InterfaceDecoratorProbe

参数:

proxy - 接口实例

method - 接口方法

args - 方法参数

抛出:

java.lang.Exception - 抛出异常中断调用

onComplete

public void onComplete(java.lang.Object proxy,
                       java.lang.reflect.Method method,
                       java.lang.Object[] args,
                       java.lang.Object result)

顺序调用listeners中的所有侦听器对象的 InterfaceDecoratorProbe.onComplete(Object, Method, Object[], Object)方法

指定者:

onComplete 在接口中 InterfaceDecoratorProbe

参数:

proxy - 接口实例

method - 接口方法

args - 方法参数

result - 接口方法调用返回值

onError

public void onError(java.lang.Object proxy,
                    java.lang.reflect.Method method,
                    java.lang.Object[] args,
                    java.lang.Throwable error)

顺序调用listeners中的所有侦听器对象的 InterfaceDecoratorProbe.onError(Object, Method, Object[], Throwable)方法

指定者:

onError 在接口中 InterfaceDecoratorProbe

参数:

proxy - 接口实例

method - 接口方法

args - 方法参数

error - 接口方法调用抛出的异常

onDone

public void onDone(java.lang.Object proxy,
                   java.lang.reflect.Method method,
                   java.lang.Object[] args)

顺序调用listeners中的所有侦听器对象的 InterfaceDecoratorProbe.onDone(Object, Method, Object[])方法

指定者:

onDone 在接口中 InterfaceDecoratorProbe

参数:

proxy - 接口实例

method - 接口方法

args - 方法参数