簡介

Zuul是Spring Cloud提供的api網(wǎng)關(guān)和過濾組件，它提供如下功能：

成都創(chuàng)新互聯(lián)公司2013年開創(chuàng)至今，先為尼木等服務(wù)建站，尼木等地企業(yè)，進(jìn)行企業(yè)商務(wù)咨詢服務(wù)。為尼木企業(yè)網(wǎng)站制作PC+手機(jī)+微官網(wǎng)三網(wǎng)同步一站式服務(wù)解決您的所有建站問題。

• 認(rèn)證
• 過濾
• 壓力測(cè)試
• Canary測(cè)試
• 動(dòng)態(tài)路由
• 服務(wù)遷移
• 負(fù)載均衡
• 安全
• 靜態(tài)請(qǐng)求處理
• 動(dòng)態(tài)流量管理

在本教程中，我們將用zuul，把web端的請(qǐng)求/product轉(zhuǎn)發(fā)到對(duì)應(yīng)的產(chǎn)品服務(wù)上，并且定義一個(gè)pre過濾器來驗(yàn)證是否經(jīng)過了zuul的轉(zhuǎn)發(fā)。

基礎(chǔ)環(huán)境

• JDK 1.8
• Maven 3.3.9
• IntelliJ 2018.1
• Git

項(xiàng)目源碼

Gitee碼云

創(chuàng)建Zuul服務(wù)

在IntelliJ中創(chuàng)建一個(gè)maven項(xiàng)目：

• cn.zxuqian
• apiGateway

然后在pom.xml中添加如下代碼：

    4.0.0

    cn.zxuqian
    apiGateway
    1.0-SNAPSHOT

    
        org.springframework.boot
        spring-boot-starter-parent
        2.0.1.RELEASE
    

    
        
            org.springframework.cloud
            
            spring-cloud-starter-netflix-zuul
        
        
            org.springframework.cloud
            spring-cloud-starter-netflix-eureka-client
        
        
            org.springframework.cloud
            spring-cloud-starter-config
        
        
            org.springframework.boot
            spring-boot-starter-actuator
        
        
            org.springframework.boot
            spring-boot-starter-web
        
    

    
        
            
                org.springframework.cloud
                spring-cloud-dependencies
                Finchley.M9
                pom
                import
            
        
    

    
        1.8
    

    
        
            
                org.springframework.boot
                spring-boot-maven-plugin
            
        
    

    
        
            spring-milestones
            Spring Milestones
            https://repo.spring.io/libs-milestone
            
                false
            
        
    

需要注意的是，Spring官網(wǎng)的教程給的zuul的artifactId為spring-cloud-starter-zuul，這個(gè)是舊版zuul的名字，在我們的Finchley.M9版本中已經(jīng)更名為spring-cloud-starter-netflix-zuul。

添加src/main/resources/bootstrap.yml文件，指定spring.application.name：

spring:
  application:
    name: zuul-server

創(chuàng)建cn.zxuqian.Application類：

package cn.zxuqian;

import cn.zxuqian.filters.PreFilter;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.cloud.client.discovery.EnableDiscoveryClient;
import org.springframework.cloud.netflix.zuul.EnableZuulProxy;
import org.springframework.context.annotation.Bean;

@EnableZuulProxy
@EnableDiscoveryClient
@SpringBootApplication
public class Application {

    public static void main(String[] args) {
        SpringApplication.run(Application.class, args);
    }

    @Bean
    public PreFilter preFilter() {
        return new PreFilter();
    }
}

這里使用了@EnableZuulProxy來指定使用zuul的反向代理，把我們的請(qǐng)求轉(zhuǎn)發(fā)到對(duì)應(yīng)的服務(wù)器上。然后啟用了eureka的服務(wù)發(fā)現(xiàn)。Zuul默認(rèn)也會(huì)使用Ribbon做負(fù)載均衡，所以可以通過eureka發(fā)現(xiàn)已注冊(cè)的服務(wù)。PreFilter是一個(gè)預(yù)過濾器，用來在request請(qǐng)求被處理之前進(jìn)行一些操作，它的代碼如下：

