实际业务中,如果要自定义filter过滤器,只需集成ZuulFIlter类即可,该类是个抽象类,它实现了IZuulFIlter接口,我们需要实现几个方法,如下示例:
import static org.springframework.cloud.netflix.zuul.filters.support.FilterConstants.PRE_TYPE; import javax.servlet.http.HttpServletRequest; import com.netflix.zuul.ZuulFilter; import com.netflix.zuul.context.RequestContext; import com.netflix.zuul.exception.ZuulException; public class ThirdPreFilter extends ZuulFilter { /** * 设置filter的类型,支持4种类型 * {@link org.springframework.cloud.netflix.zuul.filters.support.FilterConstants} * <pre> * ERROR_TYPE = "error";//这种过滤器是在整个生命周期内,如果发生异常,就执行该filter,可以做全局异常处理。 * POST_TYPE = "post";//这种过滤器是在端点请求完毕,返回结果或者发生异常后执行的filter。如果需要对返回的结果进行再次处理,可以在这种过滤中处理逻辑。 * PRE_TYPE = "pre"; //在zuul网关按照规则路由到下级服务之前执行,如果需要对请求进行预处理,可以使用这种类型的过滤器。如:认证鉴权,限流等。 * ROUTE_TYPE = "route";//这种过滤器是zuul路由动作的执行者,是Apache HttpClient或Ribbon构建和发送原始HTTP请求的地方,现在也支持OKHTTP。 * </pre> * * @return */ @Override public String filterType() { return PRE_TYPE; } /** * 设置filter的执行顺序,数字越小,优先级越高,反之越低 * * @return */ @Override public int filterOrder() { return 3; } /** * 是否执行该过滤器,可以作为一个开关,如果一直都被执行,直接返回true即可 * * @return */ @Override public boolean shouldFilter() { RequestContext ctx = RequestContext.getCurrentContext(); //从上下文获取logic-is-success值,用于判断此Filter是否执行 return (boolean) ctx.get("logic-is-success"); } /** * 该自定义filter的业务逻辑 * * @return * @throws ZuulException */ @Override public Object run() throws ZuulException { System.out.println("这是ThirdPreFilter!"); //从RequestContext获取上下文 RequestContext ctx = RequestContext.getCurrentContext(); //从上下文获取HttpServletRequest HttpServletRequest request = ctx.getRequest(); //从request尝试获取b参数值 String b = request.getParameter("b"); //如果b参数值为空则进入此逻辑 if (null == b) { //对该请求禁止路由,也就是禁止访问下游服务 ctx.setSendZuulResponse(false); //设定responseBody供PostFilter使用 ctx.setResponseBody("{\"status\":500,\"message\":\"b参数为空!\"}"); //logic-is-success保存于上下文,作为同类型下游Filter的执行开关,假定后续还有自定义Filter当设置此值 ctx.set("logic-is-success", false); //到这里此Filter逻辑结束 return null; } //设置避免报空指针异常 ctx.set("logic-is-success", true); return null; } }
import com.netflix.zuul.ZuulFilter; import com.netflix.zuul.context.RequestContext; import com.netflix.zuul.exception.ZuulException; import static org.springframework.cloud.netflix.zuul.filters.support.FilterConstants.*; public class PostFilter extends ZuulFilter { @Override public String filterType() { return POST_TYPE; } @Override public int filterOrder() { return 0; } @Override public boolean shouldFilter() { return true; } @Override public Object run() throws ZuulException { System.out.println("这是PostFilter!"); //从RequestContext获取上下文 RequestContext ctx = RequestContext.getCurrentContext(); //处理返回中文乱码 ctx.getResponse().setCharacterEncoding("UTF-8"); //获取上下文中保存的responseBody String responseBody = ctx.getResponseBody(); //如果responseBody不为空,则说明流程有异常发生 if (null != responseBody) { //设定返回状态码 ctx.setResponseStatusCode(500); //替换响应报文 ctx.setResponseBody(responseBody); } return null; } }