From 10bf1bfbec4ca26d7e0f7ce262bfe74aa8347533 Mon Sep 17 00:00:00 2001 From: Hiroki Yorimitsu <52403055+hyorimitsu@users.noreply.github.com> Date: Thu, 16 Jul 2026 10:45:54 +0900 Subject: [PATCH] docs(routing): clarify Any registers handler for any HTTP method --- site/src/content/docs/es/guide/routing.md | 7 ++++++- site/src/content/docs/guide/routing.md | 7 ++++++- site/src/content/docs/ja/guide/routing.md | 7 ++++++- site/src/content/docs/pt-br/guide/routing.md | 7 ++++++- site/src/content/docs/zh-cn/guide/routing.md | 6 +++++- 5 files changed, 29 insertions(+), 5 deletions(-) diff --git a/site/src/content/docs/es/guide/routing.md b/site/src/content/docs/es/guide/routing.md index bf08c5e7..fe2edef7 100644 --- a/site/src/content/docs/es/guide/routing.md +++ b/site/src/content/docs/es/guide/routing.md @@ -23,13 +23,18 @@ e.DELETE("/users/:id", deleteUser) e.GET("/static/*", serveFiles) // wildcard ``` -`Any` registra un handler para todos los métodos soportados, y `Match` para un conjunto específico: +`Any` registra un handler para cualquier método HTTP — incluidos los que no están en +la lista predefinida de Echo — y `Match` para un conjunto específico: ```go e.Any("/ping", pong) e.Match([]string{http.MethodGet, http.MethodPost}, "/form", handleForm) ``` +:::note +Una ruta de método específico registrada para el mismo path tiene precedencia sobre la ruta `Any`. +::: + ## Tipos de coincidencia | Patrón | Tipo | Ejemplo de coincidencia | diff --git a/site/src/content/docs/guide/routing.md b/site/src/content/docs/guide/routing.md index cb3c28cd..398cb244 100644 --- a/site/src/content/docs/guide/routing.md +++ b/site/src/content/docs/guide/routing.md @@ -23,13 +23,18 @@ e.DELETE("/users/:id", deleteUser) e.GET("/static/*", serveFiles) // wildcard ``` -`Any` registers a handler for all supported methods, and `Match` for a specific set: +`Any` registers a handler for any HTTP method — including ones not in Echo's predefined +list — and `Match` for a specific set: ```go e.Any("/ping", pong) e.Match([]string{http.MethodGet, http.MethodPost}, "/form", handleForm) ``` +:::note +A method-specific route registered for the same path takes precedence over the `Any` route. +::: + ## Match types | Pattern | Type | Example match | diff --git a/site/src/content/docs/ja/guide/routing.md b/site/src/content/docs/ja/guide/routing.md index 1da2c349..e48bb6f5 100644 --- a/site/src/content/docs/ja/guide/routing.md +++ b/site/src/content/docs/ja/guide/routing.md @@ -24,13 +24,18 @@ e.DELETE("/users/:id", deleteUser) e.GET("/static/*", serveFiles) // wildcard ``` -`Any` はサポートされているすべてのメソッドにハンドラを登録し、`Match` は指定した集合に登録します。 +`Any` は任意の HTTP メソッド(Echo にあらかじめ定義された一覧にないものも含む)にハンドラを +登録し、`Match` は指定した集合に登録します。 ```go e.Any("/ping", pong) e.Match([]string{http.MethodGet, http.MethodPost}, "/form", handleForm) ``` +:::note +同じパスに登録されたメソッド固有のルートは、`Any` ルートより優先されます。 +::: + ## マッチ種別 | パターン | 種別 | マッチ例 | diff --git a/site/src/content/docs/pt-br/guide/routing.md b/site/src/content/docs/pt-br/guide/routing.md index 2816286d..5c632d69 100644 --- a/site/src/content/docs/pt-br/guide/routing.md +++ b/site/src/content/docs/pt-br/guide/routing.md @@ -23,13 +23,18 @@ e.DELETE("/users/:id", deleteUser) e.GET("/static/*", serveFiles) // wildcard ``` -`Any` registra um handler para todos os métodos suportados, e `Match` para um conjunto específico: +`Any` registra um handler para qualquer método HTTP — incluindo os que não estão na +lista predefinida do Echo — e `Match` para um conjunto específico: ```go e.Any("/ping", pong) e.Match([]string{http.MethodGet, http.MethodPost}, "/form", handleForm) ``` +:::note +Uma rota de método específico registrada para o mesmo caminho tem precedência sobre a rota `Any`. +::: + ## Tipos de correspondência | Padrão | Tipo | Exemplo correspondente | diff --git a/site/src/content/docs/zh-cn/guide/routing.md b/site/src/content/docs/zh-cn/guide/routing.md index 770afc94..0efe97d0 100644 --- a/site/src/content/docs/zh-cn/guide/routing.md +++ b/site/src/content/docs/zh-cn/guide/routing.md @@ -23,13 +23,17 @@ e.DELETE("/users/:id", deleteUser) e.GET("/static/*", serveFiles) // wildcard ``` -`Any` 会为所有支持的方法注册处理函数,`Match` 则用于一组指定方法: +`Any` 会为任意 HTTP 方法(包括不在 Echo 预定义列表中的方法)注册处理函数,`Match` 则用于一组指定方法: ```go e.Any("/ping", pong) e.Match([]string{http.MethodGet, http.MethodPost}, "/form", handleForm) ``` +:::note +为同一路径注册的特定方法路由优先于 `Any` 路由。 +::: + ## 匹配类型 | 模式 | 类型 | 匹配示例 |