Repository: beam Updated Branches: refs/heads/master 97dde95bc -> 9114eb3ee
Add an @Internal Annotation This annotation is used as a marker that a publicly accessible API is intended for internal use and should not be used by users, and is subject to no compatibility guarantees. Project: http://git-wip-us.apache.org/repos/asf/beam/repo Commit: http://git-wip-us.apache.org/repos/asf/beam/commit/7b3cce4d Tree: http://git-wip-us.apache.org/repos/asf/beam/tree/7b3cce4d Diff: http://git-wip-us.apache.org/repos/asf/beam/diff/7b3cce4d Branch: refs/heads/master Commit: 7b3cce4da29bad280e42e2490ee3dc4ef5d4f763 Parents: 43443c9 Author: Thomas Groh <[email protected]> Authored: Tue May 2 10:02:22 2017 -0700 Committer: Thomas Groh <[email protected]> Committed: Tue May 2 10:03:31 2017 -0700 ---------------------------------------------------------------------- .../apache/beam/sdk/annotations/Internal.java | 42 ++++++++++++++++++++ 1 file changed, 42 insertions(+) ---------------------------------------------------------------------- http://git-wip-us.apache.org/repos/asf/beam/blob/7b3cce4d/sdks/java/core/src/main/java/org/apache/beam/sdk/annotations/Internal.java ---------------------------------------------------------------------- diff --git a/sdks/java/core/src/main/java/org/apache/beam/sdk/annotations/Internal.java b/sdks/java/core/src/main/java/org/apache/beam/sdk/annotations/Internal.java new file mode 100644 index 0000000..c359ef6 --- /dev/null +++ b/sdks/java/core/src/main/java/org/apache/beam/sdk/annotations/Internal.java @@ -0,0 +1,42 @@ +/* + * Licensed to the Apache Software Foundation (ASF) under one + * or more contributor license agreements. See the NOTICE file + * distributed with this work for additional information + * regarding copyright ownership. The ASF licenses this file + * to you under the Apache License, Version 2.0 (the + * "License"); you may not use this file except in compliance + * with the License. You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +package org.apache.beam.sdk.annotations; + +import java.lang.annotation.Documented; +import java.lang.annotation.ElementType; +import java.lang.annotation.Retention; +import java.lang.annotation.RetentionPolicy; +import java.lang.annotation.Target; + +/** + * Signifies that a publicly accessible API (public class, method or field) is intended for internal + * use and not for public consumption. Such an API is subject to incompatible changes or removal at + * any time. An API bearing this annotation is exempt from any compatibility guarantees made by its + * containing library. + */ +@Retention(RetentionPolicy.CLASS) +@Target({ + ElementType.ANNOTATION_TYPE, + ElementType.CONSTRUCTOR, + ElementType.FIELD, + ElementType.METHOD, + ElementType.TYPE +}) +@Documented +public @interface Internal {}
