Overview | Package | Class | Use | Tree | Deprecated | Index | Help
PREV CLASS NEXT CLASS | FRAMES NO FRAMES
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD

## org.eclipse.birt.report.model.api
Class FilterConditionHandle

    java.lang.Object
      org.eclipse.birt.report.model.api.ElementDetailHandle
          org.eclipse.birt.report.model.api.ValueHandle
              org.eclipse.birt.report.model.api.StructureHandle
                  org.eclipse.birt.report.model.api.FilterConditionHandle

    public class FilterConditionHandle

extends StructureHandle

Represents one filter in the filter list of List, Table or their Groups.

This is a managed object, meaning that all changes should be made though the command layer so that they can be undone and redone. Each filter condition has the following properties:

Column
  a filter condition has a required column.
Operator
  a filter condition has a required operator to compute.
Filter Expression
  a filter condition has a required filter expression to test. Can be a column or a complete boolean expression.
Value 1 Expression
  a filter condition has an optional value 1 expression of the comparison value for all but unary operators.
Value 2 Expression
  a filter condition has an optional value 2 expression of the second comparison value for trinary operators(between, not between).

Field Summary

Fields inherited from class org.eclipse.birt.report.model.api.StructureHandle
`structRef`

Fields inherited from class org.eclipse.birt.report.model.api.ElementDetailHandle
`elementHandle`

Constructor Summary
`FilterConditionHandle(SimpleValueHandle valueHandle, int index)` Constructs the handle of filter condition.

Method Summary
`java.lang.String` | `getColumn()` Deprecated. This property has been removed.
`java.lang.String` | `getExpr()` Returns the filter expression.
`java.lang.String` | `getFilterExpr()` Deprecated. Replaced by the method `getExpr()`
`java.lang.String` | `getFilterTarget()` Returns the filter target.
`java.lang.String` | `getOperator()` Returns the operator of this filter condition.
`java.lang.String` | `getValue1()` Returns the value 1 expression of this filter condition.
`java.lang.String` | `getValue1Expr()` Deprecated. Replaced by the method `getValue1()`
`java.util.List` | `getValue1List()` Gets the value1 expression list of this filter condition.
`java.lang.String` | `getValue2()` Returns the value 2 expression of this filter condition.
`java.lang.String` | `getValue2Expr()` Deprecated. Replaced by the method `getValue2()`
`boolean` | `isOptional()` Determines whether this filte rcondition is optional or not.
`void` | `setColumn(java.lang.String column)` Deprecated. This property has been removed.
`void` | `setExpr(java.lang.String filterExpr)` Sets the filter expression.
`void` | `setFilterExpr(java.lang.String filterExpr)` Deprecated. Replaced by the method `setExpr(String)`
`void` | `setFilterTarget(java.lang.String filterTarget)` Sets the filter target.
`void` | `setOperator(java.lang.String operator)` Sets the operator of this filter condition.
`void` | `setOptional(boolean isOptional)` Sets the optional status for this filter condition.
`void` | `setValue1(java.util.List value1List)` Sets the value 1 expression list of this filter condition.
`void` | `setValue1(java.lang.String value1Expr)` Sets the value 1 expression of this filter condition.
`void` | `setValue1Expr(java.lang.String value1Expr)` Deprecated. Replaced by the method `setValue1(String)`
`void` | `setValue2(java.lang.String value2Expr)` Sets the value 2 expression of this filter condition.
`void` | `setValue2Expr(java.lang.String value2Expr)` Deprecated. Replaced by the method `setValue2(String)`

Methods inherited from class org.eclipse.birt.report.model.api.StructureHandle
`drop, getDefn, getExternalizedValue, getMember, getProperty, getPropertyDefn, getReference, getStringProperty, getStructure, isDesignTime, iterator, setDesignTime, setProperty, setPropertySilently`

Methods inherited from class org.eclipse.birt.report.model.api.ElementDetailHandle
`getDesign, getElement, getElementHandle, getModule`

Methods inherited from class java.lang.Object
`clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait`

Constructor Detail

### FilterConditionHandle

    public FilterConditionHandle(SimpleValueHandle valueHandle,
                                 int index)

  Constructs the handle of filter condition.

  Parameters:
    `valueHandle` - the value handle for filter condition list of one property
    `index` - the position of this filter condition in the list

Method Detail

### getExpr

    public java.lang.String getExpr()

  Returns the filter expression.

  Returns:
    the filter expression

### setExpr

    public void setExpr(java.lang.String filterExpr)
                 throws SemanticException

  Sets the filter expression.

  Parameters:
    `filterExpr` - the filter expression to set
  Throws:
    `SemanticException` - value required exception

### getOperator

    public java.lang.String getOperator()

  Returns the operator of this filter condition. The possible values are defined in `DesignChoiceConstants`, and they are:
  - `FILTER_OPERATOR_EQ`
  - `FILTER_OPERATOR_NE`
  - `FILTER_OPERATOR_LT`
  - `FILTER_OPERATOR_LE`
  - `FILTER_OPERATOR_GE`
  - `FILTER_OPERATOR_GT`
  - `FILTER_OPERATOR_BETWEEN`
  - `FILTER_OPERATOR_NOT_BETWEEN`
  - `FILTER_OPERATOR_NULL`
  - `FILTER_OPERATOR_NOT_NULL`
  - `FILTER_OPERATOR_TRUE`
  - `FILTER_OPERATOR_FALSE`
  - `FILTER_OPERATOR_LIKE`
  - `FILTER_OPERATOR_TOP_N`
  - `FILTER_OPERATOR_BOTTOM_N`
  - `FILTER_OPERATOR_TOP_PERCENT`
  - `FILTER_OPERATOR_BOTTOM_PERCENT`
  - `FILTER_OPERATOR_ANY`

  Returns:
    the operator of this filter condition

