[LUCENE-2460] Search Results Filtering Based on Bitwise Operations on Integer Fields

• Type: New Feature
• Status: Open
• Priority: Major
• Resolution: Unresolved
• Fix Version/s: 4.9, 6.0
• Component/s: core/search
• Lucene Fields: New, Patch Available
• Assignee: Unassigned
• Reporter: Israel Ekpo
• Created: 14/May/10 01:30
• Updated: 28/Aug/22 12:26

Description

This package makes it possible to filter results returned from a query based on the results of a bitwise operation on an integer field in the documents returned from the pre-constructed query.

You can perform three basic types of operations on these integer fields

• BitwiseOperation.BITWISE_AND (bitwise AND)
• BitwiseOperation.BITWISE_OR (bitwise inclusive OR)
• BitwiseOperation.BITWISE_XOR (bitwise exclusive OR)

You can also negate the results of these operations.

For example, imagine there is an integer field in the index named "flags" with the a value 8 (1000 in binary). The following results will be expected :

1. A source value of 8 will match during a BitwiseOperation.BITWISE_AND operation, with negate set to false.
2. A source value of 4 will match during a BitwiseOperation.BITWISE_AND operation, with negate set to true.

The BitwiseFilter constructor accepts the following values

• The name of the integer field (A string)
• The BitwiseOperation object. Example BitwiseOperation.BITWISE_XOR
• The source value (an integer)
• A boolean value indicating whether or not to negate the results of the operation
• A pre-constructed org.apache.lucene.search.Query