from fastapi import Cookie, FastAPI, Form, Header, Query
from fastapi.testclient import TestClient
from pydantic import Json

app = FastAPI()


@app.post("/form-json-list")
def form_json_list(items: Annotated[Json[list[str]], Form()]) -> list[str]:
    return items


@app.get("/query-json-list")
def query_json_list(items: Annotated[Json[list[str]], Query()]) -> list[str]:
    return items

        }
        return null;
    }

    /**
     * Stores the document IDs associated with a search query for tracking purposes.
     * This method caches the document IDs returned for a specific query to enable click tracking and analytics.
     *
     * @param queryId the unique identifier for the search query
     * @param documentItems the list of document maps containing search results
     */

        assertNotNull(Constants.FACET_FIELD_PREFIX);
        assertNotNull(Constants.FACET_QUERY_PREFIX);
        assertEquals("field:", Constants.FACET_FIELD_PREFIX);
        assertEquals("query:", Constants.FACET_QUERY_PREFIX);
    }

    @Test
    public void test_unicode_base64_encoding() {
        // Test that unicode strings are properly encoded/decoded
        String unicodeString = "日本語テスト";

    private String fileName;

    /**
     * Constructs an SMB2 query directory request with the given configuration.
     *
     * @param config the configuration for this request
     */
    public Smb2QueryDirectoryRequest(final Configuration config) {
        this(config, Smb2Constants.UNSPECIFIED_FILEID);
    }

    /**
     * Constructs a SMB2 query directory request with the specified configuration and file ID
     *

        // Default constructor
    }

    /** The parameter for negative query. */
    public static final String AS_NQ = "nq";

    /** The parameter for OR query. */
    public static final String AS_OQ = "oq";

    /** The parameter for exact phrase query. */
    public static final String AS_EPQ = "epq";

    /** The parameter for query. */
    public static final String AS_Q = "q";

    }

    /**
     * Gets the total number of documents that match the specified query.
     *
     * @param searchEngineClient the search engine client to use for the count
     * @param queryBuilder the query to count documents for
     * @param fessConfig the Fess configuration
     * @return the number of documents that match the query
     */

`Header` 是 `Path`、`Query`、`Cookie` 的**兄弟类**，都继承自共用的 `Param` 类。

注意，从 `fastapi` 导入的 `Query`、`Path`、`Header` 等对象，实际上是返回特殊类的函数。

///

/// info | 信息

必须使用 `Header` 声明 header 参数，否则该参数会被解释为查询参数。

///

## 自动转换 { #automatic-conversion }

`Header` 比 `Path`、`Query` 和 `Cookie` 提供了更多功能。

大部分标准请求头用**连字符**分隔，即**减号**（`-`）。

但是 `user-agent` 这样的变量在 Python 中是无效的。

因此，默认情况下，`Header` 把参数名中的字符由下划线（`_`）改为连字符（`-`）来提取并存档请求头 。

import jakarta.validation.constraints.Size;

/**
 * The edit form for Related Query.
 * This form extends CreateForm and adds fields necessary for editing existing related query entries.
 */
public class EditForm extends CreateForm {

    /** Unique identifier for the related query entry */
    @Required
    @Size(max = 1000)
    public String id;

    *,
    settings: Settings,
    query: str,
    after: str | None = None,
) -> dict[str, Any]:
    headers = {"Authorization": f"token {settings.sponsors_token.get_secret_value()}"}
    variables = {"after": after}
    response = httpx.post(
        github_graphql_url,
        headers=headers,
        timeout=settings.httpx_timeout,
        json={"query": query, "variables": variables, "operationName": "Q"},
    )

{* ../../docs_src/body/tutorial003_py310.py hl[15:16] *}


## Request body + path + query parameters { #request-body-path-query-parameters }

You can also declare **body**, **path** and **query** parameters, all at the same time.

**FastAPI** will recognize each of them and take the data from the correct place.