日志
开发人员和用户接口指南：hadoop接口分类-Audience 和 Stability 分类
问题导读
1.hadoop接口分为哪两类？
2.audience分为几类，具体有哪几类？
3.Stability有哪些分类？
4.对于audience和Stability你是如何理解的？
目的
这里提供的接口分类分类是为开发人员和用户提供接口的指南。这个分类指导开发者声明目标受众和用户接口及他的稳定性。
用户接口的好处：知道什么接口可以用，什么接口不可以用及它们的稳定性
开发者好处：防止接口意外改变和因此，意外的影响用户或其他组件或系统。这对于一个大的系统是非常有用的，许多开发者谁可能不都具有该项目的共享状态/历史记录。
接口分类
hadoop采用以下接口分类，这个分类来自OpenSolaris taxonomy，在某种程度上，来自雅虎内部使用的分类。接口有两个主要属性：Audience 和 Stability
Audience
Audience指出了接口潜在使用者。许多接口是 internal/private的实现。其它是public/external 接口，意味着更广泛的使用被应用程序或则客户端。
例如： in posix, lib是外部的或则公共接口, 大部分内核都是内部或私有接口。某些接口是针对其他特定子系统的。
确认接口的Audience可以帮助了解打破它带来的影响。例如，它可能是好的，打破一个接口的兼容性，其受众是一个小数目的特定子系统。另一方面，它可能是不好的，打破数以百万计的互联网用户依赖的协议接口。
hadoops使用下面种类的audience
Private：
内部接口项目内部使用（比如hdfs，mapreduce），不能被应用程序和其它项目使用。它可以做任何的改变。大多数项目接口是私有的，也被称为项目专用。
Limited-Private:这样的接口由特定的项目或则接口使用（通常密切相关的项目）。其它项目或则系统不能使用。接口改变将通知指定项目。例如：hadoop项目一些接口是LimitedPrivate{HDFS, MapReduce}，它们是私有的HDFS和MapReduce项目。
Public
这些接口一般被应用程序使用
Stability
Stability指出了什么样的接口是稳定的，当接口做不兼容改变时是允许的。hadoop api有下列类别stability
Stable
版本演进的同时保留与次要版本的相容；换句话说，不兼容的更改API的标记为稳定只允许在主要版本（即在m.0）。
Evolving
Evolving，不兼容的改变在小版本里允许的 (即. m .x)
Unstable
不通用的改变不稳定的APIs任何时候都是允许的。这通常只对私有接口
尽管如此一些人称其为public接口以强调，它不应该被用作接口，对于public接口，被标记为非接口比“Unstable”可能更合适。例子：公共可视化接口是unstable（即不是接口），GUI，clis的输出格式将改变
Deprecated
在未来可能被删除的APIs，不应该使用。
1.hadoop接口分为哪两类？
2.audience分为几类，具体有哪几类？
3.Stability有哪些分类？
4.对于audience和Stability你是如何理解的？
目的
这里提供的接口分类分类是为开发人员和用户提供接口的指南。这个分类指导开发者声明目标受众和用户接口及他的稳定性。
用户接口的好处：知道什么接口可以用，什么接口不可以用及它们的稳定性
开发者好处：防止接口意外改变和因此，意外的影响用户或其他组件或系统。这对于一个大的系统是非常有用的，许多开发者谁可能不都具有该项目的共享状态/历史记录。
接口分类
hadoop采用以下接口分类，这个分类来自OpenSolaris taxonomy，在某种程度上，来自雅虎内部使用的分类。接口有两个主要属性：Audience 和 Stability
Audience
Audience指出了接口潜在使用者。许多接口是 internal/private的实现。其它是public/external 接口，意味着更广泛的使用被应用程序或则客户端。
例如： in posix, lib是外部的或则公共接口, 大部分内核都是内部或私有接口。某些接口是针对其他特定子系统的。
确认接口的Audience可以帮助了解打破它带来的影响。例如，它可能是好的，打破一个接口的兼容性，其受众是一个小数目的特定子系统。另一方面，它可能是不好的，打破数以百万计的互联网用户依赖的协议接口。
hadoops使用下面种类的audience
Private：
内部接口项目内部使用（比如hdfs，mapreduce），不能被应用程序和其它项目使用。它可以做任何的改变。大多数项目接口是私有的，也被称为项目专用。
Limited-Private:这样的接口由特定的项目或则接口使用（通常密切相关的项目）。其它项目或则系统不能使用。接口改变将通知指定项目。例如：hadoop项目一些接口是LimitedPrivate{HDFS, MapReduce}，它们是私有的HDFS和MapReduce项目。
Public
这些接口一般被应用程序使用
Stability
Stability指出了什么样的接口是稳定的，当接口做不兼容改变时是允许的。hadoop api有下列类别stability
Stable
版本演进的同时保留与次要版本的相容；换句话说，不兼容的更改API的标记为稳定只允许在主要版本（即在m.0）。
Evolving
Evolving，不兼容的改变在小版本里允许的 (即. m .x)
Unstable
不通用的改变不稳定的APIs任何时候都是允许的。这通常只对私有接口
尽管如此一些人称其为public接口以强调，它不应该被用作接口，对于public接口，被标记为非接口比“Unstable”可能更合适。例子：公共可视化接口是unstable（即不是接口），GUI，clis的输出格式将改变
Deprecated
在未来可能被删除的APIs，不应该使用。
/2 
