Access to Swagger and Modify Swagger UI API Key

[nmonterroso]

There currently isn't a way to access the Swagger object and add any additional documentation your application might need, like securityDefinition or tags (see #55). This PR introduces a new function to SwaggerBundle:

protected void setUpSwagger(Swagger swagger)

Which allows us to provide these properties, and then sets the application context's swagger attribute to this modified Swagger object, so it can be properly fetched in ApiListingResource.

Also introducing a SwaggerUIConfiguration class to configure some parts of the Swagger UI on /swagger. For now, the only controllable parts are the API key's name, it's location (header or query) and the name for the header or query param. This is configured like so:

# other configs
swaggerConfiguration:
  ui:
    authName: "api_key"
    authKey: "x-some-header"
    authKeyLocation: "header"

And default to api_key, api_key, query, which is their current value in the Swagger UI.

[apetersson]

This is something i would really use since i am using swagger with basic auth and it seems to leave out some important tags

[nmonterroso]

@apetersson It looks like the main repo hasn't been updated since this pull request was opened. Currently we're importing this into our projects from an internal Archiva repository, but maybe we should release it to Maven Central if there are other folks who want to take advantage of this functionality. Though as much as possible we'd like to avoid forking. @federecio ?