package cn.zxuqian.filters;

import com.netflix.zuul.ZuulFilter;
import com.netflix.zuul.context.RequestContext;
import com.netflix.zuul.exception.ZuulException;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;

import javax.servlet.http.HttpServletRequest;

public class PreFilter extends ZuulFilter {

    private static Logger log = LoggerFactory.getLogger(PreFilter.class);

    @Override
    public String filterType() {
        return "pre";
    }

    @Override
    public int filterOrder() {
        return 1;
    }

    @Override
    public boolean shouldFilter() {
        return true;
    }

    @Override
    public Object run() throws ZuulException {
        RequestContext ctx = RequestContext.getCurrentContext();
        HttpServletRequest request = ctx.getRequest();

        log.info(String.format("%s 方式請(qǐng)求 %s", request.getMethod(), request.getRequestURL().toString()));

        return null;
    }
}

filterType - Zuul內(nèi)置的filter類型有四種，pre, route，post，error，分別代表請(qǐng)求處理前，處理時(shí)，處理后和出錯(cuò)后。
filterOrder - 指定了該過濾器執(zhí)行的順序。
shouldFilter - 是否開啟此過濾器。
run - 過濾器的業(yè)務(wù)邏輯。這里只是簡單的log了一下reqeust的請(qǐng)求方式和請(qǐng)求的路徑。

接下來，在我們的配置中心的git倉庫中創(chuàng)建zuul-server.yml文件，并添加如下配置：

server:
  port: 8083
zuul:
  routes:
    products:
      path: /product/**
      serviceId: product-service

這里配置了zuul的端口為8083，然后映射所有/product/的請(qǐng)求到我們的product-service服務(wù)上。如果不配置serviceId，那么products這個(gè)Key就會(huì)默認(rèn)作為ServiceId，而我們的例子中，ServiceId包括了-，所以在下邊顯示指定了ServiceId。配置完成后提交到git。

更新productService

productService的uri做了一點(diǎn)改動(dòng)，使其更符合rest風(fēng)格：

@RequestMapping("/list")
public String productList() {
    log.info("Access to /products endpoint");
    return "外套，夾克，毛衣，T恤";
}

這里@RequestMapping匹配的路徑改為了/list，之前是/products。

更新web客戶端

在我們的web客戶端的ProductService中添加一個(gè)新的方法：

public String productListZuul() {
    return this.restTemplate.getForObject("http://zuul-server/product/list", String.class);
}

這次我們直接請(qǐng)求zuul-server服務(wù)，然后由它把我們的請(qǐng)求反射代理到product-service服務(wù)。最后在ProductController中添加一個(gè)請(qǐng)求處理方法：

@RequestMapping("/product/list")
public String productListZuul() {
    return productService.productListZuul();
}

用來處理/product/list請(qǐng)求，然后調(diào)用ProductService類中的方法。

測(cè)試

使用mvn spring-boot:run啟動(dòng)configServer，registry, zuulServer, productService，web這幾個(gè)工程，然后啟動(dòng)第二個(gè)productService，使用SERVER_PORT=8082 spring-boot:run。
訪問幾次http://localhost:8080/product/list，然后除了會(huì)在瀏覽器看到返回的結(jié)果，我們還會(huì)在zuulServer的命令行窗口中看到如下字樣：

GET 方式請(qǐng)求 http://xuqians-imac:8083/product/list

然后在兩個(gè)productService的命令行窗口中，我們還會(huì)看到隨機(jī)出現(xiàn)的

Access to /products endpoint

說明zuulServer也會(huì)自動(dòng)進(jìn)行負(fù)載均衡。

歡迎訪問我的博客張旭乾的博客

大家有什么想法歡迎來討論。