hadoop-common-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Robert Chansler (JIRA)" <j...@apache.org>
Subject [jira] Updated: (HADOOP-3944) TupleWritable listed as public class but cannot be used without methods private to the package
Date Tue, 21 Oct 2008 23:22:44 GMT

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

Robert Chansler updated HADOOP-3944:
------------------------------------

    Release Note:   (was: TupleWritable in join package needs to be public, but it is not
supposed to be constructed/altered by users. This issue improves the javadoc for the TupleWritable,
describing the use cases.  )

> TupleWritable listed as public class but cannot be used without methods private to the
package
> ----------------------------------------------------------------------------------------------
>
>                 Key: HADOOP-3944
>                 URL: https://issues.apache.org/jira/browse/HADOOP-3944
>             Project: Hadoop Core
>          Issue Type: Improvement
>          Components: documentation
>    Affects Versions: 0.17.1
>            Reporter: Michael Andrews
>            Assignee: Chris Douglas
>            Priority: Trivial
>             Fix For: 0.19.0
>
>         Attachments: 3944-0.patch
>
>
> Reading the hadoop-core javadocs, it appears as though TupleWritable can be used outside
of the
> org.apache.hadoop.mapred.join.* package.  A user can import TupleWritable but cannot
use it correctly without the setWritten, and clearWritten methods being public.   It seems
as the though the intent was to make TupleWritable hidden from the user as it is dependent
on CompositeRecordReader.  As a possible solution, classes within a package can be made invisible
to the user by omitting 'public' from the class definition.  In the case of TupleWritable,
this removes the javadoc link from other classes in mapred.join and it's not clear if these
classes should be hidden from the user.

-- 
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