///

## 使用 Pydantic 模型的查询参数

在一个 **Pydantic 模型**中声明你需要的**查询参数**，然后将参数声明为 `Query`：

{* ../../docs_src/query_param_models/tutorial001_an_py310.py hl[9:13,17] *}

**FastAPI** 将会从请求的**查询参数**中**提取**出**每个字段**的数据，并将其提供给你定义的 Pydantic 模型。

## 查看文档

你可以在 `/docs` 页面的 UI 中查看查询参数：

<div class="screenshot">
<img src="/img/tutorial/query-param-models/image01.png">
</div>

## 禁止额外的查询参数

    // ===================================================================================
    //                                                                               Query
    //                                                                               =====
    public BsClickLogCQ query() {
        assertQueryPurpose();
        return doGetConditionQuery();
    }

    protected BsClickLogCQ doGetConditionQuery() {

 * Contains the document ID and query parameters needed to retrieve thumbnail images.
 */
public class ThumbnailForm {

    /**
     * The document ID for which to retrieve the thumbnail.
     */
    @Required
    @Size(max = 100)
    public String docId;

    /**
     * The query ID associated with the search request.
     */
    @Required
    public String queryId;

    /**

     * @param queryId The ID of the search query.
     * @param query The search query.
     * @param pageStart The starting page number.
     * @param pageSize The size of the page.
     * @param queryResponseList The list of query responses.
     */
    public void addSearchLog(final SearchRequestParams params, final LocalDateTime requestedTime, final String queryId, final String query,

            cb.query().setName_Wildcard(wrapQuery(webConfigPager.name));
        }
        if (StringUtil.isNotBlank(webConfigPager.urls)) {
            cb.query().setUrls_Wildcard(wrapQuery(webConfigPager.urls));
        }
        if (StringUtil.isNotBlank(webConfigPager.description)) {
            if (webConfigPager.description.startsWith("*")) {

  public ImmutableMultisetFloodingTest() {
    super(
        asList(ConstructionPathway.values()),
        n -> n * log(n),
        ImmutableList.of(
            QueryOp.create(
                "count",
                (ms, o) -> {
                  int unused = ms.count(o);
                },
                Math::log)));
  }

  /** All the ways to create an ImmutableMultiset. */

    //                                                                               Query
    //                                                                               =====
    public BsFavoriteLogCQ query() {
        assertQueryPurpose();
        return doGetConditionQuery();
    }

    protected BsFavoriteLogCQ doGetConditionQuery() {

     * This field is optional and used for request verification.
     */
    public String hash;

    /**
     * Query identifier associated with the search that led to this document access.
     * This is required for tracking and analytics purposes.
     */
    @Required
    public String queryId;

    /**
     * Order or ranking position of the document in search results.

                                            <c:choose>
                                                <c:when test="${info.key == 'Query ID'}">
                                                    <td><la:link
                                                            href="/admin/searchlog/search?logType=search&amp;queryId=${f:u(info.value)}&amp;userSessionId=&amp;requestedTimeRange=&amp;accessType=">${f:h(info.value)}</la:link></td>

    // ===================================================================================
    //                                                                               Query
    //                                                                               =====
    public BsSearchLogCQ query() {
        assertQueryPurpose();
        return doGetConditionQuery();
    }

    protected BsSearchLogCQ doGetConditionQuery() {