hadoop-hdfs-issues mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Suresh Srinivas (JIRA)" <j...@apache.org>
Subject [jira] Updated: (HDFS-752) Add interface classification stable & scope to HDFS
Date Tue, 03 Nov 2009 23:46:32 GMT

     [ https://issues.apache.org/jira/browse/HDFS-752?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel
]

Suresh Srinivas updated HDFS-752:
---------------------------------

    Attachment: hdfs.interface.txt

Attached file has details of interface labeling.

How InterfaceAudience classification was done:
# None of the current classes in HDFS are expected to directly used by Application or MapReduce.
Hence all the classes are marked as private.

How InterfaceStability classification was done:
# Classes used for inter node communication, FSImage and edits log are marked as stable to
ensure backward/forward compatibility between the nodes running different releases.
# All the super classes of Stable or Evolving classes, the return values and the parameters
in public methods are recursively marked Stable/Evolving.

How labeling will be done:
# Classes that are private and unstable are not labelled.
# Classes that are marked as stable will need backward/forward compatibility tests.

Open issues:
# A separate jira is needed to track writing tests for backward/forward compatility of Stable
classes.
# Labeling clarifies where a class can be used and the stability expectation. But there is
no tool available to a user to check if class is being misused. Alternatively instead of tool,
we could have separate jars (a jar for application, a jar for internal projects and a jar
with all the classes?). Applications use a jar that includes only classes relevant to it,
avoiding misuse of classes. tool or separate jars. How this will be resolved will be considered
in a separate jira.


> Add interface classification stable & scope to HDFS
> ---------------------------------------------------
>
>                 Key: HDFS-752
>                 URL: https://issues.apache.org/jira/browse/HDFS-752
>             Project: Hadoop HDFS
>          Issue Type: New Feature
>    Affects Versions: 0.21.0, 0.22.0
>            Reporter: Suresh Srinivas
>            Assignee: Suresh Srinivas
>             Fix For: 0.21.0, 0.22.0
>
>         Attachments: hdfs.interface.txt
>
>
> This jira addresses adding interface classification for the classes in hadoop hdfs, based
on the mechanism described in Hadoop-5073.

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


Mime
View raw message