Mailing-List: contact dev-help@hbase.apache.org; run by ezmlm
Precedence: bulk
Reply-To: dev@hbase.apache.org
Received-SPF: pass (nike.apache.org: local policy)
DomainKey-Signature: a=rsa-sha1; q=dns; c=nofws;
  s=s1024; d=yahoo.com;
  h=X-YMail-OSG:Received:X-Rocket-MIMEInfo:X-RocketYMMF:X-Mailer:Message-ID:Date:From:Reply-To:Subject:To:MIME-Version:Content-Type;
  b=h+Wb2/f1tbjpE6XZHC4gUr6j7SWgqLavh/sujvby+c72VvlbMOrniWXx4xHwedvMIkPYabLj+K02ryDneYL+jaV3K8iAqoSIYdwj4c0sMDMinIBts2QQn5GiWPqspHvr+v5OLJfJCh/iKtPuff7A/grQZbHjIhMQhdTWxIJzHrA=;
Message-ID: <1361844525.15111.YahooMailNeo@web140601.mail.bf1.yahoo.com>
Date: Mon, 25 Feb 2013 18:08:45 -0800 (PST)
From: lars hofhansl <larsh@apache.org>
Reply-To: lars hofhansl <larsh@apache.org>
Subject: Filter.isFamilyEssential in 0.94.5
To: hbase-dev <dev@hbase.apache.org>
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii

- If you do not implement custom filter you can ignore the rest of this message.
- If you your custom filters extend FilterBase you can ignore the rest of this message.

In 0.94.5 we added a new feature to Filters, which allows certain filters to avoid loading entire column families if they are not necessary to evaluation the filter (and the filter indicates that the row/kv should be filtered).

In order to do that we added a new method to Filter: isFamilyEssential(bytep[]). It was pointed out that anybody who implemented the Filter interface directly instead of extending FilterBase in prior versions of HBase now has make changes to the implementing class to add an implementation of isFamilyEssential.

After some discussion (see HBASE-5416) we decided to remove that method from Filter and push it instead into FilterBase (even though I was skeptical about that).

TL;DR: Custom filters should extend FilterBase. If you implement custom filter and makes use of isFamilyEssential for HBase 0.94.5 and do so by implementing Filter directly you will have to change your code in 0.94.6 and later and extend FilterBase instead to get this functionality.
Just a heads up, it is quite unlikely that anybody will actually run into this.

Your 0.94 release manager.


-- Lars