Introduce: Module for Swagger 2.x

[CarstenWickner]

In the scope of GH-76 and even independently of that, it'd be convenient for out-of-the-box support of Swagger 2.x (OpenAPI) via a new module.

---

For now this is a draft, including changes from @jochenberger and myself.

[jochenberger]

In my real use-case, this would also be an interface, i.e. interface PersonReference extends IReference. That breaks the properties resolution because unfortunately the getter in the interface won't be detected as such.

[jochenberger]

What's left to do for this to go in? Is there anything I can help with?

[CarstenWickner]

Hi @jochenberger,

I‘d say:

• fix formatting
• add some more tests
• consider more aspects in forTypesInGeneral() as well
• at least briefly investigate how to pick-up annotations from extended interfaces
• allow to derive fields from methods (already working on this one)

I didn’t have much time recently. Maybe I’ll get to it over the upcoming weekend.

If you have the capacity, you could look into points 3 and 4.

[jochenberger]

1 should be done, at least checkstyle doesn't complain anymore.
I'm not sure if 4 is an issue at all, I think that it should work. If you're referring to #117 (comment), the problem is that the target implementation is an interface but there is no implementation. The interface is just there for documentary purposes. Specifically, it allows us to override the description of nested fields and to work around swagger-api/swagger-core#3290.
I could have a look at 3 in the next week, I need to figure out which attributes make sense on a type.

[CarstenWickner]

Alright. Merging and releasing the initial version of the Swagger2Module as release 4.13.0 now

[CarstenWickner]

Release v4.13.0 is complete and includes this new Swagger2Module.