com.blazebit.persistence.view

Class EntityViewSetting<T,Q extends FullQueryBuilder<T,Q>>

java.lang.Object

com.blazebit.persistence.view.EntityViewSetting<T,Q>

Type Parameters:

T - The type of the entity view

Q - PaginatedCriteriaBuilder if paginated, CriteriaBuilder otherwise

public final class EntityViewSetting<T,Q extends FullQueryBuilder<T,Q>>
extends Object

A EntityViewSetting is a set of filters and sorters that can be applied to a CriteriaBuilder. Filters and sorters are added for entity view attribute names. It also supports pagination and optional parameters. Optional parameters are only set on a criteria builder if they are needed but not satisfied.

Since:

1.0

Author:

Christian Beikov

Method Summary

Methods

Modifier and Type	Method and Description
void	addAttributeFilter(String attributeName, Object filterValue) Adds the given attribute filter to the attribute filters of this setting.
void	addAttributeFilters(Map<String,Object> attributeFilters) Adds the given attribute filters to the attribute filters of this setting.
void	addAttributeNamedFilter(String filterName) Enables and adds the attribute filter with the given name in this setting.
void	addAttributeSorter(String attributeName, Sorter sorter) Adds the given attribute sorter to the attribute sorters of this setting.
void	addAttributeSorters(Map<String,Sorter> attributeSorters) Adds the given attribute sorters to the attribute sorters of this setting.
void	addOptionalParameter(String parameterName, Object value) Adds the given optional parameter to the optional parameters of this setting.
void	addOptionalParameters(Map<String,Object> optionalParameters) Adds the given optional parameters to the optional parameters of this setting.
void	addViewFilter(String filterName) Enables and adds the view filter with the given name in this setting.
static <T> EntityViewSetting<T,CriteriaBuilder<T>>	create(Class<T> entityViewClass) Like create(java.lang.Class, java.lang.String) but with the viewConstructorname set to null.
static <T> EntityViewSetting<T,PaginatedCriteriaBuilder<T>>	create(Class<T> entityViewClass, int firstRow, int maxRows) Like create(java.lang.Class, int, int, java.lang.String) but with the viewConstructorname set to null.
static <T> EntityViewSetting<T,PaginatedCriteriaBuilder<T>>	create(Class<T> entityViewClass, int firstRow, int maxRows, String viewConstructorName) Creates a new EntityViewSetting that can be applied on criteria builders.
static <T> EntityViewSetting<T,PaginatedCriteriaBuilder<T>>	create(Class<T> entityViewClass, Object entityId, int maxRows) Like create(java.lang.Class, java.lang.Object, int, java.lang.String) but with the viewConstructorname set to null.
static <T> EntityViewSetting<T,PaginatedCriteriaBuilder<T>>	create(Class<T> entityViewClass, Object entityId, int maxRows, String viewConstructorName) Creates a new EntityViewSetting that can be applied on criteria builders.
static <T> EntityViewSetting<T,CriteriaBuilder<T>>	create(Class<T> entityViewClass, String viewConstructorName) Creates a new EntityViewSetting that can be applied on criteria builders.
Map<String,Object>	getAttributeFilters() Returns a copy of the attribute filters that have been added.
Set<String>	getAttributeNamedFilters() Returns a copy of the named filters for attributes that have been added.
Map<String,Sorter>	getAttributeSorters() Returns a copy of the attribute sorters that have been added.
Object	getEntityId() The id of the entity which should be located on the page returned result.
Class<T>	getEntityViewClass() Returns the entity view class.
int	getFirstResult() The first result that the criteria builder should return.
KeysetPage	getKeysetPage() Returns the key set of this setting.
int	getMaxResults() The maximum number of results that the criteria builder should return.
Map<String,Object>	getOptionalParameters() Returns a copy of the optional parameters that have been added.
String	getViewConstructorName() Returns the entity view constructor name.
Set<String>	getViewFilters() Returns a copy of the named filters for the view that have been added.
boolean	hasAttributeFilters() Returns true if filters have been added, otherwise false.
boolean	hasAttributeNamedFilters() Returns true if named filters for attributes have been added, otherwise false.
boolean	hasAttributeSorters() Returns true if sorters have been added, otherwise false.
boolean	hasOptionalParameters() Returns true if optional parameters have been added, otherwise false.
boolean	hasViewFilters() Returns true if named filters for the view have been added, otherwise false.
boolean	isKeysetPaginated() Returns true if this setting is key set paginated.
boolean	isPaginated() Returns true if this entiy view setting applies pagination, false otherwise.
EntityViewSetting<T,Q>	withKeysetPage(KeysetPage keysetPage) Sets the key set of this setting.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

