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, SmithyBuilder<UnionShape>
Enclosing class:
UnionShape

public static final class UnionShape.Builder extends AbstractShapeBuilder<B,S>
Builder used to create a UnionShape.
  • Field Details

  • Constructor Details

    • Builder

      public Builder()
  • Method Details

    • build

      public UnionShape build()
      Description copied from interface: SmithyBuilder
      Creates an immutable object that is created from the properties that have been set on the builder.
      Returns:
      an instance of T
    • 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 Optional<MemberShape> getMember(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 UnionShape.Builder 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 UnionShape.Builder members(Collection<MemberShape> members)
      Replaces the members of the builder.
      Parameters:
      members - Members to add to the builder.
      Returns:
      Returns the builder.
    • clearMembers

      public UnionShape.Builder 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 UnionShape.Builder 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 UnionShape.Builder addMember(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 UnionShape.Builder addMember(String memberName, ShapeId target, 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 UnionShape.Builder removeMember(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 UnionShape.Builder 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 UnionShape.Builder 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 UnionShape.Builder 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.