Trans2GetDfsReferral(final String filename) {
        this(filename, 3);
    }

    Trans2GetDfsReferral(final String filename, final int maxReferralLevel) {
        this.maxReferralLevel = maxReferralLevel;
        path = filename;
        command = SMB_COM_TRANSACTION2;
        subCommand = TRANS2_GET_DFS_REFERRAL;
        totalDataCount = 0;
        maxParameterCount = 0;
        maxDataCount = 4096;
        maxSetupCount = (byte) 0x00;

     */
    void destroy();

    /**
     * Creates a thumbnail generation task.
     * @param path The path to the source document.
     * @param docMap The document map containing metadata.
     * @return A tuple containing task information.
     */
    Tuple3<String, String, String> createTask(String path, Map<String, Object> docMap);

class Trans2QueryPathInformation extends SmbComTransaction {

    private final int informationLevel;

    Trans2QueryPathInformation(final String filename, final int informationLevel) {
        path = filename;
        this.informationLevel = informationLevel;
        command = SMB_COM_TRANSACTION2;
        subCommand = TRANS2_QUERY_PATH_INFORMATION;
        totalDataCount = 0;
        maxParameterCount = 2;

- Use the following preferred translations when they apply in documentation prose:

- request (HTTP): 請求
- response (HTTP): 回應
- path operation: 路徑操作
- path operation function: 路徑操作函式

The translation can optionally include the original English text only in the first occurrence of each page (e.g. "路徑操作 (path operation)") if the translation is hard to be comprehended by most of the Chinese readers.

### `///` admonitions

# 본문 - 다중 매개변수 { #body-multiple-parameters }

이제 `Path`와 `Query`를 어떻게 사용하는지 확인했으니, 요청 본문 선언에 대한 더 고급 사용법을 살펴보겠습니다.

## `Path`, `Query` 및 본문 매개변수 혼합 { #mix-path-query-and-body-parameters }

먼저, 물론 `Path`, `Query` 및 요청 본문 매개변수 선언을 자유롭게 혼합해서 사용할 수 있고, **FastAPI**는 어떤 동작을 할지 압니다.

또한 기본 값을 `None`으로 설정해 본문 매개변수를 선택사항으로 선언할 수 있습니다:

{* ../../docs_src/body_multiple_params/tutorial001_an_py310.py hl[18:20] *}

/// note | 참고

# 请求体 - 多个参数 { #body-multiple-parameters }

既然我们已经知道了如何使用 `Path` 和 `Query`，下面让我们来了解一下请求体声明的更高级用法。

## 混合使用 `Path`、`Query` 和请求体参数 { #mix-path-query-and-body-parameters }

首先，毫无疑问地，你可以随意地混合使用 `Path`、`Query` 和请求体参数声明，**FastAPI** 会知道该如何处理。

你还可以通过将默认值设置为 `None` 来将请求体参数声明为可选参数：

{* ../../docs_src/body_multiple_params/tutorial001_an_py310.py hl[18:20] *}

/// note | 注意

请注意，在这种情况下，将从请求体获取的 `item` 是可选的。因为它的默认值为 `None`。

///

        // Time to live (2 bytes for v3)
        SMBUtil.writeInt2(300, buffer, 18);

        // DFS path offset (2 bytes) - points to string data
        SMBUtil.writeInt2(stringDataStart - 8, buffer, 20); // Offset from start of referral

        // DFS alternate path offset (2 bytes)
        SMBUtil.writeInt2(0, buffer, 22);

        // Network address offset (2 bytes)

from typing import Annotated

from fastapi import FastAPI, Path

app = FastAPI()


@app.get("/items/{item_id}")
async def read_items(
    q: str, item_id: Annotated[int, Path(title="The ID of the item to get")]
):
    results = {"item_id": item_id}
    if q:
        results.update({"q": q})

from typing import Annotated

from fastapi import FastAPI, Path

app = FastAPI()


@app.get("/items/{item_id}")
async def read_items(
    item_id: Annotated[int, Path(title="The ID of the item to get")], q: str
):
    results = {"item_id": item_id}
    if q:
        results.update({"q": q})

import json
from pathlib import Path

file_path = Path("./openapi.json")
openapi_content = json.loads(file_path.read_text())

for path_data in openapi_content["paths"].values():
    for operation in path_data.values():
        tag = operation["tags"][0]
        operation_id = operation["operationId"]
        to_remove = f"{tag}-"
        new_operation_id = operation_id[len(to_remove) :]
        operation["operationId"] = new_operation_id