Package org.apache.lucene.sandbox.search
Class TermAutomatonQuery
java.lang.Object
org.apache.lucene.search.Query
org.apache.lucene.sandbox.search.TermAutomatonQuery
- All Implemented Interfaces:
Accountable
A proximity query that lets you express an automaton, whose transitions are terms, to match
documents. This is a generalization of other proximity queries like
PhraseQuery
, MultiPhraseQuery
and SpanNearQuery
. It is likely slow, since it visits any document
having any of the terms (i.e. it acts like a disjunction, not a conjunction like PhraseQuery
), and then it must merge-sort all positions within each document to test whether/how
many times the automaton matches.
After creating the query, use createState()
, setAccept(int, boolean)
, addTransition(int, int, java.lang.String)
and addAnyTransition(int, int)
to build up the automaton. Once you are done, call finish()
and then execute the query.
This code is very new and likely has exciting bugs!
- WARNING: This API is experimental and might change in incompatible ways in the next release.
-
Field Summary
Fields inherited from interface org.apache.lucene.util.Accountable
NULL_ACCOUNTABLE
-
Constructor Summary
-
Method Summary
Modifier and TypeMethodDescriptionvoid
addAnyTransition
(int source, int dest) Adds a transition matching any term.void
addTransition
(int source, int dest, String term) Adds a transition to the automaton.void
addTransition
(int source, int dest, BytesRef term) Adds a transition to the automaton.int
Returns a new state; state 0 is always the initial state.createWeight
(IndexSearcher searcher, ScoreMode scoreMode, float boost) boolean
Returns true iffo
is equal to this.void
finish()
Call this once you are done adding states/transitions.void
finish
(int determinizeWorkLimit) Call this once you are done adding states/transitions.int
hashCode()
long
rewrite
(IndexReader reader) void
setAccept
(int state, boolean accept) Marks the specified state as accept or not.toDot()
Returns the dot (graphviz) representation of this automaton.void
visit
(QueryVisitor visitor) Methods inherited from class org.apache.lucene.search.Query
classHash, sameClassAs, toString
Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait
Methods inherited from interface org.apache.lucene.util.Accountable
getChildResources
-
Constructor Details
-
TermAutomatonQuery
-
-
Method Details
-
createState
public int createState()Returns a new state; state 0 is always the initial state. -
setAccept
public void setAccept(int state, boolean accept) Marks the specified state as accept or not. -
addTransition
Adds a transition to the automaton. -
addTransition
Adds a transition to the automaton. -
addAnyTransition
public void addAnyTransition(int source, int dest) Adds a transition matching any term. -
finish
public void finish()Call this once you are done adding states/transitions. -
finish
public void finish(int determinizeWorkLimit) Call this once you are done adding states/transitions.- Parameters:
determinizeWorkLimit
- Maximum effort to spend determinizing the automaton. Higher numbers allow this operation to consume more memory but allow more complex automatons. UseOperations.DEFAULT_DETERMINIZE_WORK_LIMIT
as a decent default if you don't otherwise know what to specify.
-
createWeight
public Weight createWeight(IndexSearcher searcher, ScoreMode scoreMode, float boost) throws IOException - Overrides:
createWeight
in classQuery
- Throws:
IOException
-
toString
-
equals
Returns true iffo
is equal to this. -
hashCode
public int hashCode() -
ramBytesUsed
public long ramBytesUsed()- Specified by:
ramBytesUsed
in interfaceAccountable
-
toDot
Returns the dot (graphviz) representation of this automaton. This is extremely useful for visualizing the automaton. -
rewrite
- Overrides:
rewrite
in classQuery
- Throws:
IOException
-
visit
-