Package software.amazon.smithy.model.shapes

Class ServiceShape

java.lang.Object

software.amazon.smithy.model.shapes.Shape

software.amazon.smithy.model.shapes.EntityShape

software.amazon.smithy.model.shapes.ServiceShape

All Implemented Interfaces:

Comparable<Shape>, FromSourceLocation, ToShapeId, Tagged, ToSmithyBuilder<ServiceShape>

public final class ServiceShape
extends EntityShape
implements ToSmithyBuilder<ServiceShape>

Represents a service shape.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static final class	ServiceShape.Builder	Builder used to create a ServiceShape.

Method Summary

Modifier and Type	Method	Description
<R> R	accept(ShapeVisitor<R> visitor)	Dispatches the shape to the appropriate ShapeVisitor method.
Optional<ServiceShape>	asServiceShape()
static ServiceShape.Builder	builder()
boolean	equals(Object other)
String	getContextualName(ToShapeId shape)	Gets the contextual name of a shape within the closure.
List<ShapeId>	getErrors()	Gets a list of the common errors that can be encountered by every operation in the service.
List<ShapeId>	getIntroducedErrors()	Gets the list of common errors introduced by the shape and not inherited from mixins.
Map<ShapeId,String>	getIntroducedRename()	Gets the rename map introduced by the shape and not inherited from mixins.
String	getIntroducedVersion()	Gets the version of the service introduced by the shape and not inherited from mixins.
Map<ShapeId,String>	getRename()
ShapeType	getType()	Gets the type of the shape.
String	getVersion()	Get the version of the service.
ServiceShape.Builder	toBuilder()	Take this object and create a builder that contains all of the current property values of this object.

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

getAllOperations, getIntroducedOperations, getIntroducedResources, getOperations, getResources

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

asBigDecimalShape, asBigIntegerShape, asBlobShape, asBooleanShape, asByteShape, asDocumentShape, asDoubleShape, asEnumShape, asFloatShape, asIntegerShape, asIntEnumShape, asListShape, asLongShape, asMapShape, asMemberShape, asOperationShape, asResourceShape, asSetShape, asShortShape, asStringShape, asStructureShape, asTimestampShape, asUnionShape, compareTo, expectTrait, findMemberTrait, findTrait, findTrait, getAllMembers, getAllTraits, getId, getIntroducedTraits, getMember, getMemberNames, getMemberTrait, getMixins, getRequiredMixinMember, getSourceLocation, getTags, getTrait, hashCode, hasTrait, hasTrait, hasTrait, isBigDecimalShape, isBigIntegerShape, isBlobShape, isBooleanShape, isByteShape, isDocumentShape, isDoubleShape, isEnumShape, isFloatShape, isIntegerShape, isIntEnumShape, isListShape, isLongShape, isMapShape, isMemberShape, isOperationShape, isResourceShape, isServiceShape, isSetShape, isShortShape, isStringShape, isStructureShape, isTimestampShape, isUnionShape, members, shapeToBuilder, toShapeId, toString, validateMemberShapeIds, validateMixins

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface software.amazon.smithy.utils.Tagged

hasTag

Method Details

builder

public static ServiceShape.Builder builder()

toBuilder

public ServiceShape.Builder toBuilder()

Description copied from interface: ToSmithyBuilder

Take this object and create a builder that contains all of the current property values of this object.

Specified by:

toBuilder in interface ToSmithyBuilder<ServiceShape>

Returns:

a builder for type T

accept

public <R> R accept(ShapeVisitor<R> visitor)

Description copied from class: Shape

Dispatches the shape to the appropriate ShapeVisitor method.

Specified by:

accept in class Shape

Type Parameters:

R - Return type of the accept.

Parameters:

visitor - ShapeVisitor to use.

Returns:

Returns the result.

asServiceShape

public Optional<ServiceShape> asServiceShape()

Overrides:

asServiceShape in class Shape

Returns:

Optionally returns the shape as a ServiceShape.

equals

public boolean equals(Object other)

Overrides:

equals in class EntityShape

getType

public ShapeType getType()

Description copied from class: Shape

Gets the type of the shape.

Specified by:

getType in class Shape

Returns:

Returns the type;

getVersion

public String getVersion()

Get the version of the service. An empty string is returned if the version is undefined.

Returns:

The version of the service.

getIntroducedVersion

public String getIntroducedVersion()

Gets the version of the service introduced by the shape and not inherited from mixins. An empty string is returned if the version is undefined.

Returns:

The introduced version of the service.

getRename

public Map<ShapeId,String> getRename()

Returns:

The rename map of the service.

getIntroducedRename

public Map<ShapeId,String> getIntroducedRename()

Gets the rename map introduced by the shape and not inherited from mixins.

Returns:

The introduced rename map of the service.

getErrors

public List<ShapeId> getErrors()

Gets a list of the common errors that can be encountered by every operation in the service.

Each returned ShapeId must resolve to a StructureShape that is targeted by an error trait; however, this is only guaranteed after a model is validated.

Returns:

Returns the errors.

getIntroducedErrors

public List<ShapeId> getIntroducedErrors()

Gets the list of common errors introduced by the shape and not inherited from mixins. These errors can be encountered by every operation in the service. Each returned ShapeId must resolve to a StructureShape that is targeted by an error trait; however, this is only guaranteed after a model is validated.

Returns:

Returns the introduced service errors.

getContextualName

public String getContextualName(ToShapeId shape)

Gets the contextual name of a shape within the closure.

If there is a rename property entry for the given shape ID, then the renamed shape name is returned. Otherwise, the name part of the given shape ID is returned, regardless of if the shape exists in the closure of the service.

This is a mirror of ShapeId.getName(ServiceShape) that serves to make this functionality more discoverable.

Parameters:

shape - Shape to get the contextual name of.

Returns:

Returns the contextual name of the shape within the service.