software.amazon.smithy.model.shapes

Class UnionShape.Builder

java.lang.Object

software.amazon.smithy.model.shapes.AbstractShapeBuilder<B,S>

software.amazon.smithy.model.shapes.UnionShape.Builder

All Implemented Interfaces:

FromSourceLocation, software.amazon.smithy.utils.SmithyBuilder<UnionShape>

Enclosing class:

UnionShape

public static final class UnionShape.Builder
extends AbstractShapeBuilder<B,S>

Builder used to create a UnionShape.

Field Summary

Fields

Modifier and Type	Field and Description
protected software.amazon.smithy.utils.BuilderRef<java.util.Map<java.lang.String,MemberShape>>	members

Constructor Summary

Constructors

Constructor and Description
Builder()

Method Summary

Modifier and Type	Method and Description
B	addMember(MemberShape member) Adds a member to the shape IFF the shape supports members.
B	addMember(java.lang.String memberName, ShapeId target) Adds a member to the builder.
B	addMember(java.lang.String memberName, ShapeId target, java.util.function.Consumer<MemberShape.Builder> memberUpdater) Adds a member to the builder.
B	addMixin(Shape shape) Adds a mixin to the shape.
UnionShape	build()
B	clearMembers() Removes all members from the builder.
B	flattenMixins() Removes mixins from a shape and flattens them into the shape.
java.util.Optional<MemberShape>	getMember(java.lang.String memberName) Gets the optional member with the given name.
ShapeType	getShapeType() Gets the type of shape being built.
B	id(ShapeId shapeId) Sets the shape ID of the shape.
B	members(java.util.Collection<MemberShape> members) Replaces the members of the builder.
B	removeMember(java.lang.String member) Removes a member by name.
B	removeMixin(ToShapeId shape) Removes a mixin from the shape by shape or ID.

Methods inherited from class software.amazon.smithy.model.shapes.AbstractShapeBuilder

addTrait, addTraits, clearMixins, clearTraits, getAllTraits, getId, getSourceLocation, id, mixins, removeTrait, removeTrait, source, source, traits

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.utils.SmithyBuilder

requiredState

Methods inherited from interface software.amazon.smithy.model.FromSourceLocation

compare

Field Detail

members

protected final software.amazon.smithy.utils.BuilderRef<java.util.Map<java.lang.String,MemberShape>> members

Constructor Detail

Builder

public Builder()

Method Detail

build

public UnionShape build()

getShapeType

public ShapeType getShapeType()

Description copied from class: AbstractShapeBuilder

Gets the type of shape being built.

Specified by:

getShapeType in class AbstractShapeBuilder<UnionShape.Builder,UnionShape>

Returns:

Returns the shape type.

getMember

public java.util.Optional<MemberShape> getMember(java.lang.String memberName)

Description copied from class: AbstractShapeBuilder

Gets the optional member with the given name.

Overrides:

getMember in class AbstractShapeBuilder<B extends software.amazon.smithy.model.shapes.NamedMembersShapeBuilder<B,S>,S extends Shape>

Returns:

Returns the optional member with the given name.

id

public final B id(ShapeId shapeId)

Description copied from class: AbstractShapeBuilder

Sets the shape ID of the shape.

Overrides:

id in class AbstractShapeBuilder<B extends software.amazon.smithy.model.shapes.NamedMembersShapeBuilder<B,S>,S extends Shape>

Parameters:

shapeId - Shape ID to set.

Returns:

Returns the builder.

members

public B members(java.util.Collection<MemberShape> members)

Replaces the members of the builder.

Parameters:

members - Members to add to the builder.

Returns:

Returns the builder.

clearMembers

public B clearMembers()

Description copied from class: AbstractShapeBuilder

Removes all members from the builder.

Overrides:

clearMembers in class AbstractShapeBuilder<B extends software.amazon.smithy.model.shapes.NamedMembersShapeBuilder<B,S>,S extends Shape>

Returns:

Returns the builder.

addMember

public B addMember(MemberShape member)

Description copied from class: AbstractShapeBuilder

Adds a member to the shape IFF the shape supports members.

Overrides:

addMember in class AbstractShapeBuilder<B extends software.amazon.smithy.model.shapes.NamedMembersShapeBuilder<B,S>,S extends Shape>

Parameters:

member - Member to add to the shape.

Returns:

Returns the builder.

addMember

public B addMember(java.lang.String memberName,
                   ShapeId target)

Adds a member to the builder.

Parameters:

memberName - Member name to add.

target - Target of the member.

Returns:

Returns the builder.

addMember

public B addMember(java.lang.String memberName,
                   ShapeId target,
                   java.util.function.Consumer<MemberShape.Builder> memberUpdater)

Adds a member to the builder.

Parameters:

memberName - Member name to add.

target - Target of the member.

memberUpdater - Consumer that can update the created member shape.

Returns:

Returns the builder.

removeMember

public B removeMember(java.lang.String member)

Removes a member by name.

Note that removing a member that was added by a mixin results in an inconsistent model. It's best to use ModelTransform to ensure that the model remains consistent when removing members.

Parameters:

member - Member name to remove.

Returns:

Returns the builder.

addMixin

public B addMixin(Shape shape)

Description copied from class: AbstractShapeBuilder

Adds a mixin to the shape.

Overrides:

addMixin in class AbstractShapeBuilder<B extends software.amazon.smithy.model.shapes.NamedMembersShapeBuilder<B,S>,S extends Shape>

Parameters:

shape - Mixin to add.

Returns:

Returns the builder.

removeMixin

public B removeMixin(ToShapeId shape)

Description copied from class: AbstractShapeBuilder

Removes a mixin from the shape by shape or ID.

Overrides:

removeMixin in class AbstractShapeBuilder<B extends software.amazon.smithy.model.shapes.NamedMembersShapeBuilder<B,S>,S extends Shape>

Parameters:

shape - Shape or shape ID to remove.

Returns:

Returns the builder.

flattenMixins

public B flattenMixins()

Description copied from class: AbstractShapeBuilder

Removes mixins from a shape and flattens them into the shape.

Flattening a mixin into a shape copies the traits and members of a mixin onto the shape, effectively resulting in the same shape but with no trace of the mixin relationship.

Overrides:

flattenMixins in class AbstractShapeBuilder<B extends software.amazon.smithy.model.shapes.NamedMembersShapeBuilder<B,S>,S extends Shape>

Returns:

Returns the updated builder.