Package software.amazon.smithy.build.transforms

Class ConfigurableProjectionTransformer<T>

java.lang.Object

software.amazon.smithy.build.transforms.ConfigurableProjectionTransformer<T>

Type Parameters:

T - The configuration setting type (e.g., a POJO).

All Implemented Interfaces:

ProjectionTransformer

Direct Known Subclasses:

Apply, ExcludeMetadata, ExcludeShapesByTag, ExcludeTags, ExcludeTraits, ExcludeTraitsByTag, IncludeMetadata, IncludeNamespaces, IncludeServices, IncludeShapesByTag, IncludeTags, IncludeTraits, IncludeTraitsByTag, RemoveUnusedShapes

public abstract class ConfigurableProjectionTransformer<T>
extends java.lang.Object
implements ProjectionTransformer

An abstract class used to more easily implement a Smithy build projection transformer that expects configuration input in a specific type, T.

This class will automatically deserialize the given Node value in the T and invoke transformWithConfig(TransformContext, Object) with the deserialized configuration of type T.

If your build transformer requires configuration, then you typically should just extend this class.

Constructor Summary

Constructors

Constructor	Description
ConfigurableProjectionTransformer()

Method Summary

Modifier and Type	Method	Description
abstract java.lang.Class<T>	getConfigType()	Gets the configuration class type.
software.amazon.smithy.model.Model	transform(TransformContext context)	Transforms the given model using the provided TransformContext.
protected abstract software.amazon.smithy.model.Model	transformWithConfig(TransformContext context, T config)	Executes the transform using the deserialized configuration object.

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.build.ProjectionTransformer

getName

Constructor Detail

ConfigurableProjectionTransformer

public ConfigurableProjectionTransformer()

Method Detail

getConfigType

public abstract java.lang.Class<T> getConfigType()

Gets the configuration class type.

The referenced configType class must be a public POJO with a public, zero-arg constructor, getters, and setters. If the POJO has a public static fromNode method, it will be invoked and is expected to deserialize the Node. If the POJO has a public static builder method, it will be invoked, setters will be called on the builder POJO, and finally the result of calling the build method is used as the configuration type. Finally, the deserializer will attempt to create the type and call setters on the instantiated object that correspond to property names (either named "set" + property name, or just property name).

Returns:

Returns the configuration class (a POJO with setters/getters).

transform

public software.amazon.smithy.model.Model transform(TransformContext context)

Description copied from interface: ProjectionTransformer

Transforms the given model using the provided TransformContext.

Specified by:

transform in interface ProjectionTransformer

Parameters:

context - Transformation context.

Returns:

Returns the created transformer.

transformWithConfig

protected abstract software.amazon.smithy.model.Model transformWithConfig(TransformContext context,
                                                                          T config)

Executes the transform using the deserialized configuration object.

Parameters:

context - Transform context.

config - Deserialized configuration object.

Returns:

Returns the transformed model.