Chain of Responsibilityaka CoR, Middleware, Filter Chain, Pipeline of handlers

Vào toà nhà văn phòng: bảo vệ kiểm thẻ, lễ tân ghi tên, máy quét kiểm túi, rồi mới tới thang máy. Mỗi trạm chỉ lo việc của mình và biết 'người kế tiếp'. Nếu bảo vệ thấy bạn không có thẻ, bạn bị chặn ngay — lễ tân không bao giờ thấy bạn.Entering an office tower: security checks your badge, reception logs your name, a scanner checks your bag, then you reach the lift. Each checkpoint does its own job and knows 'the next one'. If security sees no badge, you're stopped right there — reception never sees you.

Thành phần tham giaParticipants

Handler

Chữ ký chung cho mọi mắt xích (Filter, http.Handler).Common signature for every link (Filter, http.Handler).

ConcreteHandler

Một mắt xích cụ thể: log, auth, rate limit... quyết định chuyền tiếp hay chặn.A concrete link: logging, auth, rate limiting... decides to pass on or stop.

Chain / next

Tham chiếu tới mắt xích kế tiếp (FilterChain, biến next).Reference to the next link (FilterChain, the next variable).

Client

Gửi yêu cầu vào đầu chuỗi, không biết ai sẽ xử lý.Sends the request into the head of the chain without knowing who handles it.

Dùng Tự chạy hoặc phím mũi tên để đi qua từng bước gọi giữa các object. Console hiển thị output tương ứng của chương trình.Use Autoplay or the arrow keys to step through each call between objects. The console shows the matching program output.

Cùng một bài toán, hai ngôn ngữ. Rê chuột hoặc focus vào chú thích (số màu cam) để làm nổi bật dòng code tương ứng.Same problem, two languages. Hover or focus an annotation (orange number) to highlight its line.

package com.shop.web;

import jakarta.servlet.FilterChain;
import jakarta.servlet.ServletException;
import jakarta.servlet.http.HttpServletRequest;
import jakarta.servlet.http.HttpServletResponse;
import org.slf4j.MDC;
import org.springframework.core.Ordered;
import org.springframework.core.annotation.Order;
import org.springframework.stereotype.Component;
import org.springframework.web.filter.OncePerRequestFilter;
import java.io.IOException;
import java.util.Optional;
import java.util.UUID;

@Component1
@Order(Ordered.HIGHEST_PRECEDENCE)2
public class RequestIdFilter extends OncePerRequestFilter {

    @Override
    protected void doFilterInternal(HttpServletRequest req, HttpServletResponse res,
                                    FilterChain chain) throws ServletException, IOException {
        String id = Optional.ofNullable(req.getHeader("X-Request-Id"))
            .orElseGet(() -> UUID.randomUUID().toString());
        MDC.put("requestId", id);
        res.setHeader("X-Request-Id", id);
        try {
            chain.doFilter(req, res); // pass to the next link3
        } finally {
            MDC.remove("requestId"); // runs AFTER the rest of the chain returns4
        }
    }
}

package web

import (
	"log/slog"
	"net/http"
	"time"
)

// Middleware wraps a handler with extra behaviour: one link of the chain.
type Middleware func(next http.Handler) http.Handler1

func Logging(next http.Handler) http.Handler {
	return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
		start := time.Now()
		next.ServeHTTP(w, r) // pass to the next link
		slog.Info("request", "method", r.Method, "path", r.URL.Path, "took", time.Since(start))2
	})
}

func PartnerKey(valid map[string]bool) Middleware {3
	return func(next http.Handler) http.Handler {
		return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
			if !valid[r.Header.Get("X-Api-Key")] {
				http.Error(w, "invalid api key", http.StatusUnauthorized)
				return // stop the chain here
			}
			next.ServeHTTP(w, r)
		})
	}
}

// Chain applies middlewares so the FIRST one listed runs first.
func Chain(h http.Handler, mws ...Middleware) http.Handler {
	for i := len(mws) - 1; i >= 0; i-- {4
		h = mws[i](h)
	}
	return h
}

• Spring Security SecurityFilterChainSpring Security SecurityFilterChain

  Mọi request đi qua chuỗi filter: CorsFilter → CsrfFilter → BearerTokenAuthenticationFilter → AuthorizationFilter. Bật log DEBUG org.springframework.security là thấy cả chuỗi.Every request passes CorsFilter → CsrfFilter → BearerTokenAuthenticationFilter → AuthorizationFilter. Turn on DEBUG for org.springframework.security to see the whole chain.

• Middleware HTTP trong GoGo HTTP middleware

  http.TimeoutHandler, http.StripPrefix trong stdlib; chi, echo, gin đều có Use(middleware...) theo đúng mô hình này. gRPC có interceptor chain.http.TimeoutHandler, http.StripPrefix in the stdlib; chi, echo and gin all have Use(middleware...) on this model. gRPC has interceptor chains.

• HandlerInterceptor, WebClient filterHandlerInterceptor, WebClient filters

  Spring MVC HandlerInterceptor, ExchangeFilterFunction của WebClient, ClientHttpRequestInterceptor của RestClient — đều là chuỗi mắt xích.Spring MVC HandlerInterceptor, WebClient's ExchangeFilterFunction, RestClient's ClientHttpRequestInterceptor — all chains of links.

• Duyệt hoàn tiền theo hạn mứcRefund approval by limit

  Nhân viên duyệt ≤ 1 triệu, trưởng nhóm ≤ 10 triệu, còn lại lên giám đốc: phiên bản GoF 'cổ điển' — chỉ MỘT mắt xích xử lý.Staff approve ≤ 1M VND, team leads ≤ 10M, the rest go to a director: the 'classic' GoF version — only ONE link handles it.