Zuul Server是一個網關應用程式,可處理所有請求並執行微服務應用程式的動態路由。 Zuul伺服器也稱為邊緣伺服器。
例如,/api/user
映射到用戶服務,/api/products
映射到產品服務,Zuul Server將請求動態路由到相應的後端應用程式。
在本章中,將詳細介紹如何在Spring Boot中創建Zuul Server應用程式。
創建Zuul伺服器應用程式
Zuul Server捆綁了Spring Cloud依賴項。可以從Spring Initializer頁面https://start.spring.io /下載Spring Boot專案,然後選擇Zuul Server依賴項。
在主Spring Boot應用程式中添加@EnableZuulProxy
注解。 @EnableZuulProxy
注釋用於使Spring Boot應用程式充當Zuul代理伺服器。
package com.zaixian.zuulserver;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.cloud.netflix.zuul.EnableZuulProxy;
@SpringBootApplication
@EnableZuulProxy
public class ZuulserverApplication {
public static void main(String[] args) {
SpringApplication.run(ZuulserverApplication.class, args);
}
}
必須在構建配置檔中添加Spring Cloud Starter Zuul依賴項。
Maven用戶需要在pom.xml 檔中添加以下依賴項 -
<dependency>
<groupId>org.springframework.cloud</groupId>
<artifactId>spring-cloud-starter-zuul</artifactId>
</dependency>
對於Gradle用戶,請在build.gradle 檔中添加以下依賴項 -
compile('org.springframework.cloud:spring-cloud-starter-zuul')
對於Zuul路由,請在application.properties 檔或application.yml 檔中添加以下屬性。
spring.application.name = zuulserver
zuul.routes.products.path = /api/demo/**
zuul.routes.products.url = http://localhost:8080/
server.port = 8111
它表示 http 調用/api/demo/get
轉發到產品服務。 例如,/api/demo/products
被轉發到/products
。
yaml檔用戶可以使用如下所示的 application.yml 檔 -
server:
port: 8111
spring:
application:
name: zuulserver
zuul:
routes:
products:
path: /api/demo/**
url: http://localhost:8080/
注 - 在通過Zuul Proxy進行路由之前,
http://localhost:8080/
應用程式應該已經運行。
完整的構建配置檔如下所示。
Maven用戶可以使用下麵給出的pom.xml 檔 -
<?xml version = "1.0" encoding = "UTF-8"?>
<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.zaixian</groupId>
<artifactId>zuulserver</artifactId>
<version>0.0.1-SNAPSHOT</version>
<packaging>jar</packaging>
<name>zuulserver</name>
<description>Demo project for Spring Boot</description>
<parent>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-parent</artifactId>
<version>1.5.9.RELEASE</version>
<relativePath/> <!-- lookup parent from repository -->
</parent>
<properties>
<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
<project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding>
<java.version>1.8</java.version>
<spring-cloud.version>Edgware.RELEASE</spring-cloud.version>
</properties>
<dependencies>
<dependency>
<groupId>org.springframework.cloud</groupId>
<artifactId>spring-cloud-starter-zuul</artifactId>
</dependency>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-test</artifactId>
<scope>test</scope>
</dependency>
</dependencies>
<dependencyManagement>
<dependencies>
<dependency>
<groupId>org.springframework.cloud</groupId>
<artifactId>spring-cloud-dependencies</artifactId>
<version>${spring-cloud.version}</version>
<type>pom</type>
<scope>import</scope>
</dependency>
</dependencies>
</dependencyManagement>
<build>
<plugins>
<plugin>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-maven-plugin</artifactId>
</plugin>
</plugins>
</build>
</project>
Gradle用戶可以使用下麵給出的build.gradle 檔 -
buildscript {
ext {
springBootVersion = '1.5.9.RELEASE'
}
repositories {
mavenCentral()
}
dependencies {
classpath("org.springframework.boot:spring-boot-gradle-plugin:${springBootVersion}")
}
}
apply plugin: 'java'
apply plugin: 'eclipse'
apply plugin: 'org.springframework.boot'
group = 'com.zaixian'
version = '0.0.1-SNAPSHOT'
sourceCompatibility = 1.8
repositories {
mavenCentral()
}
ext {
springCloudVersion = 'Edgware.RELEASE'
}
dependencies {
compile('org.springframework.cloud:spring-cloud-starter-zuul')
testCompile('org.springframework.boot:spring-boot-starter-test')
}
dependencyManagement {
imports {
mavenBom "org.springframework.cloud:spring-cloud-dependencies:${springCloudVersion}"
}
}
創建一個可執行的JAR檔,並使用下麵給出的Maven或Gradle命令運行Spring Boot應用程式 -
對於Maven,可以使用下麵給出的命令 -
mvn clean install
在“BUILD SUCCESS”之後,可以在target
目錄下找到JAR檔。
對於Gradle,可以使用下麵給出的命令 -
gradle clean build
在“BUILD SUCCESSFUL” 之後,可以在build/libs
目錄下找到JAR檔。
現在,使用下麵顯示的命令運行JAR檔 -
java –jar <JARFILE>
在Tomcat端口8111上找到已啟動的應用程式。
現在,在Web流覽器訪問URL => http://localhost:8111/api/demo/products
,可看到/products
REST端點的輸出,如下所示 -