@InterfaceAudience 与 @InterfaceStability

最新推荐文章于 2021-11-25 22:20:57 发布

原创最新推荐文章于 2021-11-25 22:20:57 发布 · 5.5k 阅读

2 ·

CC 4.0 BY-SA版权

文章标签：

#mapreduce #hadoop #hbase #任务

hadoop 源码专栏收录该内容

3 篇文章

订阅专栏

本文介绍了Hadoop Common库中用于标注API使用范围和稳定性的重要注解@InterfaceAudience和@InterfaceStability。@InterfaceAudience包括Public、LimitedPrivate和Private三个级别，分别对应公共、特定项目和内部使用。而@InterfaceStability则分为Stable、Evolving和Unstable，分别表示主版本间的稳定性、次版本间可能的不兼容以及无法保证任何版本级别的稳定性和可靠性。

hadoop common 下的两个类 InterfaceAudience ，InterfaceStability ；

InterfaceAudience 有三个抽象方法，主要用于说明使用的范围

/**
* Intended for use by any project or application. 在任务项目或应用中可使用
*/

@InterfaceAudience.Public

/**
* Intended only for the project(s) specified in the annotation.
* For example, "Common", "HDFS", "MapReduce", "ZooKeeper", "HBase".

* 只能用在指定的项目中如"Common", "HDFS", "MapReduce", "ZooKeeper", "HBase"
*/
@InterfaceAudience.LimitedPrivate

/**
* Intended for use only within Hadoop itself. 只能在hadoop本身项目中使用
*/

@InterfaceAudience.Private

InterfaceStability 有三个抽象方法，主要用于说明版本的稳定性，及有特定包的依赖

/**
   * Can evolve while retaining compatibility for minor release boundaries.;
   * can break compatibility only at major release (ie. at m.0). 主版本是稳定的，不同主版本间可能不兼容
   */

@InterfaceStability.Stable

/**
* Evolving, but can break compatibility at minor release (i.e. m.x) 不断变化，不同次版本间可能不兼容
*/

@InterfaceStability.Evolving

/**
   * No guarantee is provided as to reliability or stability across any 不能提供稳定性和可靠性
   * level of release granularity.
   */

@InterfaceStability.Unstable