create

public static <T> EntityViewSetting<T,CriteriaBuilder<T>> create(Class<T> entityViewClass)

Like create(java.lang.Class, java.lang.String) but with the viewConstructorname set to null.

Type Parameters:

T - The type of the entity view

Parameters:

entityViewClass - The entity view class that should be used for the object builder

Returns:

A new entity view setting

create

public static <T> EntityViewSetting<T,CriteriaBuilder<T>> create(Class<T> entityViewClass,
                                                 String viewConstructorName)

Creates a new EntityViewSetting that can be applied on criteria builders.

Type Parameters:

T - The type of the entity view

Parameters:

entityViewClass - The entity view class that should be used for the object builder

viewConstructorName - The name of the view constructor

Returns:

A new entity view setting

create

public static <T> EntityViewSetting<T,PaginatedCriteriaBuilder<T>> create(Class<T> entityViewClass,
                                                          int firstRow,
                                                          int maxRows)

Like create(java.lang.Class, int, int, java.lang.String) but with the viewConstructorname set to null.

Type Parameters:

T - The type of the entity view

Parameters:

entityViewClass - The entity view class that should be used for the object builder

firstRow - The position of the first result to retrieve, numbered from 0

maxRows - The maximum number of results to retrieve

Returns:

A new entity view setting

create

public static <T> EntityViewSetting<T,PaginatedCriteriaBuilder<T>> create(Class<T> entityViewClass,
                                                          Object entityId,
                                                          int maxRows)

Like create(java.lang.Class, java.lang.Object, int, java.lang.String) but with the viewConstructorname set to null.

Type Parameters:

T - The type of the entity view

Parameters:

entityViewClass - The entity view class that should be used for the object builder

entityId - The id of the entity which should be located on a page

maxRows - The maximum number of results to retrieve

Returns:

A new entity view setting

create

public static <T> EntityViewSetting<T,PaginatedCriteriaBuilder<T>> create(Class<T> entityViewClass,
                                                          int firstRow,
                                                          int maxRows,
                                                          String viewConstructorName)

Creates a new EntityViewSetting that can be applied on criteria builders.

Type Parameters:

T - The type of the entity view

Parameters:

entityViewClass - The entity view class that should be used for the object builder

firstRow - The position of the first result to retrieve, numbered from 0

maxRows - The maximum number of results to retrieve

viewConstructorName - The name of the view constructor

Returns:

A new entity view setting

create

public static <T> EntityViewSetting<T,PaginatedCriteriaBuilder<T>> create(Class<T> entityViewClass,
                                                          Object entityId,
                                                          int maxRows,
                                                          String viewConstructorName)

Creates a new EntityViewSetting that can be applied on criteria builders.

Type Parameters:

T - The type of the entity view

Parameters:

entityViewClass - The entity view class that should be used for the object builder

entityId - The id of the entity which should be located on a page

maxRows - The maximum number of results to retrieve

viewConstructorName - The name of the view constructor

Returns:

A new entity view setting

getEntityViewClass

public Class<T> getEntityViewClass()

Returns the entity view class.

Returns:

The entity view class

getViewConstructorName

public String getViewConstructorName()

Returns the entity view constructor name.

Returns:

The entity view constructor name

getEntityId

public Object getEntityId()

The id of the entity which should be located on the page returned result. Returns null if no pagination or a absolute first result will be applied.

Returns:

The id of the entity which should be located on a page

See Also:

FullQueryBuilder.page(java.lang.Object, int)

getFirstResult

public int getFirstResult()

The first result that the criteria builder should return. Returns 0 if no pagination will be applied. Returns -1 if an entity id was supplied.

Returns:

The first result

See Also:

FullQueryBuilder.page(int, int)

getMaxResults

public int getMaxResults()

