QT_ADD_OPENAPI_CLIENT

제공된 OpenAPI 사양을 사용하여 HTTP 클라이언트를 생성합니다.

이 명령은 Qt6 패키지의 OpenApiTools 구성 요소에 정의되어 있습니다. 패키지를 로드합니다:

find_package(Qt6 REQUIRED COMPONENTS OpenApiTools)

이 명령은 Qt 6.11에 도입되었습니다.

개요

qt_add_openapi_client(<target>
    SPEC_FILE <file>
    [OUTPUT_DIRECTORY <dir>]
    [ADDITIONAL_PROPERTIES property1=value1 property2=value2 ...]
    [GENERATE_OPTIONS generate_option1 generate_option2 ...]
    [JAVA_OPTIONS jvm_option1 jvm_option2 ...]
    [GENERATE_DOCUMENTATION]
    [DOCUMENTATION_OUTPUT_DIRECTORY <dir>]
    [OUTPUT_PUBLIC_HEADERS_DIR <dir>]
    [OUTPUT_PRIVATE_HEADERS_DIR <dir>]
)

버전 없는 명령을 사용할 수 없는 경우 qt6_add_openapi_client() 을 대신 사용합니다. 이 명령과 동일한 인수 집합을 지원합니다.

설명

qt_add_openapi_client 함수는 제공된 사양 파일에 대한 Qt OpenAPI 생성기를 호출합니다. 결과적으로 이 명령은 소스 파일의 범위를 생성하고 대상 소스 목록에 추가합니다. 타깃이 존재하지 않으면 오류 메시지와 함께 생성이 중지됩니다. 대상을 생성하려면 qt_add_library 또는 qt_add_executable 함수를 호출할 수 있습니다.

인수

• SPEC_FILE 코드 생성에 필수인 OpenAPI 사양 파일을 지정합니다. 파일의 확장자는 *.yaml 여야 합니다.
• OUTPUT_DIRECTORY 생성된 코드의 출력 디렉터리를 지정합니다. 지정하지 않으면 CMAKE_CURRENT_BINARY_DIR 가 사용됩니다.
• ADDITIONAL_PROPERTIES 생성 명령에 대한 추가 구성 속성을 지정합니다. 이 속성은 유효성 검사 없이 OpenAPI 생성기에 있는 그대로 전달됩니다.
• GENERATE_OPTIONS 생성 명령에 전달되는 추가 옵션을 지정합니다.

  GENERATE_OPTIONS 을 통해 전달된 -i 및 --input-spec 인수는 무시됩니다. OpenAPI 사양 파일은 SPEC_FILE 인수를 사용하여 독점적으로 설정됩니다.

  GENERATE_OPTIONS 을 통해 전달된 -o 및 --output 인수는 무시됩니다. 출력 디렉토리는 OUTPUT_DIRECTORY 인수를 사용하여 독점적으로 설정됩니다.

• JAVA_OPTIONS OpenAPI 생성기를 호출할 때 JVM에 전달되는 추가 옵션을 지정합니다. 이를 사용하여 JVM 동작을 구성합니다. 옵션은 유효성 검사 없이 그대로 전달됩니다.
• GENERATE_DOCUMENTATION 생성된 클래스에 대한 doxygen 문서 생성을 활성화합니다.
• DOCUMENTATION_OUTPUT_DIRECTORY doxygen 문서를 저장할 디렉터리를 지정합니다. 이 옵션은 GENERATE_DOCUMENTATION 와 함께만 사용할 수 있습니다.
• OUTPUT_PUBLIC_HEADERS_DIR 생성된 공개 헤더 목록을 저장할 디렉터리를 지정하며, 그렇지 않으면 OUTPUT_DIRECTORY 에서 헤더를 찾을 수 있습니다.
• OUTPUT_PRIVATE_HEADERS_DIR 는 생성된 비공개 헤더 목록을 저장할 디렉터리를 지정하며, 그렇지 않으면 OUTPUT_DIRECTORY 에서 헤더를 찾을 수 있습니다.

생성 동작 사용자 지정

GENERATE_OPTIONS 및 ADDITIONAL_PROPERTIES 인수를 사용하면 업스트림 OpenAPI 생성기와 Qt 생성기 플러그인의 동작을 모두 사용자 정의할 수 있습니다.

아래 예제는 프로젝트에서 두 인수를 함께 사용하는 방법을 보여줍니다:

qt6_add_openapi_client(ClientExample
    SPEC_FILE
        ${CMAKE_CURRENT_SOURCE_DIR}/example.yaml
    ADDITIONAL_PROPERTIES
        cppNamespace=ExampleNamespace
        modelNamePrefix=Example
    GENERATE_OPTIONS
        --skip-overwrite
        --api-name-suffix MyApiSuffix
)

생성기 인수의 동작과 지원되는 값은 설치된 OpenAPI 생성기 버전에 따라 다르며 버전 간에 변경될 수 있습니다.

두 가지 방법으로 추가 구성 속성을 제공할 수 있습니다:

• ADDITIONAL_PROPERTIES 인수를 사용합니다.
• GENERATE_OPTIONS 인수에 -p 또는 --additional-properties 전달.

두 가지를 동시에 사용하면 예기치 않은 결과가 발생할 수 있습니다. 한 가지 방법을 선택하는 것이 좋습니다.

JVM 동작 사용자 지정하기

다음 예는 JAVA_OPTIONS 을 사용하여 대용량 사양 파일에 대한 YAML 파서 제한을 늘리고 로그 출력을 경고로만 줄이는 방법을 보여줍니다:

qt6_add_openapi_client(ClientExample
    SPEC_FILE
        ${CMAKE_CURRENT_SOURCE_DIR}/example.yaml
    JAVA_OPTIONS
        -DmaxYamlCodePoints=99999999
        -Dlog.level=warn
)