}
                }
            } catch (final IOException e) {
                throw new CrawlingAccessException("Failed to access permission info", e);
            }
            if (logger.isDebugEnabled()) {
                logger.debug("fileUrl:{} roleType:{}", responseData.getUrl(), roleTypeList);
            }
        }
        return roleTypeList;

WebargsはFlaskをはじめとするいくつかのフレームワークの上にそれを提供するために作られたツールです。

データのバリデーションを行うために内部ではMarshmallowを使用しており、同じ開発者によって作られました。

素晴らしいツールで、私も**FastAPI**を持つ前はよく使っていました。

/// info | 情報

Webargsは、Marshmallowと同じ開発者により作られました。

///

/// check | **FastAPI**へ与えたインスピレーション

受信したデータに対する自動的なバリデーションを持っている点。

///

import org.junit.jupiter.api.DisplayName;
import org.junit.jupiter.api.Test;

import jcifs.smb.SID;

/**
 * Unit tests for PacLogonInfo class.
 * Tests the parsing and data extraction from PAC Logon Info structures.
 */
class PacLogonInfoTest {

    private static final long TEST_FILETIME = 130640000000000000L;
    private static final String TEST_USERNAME = "testuser";

}

func getQuorumDiskInfos(disks []StorageAPI, infos []DiskInfo, readQuorum int) (newDisks []StorageAPI, newInfos []DiskInfo) {
	commonMutations := calcCommonCounter(infos, readQuorum)
	for i, info := range infos {
		mutations := info.Metrics.TotalDeletes + info.Metrics.TotalWrites
		if mutations >= commonMutations {
			newDisks = append(newDisks, disks[i])
			newInfos = append(newInfos, infos[i])
		}
	}

	return newDisks, newInfos

使用するすべてのタグにメタデータを追加する必要はありません。

///

### タグの使用 { #use-your-tags }

*path operation*（および `APIRouter`）の `tags` パラメータを使用して、それらを異なるタグに割り当てます:

{* ../../docs_src/metadata/tutorial004_py310.py hl[21,26] *}

/// info | 情報

タグの詳細は [Path Operation の設定](path-operation-configuration.md#tags) を参照してください。

///

### ドキュメントの確認 { #check-the-docs }

ここでドキュメントを確認すると、追加したメタデータがすべて表示されます:

page.role.max.fetch.size=1000
# Maximum number of group records to fetch per page.
page.group.max.fetch.size=1000
# Maximum number of crawling info parameters to fetch per page.
page.crawling.info.param.max.fetch.size=100
# Maximum number of crawling info records to fetch per page.
page.crawling.info.max.fetch.size=1000
# Maximum number of data config records to fetch per page.
page.data.config.max.fetch.size=100

    protected static final short SMB2_QUERY_DIRECTORY = 0x000E;
    /** SMB2 change notify command */
    protected static final short SMB2_CHANGE_NOTIFY = 0x000F;
    /** SMB2 query info command */
    protected static final short SMB2_QUERY_INFO = 0x0010;
    /** SMB2 set info command */
    protected static final short SMB2_SET_INFO = 0x0011;
    /** SMB2 opportunistic lock break notification */
    protected static final short SMB2_OPLOCK_BREAK = 0x0012;

当然，除了请求体参数外，你还可以在任何需要的时候声明额外的查询参数。

由于默认情况下单一值会被解释为查询参数，因此你不必显式地添加 `Query`，你可以这样写：

```Python
q: str | None = None
```

比如：

{* ../../docs_src/body_multiple_params/tutorial004_an_py310.py hl[28] *}

/// info | 信息

`Body` 同样具有与 `Query`、`Path` 以及其他后面将看到的类完全相同的额外校验和元数据参数。

///

## 嵌入单个请求体参数 { #embed-a-single-body-parameter }

假设你只有一个来自 Pydantic 模型 `Item` 的请求体参数 `item`。

默认情况下，**FastAPI** 将直接期望这样的请求体。

				beforeState[index] = madmin.DriveStateMissing
				afterState[index] = madmin.DriveStateMissing

				return serr
			}
			return nil
		}, index)
	}

	errs := g.Wait()

	// Initialize heal result info
	res = madmin.HealResultItem{
		Type:      madmin.HealItemBucket,
		Bucket:    bucket,
		DiskCount: len(localDrives),
		SetCount:  -1, // explicitly set an invalid value -1, for bucket heal scenario
	}

**请求体**是客户端发送给你的 API 的数据。**响应体**是你的 API 发送给客户端的数据。

你的 API 几乎总是需要发送**响应体**。但客户端不一定总是要发送**请求体**，有时它们只请求某个路径，可能带一些查询参数，但不会发送请求体。

使用 [Pydantic](https://docs.pydantic.dev/) 模型来声明**请求体**，能充分利用它的功能和优点。

/// info | 信息

发送数据应使用以下之一：`POST`（最常见）、`PUT`、`DELETE` 或 `PATCH`。

规范中没有定义用 `GET` 请求发送请求体的行为，但 FastAPI 仍支持这种方式，只用于非常复杂/极端的用例。

由于不推荐，在使用 `GET` 时，Swagger UI 的交互式文档不会显示请求体的文档，而且中间的代理可能也不支持它。

///