Blog

swagger SDK and cbSwagger v2 Released!

Luis Majano September 03, 2019

Spread the word

Luis Majano

September 03, 2019

Spread the word


Share your thoughts

We are very excited to finally update our swagger modules to version 2: swagger-sdk, cbSwagger. This major version has tons of new features and improvements when documenting ColdBox APIs. However, the biggest features are that we now support the latest Open API Spec => v3.0.2 and we can export your documentation in either JSON or YAML. Check out the release notes below to see all the great new improvements.

Swagger SDK v2.0

This module allows for software development using the Swagger/OpenAPI specification.

box install swagger-sdk

v2.0.0

  • Open API 3.02 support instead of swagger
  • New template layout
  • Engine removals: lucee4.5, ACF10, ACF11
  • Upgraded jackson-core to latest v2.9.9
  • Upgraded snakeyaml to latest v1.24
  • Added more tests
  • Added ability to chain methods on all methods that where void before.
  • document.asYAML() is not fully implemented so you can convert the document to yaml.
  • Upgraded createLinkedHashMap() to use new ACF structNew( "ordered" ) instead.

cbSwagger v2.0

This module automatically generates OpenAPI documenation from your configured application and module routes in either JSON or YAML by simply visiting /cbSwagger in your URL. Focus on building your APIs and document them with ease by simply annotating your handlers.

box install cbSwagger

v2.0.0

  • feature: Upgraded to swagger-sdk 2.0.0 to support OpenAPI 3.0.x. A great guide on migrating is here: https://blog.readme.io/an-example-filled-guide-to-swagger-3-2/

  • Migrated cbSwagger settings to the moduleSettings struct instead of top-level in the config/ColdBox.cfc. Make sure you move your settings.

  • feature : You can now pass a format to the /cbSwagger endpoint to either get the OpenAPI doc as json or yml. Eg: /cbswagger?format=yml

  • feature : You have two distinct routes for the json and yml formats: /cbSwagger/json and /cbSwagger/yml

  • You can choose your default output format via the module settings: defaultFormat setting. Valid options are json and yml

  • features : Support for ColdBox 5 event routing and response routing.

  • improvement : You can now tag your handlers with a displayName that will be used for operation ID building

  • improvement : Improved the way operation Ids are reported so they can be unique when reusing handler actions.

  • improvement : Refactored createLinkedHashMap() -> structNew( "ordered" )

  • improvement: Removed lucee 4.5, acf11 support.

Add Your Comment

Recent Entries

BoxLang: Available for Chromebook!

BoxLang: Available for Chromebook!

Chromebooks are fantastic for developers because they can install a Debian Linux container alongside Chrome OS. This makes running and developing BoxLang applications on your Chromebook simple. Chromebooks have gained popularity among developers and students due to their unique blend of affordability, portability, and robust integration with Linux. By bringing BoxLang to Chromebooks, we are creating a powerful platform for learning and development. Here’s why BoxLang on Chromebooks is a perfect match for students:

Maria Jose Herrera
Maria Jose Herrera
June 13, 2024
ColdBox 7 Workshop 2023: Mission Accomplished!

ColdBox 7 Workshop 2023: Mission Accomplished!

Our two-day ColdBox 7 Workshop of 2023 has concluded, and it was an exciting journey of knowledge and skill-building. Our attendees came, saw, and conquered, learning a treasure trove of materials, techniques, tools, and resources to enhance their projects with ColdBox 7 mastery. It was a fantastic ride, indeed!

Maria Jose Herrera
Maria Jose Herrera
June 13, 2024
May Newsletter 2024!

May Newsletter 2024!

May 2024 Updates & News

Welcome to Ortus Solutions’ monthly roundup, where we're thrilled to showcase cutting-edge advancements, product updates, and exciting events! Join us as we delve into the latest innovations shaping the future of technology. Let’s get started!

...

Maria Jose Herrera
Maria Jose Herrera
June 06, 2024