Package org.springframework.modulith.docs

Class Documenter

java.lang.Object

org.springframework.modulith.docs.Documenter

public class Documenter
extends Object

API to create documentation for ApplicationModules.

Author:

Oliver Drotbohm

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	Documenter.CanvasOptions
static class	Documenter.DiagramOptions	Options to tweak the rendering of diagrams.

Constructor Summary

Constructors

Constructor	Description
Documenter(Class<?> modulithType)	Creates a new Documenter for the ApplicationModules created for the given modulith type in the default output folder (spring-modulith-docs).
Documenter(ApplicationModules modules)	Creates a new Documenter for the given ApplicationModules instance in the default output folder (spring-modulith-docs).
Documenter(ApplicationModules modules, String outputFolder)	Creates a new Documenter for the given ApplicationModules and output folder.

Method Summary

Modifier and Type	Method	Description
(package private) ApplicationModules	getModules()
(package private) String	toModuleCanvas(ApplicationModule module)
(package private) String	toModuleCanvas(ApplicationModule module, String apiBase)
(package private) String	toModuleCanvas(ApplicationModule module, Documenter.CanvasOptions options)
(package private) String	toPlantUml()
Documenter	withOutputFolder(String outputFolder)	Deprecated, for removal: This API element is subject to removal in a future version. use Documenter(org.springframework.modulith.core.ApplicationModules,java.lang.String) directly.
Documenter	writeDocumentation()	Writes all available documentation: The entire set of modules as overview component diagram. Individual component diagrams per module to include all upstream modules. The Module Canvas for each module. using Documenter.DiagramOptions.defaults() and Documenter.CanvasOptions.defaults().
Documenter	writeDocumentation(Documenter.DiagramOptions options, Documenter.CanvasOptions canvasOptions)	Writes all available documentation: The entire set of modules as overview component diagram. Individual component diagrams per module to include all upstream modules. The Module Canvas for each module.
Documenter	writeIndividualModulesAsPlantUml()
Documenter	writeIndividualModulesAsPlantUml(Documenter.DiagramOptions options)	Writes the component diagrams for all individual modules.
Documenter	writeModuleAsPlantUml(ApplicationModule module)	Writes the PlantUML component diagram for the given ApplicationModule.
Documenter	writeModuleAsPlantUml(ApplicationModule module, Documenter.DiagramOptions options)	Writes the PlantUML component diagram for the given ApplicationModule with the given rendering Documenter.DiagramOptions.
Documenter	writeModuleCanvases()	Writes all module canvases using Documenter.DiagramOptions.defaults().
Documenter	writeModuleCanvases(Documenter.CanvasOptions options)	Writes all module canvases using the given Documenter.DiagramOptions.
Documenter	writeModulesAsPlantUml()	Writes the PlantUML component diagram for all ApplicationModules using Documenter.DiagramOptions.defaults().
Documenter	writeModulesAsPlantUml(Documenter.DiagramOptions options)	Writes the PlantUML component diagram for all ApplicationModules with the given Documenter.DiagramOptions.

Methods inherited from class java.lang.Object

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

Constructor Details

Documenter

public Documenter(Class<?> modulithType)

Creates a new Documenter for the ApplicationModules created for the given modulith type in the default output folder (spring-modulith-docs).

Parameters:

modulithType - must not be null.

Documenter

public Documenter(ApplicationModules modules)

Creates a new Documenter for the given ApplicationModules instance in the default output folder (spring-modulith-docs).

Parameters:

modules - must not be null.

Documenter

public Documenter(ApplicationModules modules,
 String outputFolder)

Creates a new Documenter for the given ApplicationModules and output folder.

Parameters:

modules - must not be null.

outputFolder - must not be null or empty.

Method Details

withOutputFolder

@Deprecated(forRemoval=true)
public Documenter withOutputFolder(String outputFolder)

Deprecated, for removal: This API element is subject to removal in a future version.

use Documenter(org.springframework.modulith.core.ApplicationModules,java.lang.String) directly.

Customize the output folder to write the generated files to. Defaults to "spring-modulith-docs".

Parameters:

outputFolder - must not be null or empty.

Returns:

will never be null.

writeDocumentation

public Documenter writeDocumentation()

Writes all available documentation:

• The entire set of modules as overview component diagram.
• Individual component diagrams per module to include all upstream modules.
• The Module Canvas for each module.

using Documenter.DiagramOptions.defaults() and Documenter.CanvasOptions.defaults().

Returns:

the current instance, will never be null.

writeDocumentation

public Documenter writeDocumentation(Documenter.DiagramOptions options,
 Documenter.CanvasOptions canvasOptions)

Writes all available documentation:

• The entire set of modules as overview component diagram.
• Individual component diagrams per module to include all upstream modules.
• The Module Canvas for each module.

Parameters:

options - must not be null.

canvasOptions - must not be null.

Returns:

the current instance, will never be null.

writeModulesAsPlantUml

public Documenter writeModulesAsPlantUml()

Writes the PlantUML component diagram for all ApplicationModules using Documenter.DiagramOptions.defaults().

Returns:

the current instance, will never be null.

writeModulesAsPlantUml

public Documenter writeModulesAsPlantUml(Documenter.DiagramOptions options)

Writes the PlantUML component diagram for all ApplicationModules with the given Documenter.DiagramOptions.

Parameters:

options - must not be null.

Returns:

the current instance, will never be null.

writeIndividualModulesAsPlantUml

public Documenter writeIndividualModulesAsPlantUml()

writeIndividualModulesAsPlantUml

public Documenter writeIndividualModulesAsPlantUml(Documenter.DiagramOptions options)

Writes the component diagrams for all individual modules.

Parameters:

options - must not be null.

Returns:

the current instance, will never be null.

writeModuleAsPlantUml

public Documenter writeModuleAsPlantUml(ApplicationModule module)

Writes the PlantUML component diagram for the given ApplicationModule.

Parameters:

module - must not be null.

Returns:

the current instance, will never be null.

writeModuleAsPlantUml

public Documenter writeModuleAsPlantUml(ApplicationModule module,
 Documenter.DiagramOptions options)

Writes the PlantUML component diagram for the given ApplicationModule with the given rendering Documenter.DiagramOptions.

Parameters:

module - must not be null.

options - must not be null.

Returns:

the current instance, will never be null.

writeModuleCanvases

public Documenter writeModuleCanvases()

Writes all module canvases using Documenter.DiagramOptions.defaults().

Returns:

the current instance, will never be null.

writeModuleCanvases

public Documenter writeModuleCanvases(Documenter.CanvasOptions options)

Writes all module canvases using the given Documenter.DiagramOptions.

Parameters:

options - must not be null.

Returns:

the current instance, will never be null.

toModuleCanvas

String toModuleCanvas(ApplicationModule module)

toModuleCanvas

String toModuleCanvas(ApplicationModule module,
 String apiBase)

toModuleCanvas

String toModuleCanvas(ApplicationModule module,
 Documenter.CanvasOptions options)

getModules

ApplicationModules getModules()

toPlantUml

String toPlantUml()