org.nuiton.wikitty.query
Class WikittyQuery

java.lang.Object
  org.nuiton.wikitty.query.WikittyQuery

All Implemented Interfaces:

Serializable

public class WikittyQuery
extends Object
implements Serializable

Classe permettant de faire des recherches dans les données.

Pour creer facilement la condition le plus simple est d'utiliser WikittyQueryMaker pour creer le WikittyQuery en appelant la method WikittyQueryMaker.end() a la fin.

Pour offrir au utilisateur de vos applications la possibilite d'ecrire eux meme des requetes vous pouvez utiliser WikittyQueryParser

Since:

3.3 Last update: $Date$ by : $Author$

Version:

$Revision$

Author:

poussin

See Also:

Serialized Form

Field Summary

protected Condition	condition query condition
protected boolean	facetExtension if true facet is done on extension name.
protected List<Element>	facetField Facet on field.
protected int	facetLimit Nombre maximum de topic par facet a retourner.
protected int	facetMinCount nombre minimum de valeur pour qu'une valeur apparaisse dans les facets.
protected List<FacetQuery>	facetQuery Facet on condition.
protected FacetSortType	facetSort sort topic order, default is sorted on count
protected int	first First index to get result.
protected int	limit Number of result to retrieve. 100 by default.
static int	MAX Use to not limit result.
protected String	name query name
protected List<Element>	sortAscending Sort ascending on fields.
protected List<Element>	sortDescending Sort descending on fields.

Constructor Summary

WikittyQuery()
create anonymous query

WikittyQuery(Condition condition)

WikittyQuery(String name)
create named query

WikittyQuery(String name, Condition condition)
create named query with condition

Method Summary

void	accept(WikittyQueryVisitor visitor)
WikittyQuery	addFacetField(Element field)
WikittyQuery	addFacetQuery(FacetQuery facetQuery)
WikittyQuery	addFacetQuery(String name, Condition condition)
WikittyQuery	addSortAscending(ElementField... field)
WikittyQuery	addSortDescending(Element... field)
WikittyQuery	copy()
boolean	equals(Object o)
Condition	getCondition()
List<Element>	getFacetField()
int	getFacetLimit()
int	getFacetMinCount()
List<FacetQuery>	getFacetQuery()
FacetSortType	getFacetSort()
int	getFirst()
int	getLimit() Get result limit. 0 return no result (usefull for facets and result count). -1 return all results.
String	getName()
List<Element>	getSortAscending() Get field names where sort is configured ascending.
List<Element>	getSortDescending() Get field names where sort is configured descending.
int	hashCode() Inefficient hashCode method but necessary with overloading of equals method This method return hashCode of object class.
boolean	isFacetExtension()
WikittyQuery	setCondition(Condition condition)
WikittyQuery	setFacetExtension(boolean facetExtension)
WikittyQuery	setFacetField(Element... facetField)
WikittyQuery	setFacetField(List<Element> facetField)
WikittyQuery	setFacetLimit(int facetLimit)
WikittyQuery	setFacetMinCount(int facetMinCount)
WikittyQuery	setFacetQuery(FacetQuery... facetQuery)
void	setFacetSort(FacetSortType facetSort)
WikittyQuery	setFirst(int first)
WikittyQuery	setLimit(int count) Set result limit. 0 return no result (usefull for facets and result count). -1 return all results.
WikittyQuery	setName(String name)
WikittyQuery	setSortAscending(Element... sortAscending)
WikittyQuery	setSortAscending(List<Element> sortAscending)
WikittyQuery	setSortDescending(Element... sortDescending)
WikittyQuery	setSortDescending(List<Element> sortDescending)
String	toString()

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Field Detail

MAX

public static final int MAX

Use to not limit result.

See Also:

Constant Field Values

name

protected String name

query name

condition

protected Condition condition

query condition

first

protected int first

First index to get result.

limit

protected int limit

Number of result to retrieve. 100 by default.

facetMinCount

