com.atlassian.bamboo.specs.codegen.emitters.value

Class EntityPropertiesEmitter<T extends EntityProperties>

java.lang.Object

com.atlassian.bamboo.specs.codegen.emitters.value.EntityPropertiesEmitter<T>

All Implemented Interfaces:

CodeEmitter<T>

Direct Known Subclasses:

AnyNotificationRecipientEmitter, AnyNotificationTypeEmitter, AnyVcsRepositoryViewerEmitter, ArtifactItemEmitter, BranchCleanupEmitter, CheckoutSpecEmitter, DockerBuildImageEmitter, DockerRegistryEmitter, DockerRunContainerEmitter, PermissionPropertiesEmitter, PlanIdentifierEmitter, ScheduledTriggerEmitter, ScpTaskEmitter

public class EntityPropertiesEmitter<T extends EntityProperties>
extends Object
implements CodeEmitter<T>

Default code generator for any EntityProperties This class can be extended to implement more specialised generators. Note that the implementation is stateful.

Field Summary

Fields

Modifier and Type	Field and Description
protected Class	builderClass Builder class associated with given properties type.
protected Set<String>	fieldsToSkip Fields that should be skipped in emitFields(CodeGenerationContext, EntityProperties).

Constructor Summary

Constructors

Constructor and Description
EntityPropertiesEmitter()

Method Summary

Modifier and Type	Method and Description
protected EntityProperties	createDefaultObject(EntityProperties rootObject) Creates instance of the EntityProperties that contains default values.
String	emitCode(CodeGenerationContext context, T entity) Generates code for properties class.
protected String	emitConstructorInvocation(CodeGenerationContext context, T entity) Generates constructor invocation of the builder class.
protected String	emitFields(CodeGenerationContext context, EntityProperties entity) Generate code for all fields of the class that are not already covered by emitConstructorInvocation(CodeGenerationContext, EntityProperties) not contained in fieldsToSkip and not annotated with SkipCodeGen.
protected String	emitFieldValue(CodeGenerationContext context, EntityProperties entity, Field field) Generates value of a field.
protected Field	findField(Class clazz, String fieldName)
protected boolean	hasPublicConstructor(Class builderClass, Class... argTypes)
protected void	initBuilderClass(T entity) Default method of finding builderClass.

Methods inherited from class java.lang.Object

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

Field Detail

builderClass

protected Class builderClass

Builder class associated with given properties type.

fieldsToSkip

protected final Set<String> fieldsToSkip

Fields that should be skipped in emitFields(CodeGenerationContext, EntityProperties). Extending classes can use this field to be able to add specialised handling for some fields, while still being able to delegate handling for the rest of the class to default implementation.

Constructor Detail

EntityPropertiesEmitter

public EntityPropertiesEmitter()

Method Detail

findField

@Nullable
protected Field findField(Class clazz,
                                    String fieldName)

hasPublicConstructor

protected boolean hasPublicConstructor(Class builderClass,
                                       Class... argTypes)

emitConstructorInvocation

protected String emitConstructorInvocation(@NotNull
                                           CodeGenerationContext context,
                                           @NotNull
                                           T entity)
                                    throws CodeGenerationException

Generates constructor invocation of the builder class.

Throws:

CodeGenerationException

emitFieldValue

protected String emitFieldValue(CodeGenerationContext context,
                                EntityProperties entity,
                                Field field)
                         throws CodeGenerationException

Generates value of a field. Used to generate constructor invocation.

Throws:

CodeGenerationException

createDefaultObject

protected EntityProperties createDefaultObject(EntityProperties rootObject)

Creates instance of the EntityProperties that contains default values. The values are then compared to the actual field values of the instance the code is generated for. If the values match it is assumed that invocation of the respective setter is not necessary. The object is generated by trying the following:

• static method annotated with DefaultFieldValues
• a parameterless constructor

If none of the above is present null value is returned and code is generated for all non-empty fields.

emitFields

protected String emitFields(@NotNull
                            CodeGenerationContext context,
                            @NotNull
                            EntityProperties entity)
                     throws CodeGenerationException

Generate code for all fields of the class that are not already covered by emitConstructorInvocation(CodeGenerationContext, EntityProperties) not contained in fieldsToSkip and not annotated with SkipCodeGen. This involves finding a matching setter method, determining the appropriate code generator and generating method invocation and its arguments.

Throws:

CodeGenerationException

initBuilderClass

protected void initBuilderClass(@NotNull
                                T entity)
                         throws CodeGenerationException

Default method of finding builderClass. Extending class can set the field explicitly to skip the default search algorithm.

Throws:

CodeGenerationException

emitCode

@NotNull
public String emitCode(@NotNull
                                CodeGenerationContext context,
                                @NotNull
                                T entity)
                         throws CodeGenerationException

Generates code for properties class. This includes generating invocation of the constructor of the appropriate builder followed by invocations of its setters.

Specified by:

emitCode in interface CodeEmitter<T extends EntityProperties>

Throws:

CodeGenerationException