hadoop入门-第一章General：第六节开发人员和用户接口指南：hadoop接口分类

问题导读

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，不应该使用。

常见问题解答

java作用域难道不充足吗？
Java的范围不是很完整.一个类经常被强制为public为内部其它组件使用。它没有friends或则像C++ sub-package-private
我可以很容易地访问私有实现的接口，如果它是Java的public。哪里体现保护和控制？

这样做的目的并不提供绝对的访问控制,其目的是为了传达给用户和开发。一个可以访问私有继承的函数在libc.




相关文章

hadoop入门-第一章General：第一节单节点伪分布

hadoop入门-第一章General：第二节集群配置

hadoop入门-第一章General：第三节Hadoop初级入门之命令指南

hadoop入门-第一章General：第四节文件系统shell

hadoop入门-第一章General：第五节hadoop的兼容性说明

hadoop入门-第一章General：第六节开发人员和用户接口指南：hadoop接口分类

hadoop入门-第一章General：第七节Hadoop 文件系统 API ：概述

hadoop入门-第二章common：第一节hadoop 本地库 指南

hadoop入门-第二章common：第二节hadoop代理用户 -超级用户代理其它用户

hadoop入门-第二章common：第三节机架智能感知

hadoop入门-第二章common：第四节安全模式说明

hadoop入门-第二章common：第五节服务级别授权指南

hadoop入门-第二章common：第六节Hadoop HTTP web-consoles认证机制

hadoop入门-第二章common：第七节Hadoop Key管理服务器(KMS) - 文档集

hadoop入门:第三章HDFS文档概述（一）

hadoop入门:第三章HDFS文档概述（二）

hadoop入门:第四章mapreduce文档概述

hadoop入门:第五章MapReduce REST APIs文档概述

hadoop入门:第六章YARN文档概述

hadoop入门:第七章YARN REST APIs

hadoop入门:第八章hadoop兼容文件系统

hadoop入门:第九章hadoop认证

hadoop入门:第十章hadoop工具

hadoop入门:第十一章hadoop配置