filter的with变量是啥

Posted 2023-05-05

Filter(过滤器)简介
Filter 的基本功能是对 Servlet 容器调用 Servlet 的过程进行拦截，从而在 Servlet 进行响应处理的前后实现一些特殊的功能。
在 Servlet API 中定义了三个接口类来开供开发人员编写 Filter 程序：Filter, FilterChain, FilterConfig
Filter 程序是一个实现了 Filter 接口的 Java 类，与 Servlet 程序相似，它由 Servlet 容器进行调用和执行
Filter 程序需要在 web.xml 文件中进行注册和设置它所能拦截的资源：Filter 程序可以拦截 Jsp, Servlet, 静态图片文件和静态 html 文件

Filter 的基本工作原理
当在 web.xml 中注册了一个 Filter 来对某个 Servlet 程序进行拦截处理时，这个 Filter 就成了 Servlet 容器与该 Servlet 程序的通信线路上的一道关卡，该 Filter 可以对 Servlet 容器发送给 Servlet 程序的请求和 Servlet 程序回送给 Servlet 容器的相应进行拦截，可以决定是否将请求继续传递给 Servlet 程序，以及对请求和相应信息是否进行修改
在一个 web 应用程序中可以注册多个 Filter 程序，每个 Filter 程序都可以对一个或一组 Servlet 程序进行拦截。
若有多个 Filter 程序对某个 Servlet 程序的访问过程进行拦截，当针对该 Servlet 的访问请求到达时，web 容器将把这多个 Filter 程序组合成一个 Filter 链(过滤器链)。Filter 链中各个 Filter 的拦截顺序与它们在应用程序的 web.xml 中映射的顺序一致

Filter 接口
init(FilterConfig filterConfig)throws ServletException：在 web 应用程序启动时，web 服务器将根据 web.xml 文件中的配置信息来创建每个注册的 Filter 实例对象，并将其保存在服务器的内存中。Web容器创建 Filter 对象实例后，将立即调用该 Filter 对象的 init 方法。Init 方法在 Filter 生命周期中仅执行一次，web 容器在调用 init 方法时，会传递一个包含 Filter 的配置和运行环境的 FilterConfig 对象(FilterConfig的用法和ServletConfig类似)。利用FilterConfig对象可以得到ServletContext对象，以及部署描述符中配置的过滤器的初始化参数。在这个方法中，可以抛出ServletException异常，通知容器该过滤器不能正常工作。

destroy()：在Web容器卸载 Filter 对象之前被调用。该方法在Filter的生命周期中仅执行一次。在这个方法中，可以释放过滤器使用的资源。

与开发Servlet不同的是，Filter接口并没有相应的实现类可供继承，要开发过滤器，只能直接实现Filter接口。

doFilter(ServletRequest request,ServletResponse response,
FilterChain chain)throws java.io.IOException,ServletException：
doFilter()方法类似于Servlet接口的service()方法。当客户端请求目标资源的时候，容器就会调用与这个目标资源相关联的过滤器的 doFilter()方法。其中参数 request, response 为 web 容器或 Filter 链的上一个 Filter 传递过来的请求和相应对象；参数 chain 为代表当前 Filter 链的对象，在特定的操作完成后，可以在当前 Filter 对象的 doFilter 方法内部需要调用 FilterChain 对象的 chain.doFilter(request,response)方法才能把请求交付给 Filter 链中的下一个 Filter 或者目标 Servlet 程序去处理，也可以直接向客户端返回响应信息，或者利用RequestDispatcher的forward()和include()方法，以及 HttpServletResponse的sendRedirect()方法将请求转向到其他资源。这个方法的请求和响应参数的类型是 ServletRequest和ServletResponse，也就是说，过滤器的使用并不依赖于具体的协议。

FilterChain接口：
FilterChain接口：代表当前 Filter 链的对象。由容器实现，容器将其实例作为参数传入过滤器对象的doFilter()方法中。过滤器对象使用FilterChain对象调用过滤器链中的下一个过滤器，如果该过滤器是链中最后一个过滤器，那么将调用目标资源。
doFilter(ServletRequest request,ServletResponse response)throws java.io.IOException：调用该方法将使过滤器链中的下一个过滤器被调用。如果是最后一个过滤器，会调用目标资源。

