Определение маршрутов и предикатов
Научитесь определять динамические маршруты с помощью предикатов (например, Path, Host и Method), чтобы направлять запросы к определённым службам.
«Определение маршрутов и предикатов» — бесплатный урок API Gateway & Reverse Proxy (Nginx + Spring Cloud Gateway) на CoddyKit. Это урок 3 из 4. Ты можешь прочитать весь урок бесплатно ниже — а потом практиковать его прямо в браузере с встроенным редактором кода и ИИ-репетитором 24/7. Это часть пути обучения API Gateway & Reverse Proxy (Nginx + Spring Cloud Gateway), и твой прогресс синхронизируется между веб-версией и приложением CoddyKit. Курс API Gateway & Reverse Proxy (Nginx + Spring Cloud Gateway) содержит 4 уроков всего.
Части этого урока еще не переведены и отображаются на английском.
Routing with API Gateways
Welcome! In a microservices architecture, clients don't talk directly to every service. Instead, they interact with an API Gateway.
This gateway acts as a single entry point, directing incoming requests to the correct backend service. This process is called routing.
What Are Predicates?
In Spring Cloud Gateway, predicates are key to routing. Think of them as 'conditions' or 'rules'.
- A predicate evaluates to
trueorfalse. - If a predicate (or set of predicates) for a route evaluates to
true, the gateway forwards the request using that route. - If
false, the gateway tries the next route.
Gateway Project Foundation
Routes are typically configured in your Spring Boot application's application.yml or application.properties file. Here's a minimal Spring Boot application that *could* host our gateway configuration. The routing logic itself will go into the YAML.
You can run this basic app to see it working:
package com.coddykit.gateway;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;
@SpringBootApplication
@RestController
public class GatewayApplication {
public static void main(String[] args) {
SpringApplication.run(GatewayApplication.class, args);
}
@GetMapping("/test-gateway")
public String testGateway() {
return "Hello from Gateway!";
}
}Basic Route Structure
A route in Spring Cloud Gateway needs three main things:
id: A unique identifier for the route.uri: The URI of the backend service to which requests will be forwarded.predicates: A list of conditions that must be met for this route to activate.
We'll primarily define these in application.yml.
The Path Predicate
The Path predicate is one of the most common. It matches the request URI path against a specified pattern.
- You can use wildcards like
*(matches one path segment) and**(matches multiple path segments). - For example,
/users/*matches/users/1but not/users/admin/1. /users/**matches both/users/1and/users/admin/1.
Path Predicate in Action
Here's how you'd configure a route using the Path predicate to send all requests starting with /api/users to a backend user-service:
spring:
cloud:
gateway:
routes:
- id: user_service_route
uri: http://localhost:8081 # Your backend user service
predicates:
- Path=/api/users/**The Host Predicate
The Host predicate matches requests based on the hostname in the request header.
- This is useful for routing requests from different domains or subdomains to specific services.
- You can also use wildcards here, like
*.example.comto match any subdomain ofexample.com.
Host Predicate Example
Let's say you want to route all requests coming from api.mycompany.com to a specific backend service. Here's how:
spring:
cloud:
gateway:
routes:
- id: api_domain_route
uri: http://localhost:8082 # Your backend API service
predicates:
- Host=api.mycompany.comThe Method Predicate
The Method predicate matches requests based on their HTTP method (also known as HTTP verb).
- Common methods include
GET,POST,PUT,DELETE, andPATCH. - This allows you to direct different types of operations (e.g., reading vs. creating data) to distinct backend endpoints or services.
Method Predicate Example
To ensure only POST requests to /products are routed to a specific service, and other methods are handled elsewhere:
spring:
cloud:
gateway:
routes:
- id: create_product_route
uri: http://localhost:8083 # Service for creating products
predicates:
- Path=/products
- Method=POSTPredicate Power Check
You've learned about Path, Host, and Method predicates. Now, let's test your understanding!
Recap: Routes & Predicates
Great job! You've learned the fundamentals of defining routes and using predicates in Spring Cloud Gateway.
- Routes direct traffic to backend services.
- Predicates are the conditions (like
Path,Host,Method) that determine if a route matches. - Multiple predicates on a single route act as an AND condition.
This powerful combination allows for flexible and intelligent traffic management in your microservices.
Часто задаваемые вопросы
Урок «Определение маршрутов и предикатов» бесплатный?
Да — полный текст урока «Определение маршрутов и предикатов» бесплатно доступен здесь в веб-версии. Чтобы практиковать его интерактивно (встроенный редактор кода и ИИ-репетитор 24/7) и разблокировать остальной курс API Gateway & Reverse Proxy (Nginx + Spring Cloud Gateway), подпишись на CoddyKit PRO. Курс API Gateway & Reverse Proxy (Nginx + Spring Cloud Gateway) содержит 4 уроков всего.
Чему я научусь в уроке «Определение маршрутов и предикатов»?
Научитесь определять динамические маршруты с помощью предикатов (например, Path, Host и Method), чтобы направлять запросы к определённым службам. Ты практикуешь API Gateway & Reverse Proxy (Nginx + Spring Cloud Gateway) с помощью реального кода, который запускаешь прямо в браузере, и ИИ-репетитор 24/7 отвечает на твои вопросы во время урока.
Нужен ли мне опыт, чтобы начать API Gateway & Reverse Proxy (Nginx + Spring Cloud Gateway)?
Предыдущий опыт не требуется. API Gateway & Reverse Proxy (Nginx + Spring Cloud Gateway) на CoddyKit структурирован для всех уровней — от новичков до продвинутых, поэтому ты можешь начать отсюда или с самого начала и учиться в своем темпе. Это урок 3 из 4.
Сколько времени занимает урок «Определение маршрутов и предикатов»?
Большинство уроков CoddyKit занимают около 5–10 минут. Каждый из них компактный и интерактивный, поэтому ты постоянно делаешь прогресс и продолжаешь с того же места в веб-версии и приложении.
Можно ли писать и запускать код в этом уроке API Gateway & Reverse Proxy (Nginx + Spring Cloud Gateway)?
Да. Каждый урок API Gateway & Reverse Proxy (Nginx + Spring Cloud Gateway) включает встроенный редактор кода, поэтому ты пишешь и запускаешь реальный код прямо в браузере и получаешь моментальную обратную связь от AI — локальная установка не требуется.
Все уроки этого курса
- Шлюз и традиционные микросервисы
- Создание базового проекта шлюза
- Определение маршрутов и предикатов
- Основы реактивной модели