///

/// tip | Порада

Якщо вам потрібно виконати будь-яку валідацію, яка вимагає взаємодії з будь-яким зовнішнім компонентом, таким як база даних чи інший API, замість цього слід використовувати FastAPI Dependencies — ви дізнаєтесь про них пізніше.

Ці кастомні валідатори використовуються для речей, які можна перевірити лише з тими самими даними, що надані в запиті.

///

### Зрозумійте цей код { #understand-that-code }

///

/// tip

If you need to do any type of validation that requires communicating with any **external component**, like a database or another API, you should instead use **FastAPI Dependencies**, you will learn about them later.

These custom validators are for things that can be checked with **only** the **same data** provided in the request.

///

### Understand that Code { #understand-that-code }

        assertNotNull(thumbnailJob.sessionId);
        assertTrue(result.contains("Session Id:"));

        // The test cannot actually start the process since it requires many dependencies
        // The execute method catches the exception and returns the session ID
    }

    // Test execute with custom session ID
    @Test
    public void test_execute_withCustomSessionId() {

        options.addOption(Option.builder(IGNORE_TRANSITIVE_REPOSITORIES)
                .longOpt("ignore-transitive-repositories")
                .desc("If set, Maven will ignore remote repositories introduced by transitive dependencies.")
                .build());

        // Parameters handled by script
        options.addOption(Option.builder()
                .longOpt(DEBUG)

        assertTrue(tag.toString().contains("attrName=role"));
        assertTrue(tag.toString().contains("attrValue=link"));
    }

    // Mock implementation of Node for testing without external dependencies
    private static class MockNode implements Node {
        private final String nodeName;
        private final Map<String, MockNode> attributes = new HashMap<>();

 *       class instead.
 *   <li>If checking an <i>impossible</i> condition (which <i>cannot</i> happen unless your own
 *       class or its <i>trusted</i> dependencies is badly broken), this is what ordinary Java
 *       assertions are for. Note that assertions are not enabled by default; they are essentially
 *       considered "compiled comments."

建立一個權杖有效期的變數。

定義一個用於權杖端點回應的 Pydantic Model。

建立一個工具函式來產生新的 access token。

{* ../../docs_src/security/tutorial004_an_py310.py hl[4,7,13:15,29:31,82:90] *}

## 更新相依項目 { #update-the-dependencies }

更新 `get_current_user`，讓它仍接收相同的權杖，但這次改用 JWT 權杖。

解碼收到的權杖、驗證它，並回傳目前的使用者。

如果權杖無效，立即回傳一個 HTTP 錯誤。

{* ../../docs_src/security/tutorial004_an_py310.py hl[93:110] *}

创建一个变量用于设置令牌的过期时间。

定义一个用于令牌端点响应的 Pydantic 模型。

创建一个生成新访问令牌的工具函数。

{* ../../docs_src/security/tutorial004_an_py310.py hl[4,7,13:15,29:31,82:90] *}

## 更新依赖项 { #update-the-dependencies }

更新 `get_current_user` 以接收与之前相同的令牌，但这次使用的是 JWT 令牌。

解码接收到的令牌，进行校验，并返回当前用户。

如果令牌无效，立即返回一个 HTTP 错误。

{* ../../docs_src/security/tutorial004_an_py310.py hl[93:110] *}

Using `check_same_thread=False` allows FastAPI to use the same SQLite database in different threads. This is necessary as **one single request** could use **more than one thread** (for example in dependencies).

Don't worry, with the way the code is structured, we'll make sure we use **a single SQLModel *session* per request** later, this is actually what the `check_same_thread` is trying to achieve.

/// tip | 豆知識

`shutdown` は、アプリケーションを「停止」するときに発生します。

新しいバージョンを開始する必要があるか、単に実行をやめたくなったのかもしれません。🤷

///

### Lifespan 関数 { #lifespan-function }

まず注目すべきは、`yield` を使う非同期関数を定義していることです。これは「yield を使う依存関係（Dependencies）」にとてもよく似ています。

{* ../../docs_src/events/tutorial003_py310.py hl[14:19] *}

`yield` の前の前半は、アプリケーションが開始される「前」に実行されます。

`yield` の後半は、アプリケーションの処理が「終了」した「後」に実行されます。

### 非同期コンテキストマネージャ { #async-context-manager }