{"id":173,"date":"2021-03-03T11:34:25","date_gmt":"2021-03-03T03:34:25","guid":{"rendered":"https:\/\/fugary.com\/?p=173"},"modified":"2021-03-03T11:34:25","modified_gmt":"2021-03-03T03:34:25","slug":"%e4%bd%bf%e7%94%a8swagger-codegen%e7%94%9f%e6%88%90java%e5%ae%a2%e6%88%b7%e7%ab%af","status":"publish","type":"post","link":"https:\/\/fugary.com\/?p=173","title":{"rendered":"\u4f7f\u7528swagger-codegen\u751f\u6210Java\u5ba2\u6237\u7aef"},"content":{"rendered":"

\u4f7f\u7528swagger-codegen\u751f\u6210Java\u5ba2\u6237\u7aef<\/h1>\n

Swagger\u4ecb\u7ecd<\/h2>\n

Swagger \u662f\u4e00\u6b3eRESTFUL\u63a5\u53e3\u7684\u3001\u57fa\u4e8eYAML\u3001JSON\u8bed\u8a00\u7684\u6587\u6863\u5728\u7ebf\u81ea\u52a8\u751f\u6210\u3001\u4ee3\u7801\u81ea\u52a8\u751f\u6210\u7684\u5de5\u5177\u3002<\/p>\n

\u4f7f\u7528Swagger\u89c4\u8303\u5f00\u53d1\u7684\u63a5\u53e3\uff0c\u4f7f\u7528swagger\u7684json\/yaml\u683c\u5f0f\u7684\u5b9a\u4e49\u6587\u4ef6\u4f5c\u4e3a\u63a5\u53e3\u5b9a\u4e49\uff0c\u7c7b\u4f3c\u4ee5\u524d\u7684wsdl\u5b9a\u4e49\u6587\u4ef6\uff0c\u5305\u542b\u63a5\u53e3\u65b9\u6cd5\u4ee5\u53ca\u4e00\u4e9b\u6a21\u578b\u5bf9\u8c61\u5b9a\u4e49\u3002<\/p>\n

\u62ff\u5230\u5b9a\u4e49\u6587\u4ef6\u4e4b\u540e\u53ef\u4ee5\u6839\u636e\u5b9a\u4e49\u751f\u6210\u5ba2\u6237\u7aef\uff0c\u9700\u8981\u7528\u5230\u7684\u5de5\u5177\u5c31\u662fswagger-codegen\u3002<\/p>\n

\u4f7f\u7528swagger-codegen\u53ef\u4ee5\u4f7f\u7528maven\u63d2\u4ef6\u65b9\u5f0f\uff0c\u4e5f\u53ef\u4ee5\u4f7f\u7528\u547d\u4ee4\u884c\u5de5\u5177\u65b9\u5f0f<\/p>\n

\u4f7f\u7528\u547d\u4ee4\u751f\u6210<\/h2>\n

\u4e0b\u8f7dswagger-codegen<\/h3>\n

Github\u5730\u5740\uff1aswagger-codegen<\/a><\/strong><\/p>\n

\u4e0b\u8f7d\u5730\u5740\uff08github\u4e0arelease\u53ea\u6709\u6e90\u7801\uff0c\u53ef\u4ee5\u4ecemaven\u4ed3\u5e93\u4e0b\u8f7d\uff09:<\/p>\n

\u641c\u7d22\uff1ahttps:\/\/search.maven.org\/search?q=a:swagger-codegen-cli<\/a><\/p>\n

https:\/\/repo1.maven.org\/maven2\/io\/swagger\/codegen\/v3\/swagger-codegen-cli\/3.0.24\/swagger-codegen-cli-3.0.24.jar<\/a><\/p>\n

\u4f7f\u7528\u65b9\u6cd5<\/h3>\n

\u67e5\u770b\u5e2e\u52a9\uff1a<\/p>\n

java -jar swagger-codegen-cli-3.0.24.jar generate --help<\/code><\/pre>\n
NAME\n        swagger-codegen-cli generate - Generate code with chosen lang\n\nSYNOPSIS\n        swagger-codegen-cli generate\n                [(-a <authorization> | --auth <authorization>)]\n                [--additional-properties <additional properties>...]\n                [--api-package <api package>] [--artifact-id <artifact id>]\n                [--artifact-version <artifact version>]\n                [(-c <configuration file> | --config <configuration file>)]\n                [-D <system properties>...] [--git-repo-id <git repo id>]\n                [--git-user-id <git user id>] [--group-id <group id>]\n                [--http-user-agent <http user agent>]\n                (-i <spec file> | --input-spec <spec file>)\n                [--ignore-file-override <ignore file override location>]\n                [--import-mappings <import mappings>...]\n                [--instantiation-types <instantiation types>...]\n                [--invoker-package <invoker package>]\n                (-l <language> | --lang <language>)\n                [--language-specific-primitives <language specific primitives>...]\n                [--library <library>] [--model-name-prefix <model name prefix>]\n                [--model-name-suffix <model name suffix>]\n                [--model-package <model package>]\n                [(-o <output directory> | --output <output directory>)]\n                [--release-note <release note>] [--remove-operation-id-prefix]\n                [--reserved-words-mappings <reserved word mappings>...]\n                [(-s | --skip-overwrite)]\n                [(-t <template directory> | --template-dir <template directory>)]\n                [--type-mappings <type mappings>...] [(-v | --verbose)]\n                .......................<\/code><\/pre>\n
\u751f\u6210\u4ee3\u7801<\/h3>\n
\u6709\u5f88\u591a\u53ef\u9009\u7684language\uff08generators\uff09\uff0c\u8fd9\u91cc\u4f7f\u7528jaxrs-cxf-client<\/p>\n
java -jar swagger-codegen-cli-3.0.24.jar generate -i test.yml -l jaxrs-cxf-client -o output --remove-operation-id-prefix true --model-package com.citsgbt.gds.derby.bookingusb.model --api-package com.citsgbt.gds.derby.bookingusb.api<\/code><\/pre>\n
\u4f7f\u7528Maven\u63d2\u4ef6\u751f\u6210<\/h2>\n
\u5f15\u5165\u914d\u7f6e<\/h3>\n
\u6700\u65b0\u7248\uff1a<\/p>\n
https:\/\/github.com\/swagger-api\/swagger-codegen\/tree\/v3.0.24\/modules\/swagger-codegen-maven-plugin<\/a><\/p>\n
<plugin>\n    <groupId>io.swagger.codegen.v3<\/groupId>\n    <artifactId>swagger-codegen-maven-plugin<\/artifactId>\n    <version>3.0.24<\/version>\n    <executions>\n        <execution>\n            <goals>\n                <goal>generate<\/goal>\n            <\/goals>\n            <configuration>\n                <inputSpec>${project.basedir}\/src\/main\/:\/api\/bookingUsb.yml<\/inputSpec>\n                <language>jaxrs-cxf-client<\/language>\n                <configOptions>\n                    <sourceFolder>src\/gen\/java\/main<\/sourceFolder>\n                <\/configOptions>\n                <apiPackage>com.citsgbt.gds.derby.bookingusb.api<\/apiPackage>\n                <modelPackage>com.citsgbt.gds.derby.bookingusb.model<\/modelPackage>\n            <\/configuration>\n        <\/execution>\n    <\/executions>\n<\/plugin><\/code><\/pre>\n
\u53c2\u6570\uff1a<\/p>\n
    \n
  • inputSpec<\/code> - OpenAPI Spec file path<\/li>\n
  • language<\/code> - target generation language<\/li>\n
  • output<\/code> - target output path (default is ${project.build.directory}\/generated-sources\/swagger<\/code>)<\/li>\n
  • templateDirectory<\/code> - directory with mustache templates<\/li>\n
  • addCompileSourceRoot<\/code> - add the output directory to the project as a source root (true<\/code> by default)<\/li>\n
  • modelPackage<\/code> - the package to use for generated model objects\/classes<\/li>\n
  • apiPackage<\/code> - the package to use for generated api objects\/classes<\/li>\n
  • invokerPackage<\/code> - the package to use for the generated invoker objects<\/li>\n
  • modelNamePrefix<\/code> and modelNameSuffix<\/code> - Sets the pre- or suffix for model classes and enums<\/li>\n
  • withXml<\/code> - enable XML annotations inside the generated models and API (only works with Java language<\/code> and libraries that provide support for JSON and XML)<\/li>\n
  • configOptions<\/code> - a map of language-specific parameters (see below)<\/li>\n
  • configHelp<\/code> - dumps the configuration help for the specified library (generates no sources)<\/li>\n
  • ignoreFileOverride<\/code> - specifies the full path to a .swagger-codegen-ignore<\/code> used for pattern based overrides of generated outputs<\/li>\n
  • generateApis<\/code> - generate the apis (true<\/code> by default)<\/li>\n
  • generateApiTests<\/code> - generate the api tests (true<\/code> by default. Only available if generateApis<\/code> is true<\/code>)<\/li>\n
  • generateApiDocumentation<\/code> - generate the api documentation (true<\/code> by default. Only available if generateApis<\/code> is true<\/code>)<\/li>\n
  • generateModels<\/code> - generate the models (true<\/code> by default)<\/li>\n
  • modelsToGenerate<\/code> - A comma separated list of models to generate. All models is the default.<\/li>\n
  • generateModelTests<\/code> - generate the model tests (true<\/code> by default. Only available if generateModels<\/code> is true<\/code>)<\/li>\n
  • generateModelDocumentation<\/code> - generate the model documentation (true<\/code> by default. Only available if generateModels<\/code> is true<\/code>)<\/li>\n
  • generateSupportingFiles<\/code> - generate the supporting files (true<\/code> by default)<\/li>\n
  • supportingFilesToGenerate<\/code> - A comma separated list of supporting files to generate. All files is the default.<\/li>\n
  • skip<\/code> - skip code generation (false<\/code> by default. Can also be set globally through the codegen.skip<\/code> property)<\/li>\n<\/ul>\n
    \u751f\u6210\u4ee3\u7801<\/h3>\n
    mvn clean compile<\/code><\/pre>\n","protected":false},"excerpt":{"rendered":"
    \u4f7f\u7528swagger-codegen\u751f\u6210Java\u5ba2\u6237\u7aef Swagger\u4ecb\u7ecd Swagger \u662f\u4e00\u6b3eRESTFUL […]<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":[],"categories":[2],"tags":[],"_links":{"self":[{"href":"https:\/\/fugary.com\/index.php?rest_route=\/wp\/v2\/posts\/173"}],"collection":[{"href":"https:\/\/fugary.com\/index.php?rest_route=\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/fugary.com\/index.php?rest_route=\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/fugary.com\/index.php?rest_route=\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/fugary.com\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=173"}],"version-history":[{"count":1,"href":"https:\/\/fugary.com\/index.php?rest_route=\/wp\/v2\/posts\/173\/revisions"}],"predecessor-version":[{"id":174,"href":"https:\/\/fugary.com\/index.php?rest_route=\/wp\/v2\/posts\/173\/revisions\/174"}],"wp:attachment":[{"href":"https:\/\/fugary.com\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=173"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/fugary.com\/index.php?rest_route=%2Fwp%2Fv2%2Fcategories&post=173"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/fugary.com\/index.php?rest_route=%2Fwp%2Fv2%2Ftags&post=173"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}