Package io.apicurio.hub.api.codegen

Class OpenApi2JaxRs

java.lang.Object

io.apicurio.hub.api.codegen.OpenApi2JaxRs

Direct Known Subclasses:

OpenApi2Quarkus, OpenApi2Thorntail

public class OpenApi2JaxRs
extends Object

Class used to generate a simple JAX-RS project from an OpenAPI document.

Author:

eric.wittmann@gmail.com

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	OpenApi2JaxRs.JaxRsRuleFactory

Field Summary

Fields

Modifier and Type	Field	Description
protected static org.jsonschema2pojo.GenerationConfig	config
protected io.apicurio.datamodels.core.models.Document	document
protected static com.fasterxml.jackson.databind.ObjectMapper	mapper
protected static JavaBeanPostProcessor	postProcessor
protected JaxRsProjectSettings	settings
protected static Charset	utf8

Constructor Summary

Constructors

Constructor	Description
OpenApi2JaxRs()	Constructor.

Method Summary

Modifier and Type	Method	Description
protected URI	classnameToUri(String path)
ByteArrayOutputStream	generate()	Generate the JaxRs project.
void	generate(OutputStream output)	Generates a JaxRs project and streams the generated ZIP to the given output stream.
protected void	generateAll(CodegenInfo info, StringBuilder log, ZipOutputStream zipOutput)	Generates all of the content for storage in the ZIP.
protected String	generateJavaInterface(CodegenInfo info, CodegenJavaInterface _interface)	Generates a Jax-rs interface from the given codegen information.
protected String	generateJaxRsApplication()	Generates the JaxRsApplication java class.
protected String	generatePomXml(CodegenInfo info)	Generates the pom.xml file.
protected CodegenInfo	getInfoFromApiDoc()	Processes the OpenAPI document to produce a CodegenInfo object that contains everything needed to generate appropriate Java class(es).
protected URL	getResource(String name)
protected String	getResourceName(String name)
JaxRsProjectSettings	getSettings()
boolean	isUpdateOnly()
protected String	javaPackageToZipPath(String javaPackage)
protected String	schemaRefToFQCN(String path)
void	setOpenApiDocument(InputStream stream)	Sets the OpenAPI document via an input stream.
void	setOpenApiDocument(String content)	Sets the OpenAPI document.
void	setOpenApiDocument(URL url)	Sets the OpenAPI document via a URL to the content.
void	setSettings(JaxRsProjectSettings settings)	Configure the settings.
void	setUpdateOnly(boolean updateOnly)

Methods inherited from class java.lang.Object

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

Field Detail

mapper

protected static com.fasterxml.jackson.databind.ObjectMapper mapper

utf8

protected static Charset utf8

config

protected static org.jsonschema2pojo.GenerationConfig config

postProcessor

protected static JavaBeanPostProcessor postProcessor

document

protected transient io.apicurio.datamodels.core.models.Document document

settings

protected JaxRsProjectSettings settings

Constructor Detail

OpenApi2JaxRs

public OpenApi2JaxRs()

Constructor.

Method Detail

setSettings

public void setSettings(JaxRsProjectSettings settings)

Configure the settings.

Parameters:

settings -

setOpenApiDocument

public void setOpenApiDocument(String content)

Sets the OpenAPI document.

Parameters:

content -

Throws:

IOException

setOpenApiDocument

public void setOpenApiDocument(URL url)
                        throws IOException

Sets the OpenAPI document via a URL to the content.

Parameters:

url -

Throws:

IOException

setOpenApiDocument

public void setOpenApiDocument(InputStream stream)
                        throws IOException

Sets the OpenAPI document via an input stream. The stream must be closed by the caller.

Parameters:

stream -

Throws:

IOException

generate

public final void generate(OutputStream output)
                    throws IOException

Generates a JaxRs project and streams the generated ZIP to the given output stream.

Parameters:

output -

Throws:

IOException

generateAll

protected void generateAll(CodegenInfo info,
                           StringBuilder log,
                           ZipOutputStream zipOutput)
                    throws IOException

Generates all of the content for storage in the ZIP. Responsible for generating all classes and other resources that make up the generated project.

Parameters:

info -

log -

zipOutput -

Throws:

IOException

generate

public ByteArrayOutputStream generate()
                               throws IOException

Generate the JaxRs project.

Throws:

IOException

getInfoFromApiDoc

protected CodegenInfo getInfoFromApiDoc()
                                 throws IOException

Processes the OpenAPI document to produce a CodegenInfo object that contains everything needed to generate appropriate Java class(es).

Throws:

IOException

generatePomXml

protected String generatePomXml(CodegenInfo info)
                         throws IOException

Generates the pom.xml file.

Parameters:

info -

Throws:

IOException

generateJaxRsApplication

protected String generateJaxRsApplication()
                                   throws IOException

Generates the JaxRsApplication java class.

Throws:

IOException

generateJavaInterface

protected String generateJavaInterface(CodegenInfo info,
                                       CodegenJavaInterface _interface)

Generates a Jax-rs interface from the given codegen information.

Parameters:

info -

_interface -

getResource

protected URL getResource(String name)

getResourceName

protected String getResourceName(String name)

classnameToUri

protected URI classnameToUri(String path)

schemaRefToFQCN

protected String schemaRefToFQCN(String path)

javaPackageToZipPath

protected String javaPackageToZipPath(String javaPackage)

isUpdateOnly

public boolean isUpdateOnly()

Returns:

the updateOnly

getSettings

public JaxRsProjectSettings getSettings()

Returns:

the settings

setUpdateOnly

public void setUpdateOnly(boolean updateOnly)

Parameters:

updateOnly - the updateOnly to set