SpringCloud之Zuul 自定义filter

实现过滤器很简单，只需要继承ZuulFilter,并实现ZuulFilter中的抽象方法。

filterType()：定义过滤器的类型，它有4种类型，分别是pre、post、routing和error
filterOrder()：过滤顺序，它是一个Int类型的值，值越小，越早执行该过滤器
shouldFilter()：表示该过滤器是否过滤逻辑，如果为true，则执行run方法，如果为false，则不执行run方法
Object run()：写具体的过滤逻辑

注意重要说明,有些版本在转发post时,文件上传无法转法。只要升级下版本就可以了。

本示中使用的是 springcloud    Edgware.RELEASE 对应springboot1.5.9

Spring Boot	Spring Cloud
1.2.x	Angel版本
1.3.x	Brixton版本
1.4.xstripes	Camden版本
1.5.x	Dalston版本、Edgware版本
2.0.x	Finchley版本
2.1.x	Greenwich.SR2

 

示例

1.pom中引用

<project xmlns="http://maven.apache.org/POM/4.0.0"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>

    <groupId>com.company</groupId>
    <artifactId>zuuldemo</artifactId>
    <version>0.0.1-SNAPSHOT</version>
    <packaging>jar</packaging>

    <name>zuuldemo</name>
    <url>http://maven.apache.org</url>

    <properties>
        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
        <maven.compiler.source>1.8</maven.compiler.source>
        <maven.compiler.target>1.8</maven.compiler.target>
    </properties>
    <parent>
        <groupId>org.springframework.cloud</groupId>
        <artifactId>spring-cloud-starter-parent</artifactId>
        <version>Edgware.RELEASE</version>
        <relativePath></relativePath>
    </parent>
    <dependencies>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>
        <dependency>
            <groupId>org.springframework.cloud</groupId>
            <artifactId>spring-cloud-starter-zuul</artifactId>
        </dependency>
        <dependency>
            <groupId>commons-codec</groupId>
            <artifactId>commons-codec</artifactId>
        </dependency>
        <dependency>
            <groupId>org.apache.httpcomponents</groupId>
            <artifactId>httpclient</artifactId>
        </dependency>
        <dependency>
            <groupId>junit</groupId>
            <artifactId>junit</artifactId>
            <scope>test</scope>
        </dependency>
        <dependency>
            <groupId>com.google.guava</groupId>
            <artifactId>guava</artifactId>
        </dependency>
        <dependency>
            <groupId>com.alibaba</groupId>
            <artifactId>fastjson</artifactId>
            <version>1.2.58</version>
        </dependency>
    </dependencies>
</project>

2.springcloud项目

2.1 src/main/resources/application.yml

server:
   port: 80
spring:
   application:
      name: api-geteway
   http:
      multipart:
         enabled: true # 使用http multipart上传处理
         file-size-threshold: 1MB # 当上传文件达到1MB的时候进行磁盘写入
         max-request-size: 10MB # 设置最大的请求文件的大小
         max-file-size: 10MB # 设置单个文件的最大长度
zuul:
   routes:
      weixin:
         path: /mypath/**
         url: https://www.baidu.com

2.2 App.java

package com.company.zuuldemo;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.cloud.netflix.zuul.EnableZuulProxy;
import org.springframework.context.annotation.Bean;

import com.company.zuuldemo.filter.MyFilter;

/**
 * Hello world!
 *
 */
@EnableZuulProxy
@SpringBootApplication
public class ZuulApp {

    //使用filter
    @Bean
    public MyFilter myFilter() {
        return new MyFilter();
    }

//    @Bean
//    public FirstFilter firstFilter() {
//        return new FirstFilter();
//    }
//
//    @Bean
//    public SecondFilter secondFilter() {
//        return new SecondFilter();
//    }

    public static void main(String[] args) {
        // System.out.println( "Hello World!" );
        SpringApplication.run(ZuulApp.class);
    }
}

2.3 MyFilter.java

 

package com.company.zuuldemo.filter;

import java.util.Arrays;
import java.util.Date;
import java.util.HashMap;
import java.util.List;
import java.util.Map;

import org.slf4j.Logger;
import org.slf4j.LoggerFactory;

import com.netflix.zuul.ZuulFilter;
import com.netflix.zuul.context.RequestContext;

public class MyFilter extends ZuulFilter {

    final static Logger logger = LoggerFactory.getLogger(FirstFilter.class);

    // 这里可以依据url规则判断是否需要进行过滤 true需要过滤进入run方法 ,false直接忽略
    public boolean shouldFilter() {
        RequestContext ctx = RequestContext.getCurrentContext();
        logger.info(ctx.getRequest().getRequestURI() + " get request path info");
        String url = ctx.getRequest().getRequestURI().toLowerCase();

        // 这里判断url逻辑
        if (url.startsWith("/login")) {
            return false;
        }

        return true;
    }

    public Object run() {

        RequestContext ctx = RequestContext.getCurrentContext();

        // 通过其它业务生成token
        String access_token = "user_name_token";

        // 使用1 ：向request的header中增加参数access_token
        ctx.addZuulRequestHeader("access_token", access_token);

        // 使用2：向request的url里增加参数,示例增加 access_token
        Map<String, List<String>> requestQueryParams = ctx.getRequestQueryParams();
        if (requestQueryParams == null) {
            requestQueryParams = new HashMap<>();
        }

        requestQueryParams.put("access_token", Arrays.asList(access_token));

        ctx.setRequestQueryParams(requestQueryParams);

        //使用3 ：:判断是否登录,如果未登录直接返回404
        if (access_token == null || access_token.trim().length() == 0) {
            //过滤该请求，不对其进行路由(直接输入返回）
            ctx.setSendZuulResponse(false);
            //返回错误码
            ctx.setResponseStatusCode(401);
            // 返回错误内容
            ctx.setResponseBody("{"result":"access_token is not correct!"}");
            
            //让下一个Filter看到上一个Filter的状态用于过滤器间的协调
            ctx.set("my_filter_is_success", false);
            return null; 
        }

        // 对该请求进行路由(默认就是true)
        //ctx.setSendZuulResponse(true);
        //ctx.setResponseStatusCode(200);
        //让下一个Filter看到上一个Filter的状态用于过滤器间的协调
        ctx.set("my_filter_is_success", false);

        return null; //直接返回null即可
    }

    @Override
    public String filterType() {
        // 前置过滤器
        //pre：可以在请求被路由之前调用
        //route：在路由请求时候被调用
        //post：在route和error过滤器之后被调用
        //error：处理请求时发生错误时被调用
        return "pre";
    }

    @Override
    public int filterOrder() {
        //优先级为0，数字越大，优先级越低  
        return 0;
    }
}