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:

java.lang.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 class	ServiceShape.Builder	Builder used to create a ServiceShape.

Method Summary

Modifier and Type	Method	Description
<R> R	accept(ShapeVisitor<R> cases)	Dispatches the shape to the appropriate ShapeVisitor method.
java.util.Optional<ServiceShape>	asServiceShape()
static ServiceShape.Builder	builder()
boolean	equals(java.lang.Object other)
java.lang.String	getContextualName(ToShapeId shape)	Gets the contextual name of a shape within the closure.
java.util.List<ShapeId>	getErrors()	Gets a list of the common errors that can be encountered by every operation in the service.
java.util.Map<ShapeId,java.lang.String>	getRename()
java.lang.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, getOperations, getResources

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

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

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 Detail

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> cases)

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:

cases - NeighborVisitor to use.

Returns:

Returns the result.

asServiceShape

public java.util.Optional<ServiceShape> asServiceShape()

Overrides:

asServiceShape in class Shape

Returns:

Optionally returns the shape as a ServiceShape.

equals

public boolean equals(java.lang.Object other)

Overrides:

equals in class EntityShape

getVersion

public java.lang.String getVersion()

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

Returns:

The version of the service.

getRename

public java.util.Map<ShapeId,java.lang.String> getRename()

Returns:

The rename map of the service.

getErrors

public java.util.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.

getContextualName

public java.lang.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.