Package io.micronaut.openapi.view

Class OpenApiViewConfig

java.lang.Object

io.micronaut.openapi.view.OpenApiViewConfig

public final class OpenApiViewConfig
extends Object

OpenApi view configuration for Swagger UI, ReDoc, OpenAPI Explorer and RapiDoc. By default, no views are enabled.

Author:

croudet

See Also:

• Swagger UI
• ReDoc
• RapiDoc
• OpenAPI Explorer

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static enum	OpenApiViewConfig.RendererType	The Renderer types.

Field Summary

Fields

Modifier and Type	Field	Description
static final String	DEFAULT_SPEC_MAPPING_PATH
static final String	RESOURCE_DIR
static final String	TEMPLATES
static final String	TEMPLATES_OPENAPI_EXPLORER
static final String	TEMPLATES_RAPIDOC
static final String	TEMPLATES_RAPIPDF
static final String	TEMPLATES_REDOC
static final String	TEMPLATES_SWAGGER_UI
static final String	THEMES_DIR

Method Summary

Modifier and Type	Method	Description
static OpenApiViewConfig	fromSpecification(String specification, Map<Pair<String,String>,OpenApiInfo> openApiInfos, Properties openApiProperties, io.micronaut.inject.visitor.VisitorContext context)	Creates an OpenApiViewConfig form a String representation.
OpenApiExplorerConfig	getOpenApiExplorerConfig()
RapidocConfig	getRapidocConfig()
RedocConfig	getRedocConfig()
String	getSpecURL(AbstractViewConfig cfg, @Nullable io.micronaut.inject.visitor.VisitorContext context)	Returns the relative openApi specification url path.
SwaggerUIConfig	getSwaggerUIConfig()
String	getTitle()	Returns the title for the generated views.
boolean	isEnabled()	Returns true when the generation of views is enabled.
void	render(Path outputDir, io.micronaut.inject.visitor.VisitorContext context)	Generates the views given this configuration.
void	setSpecFile(String specFile)	Sets the generated openApi specification file name.
void	setTitle(String title)	Sets the title for the generated views.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Details

DEFAULT_SPEC_MAPPING_PATH

public static final String DEFAULT_SPEC_MAPPING_PATH

See Also:

• Constant Field Values

RESOURCE_DIR

public static final String RESOURCE_DIR

See Also:

• Constant Field Values

THEMES_DIR

public static final String THEMES_DIR

See Also:

• Constant Field Values

TEMPLATES

public static final String TEMPLATES

See Also:

• Constant Field Values

TEMPLATES_RAPIPDF

public static final String TEMPLATES_RAPIPDF

See Also:

• Constant Field Values

TEMPLATES_SWAGGER_UI

public static final String TEMPLATES_SWAGGER_UI

See Also:

• Constant Field Values

TEMPLATES_REDOC

public static final String TEMPLATES_REDOC

See Also:

• Constant Field Values

TEMPLATES_RAPIDOC

public static final String TEMPLATES_RAPIDOC

See Also:

• Constant Field Values

TEMPLATES_OPENAPI_EXPLORER

public static final String TEMPLATES_OPENAPI_EXPLORER

See Also:

• Constant Field Values

Method Details

fromSpecification

public static OpenApiViewConfig fromSpecification(String specification,
 Map<Pair<String,String>,OpenApiInfo> openApiInfos,
 Properties openApiProperties,
 io.micronaut.inject.visitor.VisitorContext context)

Creates an OpenApiViewConfig form a String representation.

Parameters:

specification - A String representation of an OpenApiViewConfig.

openApiInfos - Open API info objects.

openApiProperties - The open api properties.

context - Visitor context.

Returns:

An OpenApiViewConfig.

isEnabled

public boolean isEnabled()

Returns true when the generation of views is enabled.

Returns:

true when the generation of views is enabled.

render

public void render(Path outputDir,
 io.micronaut.inject.visitor.VisitorContext context)
            throws IOException

Generates the views given this configuration.

Parameters:

outputDir - The destination directory of the generated views.

context - The visitor context

Throws:

IOException - When the generation fails.

getTitle

public String getTitle()

Returns the title for the generated views.

Returns:

A title.

setTitle

public void setTitle(String title)

Sets the title for the generated views.

Parameters:

title - A title.

getSpecURL

public String getSpecURL(AbstractViewConfig cfg,
 @Nullable
 @Nullable io.micronaut.inject.visitor.VisitorContext context)

Returns the relative openApi specification url path.

Parameters:

cfg - view config.

context - Visitor context.

Returns:

A path.

setSpecFile

public void setSpecFile(String specFile)

Sets the generated openApi specification file name.

Parameters:

specFile - The openApi specification file name.

getSwaggerUIConfig

public SwaggerUIConfig getSwaggerUIConfig()

getRedocConfig

public RedocConfig getRedocConfig()

getRapidocConfig

public RapidocConfig getRapidocConfig()

getOpenApiExplorerConfig

public OpenApiExplorerConfig getOpenApiExplorerConfig()