Filtros Globais e GatewayFilterFactory
Entenda o conceito de filtros globais e como usar GatewayFilterFactories integrados para transformações comuns.
Filtros Globais e GatewayFilterFactory é uma aula grátis de API Gateway & Reverse Proxy (Nginx + Spring Cloud Gateway) no CoddyKit. Esta é a aula 1 de 4. Você pode ler a aula completa abaixo gratuitamente — depois pratica ao vivo no navegador com um editor de código integrado e um tutor de IA 24/7. Faz parte do caminho de aprendizado de API Gateway & Reverse Proxy (Nginx + Spring Cloud Gateway), e seu progresso é sincronizado entre a web e o app CoddyKit. O curso de API Gateway & Reverse Proxy (Nginx + Spring Cloud Gateway) inclui 4 aulas no total.
Partes desta aula ainda não foram traduzidas e aparecem em inglês.
What are Gateway Filters?
In Spring Cloud Gateway, filters are like interceptors that allow you to modify incoming HTTP requests or outgoing HTTP responses.
They provide a powerful way to implement cross-cutting concerns for your API traffic, such as security, logging, or data transformation.
Pre- and Post-Filters
Spring Cloud Gateway supports two main types of filter execution:
- Pre-filters: Executed before the request is sent to the downstream service. Great for authentication, logging, or modifying request headers.
- Post-filters: Executed after the response is received from the downstream service but before it's sent back to the client. Useful for modifying responses, caching, or error handling.
Understanding Global Filters
A Global Filter is applied to every single request that passes through the gateway, regardless of the specific route it matches.
This makes them ideal for concerns that affect all your API traffic, like global logging, security checks, or metrics collection across all services.
They implement the GlobalFilter interface.
Building a Custom Global Filter
Let's create a simple global filter that logs the incoming request path. It needs to implement GlobalFilter and Ordered.
Run this Spring Boot app and access http://localhost:8080/test/hello. You'll see the log in the console!
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.cloud.gateway.filter.GlobalFilter;
import org.springframework.cloud.gateway.filter.GatewayFilterChain;
import org.springframework.cloud.gateway.route.RouteLocator;
import org.springframework.cloud.gateway.route.builder.RouteLocatorBuilder;
import org.springframework.context.annotation.Bean;
import org.springframework.core.Ordered;
import org.springframework.stereotype.Component;
import org.springframework.web.server.ServerWebExchange;
import reactor.core.publisher.Mono;
@SpringBootApplication
public class GatewayApp {
public static void main(String[] args) {
SpringApplication.run(GatewayApp.class, args);
}
// A simple route for demonstration
@Bean
public RouteLocator customRouteLocator(RouteLocatorBuilder builder) {
return builder.routes()
.route("test_route", r -> r.path("/test/**")
.uri("http://httpbin.org:80")) // Public test service
.build();
}
@Component
static class MyLoggingFilter implements GlobalFilter, Ordered {
@Override
public Mono<Void> filter(ServerWebExchange exchange, GatewayFilterChain chain) {
System.out.println("Global Filter: Request Path -> " + exchange.getRequest().getPath());
return chain.filter(exchange); // Continue filter chain
}
@Override
public int getOrder() {
return -1; // Execute very early
}
}
}Understanding Filter Order
When multiple filters (global or route-specific) are present, their execution order matters.
Filters that implement the Ordered interface define their priority using the getOrder() method. Lower values mean higher priority (executed earlier).
- Negative values: Very high priority.
- Positive values: Lower priority.
- Filters without an explicit order often run later.
What is a GatewayFilterFactory?
While GlobalFilters apply everywhere, a GatewayFilterFactory provides reusable, configurable filters that you can apply to specific routes.
Spring Cloud Gateway comes with many built-in factories for common tasks, like adding/removing headers, rewriting paths, or applying rate limits. You configure them per route.
AddRequestHeader Factory in Action
The AddRequestHeader factory adds a static header to the request before it's forwarded to the backend service.
Run this example and navigate to http://localhost:8080/add-header/test. The response from httpbin.org will show the added header!
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.cloud.gateway.route.RouteLocator;
import org.springframework.cloud.gateway.route.builder.RouteLocatorBuilder;
import org.springframework.context.annotation.Bean;
@SpringBootApplication
public class GatewayApp {
public static void main(String[] args) {
SpringApplication.run(GatewayApp.class, args);
}
@Bean
public RouteLocator customRouteLocator(RouteLocatorBuilder builder) {
return builder.routes()
.route("add_header_route", r -> r.path("/add-header/**")
.filters(f -> f.addRequestHeader("X-Gateway-Custom", "CoddyKit"))
.uri("http://httpbin.org:80/headers")) // Shows request headers
.build();
}
}Exploring More Built-in Factories
Spring Cloud Gateway offers many other powerful GatewayFilterFactory implementations:
RemoveRequestHeader: Removes a specified header.RewritePath: Changes the request URI path.Retry: Retries failed requests.RateLimiter: Applies rate limiting to requests.
These factories simplify common gateway tasks without writing custom code.
Global vs. Route-Specific Filters
When should you use a Global Filter versus a GatewayFilterFactory?
- Choose Global Filters for: Cross-cutting concerns affecting all requests (e.g., global security, logging).
- Choose
GatewayFilterFactory(route-specific) for: Logic specific to certain APIs or groups of routes (e.g., API versioning, specific header manipulation, rate limiting on a particular endpoint).
Global Filter Check
Consider a Spring Cloud Gateway application. Which statement is TRUE about Global Filters?
Global Filters & Factories Recap
We've explored Global Filters, which apply to all requests, and learned how to create a custom one. We also introduced GatewayFilterFactory, which offers reusable, configurable filters for specific routes.
Understanding these filter types and when to use them is crucial for building powerful and flexible API Gateways with Spring Cloud Gateway.
Aprenda API Gateway & Reverse Proxy (Nginx + Spring Cloud Gateway) com um tutor de IA — grátis
Escreva e execute código real no seu navegador, obtenha ajuda instantânea de um tutor de IA 24/7 e continue de onde parou na web ou no app.
- Cursos
- 12
- Aulas
- 48
Perguntas Frequentes
A aula “Filtros Globais e GatewayFilterFactory” é grátis?
Sim — o texto completo de “Filtros Globais e GatewayFilterFactory” é grátis para ler aqui na web. Para praticá-la interativamente (um editor de código integrado e um tutor de IA 24/7) e desbloquear o restante do curso de API Gateway & Reverse Proxy (Nginx + Spring Cloud Gateway), atualize para CoddyKit PRO. O curso de API Gateway & Reverse Proxy (Nginx + Spring Cloud Gateway) inclui 4 aulas no total.
O que vou aprender em “Filtros Globais e GatewayFilterFactory”?
Entenda o conceito de filtros globais e como usar GatewayFilterFactories integrados para transformações comuns. Você pratica API Gateway & Reverse Proxy (Nginx + Spring Cloud Gateway) com código prático que executa diretamente no navegador, e um tutor de IA 24/7 responde suas dúvidas enquanto trabalha na aula.
Preciso ter experiência prévia para começar API Gateway & Reverse Proxy (Nginx + Spring Cloud Gateway)?
Nenhuma experiência prévia é necessária. API Gateway & Reverse Proxy (Nginx + Spring Cloud Gateway) no CoddyKit é estruturado para alunos iniciantes até avançados, então você pode começar aqui ou desde o início e aprender no seu ritmo. Esta é a aula 1 de 4.
Quanto tempo leva a aula “Filtros Globais e GatewayFilterFactory”?
A maioria das aulas CoddyKit leva cerca de 5–10 minutos. Cada uma é compacta e interativa, então você faz progresso constante e retoma exatamente de onde parou entre web e app.
Posso escrever e executar código nesta aula de API Gateway & Reverse Proxy (Nginx + Spring Cloud Gateway)?
Sim. Cada aula de API Gateway & Reverse Proxy (Nginx + Spring Cloud Gateway) inclui um editor de código integrado, então você escreve e executa código real direto no navegador e recebe feedback de IA instantaneamente — nenhuma configuração local necessária.
Todas as aulas deste curso
- Filtros Globais e GatewayFilterFactory
- Filtros Personalizados de Requisição e Resposta
- Pré-processamento e Pós-processamento com Filtros
- GatewayFilters integrados que você deve conhecer