You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@hbase.apache.org by Aleksandr Shulman <al...@cloudera.com> on 2013/08/24 03:02:00 UTC

Incompatible Java API Diffs from 0.94 -> 0.95.2

Hi everyone,

I took some time and went over the JDiff report of API incompatibilities
from 0.94 -> 0.95.2.
Please have a look at the document and add your comments. The goal is to
acknowledge the incompatibilities that we will permit and fix ones that
seem egregious.

I went through and identified incompatible public API changes. Note that
since this is a singularity release, these breaking changes are not
unacceptable. However, we should minimize the extent of these changes if we
can to make it easier for folks to transition their client code.

https://docs.google.com/a/cloudera.com/document/d/14nqQXlIvgJOxGFTfhSoquYzjW8Yx-v9TqTBqRjiB7g0/edit

The full report can be found here:
https://github.com/AleksandrShulman/hbase_jdiff/tree/master/reports

There were some areas where I was not sure about the impact of a change. I
noted those with a question mark. Feel free to fill in any gaps.


-- 
Best Regards,

Aleks Shulman
847.814.5804
Cloudera

Re: Incompatible Java API Diffs from 0.94 -> 0.95.2

Posted by Ted Yu <yu...@gmail.com>.
Aleks:
HBASE-9359 streamlined hbase-client API w.r.t. KeyValue.

Are you going to update the googledoc ?

Thanks


On Mon, Aug 26, 2013 at 4:25 PM, Ted Yu <yu...@gmail.com> wrote:

> I added a column 'New API' to the right of 'Risk' column.
>
> Will keep updating the doc.
>
> Thanks
>
>
> On Mon, Aug 26, 2013 at 12:39 AM, Aleksandr Shulman <al...@cloudera.com>wrote:
>
>> It would be a good idea to add such a column. Everyone should have write
>> perms on the google doc, so feel free to add that. We can discuss the pros
>> and cons as comments in that doc, as well.
>>
>>
>> On Fri, Aug 23, 2013 at 7:17 PM, Ted Yu <yu...@gmail.com> wrote:
>>
>> > Should there be a column that explains what new API replaces the removed
>> > one ?
>> >
>> > e.g. HTable#getRegionsInfo() should be replaced with HTable#
>> > getRegionLocations().
>> >
>> > Cheers
>> >
>> >
>> > On Fri, Aug 23, 2013 at 6:02 PM, Aleksandr Shulman <aleks@cloudera.com
>> > >wrote:
>> >
>> > > Hi everyone,
>> > >
>> > > I took some time and went over the JDiff report of API
>> incompatibilities
>> > > from 0.94 -> 0.95.2.
>> > > Please have a look at the document and add your comments. The goal is
>> to
>> > > acknowledge the incompatibilities that we will permit and fix ones
>> that
>> > > seem egregious.
>> > >
>> > > I went through and identified incompatible public API changes. Note
>> that
>> > > since this is a singularity release, these breaking changes are not
>> > > unacceptable. However, we should minimize the extent of these changes
>> if
>> > we
>> > > can to make it easier for folks to transition their client code.
>> > >
>> > >
>> > >
>> >
>> https://docs.google.com/a/cloudera.com/document/d/14nqQXlIvgJOxGFTfhSoquYzjW8Yx-v9TqTBqRjiB7g0/edit
>> > >
>> > > The full report can be found here:
>> > > https://github.com/AleksandrShulman/hbase_jdiff/tree/master/reports
>> > >
>> > > There were some areas where I was not sure about the impact of a
>> change.
>> > I
>> > > noted those with a question mark. Feel free to fill in any gaps.
>> > >
>> > >
>> > > --
>> > > Best Regards,
>> > >
>> > > Aleks Shulman
>> > > 847.814.5804
>> > > Cloudera
>> > >
>> >
>>
>>
>>
>> --
>> Best Regards,
>>
>> Aleks Shulman
>> 847.814.5804
>> Cloudera
>>
>
>

Re: Incompatible Java API Diffs from 0.94 -> 0.95.2

Posted by Ted Yu <yu...@gmail.com>.
I added a column 'New API' to the right of 'Risk' column.

Will keep updating the doc.

Thanks


On Mon, Aug 26, 2013 at 12:39 AM, Aleksandr Shulman <al...@cloudera.com>wrote:

