FacetExtractor (The Adobe AEM Quickstart and Web Application. 6.6.0)

All Known Implementing Classes:

DistinctValuesFacetExtractor, PredefinedBucketsFacetExtractor, PropertyFacetExtractor
```
public interface FacetExtractor
```
FacetExtractor extracts a Facet from a result set from a Query. For each node in the result, handleNode(Node) will be called and the implementation should keep track of the values or rather Buckets. After the result set was scanned, getFacet() will be called to retrieve the final Facet.
Performance Note: In order to minimize the number of FacetExtractors and Facets, all implementations should properly implement the #equals(Object) (and thus also #hashCode()) methods so that the framework can remove duplicate FacetExtractors before scanning the result nodes. The reason is that some Predicates will create Facets of the same type, since they follow the same definition, but have different user-chosen values to check against. As a Facet tries to find all different values present in a search result, for the same type of PredicateEvaluator or Facet, they will return the same set of values / Buckets.

Method Summary

All Methods Instance Methods Abstract Methods
Modifier and Type	Method	Description
`Facet`	`getFacet()`	Called after the result set was scanned (and `handleNode(Node)` was called for each node in the result) to retrieve the final `Facet` object.
`void`	`handleNode(javax.jcr.Node node)`	Called for each node of the result set.

- Method Detail
  - handleNode
```
void handleNode(javax.jcr.Node node)
         throws javax.jcr.RepositoryException
```
    Called for each node of the result set.
    
    Parameters:
    
    node - node in the result
    
    Throws:
    
    javax.jcr.RepositoryException - if access to the node failed, ie. one of the methods on node threw an exception
  - getFacet
```
Facet getFacet()
```
    Called after the result set was scanned (and handleNode(Node) was called for each node in the result) to retrieve the final Facet object. Please note that this might be called without handleNode(Node) ever being called, if the result was empty.
    Implementations can use the simple FacetImpl implementation of the Facet interface.
    
    Returns:
    
    an implementation of the Facet interface with all buckets found in the result or null if nothing was found in the result