上篇文章介绍了Filter是如何加载的。那么接下来就介绍Filter的关键类。
Filter
这个接口定义了Filter需要具备的功能,分成2部分:生命周期、必要操作。
生命周期方法为了做更好的扩展。
void init(DataSourceProxy dataSource);
void destroy();
其他方法基本上都是与数据库操作有关的方法。这里注意一个细节就是其他接口方法定义的参数中都会包含FilterChain 这个参数。这个对象使用了责任链方式对Filter进行扩展。
FilterAdapter
这个类就是Filter的适配类。实现的Filter接口。其他的具体Filter都是继承这个类,而不是直接去实现Filter 接口。这样做的好处是,在FilterAdapter类中适配的公共的方法。如果子类有特殊的操作就重写相应的方法。这样做是为了代码的复用。
public class ConfigFilter extends FilterAdapter
FilterChain
使用责任链方式依次调用每个Filter相应的方法
@Override
public void preparedStatement_setBlob(PreparedStatementProxy statement, int parameterIndex, InputStream inputStream)
throws SQLException {
// ----------- 可以看到本类的其他方法里的实现都是如下类似结构
// 推动链条往下执行
if (this.pos < filterSize) {
// 这里的 nextFilter() 方法返回的是 FilterAdapter,
// 而 FilterAdapter 对 Filter接口 的实现都是直接调度给了FilterChain的同名方法, 所以执行权回来了.
// 所以对于自定义实现的Filter, 只需要覆盖自己感兴趣的方法.
// 这样在 FilterAdapter 和 FilterChainImpl的相互的, 齿轮一样彼此推动之下将执行逻辑进行完毕.
// 1. 逻辑从FilterChainImpl的实现开始, 在设置了Filter的前提下, 执行逻辑进入判断体内部, 也就是这个if语句内部;
// 2. 然后在nextFilter()的返回值为FilterAdapter,及FilterAdapter 对 Filter接口 的实现都是直接调度给了FilterChain的同名方法(也就是本方法)
// 3. 在这样的相互作用下, 下面这句的执行最终会导致某次进入本方法时,this.pos == this.filterSize, 从而执行本职工作, 再返回到这里.
// 4. 最后由下面第三行返回.
nextFilter().preparedStatement_setBlob(this, statement, parameterIndex, inputStream);
return;
}
// 本方法的本职工作, 例如本方法就是为PreparedStatement设置Blob参数
statement.getRawObject().setBlob(parameterIndex, inputStream);
}
总结:
- 在Filter的设计上使用了适配方式,以及责任链方式来把Filter的具体实现类给串联了起来
- 通过这里的代码可以学习一下责任链的实现方式