# 路徑操作進階設定 { #path-operation-advanced-configuration }

## OpenAPI operationId { #openapi-operationid }

/// warning

如果你不是 OpenAPI 的「專家」，大概不需要這個。

///

你可以用參數 `operation_id` 為你的*路徑操作（path operation）*設定要使用的 OpenAPI `operationId`。

你必須確保每個操作的 `operationId` 都是唯一的。

{* ../../docs_src/path_operation_advanced_configuration/tutorial001_py310.py hl[6] *}

            try {
                if (count < 10) {
                    System.out.println(path);
                }
                System.out.println(path);
                assertThat(path, is(notNullValue()));
                assertThat(path, path.startsWith("junit") || path.startsWith("org/junit") || path.startsWith("org/hamcrest")

def read_model_required_list_str(p: Annotated[HeaderModelRequiredListStr, Header()]):
    return {"p": p.p}


@pytest.mark.parametrize(
    "path",
    ["/required-list-str", "/model-required-list-str"],
)
def test_required_list_str_schema(path: str):
    assert app.openapi()["paths"][path]["get"]["parameters"] == snapshot(
        [
            {
                "required": True,
                "schema": {

        ModelSource source = Sources.buildSource(path);

        assertNotNull(source);
        assertInstanceOf(Sources.BuildPathSource.class, source);
        assertEquals(path.normalize(), source.getPath());
    }

    @Test
    void testResolvedSource() {
        String location = "/tmp";
        Path path = Paths.get(location);
        String modelId = "org.example:test:1.0.0";

        @Test
        @DisplayName("should handle merging with different POM sets")
        void shouldHandleMergingWithDifferentPOMSets() {
            Path pom1 = Paths.get("pom.xml");
            Path pom2 = Paths.get("module1/pom.xml");
            Path pom3 = Paths.get("module2/pom.xml");

            UpgradeResult result1 = new UpgradeResult(
                    Set.of(pom1, pom2), // processed

        final String xpath = xpathConfigMap.get(XPath.DEFAULT_LANG);
        if (StringUtil.isNotBlank(xpath)) {
            return xpath;
        }
        return fessConfig.getCrawlerDocumentHtmlLangXpath();
    }

    /**
     * Gets the XPath expression for extracting content.
     *
     * @param fessConfig the Fess configuration
     * @param xpathConfigMap the XPath configuration map

async function modifyOpenAPIFile(filePath) {
  try {
    const data = await fs.promises.readFile(filePath)
    const openapiContent = JSON.parse(data)

    const paths = openapiContent.paths
    for (const pathKey of Object.keys(paths)) {
      const pathData = paths[pathKey]
      for (const method of Object.keys(pathData)) {
        const operation = pathData[method]
        if (operation.tags && operation.tags.length > 0) {

     * unaltered.
     *
     * @param path The path to resolve, may be {@code null}.
     * @param basedir The base directory to resolve relative paths against, may be {@code null}.
     * @return The resolved path or {@code null} if the input path was {@code null}.
     */
    String alignToBaseDirectory(String path, File basedir);

# 경로 매개변수와 숫자 검증 { #path-parameters-and-numeric-validations }

`Query`를 사용하여 쿼리 매개변수에 더 많은 검증과 메타데이터를 선언하는 방법과 동일하게 `Path`를 사용하여 경로 매개변수에 검증과 메타데이터를 같은 타입으로 선언할 수 있습니다.

## `Path` 임포트 { #import-path }

먼저 `fastapi`에서 `Path`를 임포트하고, `Annotated`도 임포트합니다:

{* ../../docs_src/path_params_numeric_validations/tutorial001_an_py310.py hl[1,3] *}

/// info | 정보

FastAPI는 0.95.0 버전에서 `Annotated` 지원을 추가했고(그리고 이를 권장하기 시작했습니다).

# パスパラメータと数値の検証 { #path-parameters-and-numeric-validations }

クエリパラメータに対して`Query`でより多くのバリデーションとメタデータを宣言できるのと同じように、パスパラメータに対しても`Path`で同じ種類のバリデーションとメタデータを宣言することができます。

## `Path`のインポート { #import-path }

まず初めに、`fastapi`から`Path`をインポートし、`Annotated`もインポートします:

{* ../../docs_src/path_params_numeric_validations/tutorial001_an_py310.py hl[1,3] *}

/// info | 情報

FastAPI はバージョン 0.95.0 で`Annotated`のサポートを追加し（そして推奨し始めました）。