com.atlassian.jira.issue.search.parameters.lucene
Class PeriodParameter

java.lang.Object
  com.atlassian.jira.issue.search.parameters.AbstractSearchParameter
      com.atlassian.jira.issue.search.parameters.AbstractLuceneParameter
          com.atlassian.jira.issue.search.parameters.lucene.SingleFieldSingleValueLuceneParameter
              com.atlassian.jira.issue.search.parameters.lucene.PeriodParameter

All Implemented Interfaces:

LuceneParameter, SearchParameter

Deprecated. since JIRA 3.3 Should now use RelativeDateRangeParameter

public class PeriodParameter
extends SingleFieldSingleValueLuceneParameter

Parameter indicating a period of time, unbounded at one end. Period is specified by a time offset (t1) from 'now' (t0), and a direction (indicating past, future) in which the period is unbounded.

t1 is positive in the past, so t1=-20000 means "20 seconds ago".

The direction is specified as an EntityOperator operator; EntityOperator.GREATER_THAN_EQUAL_TO means that times after t1 match (t1 is the lower/earlier boundary); EntityOperator.LESS_THAN_EQUAL_TO means times before t1 match (t1 is upper/latest boundary)

Field Summary

protected org.ofbiz.core.entity.EntityOperator

operator Deprecated.

Fields inherited from class com.atlassian.jira.issue.search.parameters.AbstractSearchParameter

log

Constructor Summary

PeriodParameter()
Deprecated.

PeriodParameter(String name, org.ofbiz.core.entity.EntityOperator operator, Long offset)
Deprecated.

PeriodParameter(String name, Long offset)
Deprecated. Create a PeriodParameter, with future unbounded.

Method Summary

String	getName() Deprecated. Get issue field name.
long	getOffset() Deprecated.
org.ofbiz.core.entity.EntityOperator	getOperator() Deprecated. Whether past or future is unbounded.
org.apache.lucene.search.Query	getQuery(org.ofbiz.core.entity.GenericValue project, User searcher) Deprecated.
String	getQueryString() Deprecated. Returns the query string
protected String	getQueryStringPrefix() Deprecated. Query parameter name, suitable for inclusion in URL.
electric.xml.Element	getXml() Deprecated. Return an XML elemnt representation of this search parameter.
protected String	getXmlElementName() Deprecated. For some parameters, the parameter name may not be a valid XML element name (eg, if it contains a ':' in the case of custom fields.
void	setName(String name) Deprecated. Specify issue field name to limit search by.
void	setOperator(org.ofbiz.core.entity.EntityOperator operator) Deprecated.
void	setXml(electric.xml.Element el) Deprecated. Initialise this search parameter using an XML element.

Methods inherited from class com.atlassian.jira.issue.search.parameters.lucene.SingleFieldSingleValueLuceneParameter

isValid

Methods inherited from class com.atlassian.jira.issue.search.parameters.AbstractSearchParameter

addValue, clearValues, equals, getValues, hashCode, toString

Methods inherited from class java.lang.Object

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

Methods inherited from interface com.atlassian.jira.issue.search.SearchParameter

addValue, getValues

Field Detail

operator

protected org.ofbiz.core.entity.EntityOperator operator

Deprecated.

Constructor Detail

PeriodParameter

public PeriodParameter()

Deprecated.

PeriodParameter

public PeriodParameter(String name,
                       Long offset)

Deprecated.

Create a PeriodParameter, with future unbounded.

Parameters:

name - Parameter name, typically from DocumentConstants.

offset - Offset in milliseconds, positive for dates in the past, specifying one boundary for the period.

PeriodParameter

public PeriodParameter(String name,
                       org.ofbiz.core.entity.EntityOperator operator,
                       Long offset)

Deprecated.

Parameters:

name - Period name, typically from DocumentConstants.

operator - Direction in time, relative to 'offset'.

offset - offset in milliseconds, positive for dates in the past, specifying one boundary for the period.

Method Detail

getName

public String getName()

Deprecated.

Description copied from interface: SearchParameter

Get issue field name.

Specified by:

getName in interface SearchParameter

Overrides:

getName in class AbstractSearchParameter

Returns:

Period name, with "Previous" appended if unbounded in the future, or "Next" appended if unbounded in the past. This made sense when the offset was always in the past :)

getXmlElementName

protected String getXmlElementName()

Deprecated.

Description copied from class: SingleFieldSingleValueLuceneParameter

For some parameters, the parameter name may not be a valid XML element name (eg, if it contains a ':' in the case of custom fields. For those parameters, you can override the element name here).

Overrides:

getXmlElementName in class SingleFieldSingleValueLuceneParameter

Returns:

The element name to describe this parameter. By default, it returns the same as AbstractSearchParameter.getName()

setName

public void setName(String name)

Deprecated.

Description copied from interface: SearchParameter

Specify issue field name to limit search by. Either a predefined name (from IssueFieldConstants, or Field.getId().

Specified by:

setName in interface SearchParameter

Overrides:

setName in class AbstractSearchParameter

Parameters:

name - Period name, eg. "duedate".

getOperator

public org.ofbiz.core.entity.EntityOperator getOperator()

Deprecated.

Whether past or future is unbounded.

Returns:

Typically EntityOperator.GREATER_THAN_EQUAL_TO for "future unbounded" and EntityOperator.LESS_THAN_EQUAL_TO for "past unbounded"

getQuery

public org.apache.lucene.search.Query getQuery(org.ofbiz.core.entity.GenericValue project,
                                               User searcher)
                                        throws org.apache.lucene.queryParser.ParseException

Deprecated.

Specified by:

getQuery in interface LuceneParameter

Overrides:

getQuery in class SingleFieldSingleValueLuceneParameter

Returns:

a collection of Query objects.

Throws:

org.apache.lucene.queryParser.ParseException

setXml

public void setXml(electric.xml.Element el)

Deprecated.

Description copied from interface: SearchParameter

Initialise this search parameter using an XML element.

Usual process is:

    SearchParameter param = new MySearchParameter();
    param.setXml(element);
 

Specified by:

setXml in interface SearchParameter

Overrides:

setXml in class AbstractSearchParameter

Parameters:

el - XML element

getXml

public electric.xml.Element getXml()

Deprecated.

Description copied from interface: SearchParameter

Return an XML elemnt representation of this search parameter.

Specified by:

getXml in interface SearchParameter

Overrides:

getXml in class SingleFieldSingleValueLuceneParameter

Returns:

XML element

setOperator

public void setOperator(org.ofbiz.core.entity.EntityOperator operator)

Deprecated.

getOffset

public long getOffset()

Deprecated.

Returns:

Offset of the period's boundary, in milliseconds. A positive value indicates a time offset in the past. Eg. -1000 means "1 second ago".

getQueryStringPrefix

protected String getQueryStringPrefix()

Deprecated.

Description copied from class: AbstractSearchParameter

Query parameter name, suitable for inclusion in URL. Note that implementations of this method should ensure that the values that they return are URLEncoded, perhaps using the URLEncoder.encode(String) method.

Overrides:

getQueryStringPrefix in class AbstractSearchParameter

getQueryString

public String getQueryString()

Deprecated.

Description copied from interface: SearchParameter

Returns the query string

Specified by:

getQueryString in interface SearchParameter

Overrides:

getQueryString in class AbstractSearchParameter

Returns:

query string