站内搜索: 请输入搜索关键词
当前页面: 在线文档首页 > Hibernate 3.2.3 正式版 API 英文文档

Filter (Hibernate API Documentation) - Hibernate 3.2.3 正式版 API 英文文档


org.hibernate
Interface Filter

All Known Implementing Classes:
FilterImpl

public interface Filter

Type definition of Filter. Filter defines the user's view into enabled dynamic filters, allowing them to set filter parameter values.

Author:
Steve Ebersole

Method Summary
 FilterDefinition getFilterDefinition()
          Get the filter definition containing additional information about the filter (such as default-condition and expected parameter names/types).
 String getName()
          Get the name of this filter.
 Filter setParameter(String name, Object value)
          Set the named parameter's value for this filter.
 Filter setParameterList(String name, Collection values)
          Set the named parameter's value list for this filter.
 Filter setParameterList(String name, Object[] values)
          Set the named parameter's value list for this filter.
 void validate()
          Perform validation of the filter state.
 

Method Detail

getName

public String getName()
Get the name of this filter.

Returns:
This filter's name.

getFilterDefinition

public FilterDefinition getFilterDefinition()
Get the filter definition containing additional information about the filter (such as default-condition and expected parameter names/types).

Returns:
The filter definition

setParameter

public Filter setParameter(String name,
                           Object value)
Set the named parameter's value for this filter.

Parameters:
name - The parameter's name.
value - The value to be applied.
Returns:
This FilterImpl instance (for method chaining).

setParameterList

public Filter setParameterList(String name,
                               Collection values)
Set the named parameter's value list for this filter. Used in conjunction with IN-style filter criteria.

Parameters:
name - The parameter's name.
values - The values to be expanded into an SQL IN list.
Returns:
This FilterImpl instance (for method chaining).

setParameterList

public Filter setParameterList(String name,
                               Object[] values)
Set the named parameter's value list for this filter. Used in conjunction with IN-style filter criteria.

Parameters:
name - The parameter's name.
values - The values to be expanded into an SQL IN list.
Returns:
This FilterImpl instance (for method chaining).

validate

public void validate()
              throws HibernateException
Perform validation of the filter state. This is used to verify the state of the filter after its enablement and before its use.

Throws:
HibernateException - If the state is not currently valid.