* limitations under the License.
 */

package common

enum class JvmVersion(
    val major: Int,
) {
    JAVA_8(8),
    JAVA_11(11),
    JAVA_17(17),
    JAVA_21(21),
    JAVA_25(25),
    JAVA_26(26),
    ;

    fun toCapitalized(): String = name.replace("_", "").lowercase().toCapitalized()

It will be generated only once, and then the same cached schema will be used for the next requests.

{* ../../docs_src/extending_openapi/tutorial001_py310.py hl[13:14,25:26] *}

### Override the method { #override-the-method }

Now you can replace the `.openapi()` method with your new function.

{* ../../docs_src/extending_openapi/tutorial001_py310.py hl[29] *}

 */
object Punycode {
  val PREFIX_STRING = "xn--"
  val PREFIX = PREFIX_STRING.encodeUtf8()

  private const val BASE = 36
  private const val TMIN = 1
  private const val TMAX = 26
  private const val SKEW = 38
  private const val DAMP = 700
  private const val INITIAL_BIAS = 72
  private const val INITIAL_N = 0x80

  /**

你可以把 `.openapi_schema` 屬性當作「快取」來儲存已產生的結構。

這樣使用者每次開啟 API 文件時，應用就不必重複產生結構。

結構只會產生一次，之後的請求都會使用相同的快取結果。

{* ../../docs_src/extending_openapi/tutorial001_py310.py hl[13:14,25:26] *}

### 覆寫方法 { #override-the-method }

現在你可以用新的函式取代 `.openapi()` 方法。

{* ../../docs_src/extending_openapi/tutorial001_py310.py hl[29] *}

### 檢查看看 { #check-it }

## 라우터에서의 커스텀 `APIRoute` 클래스 { #custom-apiroute-class-in-a-router }

`APIRouter`의 `route_class` 파라미터를 설정할 수도 있습니다:

{* ../../docs_src/custom_request_and_route/tutorial003_py310.py hl[26] *}

이 예시에서는 `router` 아래의 *경로 처리*들이 커스텀 `TimedRoute` 클래스를 사용하며, 응답을 생성하는 데 걸린 시간을 담은 추가 `X-Response-Time` 헤더가 응답에 포함됩니다:

github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com> 1770285177 +0000

生成したスキーマを保持する「キャッシュ」として `.openapi_schema` プロパティを利用できます。

こうすることで、ユーザーが API ドキュメントを開くたびにスキーマを生成する必要がなくなります。

最初の1回だけ生成され、その後は同じキャッシュ済みスキーマが以降のリクエストで使われます。

{* ../../docs_src/extending_openapi/tutorial001_py310.py hl[13:14,25:26] *}

### メソッドの上書き { #override-the-method }

これで、`.openapi()` メソッドを新しい関数に置き換えられます。

{* ../../docs_src/extending_openapi/tutorial001_py310.py hl[29] *}

### 確認 { #check-it }

  }

  private static long remix(long h) {
    h ^= h >>> 41;
    h *= 949921979;
    return h;
  }

  private static byte getChar(long h) {
    return (byte) ('a' + ((h & 0xfffff) % 26));
  }

## Custom `APIRoute` class in a router { #custom-apiroute-class-in-a-router }

You can also set the `route_class` parameter of an `APIRouter`:

{* ../../docs_src/custom_request_and_route/tutorial003_py310.py hl[26] *}

In this example, the *path operations* under the `router` will use the custom `TimedRoute` class, and will have an extra `X-Response-Time` header in the response with the time it took to generate the response:

对于这些用例，**FastAPI** 应用支持 `app.dependency_overrides` 属性，该属性就是**字典**。

要在测试时覆盖原有依赖项，这个字典的键应当是原依赖项（函数），值是覆盖依赖项（另一个函数）。

这样一来，**FastAPI** 就会调用覆盖依赖项，不再调用原依赖项。

{* ../../docs_src/dependency_testing/tutorial001_an_py310.py hl[26:27,30] *}

/// tip | 提示

**FastAPI** 应用中的任何位置都可以实现覆盖依赖项。

原依赖项可用于*路径操作函数*、*路径操作装饰器*（不需要返回值时）、`.include_router()` 调用等。

FastAPI 可以覆盖这些位置的依赖项。

///

然后，使用 `app.dependency_overrides` 把覆盖依赖项重置为空**字典**：