The maximum number of results that the criteria builder should return. Returns Integer.MAX_VALUE if no pagination will be applied.

Returns:

The maximum number of results

See Also:

FullQueryBuilder.page(int, int)

isPaginated

public boolean isPaginated()

Returns true if this entiy view setting applies pagination, false otherwise.

Returns:

True if this entiy view setting applies pagination, false otherwise

getKeysetPage

public KeysetPage getKeysetPage()

Returns the key set of this setting.

Returns:

The key set of this setting

withKeysetPage

public EntityViewSetting<T,Q> withKeysetPage(KeysetPage keysetPage)

Sets the key set of this setting.

Parameters:

keysetPage - the new key set

Returns:

this setting for chaining

isKeysetPaginated

public boolean isKeysetPaginated()

Returns true if this setting is key set paginated.

Returns:

true if this setting is key set paginated

addAttributeSorters

public void addAttributeSorters(Map<String,Sorter> attributeSorters)

Adds the given attribute sorters to the attribute sorters of this setting. Note that the attribute sorter order is retained.

Parameters:

attributeSorters - The attribute sorters to add

addAttributeSorter

public void addAttributeSorter(String attributeName,
                      Sorter sorter)

Adds the given attribute sorter to the attribute sorters of this setting. Note that the attribute sorter order is retained.

Parameters:

attributeName - The name of the attribute sorter

sorter - The sorter for the attribute sorter

hasAttributeSorters

public boolean hasAttributeSorters()

Returns true if sorters have been added, otherwise false.

Returns:

true if sorters have been added, otherwise false

getAttributeSorters

public Map<String,Sorter> getAttributeSorters()

Returns a copy of the attribute sorters that have been added.

Returns:

The attribute sorters

addAttributeFilters

public void addAttributeFilters(Map<String,Object> attributeFilters)

Adds the given attribute filters to the attribute filters of this setting.

Parameters:

attributeFilters - The attribute filters to add

addAttributeFilter

public void addAttributeFilter(String attributeName,
                      Object filterValue)

Adds the given attribute filter to the attribute filters of this setting.

Parameters:

attributeName - The name of the attribute filter

filterValue - The filter value for the attribute filter

hasAttributeFilters

public boolean hasAttributeFilters()

Returns true if filters have been added, otherwise false.

Returns:

true if filters have been added, otherwise false

getAttributeFilters

public Map<String,Object> getAttributeFilters()

Returns a copy of the attribute filters that have been added.

Returns:

The attribute filters

addAttributeNamedFilter

public void addAttributeNamedFilter(String filterName)

Enables and adds the attribute filter with the given name in this setting.

Parameters:

filterName - The name of the attribute filter

hasAttributeNamedFilters

public boolean hasAttributeNamedFilters()

Returns true if named filters for attributes have been added, otherwise false.

Returns:

true if named filters for attributes have been added, otherwise false

getAttributeNamedFilters

public Set<String> getAttributeNamedFilters()

Returns a copy of the named filters for attributes that have been added.

Returns:

The named filters for attributes

addViewFilter

public void addViewFilter(String filterName)

Enables and adds the view filter with the given name in this setting.

Parameters:

filterName - The name of the view filter

hasViewFilters

public boolean hasViewFilters()

Returns true if named filters for the view have been added, otherwise false.

Returns:

true if named filters for the view have been added, otherwise false

getViewFilters

public Set<String> getViewFilters()

Returns a copy of the named filters for the view that have been added.

Returns:

The named filters for the view

addOptionalParameters

public void addOptionalParameters(Map<String,Object> optionalParameters)

Adds the given optional parameters to the optional parameters of this setting.

Parameters:

optionalParameters - The optional parameters to add

addOptionalParameter

public void addOptionalParameter(String parameterName,
                        Object value)

Adds the given optional parameter to the optional parameters of this setting.

Parameters:

parameterName - The name of the optional parameter

value - The value of the optional parameter

hasOptionalParameters

public boolean hasOptionalParameters()

Returns true if optional parameters have been added, otherwise false.

Returns:

true if optional parameters have been added, otherwise false

getOptionalParameters

public Map<String,Object> getOptionalParameters()

Returns a copy of the optional parameters that have been added.

Returns:

The optional parameters