[ 
https://issues.apache.org/jira/browse/HADOOP-5073?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=12759723#action_12759723
 ] 

Sanjay Radia commented on HADOOP-5073:
--------------------------------------

Proposed Classification for Hadoop Interfaces (updated)
* Scope Public
** Deprecated
*** FileSystem, mapred
** Stable
*** FileContext, MapReduce, Config, CLI (inlcuding output), Job Logs API, Audit 
logs
*** AbstractFileSystem (targeted  for implementers of filesystems,  not for 
application use)
*** parts of Mapred.lib (have we decided which parts?)
*** parts of instrumentation metrics (have we decided which parts?)
** Evolving
*** TFile, jmx interface (till it becomes stable),
*** parts of Mapred.lib (have we decided which parts?)
*** parts of instrumentation metrics (have we decided which parts?)
*** Job logs and job history ( Some tools, scripts and chukwa use this to 
analyze job processing)
** Not An interface
*** Web GUI
* Scope Private
** Limited-Private Evolving
*** RPC, Metrics API, (HDFS-MapReduce Private) - once stable, we can consider 
making these public-stable.PIU
*** Security APIs
** Project-Private Stable
*** Intra-HDFS and MR protocols (facilitates rolling upgrades down the road)
*** Mapreduce's context object implementation class
*** FSImage
**** Note this will enable old versions of HDFS to read newer fsImage and hence 
enable more flexible roll backs.
**** Q. Should this be Project-Private Evolving instead?
**** Regardless of the stability of FSImage, new versions of HDFS have to be 
able to transparently convert older versions and provide roll-back.
** Project-Private Evolving
*** DFSClient (Q. should this be "project-private unstable")
** Project-Private Unstable
*** System logs
*** All implementation classes and interfaces not otherwise classified are 
considered to be project-private unstable.



> Hadoop 1.0 Interface Classification - scope (visibility - public/private) and 
> stability
> ---------------------------------------------------------------------------------------
>
>                 Key: HADOOP-5073
>                 URL: https://issues.apache.org/jira/browse/HADOOP-5073
>             Project: Hadoop Common
>          Issue Type: Sub-task
>    Affects Versions: 0.21.0
>            Reporter: Sanjay Radia
>            Assignee: Jakob Homan
>             Fix For: 0.21.0
>
>         Attachments: 5073_demo.png, c5073_20090825.patch, c5073_20090825.png, 
> COMMON-5073.patch, COMMON-5073.patch, COMMON-5073.patch, HADOOP-5073.patch, 
> Nested.png, Picture 1.png
>
>
> This jira proposes an interface classification for hadoop interfaces.
> The discussion was started in email alias core-...@hadoop.apache.org in Nov 
> 2008.

-- 
This message is automatically generated by JIRA.
-
You can reply to this email to add a comment to the issue online.

Reply via email to