1 /*
2  * Licensed to the Apache Software Foundation (ASF) under one
3  * or more contributor license agreements.  See the NOTICE file
4  * distributed with this work for additional information
5  * regarding copyright ownership.  The ASF licenses this file
6  * to you under the Apache License, Version 2.0 (the
7  * "License"); you may not use this file except in compliance
8  * with the License.  You may obtain a copy of the License at
9  *
10  *     http://www.apache.org/licenses/LICENSE-2.0
11  *
12  * Unless required by applicable law or agreed to in writing, software
13  * distributed under the License is distributed on an "AS IS" BASIS,
14  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
15  * See the License for the specific language governing permissions and
16  * limitations under the License.
17  */
18 package org.apache.hadoop.classification;
19 
20 import java.lang.annotation.Documented;
21 
22 /**
23  * Annotation to inform users of how much to rely on a particular package,
24  * class or method not changing over time.
25  */
26 @InterfaceAudience.Public
27 @InterfaceStability.Evolving
28 public class InterfaceStability {
29   /**
30    * Can evolve while retaining compatibility for minor release boundaries.;
31    * can break compatibility only at major release (ie. at m.0).
32    */
33   @Documented
34   public @interface Stable {};
35 
36   /**
37    * Evolving, but can break compatibility at minor release (i.e. m.x)
38    */
39   @Documented
40   public @interface Evolving {};
41 
42   /**
43    * No guarantee is provided as to reliability or stability across any
44    * level of release granularity.
45    */
46   @Documented
47   public @interface Unstable {};
48 }
49