在实现一个过滤器后，需要在 web.xml 中进行注册和设置它所能拦截的资源。这可以通过<filter>和<filter-mapping>元素来完成的。
其配置方式和servlet非常类似，下面是具体的配置代码
<filter>
<filter-name>testFilterConfig</filter-name>
<filter-class>cn.itcast.filter.TestFilterConfigFilter</filter-class>
<!-- 配置当前 Filter 的初始化参数 -->
<init-param>
<param-name>name</param-name>
<param-value>Tom</param-value>
</init-param>
<init-param>
<param-name>password</param-name>
<param-value>123456</param-value>
</init-param>
</filter>

<filter-mapping>
<filter-name>testFilterConfig</filter-name>
<url-pattern>/*</url-pattern>
</filter-mapping>
/*表示所有的url都需要被这个过滤器所过滤
在同一个 web.xml 文件中可以为同一个 Filter 设置多个映射。若一个 Filter 链中多次出现了同一个 Filter 程序，这个 Filter 程序的拦截处理过程将被多次执行

Filter的典型应用
使浏览器不缓存页面的过滤器：
有 3 个 HTTP 响应头字段都可以禁止浏览器缓存当前页面，它们在 Servlet 中的示例代码如下：
response.setDateHeader("Expires",-1);
response.setHeader("Cache-Control","no-cache");
response.setHeader("Pragma","no-cache");
并不是所有的浏览器都能完全支持上面的三个响应头，因此最好是同时使用上面的三个响应头

典型应用2
字符编码的过滤器
通过配置参数encoding指明使用何种字符编码,以处理Html Form请求参数的中文问题
具体的实例代码如下：
public void doFilter(ServletRequest arg0, ServletResponse arg1,
FilterChain arg2) throws IOException, ServletException
// TODO Auto-generated method stub
arg0.setCharacterEncoding(“UTF-8”);
arg2.doFilter(arg0, arg1);
参考技术A FilterConfig是一个接口，这表示在Filter中使用到了这个接口的实例（实际上没有实现）

即：protected FilterConfig filterconfig; 这句话就是声明一个FilterConfig实例

我把API文档里的原文翻译给你吧：

一个过滤器配置对象(即FilterConfig)使用一个servlet容器(比如说：Tomcat)传递信息并且初始化一个过滤器
说白了，它就是用来初始化过滤器的。

不过一般不使用。

AllegroGraph 中的 --with-indices 是啥

【中文标题】AllegroGraph 中的 --with-indices 是啥

【英文标题】：What is --with-indices in AllegroGraphAllegroGraph 中的 --with-indices 是什么

【发布时间】：2015-01-26 05:16:46

【问题描述】：

我正在尝试将数据加载到 Allegro Graph 服务器中，其中一个参数是 --with-indices。谁能解释一下这是怎么回事？

我已阅读整个 Allegro Graph 文档，其中提到索引可以是 spogi、sopgi 等，但没有提及它们的含义。

请准确解释。 （我不是要spogi、sopgi等的完整形式。我想要的是它们的确切含义。）

【参考方案1】：

您的三元组存储包含三元组spo（主语、谓语、宾语）。针对如此存储的图的查询可能必须遍历大量图才能找到与您的查询匹配的节点。 AllegroGraph 可以存储使遍历更快的索引：例如，查找所有首先匹配的谓词以及附加的主语和宾语节点，它可以使用首先查找谓词的索引pso。如果你的三元组有命名图，你可以添加g，并且你所有的三元组都有 ids i。所以 AG 可以使用索引psogi。 （来自文档：AllegroGraph Triple Indices）

使用一组默认索引创建 AG 三元存储。生成专门的索引是资源密集型的，但如果您知道您将获得哪些类型的查询，您可能会发现指定适当的索引以优化响应时间是值得的。

如果您从命令行加载：

以下示例将单个文件加载到 AllegroGraph 中。

./agload --with-indices "ospgi,posgi,spogi" 三元组存储会生成三个三元组索引：ospgi、posgi 和 spogi。

（来自docs for agload）

如果您使用的是 REST 接口，则可以使用指定的索引创建存储库：

PUT /repositories/[名称]

带参数index:

索引 可以指定任意次数。应该保存索引 ID，并且 用于配置为商店创建的索引集。

（来自docs for put repo）

或者你可以加载你的三元组，然后这样做：

PUT /repositories/[name]/indices/[type] 确保索引 由类型指示的存在于这家商店中。提交时生效 时间（当然，在使用共享后端或 一个自动提交会话）。

（来自docs for put index）