org.springframework.data.jpa.domain

Class JpaSort

java.lang.Object

org.springframework.data.domain.Sort

org.springframework.data.jpa.domain.JpaSort

All Implemented Interfaces:

Serializable, Iterable<Sort.Order>, Streamable<Sort.Order>

public class JpaSort
extends Sort

Sort option for queries that wraps JPA meta-model Attributes for sorting.

Author:

Thomas Darimont, Oliver Gierke, Christoph Strobl

See Also:

Serialized Form

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	JpaSort.JpaOrder Custom Order that keeps a flag to indicate unsafe property handling, i.e. the String provided is not necessarily a property but can be an arbitrary expression piped into the query execution.
static class	JpaSort.Path<T,S> Value object to abstract a collection of Attributes.

Nested classes/interfaces inherited from class org.springframework.data.domain.Sort

Sort.Direction, Sort.NullHandling, Sort.Order

Field Summary

Fields inherited from class org.springframework.data.domain.Sort

DEFAULT_DIRECTION

Constructor Summary

Constructors

Constructor and Description
JpaSort(javax.persistence.metamodel.Attribute<?,?>... attributes) Creates a new JpaSort for the given attributes with the default sort direction.
JpaSort(JpaSort.Path<?,?>... paths) Creates a new JpaSort instance with the given JpaSort.Paths.
JpaSort(Sort.Direction direction, javax.persistence.metamodel.Attribute<?,?>... attributes) Creates a new JpaSort for the given direction and attributes.
JpaSort(Sort.Direction direction, JpaSort.Path<?,?>... paths) Creates a new JpaSort for the given direction and JpaSort.Paths.

Method Summary

Modifier and Type	Method and Description
JpaSort	and(Sort.Direction direction, javax.persistence.metamodel.Attribute<?,?>... attributes) Returns a new JpaSort with the given sorting criteria added to the current one.
JpaSort	and(Sort.Direction direction, JpaSort.Path<?,?>... paths) Returns a new JpaSort with the given sorting criteria added to the current one.
JpaSort	andUnsafe(Sort.Direction direction, String... properties) Returns a new JpaSort with the given sorting criteria added to the current one.
static <A extends javax.persistence.metamodel.Attribute<T,S>,T,S> JpaSort.Path<T,S>	path(A attribute) Creates a new JpaSort.Path for the given Attribute.
static <P extends javax.persistence.metamodel.PluralAttribute<T,?,S>,T,S> JpaSort.Path<T,S>	path(P attribute) Creates a new JpaSort.Path for the given PluralAttribute.
static JpaSort	unsafe(Sort.Direction direction, List<String> properties) Creates new unsafe JpaSort based on given Direction and properties.
static JpaSort	unsafe(Sort.Direction direction, String... properties) Creates new unsafe JpaSort based on given Direction and properties.
static JpaSort	unsafe(String... properties) Creates new unsafe JpaSort based on given properties.

Methods inherited from class org.springframework.data.domain.Sort

and, ascending, by, by, by, by, descending, equals, getOrderFor, hashCode, isSorted, isUnsorted, iterator, toString, unsorted

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.springframework.data.util.Streamable

empty, filter, flatMap, map, of, of, of, stream

Methods inherited from interface java.lang.Iterable

forEach, spliterator

Constructor Detail

JpaSort

public JpaSort(javax.persistence.metamodel.Attribute<?,?>... attributes)

Creates a new JpaSort for the given attributes with the default sort direction.

Parameters:

attributes - must not be null or empty.

JpaSort

public JpaSort(JpaSort.Path<?,?>... paths)

Creates a new JpaSort instance with the given JpaSort.Paths.

Parameters:

paths - must not be null or empty.

JpaSort

public JpaSort(Sort.Direction direction,
               javax.persistence.metamodel.Attribute<?,?>... attributes)

Creates a new JpaSort for the given direction and attributes.

Parameters:

direction - the sorting direction.

attributes - must not be null or empty.

JpaSort

public JpaSort(Sort.Direction direction,
               JpaSort.Path<?,?>... paths)

Creates a new JpaSort for the given direction and JpaSort.Paths.

Parameters:

direction - the sorting direction.

paths - must not be null or empty.

Method Detail

and

public JpaSort and(@Nullable
                   Sort.Direction direction,
                   javax.persistence.metamodel.Attribute<?,?>... attributes)

Returns a new JpaSort with the given sorting criteria added to the current one.

Parameters:

direction - can be null.

attributes - must not be null.

Returns:

and

public JpaSort and(@Nullable
                   Sort.Direction direction,
                   JpaSort.Path<?,?>... paths)

Returns a new JpaSort with the given sorting criteria added to the current one.

Parameters:

direction - can be null.

paths - must not be null.

Returns:

andUnsafe

public JpaSort andUnsafe(@Nullable
                         Sort.Direction direction,
                         String... properties)

Returns a new JpaSort with the given sorting criteria added to the current one.

Parameters:

direction - can be null.

properties - must not be null or empty.

Returns:

path

public static <A extends javax.persistence.metamodel.Attribute<T,S>,T,S> JpaSort.Path<T,S> path(A attribute)

Creates a new JpaSort.Path for the given Attribute.

Parameters:

attribute - must not be null.

Returns:

path

public static <P extends javax.persistence.metamodel.PluralAttribute<T,?,S>,T,S> JpaSort.Path<T,S> path(P attribute)

Creates a new JpaSort.Path for the given PluralAttribute.

Parameters:

attribute - must not be null.

Returns:

unsafe

public static JpaSort unsafe(String... properties)

Creates new unsafe JpaSort based on given properties.

Parameters:

properties - must not be null or empty.

Returns:

unsafe

public static JpaSort unsafe(Sort.Direction direction,
                             String... properties)

Creates new unsafe JpaSort based on given Direction and properties.

Parameters:

direction - must not be null.

properties - must not be null or empty.

Returns:

unsafe

public static JpaSort unsafe(Sort.Direction direction,
                             List<String> properties)

Creates new unsafe JpaSort based on given Direction and properties.

Parameters:

direction - must not be null.

properties - must not be null or empty.

Returns: