Druid源码学习（五）-内置Filter的调用

上篇文章介绍了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);
}

总结：

1. 在Filter的设计上使用了适配方式，以及责任链方式来把Filter的具体实现类给串联了起来
2. 通过这里的代码可以学习一下责任链的实现方式