[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-4223":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":10,"language":11,"languages":10,"totalLinesOfCode":10,"stars":12,"forks":13,"watchers":14,"openIssues":15,"contributorsCount":16,"subscribersCount":16,"size":16,"stars1d":16,"stars7d":17,"stars30d":18,"stars90d":16,"forks30d":16,"starsTrendScore":19,"compositeScore":20,"rankGlobal":10,"rankLanguage":10,"license":21,"archived":22,"fork":22,"defaultBranch":23,"hasWiki":24,"hasPages":24,"topics":25,"createdAt":10,"pushedAt":10,"updatedAt":36,"readmeContent":37,"aiSummary":38,"trendingCount":16,"starSnapshotCount":16,"syncStatus":19,"lastSyncTime":39,"discoverSource":40},4223,"swagger-core","swagger-api\u002Fswagger-core","swagger-api","Examples and server integrations for generating the Swagger API Specification, which enables easy access to your REST API","http:\u002F\u002Fswagger.io",null,"Java",7528,2254,308,154,0,6,11,2,41,"Apache License 2.0",false,"master",true,[26,27,28,29,30,31,32,33,34,7,35],"hacktoberfest","java","open-source","openapi","openapi-specification","openapi3","rest","rest-api","swagger","swagger-oss","2026-06-12 02:01:00","# Swagger Core \u003Cimg src=\"https:\u002F\u002Fraw.githubusercontent.com\u002Fswagger-api\u002Fswagger.io\u002Fwordpress\u002Fimages\u002Fassets\u002FSW-logo-clr.png\" height=\"50\" align=\"right\">\n\n**NOTE:** If you're looking for Swagger Core 1.5.X and OpenAPI 2.0, please refer to [1.5 branch](https:\u002F\u002Fgithub.com\u002Fswagger-api\u002Fswagger-core\u002Ftree\u002F1.5).\n\n**NOTE:** Since version 2.1.7, Swagger Core also supports the Jakarta namespace. There are a parallel set of artifacts with the `-jakarta` suffix, providing the same functionality as the unsuffixed (i.e.: `javax`) artifacts.\nPlease see the [Wiki](https:\u002F\u002Fgithub.com\u002Fswagger-api\u002Fswagger-core\u002Fwiki\u002FSwagger-2.X---Getting-started) for more details.\n\n**NOTE:** Since version 2.2.0 Swagger Core supports OpenAPI 3.1; see [this page](https:\u002F\u002Fgithub.com\u002Fswagger-api\u002Fswagger-core\u002Fwiki\u002FSwagger-2.X---OpenAPI-3.1) for details\n\n![Build Test Deploy](https:\u002F\u002Fgithub.com\u002Fswagger-api\u002Fswagger-core\u002Fworkflows\u002FBuild%20Test%20Deploy%20master\u002Fbadge.svg?branch=master)\n[![Maven Central](https:\u002F\u002Fmaven-badges.herokuapp.com\u002Fmaven-central\u002Fio.swagger.core.v3\u002Fswagger-project\u002Fbadge.svg?style=plastic)](https:\u002F\u002Fmaven-badges.herokuapp.com\u002Fmaven-central\u002Fio.swagger.core.v3\u002Fswagger-project)\n\nSwagger Core is a Java implementation of the OpenAPI Specification. Current version supports *JAX-RS2* (`javax` and `jakarta` namespaces).\n\n## Get started with Swagger Core!\nSee the guide on [getting started with Swagger Core](https:\u002F\u002Fgithub.com\u002Fswagger-api\u002Fswagger-core\u002Fwiki\u002FSwagger-2.X---Getting-started) to get started with adding Swagger to your API.\n\n## See the Wiki!\nThe [github wiki](https:\u002F\u002Fgithub.com\u002Fswagger-api\u002Fswagger-core\u002Fwiki) contains documentation, samples, contributions, etc. Start there.\n\n## Compatibility\nThe OpenAPI Specification has undergone several revisions since initial creation in 2010.  The Swagger Core project has the following compatibilities with the OpenAPI Specification:\n\nSwagger core Version      | Release Date | OpenAPI Spec compatibility | Notes | Status\n------------------------- | ------------ | -------------------------- | ----- | ----\n2.2.49 (**current stable**)| 2026-04-28   | 3.x           | [tag v2.2.49](https:\u002F\u002Fgithub.com\u002Fswagger-api\u002Fswagger-core\u002Ftree\u002Fv2.2.49) | Supported\n2.2.48                     | 2026-04-13   | 3.x           | [tag v2.2.48](https:\u002F\u002Fgithub.com\u002Fswagger-api\u002Fswagger-core\u002Ftree\u002Fv2.2.48) | Supported\n2.2.47                     | 2026-04-09   | 3.x           | [tag v2.2.47](https:\u002F\u002Fgithub.com\u002Fswagger-api\u002Fswagger-core\u002Ftree\u002Fv2.2.47) | Supported\n2.2.46                     | 2026-03-31   | 3.x           | [tag v2.2.46](https:\u002F\u002Fgithub.com\u002Fswagger-api\u002Fswagger-core\u002Ftree\u002Fv2.2.46) | Supported\n2.2.45                     | 2026-03-09   | 3.x           | [tag v2.2.45](https:\u002F\u002Fgithub.com\u002Fswagger-api\u002Fswagger-core\u002Ftree\u002Fv2.2.45) | Supported\n2.2.44                     | 2026-03-03   | 3.x           | [tag v2.2.44](https:\u002F\u002Fgithub.com\u002Fswagger-api\u002Fswagger-core\u002Ftree\u002Fv2.2.44) | Supported\n2.2.43                     | 2026-02-17   | 3.x           | [tag v2.2.43](https:\u002F\u002Fgithub.com\u002Fswagger-api\u002Fswagger-core\u002Ftree\u002Fv2.2.43) | Supported\n2.2.42                     | 2026-01-19   | 3.x           | [tag v2.2.42](https:\u002F\u002Fgithub.com\u002Fswagger-api\u002Fswagger-core\u002Ftree\u002Fv2.2.42) | Supported\n2.2.41                     | 2025-11-24   | 3.x           | [tag v2.2.41](https:\u002F\u002Fgithub.com\u002Fswagger-api\u002Fswagger-core\u002Ftree\u002Fv2.2.41) | Supported\n2.2.40                     | 2025-10-28   | 3.x           | [tag v2.2.40](https:\u002F\u002Fgithub.com\u002Fswagger-api\u002Fswagger-core\u002Ftree\u002Fv2.2.40) | Supported\n2.2.39                     | 2025-10-13   | 3.x           | [tag v2.2.39](https:\u002F\u002Fgithub.com\u002Fswagger-api\u002Fswagger-core\u002Ftree\u002Fv2.2.39) | Supported\n2.2.38                     | 2025-09-29   | 3.x           | [tag v2.2.38](https:\u002F\u002Fgithub.com\u002Fswagger-api\u002Fswagger-core\u002Ftree\u002Fv2.2.38) | Supported\n2.2.37                     | 2025-09-16   | 3.x           | [tag v2.2.37](https:\u002F\u002Fgithub.com\u002Fswagger-api\u002Fswagger-core\u002Ftree\u002Fv2.2.37) | Supported\n2.2.36                     | 2025-08-18   | 3.x           | [tag v2.2.36](https:\u002F\u002Fgithub.com\u002Fswagger-api\u002Fswagger-core\u002Ftree\u002Fv2.2.36) | Supported\n2.2.35                     | 2025-07-31   | 3.x           | [tag v2.2.35](https:\u002F\u002Fgithub.com\u002Fswagger-api\u002Fswagger-core\u002Ftree\u002Fv2.2.35) | Supported\n2.2.34                     | 2025-06-20   | 3.x           | [tag v2.2.34](https:\u002F\u002Fgithub.com\u002Fswagger-api\u002Fswagger-core\u002Ftree\u002Fv2.2.34) | Supported\n2.2.33                     | 2025-06-12   | 3.x           | [tag v2.2.33](https:\u002F\u002Fgithub.com\u002Fswagger-api\u002Fswagger-core\u002Ftree\u002Fv2.2.33) | Supported\n2.2.32                     | 2025-05-14   | 3.x           | [tag v2.2.32](https:\u002F\u002Fgithub.com\u002Fswagger-api\u002Fswagger-core\u002Ftree\u002Fv2.2.32) | Supported\n2.2.31                     | 2025-05-13   | 3.x           | [tag v2.2.31](https:\u002F\u002Fgithub.com\u002Fswagger-api\u002Fswagger-core\u002Ftree\u002Fv2.2.31) | Supported\n2.2.30                     | 2025-04-07   | 3.x           | [tag v2.2.30](https:\u002F\u002Fgithub.com\u002Fswagger-api\u002Fswagger-core\u002Ftree\u002Fv2.2.30) | Supported\n2.2.29                     | 2025-03-10   | 3.x           | [tag v2.2.29](https:\u002F\u002Fgithub.com\u002Fswagger-api\u002Fswagger-core\u002Ftree\u002Fv2.2.29) | Supported\n2.2.28                     | 2025-01-16   | 3.x           | [tag v2.2.28](https:\u002F\u002Fgithub.com\u002Fswagger-api\u002Fswagger-core\u002Ftree\u002Fv2.2.28) | Supported\n2.2.27                     | 2024-12-11   | 3.x           | [tag v2.2.27](https:\u002F\u002Fgithub.com\u002Fswagger-api\u002Fswagger-core\u002Ftree\u002Fv2.2.27) | Supported\n2.2.26                     | 2024-11-18   | 3.x           | [tag v2.2.26](https:\u002F\u002Fgithub.com\u002Fswagger-api\u002Fswagger-core\u002Ftree\u002Fv2.2.26) | Supported\n2.2.25                     | 2024-10-02   | 3.x           | [tag v2.2.25](https:\u002F\u002Fgithub.com\u002Fswagger-api\u002Fswagger-core\u002Ftree\u002Fv2.2.25) | Supported\n2.2.24                     | 2024-09-23   | 3.x           | [tag v2.2.24](https:\u002F\u002Fgithub.com\u002Fswagger-api\u002Fswagger-core\u002Ftree\u002Fv2.2.24) | Supported\n2.2.23                     | 2024-08-28   | 3.x           | [tag v2.2.23](https:\u002F\u002Fgithub.com\u002Fswagger-api\u002Fswagger-core\u002Ftree\u002Fv2.2.23) | Supported\n2.2.22                     | 2024-05-15   | 3.x           | [tag v2.2.22](https:\u002F\u002Fgithub.com\u002Fswagger-api\u002Fswagger-core\u002Ftree\u002Fv2.2.22) | Supported\n2.2.21                     | 2024-03-20   | 3.x           | [tag v2.2.21](https:\u002F\u002Fgithub.com\u002Fswagger-api\u002Fswagger-core\u002Ftree\u002Fv2.2.21) | Supported\n2.2.20                     | 2023-12-19   | 3.x           | [tag v2.2.20](https:\u002F\u002Fgithub.com\u002Fswagger-api\u002Fswagger-core\u002Ftree\u002Fv2.2.20) | Supported\n2.2.19                     | 2023-11-10   | 3.x           | [tag v2.2.19](https:\u002F\u002Fgithub.com\u002Fswagger-api\u002Fswagger-core\u002Ftree\u002Fv2.2.19) | Supported\n2.2.18                     | 2023-10-25   | 3.x           | [tag v2.2.18](https:\u002F\u002Fgithub.com\u002Fswagger-api\u002Fswagger-core\u002Ftree\u002Fv2.2.18) | Supported\n2.2.17                     | 2023-10-12   | 3.x           | [tag v2.2.17](https:\u002F\u002Fgithub.com\u002Fswagger-api\u002Fswagger-core\u002Ftree\u002Fv2.2.17) | Supported\n2.2.16                     | 2023-09-18   | 3.x           | [tag v2.2.16](https:\u002F\u002Fgithub.com\u002Fswagger-api\u002Fswagger-core\u002Ftree\u002Fv2.2.16) | Supported\n2.2.15                     | 2023-07-08   | 3.x           | [tag v2.2.15](https:\u002F\u002Fgithub.com\u002Fswagger-api\u002Fswagger-core\u002Ftree\u002Fv2.2.15) | Supported\n2.2.14                     | 2023-06-26   | 3.x           | [tag v2.2.14](https:\u002F\u002Fgithub.com\u002Fswagger-api\u002Fswagger-core\u002Ftree\u002Fv2.2.14) | Supported\n2.2.13                     | 2023-06-24   | 3.x           | [tag v2.2.13](https:\u002F\u002Fgithub.com\u002Fswagger-api\u002Fswagger-core\u002Ftree\u002Fv2.2.13) | Supported\n2.2.12                     | 2023-06-13   | 3.x           | [tag v2.2.12](https:\u002F\u002Fgithub.com\u002Fswagger-api\u002Fswagger-core\u002Ftree\u002Fv2.2.12) | Supported\n2.2.11                     | 2023-06-01   | 3.x           | [tag v2.2.11](https:\u002F\u002Fgithub.com\u002Fswagger-api\u002Fswagger-core\u002Ftree\u002Fv2.2.11) | Supported\n2.2.10                     | 2023-05-15   | 3.x           | [tag v2.2.10](https:\u002F\u002Fgithub.com\u002Fswagger-api\u002Fswagger-core\u002Ftree\u002Fv2.2.10) | Supported\n2.2.9                     | 2023-03-20  | 3.x           | [tag v2.2.9](https:\u002F\u002Fgithub.com\u002Fswagger-api\u002Fswagger-core\u002Ftree\u002Fv2.2.9)                                             | Supported\n2.2.8                     | 2023-01-06  | 3.x           | [tag v2.2.8](https:\u002F\u002Fgithub.com\u002Fswagger-api\u002Fswagger-core\u002Ftree\u002Fv2.2.8)                                             | Supported\n2.2.7                     | 2022-11-15  | 3.0           | [tag v2.2.7](https:\u002F\u002Fgithub.com\u002Fswagger-api\u002Fswagger-core\u002Ftree\u002Fv2.2.7)                                             | Supported\n2.2.6                     | 2022-11-02  | 3.0           | [tag v2.2.6](https:\u002F\u002Fgithub.com\u002Fswagger-api\u002Fswagger-core\u002Ftree\u002Fv2.2.6)                                             | Supported\n2.2.5                     | 2022-11-02  | 3.0           | [tag v2.2.5](https:\u002F\u002Fgithub.com\u002Fswagger-api\u002Fswagger-core\u002Ftree\u002Fv2.2.5)                                             | Supported\n2.2.4                     | 2022-10-16  | 3.0           | [tag v2.2.4](https:\u002F\u002Fgithub.com\u002Fswagger-api\u002Fswagger-core\u002Ftree\u002Fv2.2.4)                                             | Supported\n2.2.3                     | 2022-09-27  | 3.0           | [tag v2.2.3](https:\u002F\u002Fgithub.com\u002Fswagger-api\u002Fswagger-core\u002Ftree\u002Fv2.2.3)                                             | Supported\n2.2.2                     | 2022-07-20  | 3.0           | [tag v2.2.2](https:\u002F\u002Fgithub.com\u002Fswagger-api\u002Fswagger-core\u002Ftree\u002Fv2.2.2)                                             | Supported\n2.2.1                     | 2022-06-15  | 3.0           | [tag v2.2.1](https:\u002F\u002Fgithub.com\u002Fswagger-api\u002Fswagger-core\u002Ftree\u002Fv2.2.1)                                             | Supported\n2.2.0                     | 2022-04-04  | 3.0           | [tag v2.2.0](https:\u002F\u002Fgithub.com\u002Fswagger-api\u002Fswagger-core\u002Ftree\u002Fv2.2.0)                                             | Supported\n2.1.13                     | 2022-02-07  | 3.0           | [tag v2.1.13](https:\u002F\u002Fgithub.com\u002Fswagger-api\u002Fswagger-core\u002Ftree\u002Fv2.1.13)                                           | Supported\n2.1.12                     | 2021-12-23  | 3.0           | [tag v2.1.12](https:\u002F\u002Fgithub.com\u002Fswagger-api\u002Fswagger-core\u002Ftree\u002Fv2.1.12)                                           | Supported\n2.1.11                     | 2021-09-29  | 3.0           | [tag v2.1.11](https:\u002F\u002Fgithub.com\u002Fswagger-api\u002Fswagger-core\u002Ftree\u002Fv2.1.11)                                           | Supported\n2.1.10                     | 2021-06-28  | 3.0           | [tag v2.1.10](https:\u002F\u002Fgithub.com\u002Fswagger-api\u002Fswagger-core\u002Ftree\u002Fv2.1.10)                                           | Supported\n2.1.9                     | 2021-04-20  | 3.0           | [tag v2.1.9](https:\u002F\u002Fgithub.com\u002Fswagger-api\u002Fswagger-core\u002Ftree\u002Fv2.1.9)                                             | Supported\n2.1.8                     | 2021-04-18  | 3.0           | [tag v2.1.8](https:\u002F\u002Fgithub.com\u002Fswagger-api\u002Fswagger-core\u002Ftree\u002Fv2.1.8)                                             | Supported\n2.1.7                     | 2021-02-18  | 3.0           | [tag v2.1.7](https:\u002F\u002Fgithub.com\u002Fswagger-api\u002Fswagger-core\u002Ftree\u002Fv2.1.7)                                             | Supported\n2.1.6                     | 2020-12-04  | 3.0           | [tag v2.1.6](https:\u002F\u002Fgithub.com\u002Fswagger-api\u002Fswagger-core\u002Ftree\u002Fv2.1.6)                                             | Supported\n2.1.5                     | 2020-10-01  | 3.0           | [tag v2.1.5](https:\u002F\u002Fgithub.com\u002Fswagger-api\u002Fswagger-core\u002Ftree\u002Fv2.1.5)                                             | Supported\n2.1.4                     | 2020-07-24  | 3.0           | [tag v2.1.4](https:\u002F\u002Fgithub.com\u002Fswagger-api\u002Fswagger-core\u002Ftree\u002Fv2.1.4)                                             | Supported\n2.1.3                     | 2020-06-27  | 3.0           | [tag v2.1.3](https:\u002F\u002Fgithub.com\u002Fswagger-api\u002Fswagger-core\u002Ftree\u002Fv2.1.3)                                             | Supported\n2.1.2                     | 2020-04-01  | 3.0           | [tag v2.1.2](https:\u002F\u002Fgithub.com\u002Fswagger-api\u002Fswagger-core\u002Ftree\u002Fv2.1.2)                                             | Supported\n2.1.1                     | 2020-01-02  | 3.0           | [tag v2.1.1](https:\u002F\u002Fgithub.com\u002Fswagger-api\u002Fswagger-core\u002Ftree\u002Fv2.1.1)                                             | Supported\n2.1.0                     | 2019-11-16  | 3.0           | [tag v2.1.0](https:\u002F\u002Fgithub.com\u002Fswagger-api\u002Fswagger-core\u002Ftree\u002Fv2.1.0)                                             | Supported\n2.0.10                    | 2019-10-11  | 3.0           | [tag v2.0.10](https:\u002F\u002Fgithub.com\u002Fswagger-api\u002Fswagger-core\u002Ftree\u002Fv2.0.10)                                           | Supported\n2.0.9                     | 2019-08-22  | 3.0           | [tag v2.0.9](https:\u002F\u002Fgithub.com\u002Fswagger-api\u002Fswagger-core\u002Ftree\u002Fv2.0.9)                                             | Supported\n2.0.8                     | 2019-04-24  | 3.0           | [tag v2.0.8](https:\u002F\u002Fgithub.com\u002Fswagger-api\u002Fswagger-core\u002Ftree\u002Fv2.0.8)                                             | Supported\n2.0.7                     | 2019-02-18  | 3.0           | [tag v2.0.7](https:\u002F\u002Fgithub.com\u002Fswagger-api\u002Fswagger-core\u002Ftree\u002Fv2.0.7)                                             | Supported\n2.0.6                     | 2018-11-27  | 3.0           | [tag v2.0.6](https:\u002F\u002Fgithub.com\u002Fswagger-api\u002Fswagger-core\u002Ftree\u002Fv2.0.6)                                             | Supported\n2.0.5                     | 2018-09-19  | 3.0           | [tag v2.0.5](https:\u002F\u002Fgithub.com\u002Fswagger-api\u002Fswagger-core\u002Ftree\u002Fv2.0.5)                                             | Supported\n2.0.4                     | 2018-09-05  | 3.0           | [tag v2.0.4](https:\u002F\u002Fgithub.com\u002Fswagger-api\u002Fswagger-core\u002Ftree\u002Fv2.0.4)                                             | Supported\n2.0.3                     | 2018-08-09  | 3.0           | [tag v2.0.3](https:\u002F\u002Fgithub.com\u002Fswagger-api\u002Fswagger-core\u002Ftree\u002Fv2.0.3)                                             | Supported\n1.6.14 (**current stable**)| 2024-03-19   | 2.0           | [tag v1.6.14](https:\u002F\u002Fgithub.com\u002Fswagger-api\u002Fswagger-core\u002Ftree\u002Fv1.6.14)                                           | Supported\n1.6.13                    | 2024-01-26   | 2.0           | [tag v1.6.13](https:\u002F\u002Fgithub.com\u002Fswagger-api\u002Fswagger-core\u002Ftree\u002Fv1.6.13)                                           | Supported\n1.6.12                    | 2023-10-14   | 2.0           | [tag v1.6.12](https:\u002F\u002Fgithub.com\u002Fswagger-api\u002Fswagger-core\u002Ftree\u002Fv1.6.12)                                           | Supported\n1.6.11                    | 2023-05-15  | 2.0           | [tag v1.6.11](https:\u002F\u002Fgithub.com\u002Fswagger-api\u002Fswagger-core\u002Ftree\u002Fv1.6.11)                                           | Supported\n1.6.10                    | 2023-03-21  | 2.0           | [tag v1.6.10](https:\u002F\u002Fgithub.com\u002Fswagger-api\u002Fswagger-core\u002Ftree\u002Fv1.6.10)                                           | Supported\n1.6.9                     | 2022-11-15  | 2.0           | [tag v1.6.9](https:\u002F\u002Fgithub.com\u002Fswagger-api\u002Fswagger-core\u002Ftree\u002Fv1.6.9)                                             | Supported\n1.6.8                     | 2022-10-16  | 2.0           | [tag v1.6.8](https:\u002F\u002Fgithub.com\u002Fswagger-api\u002Fswagger-core\u002Ftree\u002Fv1.6.8)                                             | Supported\n1.6.7                     | 2022-09-27  | 2.0           | [tag v1.6.7](https:\u002F\u002Fgithub.com\u002Fswagger-api\u002Fswagger-core\u002Ftree\u002Fv1.6.7)                                             | Supported\n1.6.6                     | 2022-04-04  | 2.0           | [tag v1.6.6](https:\u002F\u002Fgithub.com\u002Fswagger-api\u002Fswagger-core\u002Ftree\u002Fv1.6.6)                                             | Supported\n1.6.5                     | 2022-02-07  | 2.0           | [tag v1.6.5](https:\u002F\u002Fgithub.com\u002Fswagger-api\u002Fswagger-core\u002Ftree\u002Fv1.6.5)                                             | Supported\n1.6.4                     | 2021-12-23  | 2.0           | [tag v1.6.4](https:\u002F\u002Fgithub.com\u002Fswagger-api\u002Fswagger-core\u002Ftree\u002Fv1.6.4)                                             | Supported\n1.6.3                     | 2021-09-29  | 2.0           | [tag v1.6.3](https:\u002F\u002Fgithub.com\u002Fswagger-api\u002Fswagger-core\u002Ftree\u002Fv1.6.3)                                             | Supported\n1.6.2                     | 2020-07-01  | 2.0           | [tag v1.6.2](https:\u002F\u002Fgithub.com\u002Fswagger-api\u002Fswagger-core\u002Ftree\u002Fv1.6.2)                                             | Supported\n1.6.1                     | 2020-04-01  | 2.0           | [tag v1.6.1](https:\u002F\u002Fgithub.com\u002Fswagger-api\u002Fswagger-core\u002Ftree\u002Fv1.6.1)                                             | Supported\n1.6.0                     | 2019-11-16  | 2.0           | [tag v1.6.0](https:\u002F\u002Fgithub.com\u002Fswagger-api\u002Fswagger-core\u002Ftree\u002Fv1.6.0)                                             | Supported\n1.5.24                    | 2019-10-11  | 2.0           | [tag v1.5.24](https:\u002F\u002Fgithub.com\u002Fswagger-api\u002Fswagger-core\u002Ftree\u002Fv1.5.24)                                           | Supported\n1.5.23                    | 2019-08-22  | 2.0           | [tag v1.5.23](https:\u002F\u002Fgithub.com\u002Fswagger-api\u002Fswagger-core\u002Ftree\u002Fv1.5.23)                                           | Supported\n1.5.22                    | 2019-02-18  | 2.0           | [tag v1.5.22](https:\u002F\u002Fgithub.com\u002Fswagger-api\u002Fswagger-core\u002Ftree\u002Fv1.5.22)                                           | Supported\n1.5.21                    | 2018-08-09  | 2.0           | [tag v1.5.21](https:\u002F\u002Fgithub.com\u002Fswagger-api\u002Fswagger-core\u002Ftree\u002Fv1.5.21)                                           | Supported\n1.5.20                    | 2018-05-23  | 2.0           | [tag v1.5.20](https:\u002F\u002Fgithub.com\u002Fswagger-api\u002Fswagger-core\u002Ftree\u002Fv1.5.20)                                           | Supported\n2.0.2                     | 2018-05-23  | 3.0           | [tag v2.0.2](https:\u002F\u002Fgithub.com\u002Fswagger-api\u002Fswagger-core\u002Ftree\u002Fv2.0.2)                                             | Supported\n2.0.1                     | 2018-04-16  | 3.0           | [tag v2.0.1](https:\u002F\u002Fgithub.com\u002Fswagger-api\u002Fswagger-core\u002Ftree\u002Fv2.0.1)                                             | Supported\n1.5.19                    | 2018-04-16  | 2.0           | [tag v1.5.19](https:\u002F\u002Fgithub.com\u002Fswagger-api\u002Fswagger-core\u002Ftree\u002Fv1.5.19)                                           | Supported\n2.0.0                     | 2018-03-20  | 3.0           | [tag v2.0.0](https:\u002F\u002Fgithub.com\u002Fswagger-api\u002Fswagger-core\u002Ftree\u002Fv2.0.0)                                             | Supported\n2.0.0-rc4                 | 2018-01-22  | 3.0           | [tag v2.0.0-rc4](https:\u002F\u002Fgithub.com\u002Fswagger-api\u002Fswagger-core\u002Ftree\u002Fv2.0.0-rc4)                                     | Supported\n2.0.0-rc3                 | 2017-11-21  | 3.0           | [tag v2.0.0-rc3](https:\u002F\u002Fgithub.com\u002Fswagger-api\u002Fswagger-core\u002Ftree\u002Fv2.0.0-rc3)                                     | Supported\n2.0.0-rc2                 | 2017-09-29  | 3.0           | [tag v2.0.0-rc2](https:\u002F\u002Fgithub.com\u002Fswagger-api\u002Fswagger-core\u002Ftree\u002Fv2.0.0-rc2)                                     | Supported\n2.0.0-rc1                 | 2017-08-17  | 3.0           | [tag v2.0.0-rc1](https:\u002F\u002Fgithub.com\u002Fswagger-api\u002Fswagger-core\u002Ftree\u002Fv2.0.0-rc1)                                     | Supported\n1.5.18                    | 2018-01-22  | 2.0           | [tag v1.5.18](https:\u002F\u002Fgithub.com\u002Fswagger-api\u002Fswagger-core\u002Ftree\u002Fv1.5.18)                                           | Supported\n1.5.17                    | 2017-11-21  | 2.0           | [tag v1.5.17](https:\u002F\u002Fgithub.com\u002Fswagger-api\u002Fswagger-core\u002Ftree\u002Fv1.5.17)                                           | Supported\n1.5.16                    | 2017-07-15  | 2.0           | [tag v1.5.16](https:\u002F\u002Fgithub.com\u002Fswagger-api\u002Fswagger-core\u002Ftree\u002Fv1.5.16)                                           | Supported\n1.3.12                    | 2014-12-23  | 1.2           | [tag v1.3.12](https:\u002F\u002Fgithub.com\u002Fswagger-api\u002Fswagger-core\u002Ftree\u002Fv1.3.12)                                           | Supported\n1.2.4                     | 2013-06-19  | 1.1           | [tag swagger-project_2.10.0-1.2.4](https:\u002F\u002Fgithub.com\u002Fswagger-api\u002Fswagger-core\u002Ftree\u002Fswagger-project_2.10.0-1.2.4) | Deprecated\n1.0.0                     | 2011-10-16  | 1.0           | [tag v1.0](https:\u002F\u002Fgithub.com\u002Fswagger-api\u002Fswagger-core\u002Ftree\u002Fv1.0)                                                 | Deprecated\n\n\n### Change History\nIf you're interested in the change history of swagger and the Swagger Core framework, see [here](https:\u002F\u002Fgithub.com\u002Fswagger-api\u002Fswagger-core\u002Freleases).\n\n### Prerequisites\nYou need the following installed and available in your $PATH:\n\n* Java 11\n* Apache maven 3.0.4 or greater\n* Jackson 2.4.5 or greater\n\n\n### To build from source (currently 2.2.50-SNAPSHOT)\n```\n# first time building locally\nmvn -N\n```\n\nSubsequent builds:\n```\nmvn install\n```\n\nThis will build the modules.\n\nOf course if you don't want to build locally you can grab artifacts from maven central:\n\n`https:\u002F\u002Frepo1.maven.org\u002Fmaven2\u002Fio\u002Fswagger\u002Fcore\u002F`\n\n### Maven BOM\n\nThe `swagger-bom` artifact is a Bill of Materials that manages **both** the `javax` and Jakarta (`-jakarta` suffix) artifact families.\nImport it once and omit versions on all individual Swagger dependencies.\n\n> **Note:** Maven and Gradle build plugins (`swagger-maven-plugin`, `swagger-gradle-plugin`,\n> `swagger-eclipse-transformer-maven-plugin`) are intentionally **excluded** from the BOM.\n> Plugins are applied via `\u003Cbuild>\u003Cplugins>` or `plugins {}`, not via `\u003CdependencyManagement>`,\n> so including them in the BOM would be misleading and could conflict with the plugin\n> management section of a consumer's build.\n\n#### Maven\n\n```xml\n\u003CdependencyManagement>\n  \u003Cdependencies>\n    \u003Cdependency>\n      \u003CgroupId>io.swagger.core.v3\u003C\u002FgroupId>\n      \u003CartifactId>swagger-bom\u003C\u002FartifactId>\n      \u003Cversion>${swagger-openapiv3.version}\u003C\u002Fversion>\n      \u003Ctype>pom\u003C\u002Ftype>\n      \u003Cscope>import\u003C\u002Fscope>\n    \u003C\u002Fdependency>\n  \u003C\u002Fdependencies>\n\u003C\u002FdependencyManagement>\n\n\u003C!-- Then declare Swagger dependencies without explicit versions -->\n\u003Cdependencies>\n  \u003C!-- javax artifacts -->\n  \u003Cdependency>\n    \u003CgroupId>io.swagger.core.v3\u003C\u002FgroupId>\n    \u003CartifactId>swagger-annotations\u003C\u002FartifactId>\n  \u003C\u002Fdependency>\n  \u003Cdependency>\n    \u003CgroupId>io.swagger.core.v3\u003C\u002FgroupId>\n    \u003CartifactId>swagger-models\u003C\u002FartifactId>\n  \u003C\u002Fdependency>\n  \u003Cdependency>\n    \u003CgroupId>io.swagger.core.v3\u003C\u002FgroupId>\n    \u003CartifactId>swagger-core\u003C\u002FartifactId>\n  \u003C\u002Fdependency>\n  \u003Cdependency>\n    \u003CgroupId>io.swagger.core.v3\u003C\u002FgroupId>\n    \u003CartifactId>swagger-integration\u003C\u002FartifactId>\n  \u003C\u002Fdependency>\n  \u003Cdependency>\n    \u003CgroupId>io.swagger.core.v3\u003C\u002FgroupId>\n    \u003CartifactId>swagger-jaxrs2\u003C\u002FartifactId>\n  \u003C\u002Fdependency>\n  \u003Cdependency>\n    \u003CgroupId>io.swagger.core.v3\u003C\u002FgroupId>\n    \u003CartifactId>swagger-jaxrs2-servlet-initializer\u003C\u002FartifactId>\n  \u003C\u002Fdependency>\n  \u003Cdependency>\n    \u003CgroupId>io.swagger.core.v3\u003C\u002FgroupId>\n    \u003CartifactId>swagger-jaxrs2-servlet-initializer-v2\u003C\u002FartifactId>\n  \u003C\u002Fdependency>\n  \u003C!-- Jakarta namespace artifacts (use instead of, or alongside, the javax ones above) -->\n  \u003Cdependency>\n    \u003CgroupId>io.swagger.core.v3\u003C\u002FgroupId>\n    \u003CartifactId>swagger-annotations-jakarta\u003C\u002FartifactId>\n  \u003C\u002Fdependency>\n  \u003Cdependency>\n    \u003CgroupId>io.swagger.core.v3\u003C\u002FgroupId>\n    \u003CartifactId>swagger-models-jakarta\u003C\u002FartifactId>\n  \u003C\u002Fdependency>\n  \u003Cdependency>\n    \u003CgroupId>io.swagger.core.v3\u003C\u002FgroupId>\n    \u003CartifactId>swagger-core-jakarta\u003C\u002FartifactId>\n  \u003C\u002Fdependency>\n  \u003Cdependency>\n    \u003CgroupId>io.swagger.core.v3\u003C\u002FgroupId>\n    \u003CartifactId>swagger-integration-jakarta\u003C\u002FartifactId>\n  \u003C\u002Fdependency>\n  \u003Cdependency>\n    \u003CgroupId>io.swagger.core.v3\u003C\u002FgroupId>\n    \u003CartifactId>swagger-jaxrs2-jakarta\u003C\u002FartifactId>\n  \u003C\u002Fdependency>\n  \u003Cdependency>\n    \u003CgroupId>io.swagger.core.v3\u003C\u002FgroupId>\n    \u003CartifactId>swagger-jaxrs2-servlet-initializer-jakarta\u003C\u002FartifactId>\n  \u003C\u002Fdependency>\n  \u003Cdependency>\n    \u003CgroupId>io.swagger.core.v3\u003C\u002FgroupId>\n    \u003CartifactId>swagger-jaxrs2-servlet-initializer-v2-jakarta\u003C\u002FartifactId>\n  \u003C\u002Fdependency>\n\u003C\u002Fdependencies>\n```\n\n#### Gradle\n\n```kotlin\ndependencies {\n    implementation(platform(\"io.swagger.core.v3:swagger-bom:${swaggerOpenapiv3Version}\"))\n\n    \u002F\u002F javax artifacts — no version needed\n    implementation(\"io.swagger.core.v3:swagger-annotations\")\n    implementation(\"io.swagger.core.v3:swagger-core\")\n\n    \u002F\u002F Jakarta namespace artifacts — no version needed\n    implementation(\"io.swagger.core.v3:swagger-annotations-jakarta\")\n    implementation(\"io.swagger.core.v3:swagger-core-jakarta\")\n}\n```\n\n## Sample Apps\nThe samples have moved to [a new repository](https:\u002F\u002Fgithub.com\u002Fswagger-api\u002Fswagger-samples\u002Ftree\u002F2.0) and contain various integrations and configurations.\n\n## Security contact\n\nPlease disclose any security-related issues or vulnerabilities by emailing [security@swagger.io](mailto:security@swagger.io), instead of using the public issue tracker.\n","Swagger Core 是一个用于生成 Swagger API 规范的 Java 实现，使得 REST API 的访问更加便捷。它支持 JAX-RS2（包括 `javax` 和 `jakarta` 命名空间），并自 2.1.7 版本起兼容 Jakarta 命名空间。此外，从 2.2.0 版本开始，Swagger Core 支持 OpenAPI 3.1 规范。该项目提供了一系列示例和服务器集成方案，帮助开发者轻松地将 Swagger 集成到他们的项目中。适用于需要为 RESTful 服务创建清晰、结构化文档的场景，尤其适合那些希望提高 API 可发现性和可维护性的开发团队。","2026-06-11 02:59:07","top_language"]