### setOperator

    public void setOperator(java.lang.String operator)
                     throws SemanticException

  Sets the operator of this filter condition. The allowed values are defined in `DesignChoiceConstants`, and they are:
  - `FILTER_OPERATOR_EQ`
  - `FILTER_OPERATOR_NE`
  - `FILTER_OPERATOR_LT`
  - `FILTER_OPERATOR_LE`
  - `FILTER_OPERATOR_GE`
  - `FILTER_OPERATOR_GT`
  - `FILTER_OPERATOR_BETWEEN`
  - `FILTER_OPERATOR_NOT_BETWEEN`
  - `FILTER_OPERATOR_NULL`
  - `FILTER_OPERATOR_NOT_NULL`
  - `FILTER_OPERATOR_TRUE`
  - `FILTER_OPERATOR_FALSE`
  - `FILTER_OPERATOR_LIKE`
  - `FILTER_OPERATOR_TOP_N`
  - `FILTER_OPERATOR_BOTTOM_N`
  - `FILTER_OPERATOR_TOP_PERCENT`
  - `FILTER_OPERATOR_BOTTOM_PERCENT`
  - `FILTER_OPERATOR_ANY`

  Parameters:
    `operator` - the operator to set
  Throws:
    `SemanticException` - if operator is not in the choice list.

### getValue1

    public java.lang.String getValue1()

  Returns the value 1 expression of this filter condition.

  Returns:
    the value 1 expression of this filter condition

### getValue1List

    public java.util.List getValue1List()

  Gets the value1 expression list of this filter condition. For most filter operator, there is only one expression in the returned list. However, filter operator 'in' may contain more than one expression.

  Returns:
    the value1 expression list of this filter condition.

### setValue1

    public void setValue1(java.lang.String value1Expr)

  Sets the value 1 expression of this filter condition.

  Parameters:
    `value1Expr` - the value 1 expression to set

### setValue1

    public void setValue1(java.util.List value1List)
                   throws SemanticException

  Sets the value 1 expression list of this filter condition.

  Parameters:
    `value1List` - the value 1 expression list to set
  Throws:
    `SemanticException` - if the instance in the list is not valid

### getValue2

    public java.lang.String getValue2()

  Returns the value 2 expression of this filter condition.

  Returns:
    the value 2 expression of this filter condition

### setValue2

    public void setValue2(java.lang.String value2Expr)

  Sets the value 2 expression of this filter condition.

  Parameters:
    `value2Expr` - the value 2 expression to set

### getColumn

    public java.lang.String getColumn()

  Deprecated. This property has been removed.

  Returns the column name of this filter condition.

  Returns:
    `null`. NOT support any more.

### setColumn

    public void setColumn(java.lang.String column)

  Deprecated. This property has been removed.

  Sets the column name of this filter condition. NOT support any more.

  Parameters:
    `column` - the column name to set

### getFilterExpr

    public java.lang.String getFilterExpr()

  Deprecated. Replaced by the method `getExpr()`

  Returns the filter expression.

  Returns:
    the expression for the filter.

### setFilterExpr

    public void setFilterExpr(java.lang.String filterExpr)
                       throws SemanticException

  Deprecated. Replaced by the method `setExpr(String)`

  Sets the filter expression.

  Parameters:
    `filterExpr` - the filter expression to set
  Throws:
    `SemanticException` - value required exception

### getValue1Expr

    public java.lang.String getValue1Expr()

  Deprecated. Replaced by the method `getValue1()`

  Returns the value 1 expression of this filter condition.

  Returns:
    the value 1 expression.

### setValue1Expr

    public void setValue1Expr(java.lang.String value1Expr)

  Deprecated. Replaced by the method `setValue1(String)`

  Sets the value 1 expression of this filter condition.

  Parameters:
    `value1Expr` - the value 1 expression to set

### getValue2Expr

    public java.lang.String getValue2Expr()

  Deprecated. Replaced by the method `getValue2()`

  Returns the value 2 expression of this filter condition.

  Returns:
    the value 2 expression.

### setValue2Expr

    public void setValue2Expr(java.lang.String value2Expr)

  Deprecated. Replaced by the method `setValue2(String)`

  Sets the value 2 expression of this filter condition.

  Parameters:
    `value2Expr` - the value 2 expression to set

### getFilterTarget

    public java.lang.String getFilterTarget()

  Returns the filter target. The possible values are defined in `DesignChoiceConstants`, and they are:
  - `FILTER_TARGET_DATA_SET`
  - `FILTER_TARGET_RESULT_SET`

  Returns:
    the target type

### setFilterTarget

    public void setFilterTarget(java.lang.String filterTarget)
                         throws SemanticException

  Sets the filter target. The allowed values are defined in `DesignChoiceConstants`, and they are:
  - `FILTER_TARGET_DATA_SET`
  - `FILTER_TARGET_RESULT_SET`

  Parameters:
    `filterTarget` - the filter target to set
  Throws:
    `SemanticException` - if the value is not one of the above.

### isOptional

    public boolean isOptional()

  Determines whether this filte rcondition is optional or not.

  Returns:
    true if this filter is optional, otherwise false

### setOptional

    public void setOptional(boolean isOptional)

  Sets the optional status for this filter condition.

  Parameters:
    `isOptional` - true if this filter is optional, otherwise false

Overview | Package | Class | Use | Tree | Deprecated | Index | Help
PREV CLASS NEXT CLASS | FRAMES NO FRAMES
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD

Copyright © 2008 Actuate Corp. All rights reserved.