Package software.amazon.smithy.aws.traits

Class ServiceTrait

java.lang.Object

software.amazon.smithy.model.traits.AbstractTrait

software.amazon.smithy.aws.traits.ServiceTrait

All Implemented Interfaces:

software.amazon.smithy.model.FromSourceLocation, software.amazon.smithy.model.node.ToNode, software.amazon.smithy.model.shapes.ToShapeId, software.amazon.smithy.model.traits.Trait, software.amazon.smithy.utils.ToSmithyBuilder<ServiceTrait>

public final class ServiceTrait
extends software.amazon.smithy.model.traits.AbstractTrait
implements software.amazon.smithy.utils.ToSmithyBuilder<ServiceTrait>

Registers a service as an AWS service. This trait is required for all AWS services modeled in Smithy.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	ServiceTrait.Builder	Builder for ServiceTrait.
static class	ServiceTrait.Provider

Field Summary

Fields

Modifier and Type	Field	Description
static software.amazon.smithy.model.shapes.ShapeId	ID

Method Summary

Modifier and Type	Method	Description
static ServiceTrait.Builder	builder()
protected software.amazon.smithy.model.node.Node	createNode()
boolean	equals(java.lang.Object other)
java.util.Optional<java.lang.String>	getAbbreviation()	Deprecated.
java.lang.String	getArnNamespace()	Get the AWS ARN service namespace of the service.
java.lang.String	getCloudFormationName()	Get the AWS CloudFormation service name.
java.lang.String	getCloudTrailEventSource()	Returns the CloudTrail event source name of the service.
java.lang.String	getEndpointPrefix()	Returns the endpoint prefix for the service.
java.lang.String	getSdkId()	Get the SDK service ID.
int	hashCode()
ServiceTrait.Builder	toBuilder()

Methods inherited from class software.amazon.smithy.model.traits.AbstractTrait

getSourceLocation, setNodeCache, toNode, toShapeId, toString

Methods inherited from class java.lang.Object

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

Methods inherited from interface software.amazon.smithy.model.traits.Trait

isSynthetic

Field Detail

ID

public static final software.amazon.smithy.model.shapes.ShapeId ID

Method Detail

builder

public static ServiceTrait.Builder builder()

Returns:

Creates a builder used to build a ServiceTrait.

getArnNamespace

public java.lang.String getArnNamespace()

Get the AWS ARN service namespace of the service.

If not set, this value defaults to the name of the service shape converted to lowercase. This value is combined with resources contained within the service to form ARNs for resources. Only resources that explicitly define the 'aws.api#arnTemplate' trait are assigned ARNs, and their relative ARNs are combined with the service's arnNamespace to form an ARN.

Returns:

Returns the ARN service name (e.g., "route53").

getCloudFormationName

public java.lang.String getCloudFormationName()

Get the AWS CloudFormation service name.

When not set, this value defaults to the name of the service shape.

Returns:

Returns the optionally present AWS CloudFormation type prefix.

getSdkId

public java.lang.String getSdkId()

Get the SDK service ID.

This value is used to generate SDK class names.

Returns:

Returns the AWS SDK service ID value.

getCloudTrailEventSource

public java.lang.String getCloudTrailEventSource()

Returns the CloudTrail event source name of the service.

Returns:

Returns the event source name.

getEndpointPrefix

public java.lang.String getEndpointPrefix()

Returns the endpoint prefix for the service. This value is not unique across services and it can change at any time. Therefore it MUST NOT be used to generate class names, namespaces, or for any other purpose that requires a static, unique identifier. The sdkId property should be used for those purposes.

Returns:

Returns the aws sdk endpoint prefix.

getAbbreviation

@Deprecated
public java.util.Optional<java.lang.String> getAbbreviation()

Deprecated.

toBuilder

public ServiceTrait.Builder toBuilder()

Specified by:

toBuilder in interface software.amazon.smithy.utils.ToSmithyBuilder<ServiceTrait>

createNode

protected software.amazon.smithy.model.node.Node createNode()

Specified by:

createNode in class software.amazon.smithy.model.traits.AbstractTrait

equals

public boolean equals(java.lang.Object other)

Overrides:

equals in class software.amazon.smithy.model.traits.AbstractTrait

hashCode

public int hashCode()

Overrides:

hashCode in class software.amazon.smithy.model.traits.AbstractTrait