Package software.amazon.smithy.traitcodegen.integrations.core

Class CoreIntegration

java.lang.Object

software.amazon.smithy.traitcodegen.integrations.core.CoreIntegration

All Implemented Interfaces:

SmithyIntegration<TraitCodegenSettings,TraitCodegenWriter,TraitCodegenContext>, TraitCodegenIntegration

public final class CoreIntegration
extends java.lang.Object
implements TraitCodegenIntegration

Core integration for Trait code generation.

This integration applies no built-in's, but decorates the Symbol provider to replace a shape symbol with a trait symbol definition if the trait has the TraitDefinition trait applied. Trait symbols are named <ShapeName>Trait and always have a definition file. This integration runs after all other integrations have finished to ensure that any other type decorators and integrations have already been applied before creating any Trait definitions from the resulting type.

Constructor Summary

Constructors

Constructor	Description
CoreIntegration()

Method Summary

Modifier and Type	Method	Description
SymbolProvider	decorateSymbolProvider(Model model, TraitCodegenSettings settings, SymbolProvider symbolProvider)	Updates the SymbolProvider used when generating code.
java.util.List<? extends CodeInterceptor<? extends CodeSection,TraitCodegenWriter>>	interceptors(TraitCodegenContext codegenContext)	Gets a list of CodeInterceptors to register with the AbstractCodeWriters created by the code generator.
java.lang.String	name()	Gets the name of the integration.
byte	priority()	Gets the priority ordering relative to the topologically ordered integration graph determined by SmithyIntegration.runBefore() and SmithyIntegration.runAfter().

Methods inherited from class java.lang.Object

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

Methods inherited from interface software.amazon.smithy.codegen.core.SmithyIntegration

configure, customize, preprocessModel, runAfter, runBefore

Constructor Detail

CoreIntegration

public CoreIntegration()

Method Detail

name

public java.lang.String name()

Description copied from interface: SmithyIntegration

Gets the name of the integration.

This name is referred to when ordering the graph of integrations. The name defaults to the canonical class name if not overridden.

Specified by:

name in interface SmithyIntegration<TraitCodegenSettings,TraitCodegenWriter,TraitCodegenContext>

Returns:

Returns the integration name.

priority

public byte priority()

Description copied from interface: SmithyIntegration

Gets the priority ordering relative to the topologically ordered integration graph determined by SmithyIntegration.runBefore() and SmithyIntegration.runAfter().

Higher numbers come before lower numbers.

When ordering, implementations must not allow cycles, and no two integrations may have the same name.

Specified by:

priority in interface SmithyIntegration<TraitCodegenSettings,TraitCodegenWriter,TraitCodegenContext>

Returns:

Returns the priority order.

decorateSymbolProvider

public SymbolProvider decorateSymbolProvider(Model model,
                                             TraitCodegenSettings settings,
                                             SymbolProvider symbolProvider)

Description copied from interface: SmithyIntegration

Updates the SymbolProvider used when generating code.

This can be used to customize the names of shapes, the package that code is generated into, add dependencies, add imports, etc.

By default, this method will return the given symbolProvider as-is.

This integration method should be called only after SmithyIntegration.preprocessModel(software.amazon.smithy.model.Model, S).

Specified by:

decorateSymbolProvider in interface SmithyIntegration<TraitCodegenSettings,TraitCodegenWriter,TraitCodegenContext>

Parameters:

model - Model being generated.

settings - Settings used to generate.

symbolProvider - The original SymbolProvider.

Returns:

The decorated SymbolProvider.

interceptors

public java.util.List<? extends CodeInterceptor<? extends CodeSection,TraitCodegenWriter>> interceptors(TraitCodegenContext codegenContext)

Description copied from interface: SmithyIntegration

Gets a list of CodeInterceptors to register with the AbstractCodeWriters created by the code generator.

This integration method should be called only after SmithyIntegration.preprocessModel(software.amazon.smithy.model.Model, S) and SmithyIntegration.decorateSymbolProvider(software.amazon.smithy.model.Model, S, software.amazon.smithy.codegen.core.SymbolProvider).

Specified by:

interceptors in interface SmithyIntegration<TraitCodegenSettings,TraitCodegenWriter,TraitCodegenContext>

Parameters:

codegenContext - Code generation context that can be queried when creating interceptors.

Returns:

Returns the list of CodeInterceptors.