protected int facetMinCount

nombre minimum de valeur pour qu'une valeur apparaisse dans les facets. par defaut, il doit y avoir plus que 1 valeur.

facetLimit

protected int facetLimit

Nombre maximum de topic par facet a retourner. Par default on en retourne 100.

facetSort

protected FacetSortType facetSort

sort topic order, default is sorted on count

facetQuery

protected List<FacetQuery> facetQuery

Facet on condition.

facetField

protected List<Element> facetField

Facet on field.

facetExtension

protected boolean facetExtension

if true facet is done on extension name. Extention facet can be found in WikittyQueryResult.getFacets() with key Element.EXTENSION#getValue()

sortAscending

protected List<Element> sortAscending

Sort ascending on fields.

sortDescending

protected List<Element> sortDescending

Sort descending on fields.

Constructor Detail

WikittyQuery

public WikittyQuery()

create anonymous query

WikittyQuery

public WikittyQuery(Condition condition)

WikittyQuery

public WikittyQuery(String name)

create named query

WikittyQuery

public WikittyQuery(String name,
                    Condition condition)

create named query with condition

Method Detail

copy

public WikittyQuery copy()

toString

public String toString()

Overrides:

toString in class Object

equals

public boolean equals(Object o)

Overrides:

equals in class Object

hashCode

public int hashCode()

Inefficient hashCode method but necessary with overloading of equals method This method return hashCode of object class. There is no better way to compute stable hashCode in time

Overrides:

hashCode in class Object

Returns:

accept

public void accept(WikittyQueryVisitor visitor)

getName

public String getName()

setName

public WikittyQuery setName(String name)

getFirst

public int getFirst()

setFirst

public WikittyQuery setFirst(int first)

getLimit

public int getLimit()

Get result limit. 0 return no result (usefull for facets and result count). -1 return all results.

Returns:

result count

setLimit

public WikittyQuery setLimit(int count)

Set result limit. 0 return no result (usefull for facets and result count). -1 return all results.

Parameters:

count - new count

Returns:

this

getFacetMinCount

public int getFacetMinCount()

setFacetMinCount

public WikittyQuery setFacetMinCount(int facetMinCount)

getFacetLimit

public int getFacetLimit()

setFacetLimit

public WikittyQuery setFacetLimit(int facetLimit)

setFacetSort

public void setFacetSort(FacetSortType facetSort)

getFacetSort

public FacetSortType getFacetSort()

getFacetQuery

public List<FacetQuery> getFacetQuery()

addFacetQuery

public WikittyQuery addFacetQuery(FacetQuery facetQuery)

addFacetQuery

public WikittyQuery addFacetQuery(String name,
                                  Condition condition)

setFacetQuery

public WikittyQuery setFacetQuery(FacetQuery... facetQuery)

getFacetField

public List<Element> getFacetField()

addFacetField

public WikittyQuery addFacetField(Element field)

setFacetField

public WikittyQuery setFacetField(Element... facetField)

setFacetField

public WikittyQuery setFacetField(List<Element> facetField)

isFacetExtension

public boolean isFacetExtension()

setFacetExtension

public WikittyQuery setFacetExtension(boolean facetExtension)

getSortAscending

public List<Element> getSortAscending()

Get field names where sort is configured ascending.

Returns:

field names

addSortAscending

public WikittyQuery addSortAscending(ElementField... field)

setSortAscending

public WikittyQuery setSortAscending(Element... sortAscending)

setSortAscending

public WikittyQuery setSortAscending(List<Element> sortAscending)

getSortDescending

public List<Element> getSortDescending()

Get field names where sort is configured descending.

Returns:

field names

addSortDescending

public WikittyQuery addSortDescending(Element... field)

setSortDescending

public WikittyQuery setSortDescending(Element... sortDescending)

setSortDescending

public WikittyQuery setSortDescending(List<Element> sortDescending)

getCondition

public Condition getCondition()

setCondition

public WikittyQuery setCondition(Condition condition)