You are viewing a plain text version of this content. The canonical link for it is here.
Posted to issues@hbase.apache.org by "stack (JIRA)" <ji...@apache.org> on 2018/04/30 17:38:03 UTC
[jira] [Updated] (HBASE-19595) explicitly discourage public user
from creating their Public pojo
[ https://issues.apache.org/jira/browse/HBASE-19595?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]
stack updated HBASE-19595:
--------------------------
Fix Version/s: (was: 2.0.0)
3.0.0
> explicitly discourage public user from creating their Public pojo
> -----------------------------------------------------------------
>
> Key: HBASE-19595
> URL: https://issues.apache.org/jira/browse/HBASE-19595
> Project: HBase
> Issue Type: Task
> Reporter: Chia-Ping Tsai
> Priority: Major
> Fix For: 3.0.0
>
>
> HBASE-19496 make both of ReplicationLoadSink and ReplicationLoadSource be IA.Public since they are exposed by other Public class (ServerMetrics). Currently, their constructor are annotated with IA.Private to discourage user from creating their ReplicationLoadSink and ReplicationLoadSource. However, that is too implicit as users have to trace the source code to "see" the warnings.
> I believe that many pojo in hbase have same issue. We have some kinds of coding style to warn user not to create their Public pojo.
> # IA.Private constructor. for example, ReplicationLoadSink and ReplicationLoadSource
> # pure interface. for example, TableDescriptor, ColumnFamilyDescriptor, ClusterMetrics
> # final class and package private constructor. for example, CacheEvictionStats
> All of them have pros and cons. #1 is a simple solution but it is too implicit for user. #2 will cause the BC issue (see HBASE-19535). #3 is good solution to prevent user from using the constructor or extending the pojo. However, it may limit us also. (mockito or extend the pojo internally)
> Any suggestions?
--
This message was sent by Atlassian JIRA
(v7.6.3#76005)