///

在 HTTP 中，你會在回應的一部分傳回 3 位數的狀態碼。

這些狀態碼有對應的名稱以便辨識，但重點是數字本身。

簡而言之：

* `100 - 199` 表示「資訊」。你很少會直接使用它們。這些狀態碼的回應不可包含本文。
* **`200 - 299`** 表示「成功」。這是你最常使用的一組。
    * `200` 是預設狀態碼，表示一切「OK」。
    * 另一個例子是 `201`，代表「已建立」。常用於在資料庫中建立新紀錄之後。
    * 一個特殊情況是 `204`，代表「無內容」。當沒有內容要回傳給用戶端時使用，因此回應不得有本文。
* **`300 - 399`** 表示「重新導向」。這些狀態碼的回應可能有或沒有本文，唯獨 `304`（「未修改」）必須沒有本文。
* **`400 - 499`** 表示「用戶端錯誤」。這大概是你第二常用的一組。
    * 例如 `404`，代表「找不到」。

        assertEquals(404, response.getStatus());

        // Test with different status code
        manager = new StatusCodeWebApiManager(201);
        response = new TestHttpServletResponse();
        manager.process(request, response, chain);
        assertEquals(201, response.getStatus());
    }

    @Test
    public void test_process_withHeaderSetting() throws IOException, ServletException {

它會使用預設的狀態碼，或你在路徑操作中設定的狀態碼。

## 額外的狀態碼 { #additional-status-codes_1 }

如果你想在主要狀態碼之外再回傳其他狀態碼，可以直接回傳一個 `Response`（例如 `JSONResponse`），並直接設定你想要的額外狀態碼。

例如，你想要有一個允許更新項目的路徑操作，成功時回傳 HTTP 狀態碼 200 "OK"。

但你也希望它能接受新項目；當項目先前不存在時就建立它們，並回傳 HTTP 狀態碼 201 "Created"。

要達成這點，匯入 `JSONResponse`，直接在那裡回傳內容，並設定你想要的 `status_code`：

{* ../../docs_src/additional_status_codes/tutorial001_an_py310.py hl[4,25] *}

/// warning

當你直接回傳一個 `Response`（就像上面的範例），它會原封不動地被送出。

        final AtomicReference<String> capturedPath = new AtomicReference<>();
        final CoordinatorHelper helper = createCapturingHelper("node1@host1", capturedPath, capturedBody, createMockResponse(201, "{}"));

        helper.tryStartOperation("reindex", "fess");

        assertNotNull(capturedBody.get());
        final Map<String, Object> body = coordinatorHelper.parseJson(capturedBody.get());

メインのステータスコードとは別に追加のステータスコードを返したい場合は、`JSONResponse` のような `Response` を直接返し、追加のステータスコードを直接設定できます。

たとえば、item を更新でき、成功時に HTTP ステータスコード 200 "OK" を返す *path operation* を作りたいとします。

しかし、新しい item も受け付けたいとします。そして、item が以前存在しなかった場合には作成し、HTTP ステータスコード 201「Created」を返します。

これを実現するには、`JSONResponse` をインポートし、望む `status_code` を設定して、そこで内容を直接返します。

{* ../../docs_src/additional_status_codes/tutorial001_an_py310.py hl[4,25] *}

/// warning

つまり:

* `100 - 199` は「情報」のためのものです。直接使うことはほとんどありません。これらのステータスコードを持つレスポンスはボディを持つことができません。
* **`200 - 299`** は「成功」のレスポンスのためのものです。これらは最も利用するであろうものです。
    * `200`はデフォルトのステータスコードで、すべてが「OK」であったことを意味します。
    * 別の例としては、`201`（Created）があります。これはデータベースに新しいレコードを作成した後によく使用されます。
    * 特殊なケースとして、`204`（No Content）があります。このレスポンスはクライアントに返すコンテンツがない場合に使用されるため、レスポンスはボディを持ってはいけません。

                .put("/" + getIndexName() + "/_doc/" + instanceId + "?refresh=true") //
                .body(body)
                .execute()) {
            if (response.getHttpStatusCode() != 200 && response.getHttpStatusCode() != 201) {
                logger.warn("Failed to send heartbeat: status={}", response.getHttpStatusCode());
            }
        } catch (final Exception e) {
            logger.debug("Failed to send heartbeat.", e);
        }

## Пример использования { #use-case }

Например, представьте, что вы хотите по умолчанию возвращать HTTP статус-код «OK» `200`.

Но если данные не существовали, вы хотите создать их и вернуть HTTP статус-код «CREATED» `201`.

При этом вы всё ещё хотите иметь возможность фильтровать и преобразовывать возвращаемые данные с помощью `response_model`.

Для таких случаев вы можете использовать параметр `Response`.

Stellen Sie sich zum Beispiel vor, Sie möchten standardmäßig den HTTP-Statuscode „OK“ `200` zurückgeben.

Wenn die Daten jedoch nicht vorhanden sind, möchten Sie diese erstellen und den HTTP-Statuscode „CREATED“ `201` zurückgeben.

Sie möchten aber dennoch in der Lage sein, die von Ihnen zurückgegebenen Daten mit einem `response_model` zu filtern und zu konvertieren.

In diesen Fällen können Sie einen `Response`-Parameter verwenden.

[versions]
agp = "9.1.0"
amazon-corretto = "2.5.0"
android-junit5 = "2.0.1"
androidx-activity = "1.11.0"
androidx-annotation = "1.9.1"
androidx-espresso-core = "3.7.0"
androidx-junit = "1.3.0"
androidx-test-runner = "1.7.0"
animalsniffer = "2.0.1"
animalsniffer-annotations = "1.27"
assertk = "0.28.1"
binary-compatibility-validator = "0.18.1"
bnd = "7.2.3"
brotli-dec = "0.1.2"
burst = "2.10.2"
checkstyle = "13.4.0"
clikt = "5.1.0"