> It would be a good idea to add such a column. Everyone should have write
> perms on the google doc, so feel free to add that. We can discuss the pros
> and cons as comments in that doc, as well.
>
>
> On Fri, Aug 23, 2013 at 7:17 PM, Ted Yu <yu...@gmail.com> wrote:
>
> > Should there be a column that explains what new API replaces the removed
> > one ?
> >
> > e.g. HTable#getRegionsInfo() should be replaced with HTable#
> > getRegionLocations().
> >
> > Cheers
> >
> >
> > On Fri, Aug 23, 2013 at 6:02 PM, Aleksandr Shulman <aleks@cloudera.com
> > >wrote:
> >
> > > Hi everyone,
> > >
> > > I took some time and went over the JDiff report of API
> incompatibilities
> > > from 0.94 -> 0.95.2.
> > > Please have a look at the document and add your comments. The goal is
> to
> > > acknowledge the incompatibilities that we will permit and fix ones that
> > > seem egregious.
> > >
> > > I went through and identified incompatible public API changes. Note
> that
> > > since this is a singularity release, these breaking changes are not
> > > unacceptable. However, we should minimize the extent of these changes
> if
> > we
> > > can to make it easier for folks to transition their client code.
> > >
> > >
> > >
> >
> https://docs.google.com/a/cloudera.com/document/d/14nqQXlIvgJOxGFTfhSoquYzjW8Yx-v9TqTBqRjiB7g0/edit
> > >
> > > The full report can be found here:
> > > https://github.com/AleksandrShulman/hbase_jdiff/tree/master/reports
> > >
> > > There were some areas where I was not sure about the impact of a
> change.
> > I
> > > noted those with a question mark. Feel free to fill in any gaps.
> > >
> > >
> > > --
> > > Best Regards,
> > >
> > > Aleks Shulman
> > > 847.814.5804
> > > Cloudera
> > >
> >
>
>
>
> --
> Best Regards,
>
> Aleks Shulman
> 847.814.5804
> Cloudera
>

Re: Incompatible Java API Diffs from 0.94 -> 0.95.2

Posted by Aleksandr Shulman <al...@cloudera.com>.
It would be a good idea to add such a column. Everyone should have write
perms on the google doc, so feel free to add that. We can discuss the pros
and cons as comments in that doc, as well.


On Fri, Aug 23, 2013 at 7:17 PM, Ted Yu <yu...@gmail.com> wrote:

> Should there be a column that explains what new API replaces the removed
> one ?
>
> e.g. HTable#getRegionsInfo() should be replaced with HTable#
> getRegionLocations().
>
> Cheers
>
>
> On Fri, Aug 23, 2013 at 6:02 PM, Aleksandr Shulman <aleks@cloudera.com
> >wrote:
>
> > Hi everyone,
> >
> > I took some time and went over the JDiff report of API incompatibilities
> > from 0.94 -> 0.95.2.
> > Please have a look at the document and add your comments. The goal is to
> > acknowledge the incompatibilities that we will permit and fix ones that
> > seem egregious.
> >
> > I went through and identified incompatible public API changes. Note that
> > since this is a singularity release, these breaking changes are not
> > unacceptable. However, we should minimize the extent of these changes if
> we
> > can to make it easier for folks to transition their client code.
> >
> >
> >
> https://docs.google.com/a/cloudera.com/document/d/14nqQXlIvgJOxGFTfhSoquYzjW8Yx-v9TqTBqRjiB7g0/edit
> >
> > The full report can be found here:
> > https://github.com/AleksandrShulman/hbase_jdiff/tree/master/reports
> >
> > There were some areas where I was not sure about the impact of a change.
> I
> > noted those with a question mark. Feel free to fill in any gaps.
> >
> >
> > --
> > Best Regards,
> >
> > Aleks Shulman
> > 847.814.5804
> > Cloudera
> >
>



-- 
Best Regards,

Aleks Shulman
847.814.5804
Cloudera

Re: Incompatible Java API Diffs from 0.94 -> 0.95.2

Posted by Ted Yu <yu...@gmail.com>.
Should there be a column that explains what new API replaces the removed
one ?

e.g. HTable#getRegionsInfo() should be replaced with HTable#
getRegionLocations().

Cheers


On Fri, Aug 23, 2013 at 6:02 PM, Aleksandr Shulman <al...@cloudera.com>wrote:

> Hi everyone,
>
> I took some time and went over the JDiff report of API incompatibilities
> from 0.94 -> 0.95.2.
> Please have a look at the document and add your comments. The goal is to
> acknowledge the incompatibilities that we will permit and fix ones that
> seem egregious.
>
> I went through and identified incompatible public API changes. Note that
> since this is a singularity release, these breaking changes are not
> unacceptable. However, we should minimize the extent of these changes if we
> can to make it easier for folks to transition their client code.
>
>
> https://docs.google.com/a/cloudera.com/document/d/14nqQXlIvgJOxGFTfhSoquYzjW8Yx-v9TqTBqRjiB7g0/edit
>
> The full report can be found here:
> https://github.com/AleksandrShulman/hbase_jdiff/tree/master/reports
>
> There were some areas where I was not sure about the impact of a change. I
> noted those with a question mark. Feel free to fill in any gaps.
>
>
> --
> Best Regards,
>
> Aleks Shulman
> 847.814.5804
> Cloudera
>