57.2. 指定拦截器的阶段
概述
拦截器分为几个阶段。拦截器的阶段决定了在消息处理序列中调用的时间。开发人员指定拦截器的阶段。阶段使用框架提供的常量值来指定。
阶段
阶段是拦截器的逻辑集合。如 图 57.1 “拦截器阶段” 所示，阶段内的拦截器会按顺序调用。
图 57.1. 拦截器阶段
阶段以有序列表链接，组成拦截器链，并在消息处理过程中提供定义的逻辑步骤。例如，入站拦截器链的 RECEIVE 阶段有一个拦截器组使用从线路获取的原始消息数据来处理传输级别详情。
但是，并没有执行任何阶段可以执行的操作。我们建议一个阶段中的拦截器遵循阶段进取的任务。
Apache CXF 定义的完整阶段列表可在 第 62 章 Apache CXF 消息处理阶段 中找到。
指定阶段
Apache CXF 提供用于指定阶段的 org.apache.cxf.Phase 类。类是常量的集合。Apache CXF 定义的每个阶段在 阶段 类中都有对应的常数。例如，RECEIVE 阶段由值 Phase.RECEIVE 指定。
设置阶段
拦截器的阶段在拦截器的构造器中设置。AbstractPhaseInterceptor 类定义了三个用于实例化拦截器的构造器：
公共 AbstractPhaseInterceptor (String phase)- 将拦截器的阶段设置为指定的阶段，并将拦截器的 id 设置为拦截器的类名称。该构造器将满足大多数用例。
-
公共 AbstractPhaseInterceptor (String id, String phase)- 将拦截器的 id 设置为作为第一个参数传递的字符串，并将拦截器的阶段设置为第二个字符串。 -
公共 AbstractPhaseInterceptor (String phase, boolean uniqueId)-specifies the interceptor should using a unique, system generated id.如果uniqueId参数为true，则拦截器的 id 将由系统计算。如果uniqueId参数为false，则拦截器的 id 被设置为拦截器的类名称。
设置自定义拦截器阶段的建议方法是使用 super （） 方法将阶段传递给 AbstractPhaseInterceptor 构造器，如 例 57.1 “设置拦截器的阶段” 所示。
例 57.1. 设置拦截器的阶段
import org.apache.cxf.message.Message;
import org.apache.cxf.phase.AbstractPhaseInterceptor;
import org.apache.cxf.phase.Phase;
public class StreamInterceptor extends AbstractPhaseInterceptor<Message>
{
public StreamInterceptor()
{
super(Phase.PRE_STREAM);
}
}
例 57.1 “设置拦截器的阶段” 中显示的 StreamInterceptor interceptor 放置在 PRE_STREAM 阶段。
