1 /*
2  * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
3  *
4  * Licensed under the Apache License, Version 2.0 (the "License").
5  * You may not use this file except in compliance with the License.
6  * A copy of the License is located at
7  *
8  *  http://aws.amazon.com/apache2.0
9  *
10  * or in the "license" file accompanying this file. This file is distributed
11  * on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either
12  * express or implied. See the License for the specific language governing
13  * permissions and limitations under the License.
14  */
15 
16 package software.amazon.awssdk.annotations;
17 
18 import java.lang.annotation.ElementType;
19 import java.lang.annotation.Target;
20 
21 /**
22  * Marker for elements that should only be accessed by the generated clients and not users of the
23  * SDK. Do not make breaking changes to these APIs - they won't directly break customers, but
24  * they'll break old versions of generated clients.
25  * <p>
26  * TODO: Write a linter that makes sure generated code only depends on public or
27  * {@code @InternalApi} classes.
28  */
29 @Target({ElementType.PACKAGE, ElementType.TYPE, ElementType.FIELD, ElementType.CONSTRUCTOR, ElementType.METHOD})
30 @SdkProtectedApi
31 public @interface SdkProtectedApi {
32 }
33