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>, Supplier<Stream<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, David Madden

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, Sort.TypedSort<T>

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) Deprecated. since 2.3, use of(Attribute...) instead.
JpaSort(JpaSort.Path<?,?>... paths) Deprecated. since 2.3, use JpaSort#of(Path...)) instead.
JpaSort(Sort.Direction direction, javax.persistence.metamodel.Attribute<?,?>... attributes) Deprecated. since 2.3, use JpaSort#of(Direction, Attribute...) instead.
JpaSort(Sort.Direction direction, JpaSort.Path<?,?>... paths) Deprecated. since 2.3, use JpaSort#of(Direction, Path...) instead.

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 JpaSort	of(javax.persistence.metamodel.Attribute<?,?>... attributes) Creates a new JpaSort for the given attributes with the default sort direction.
static JpaSort	of(JpaSort.Path<?,?>... paths) Creates a new JpaSort instance with the given JpaSort.Paths.
static JpaSort	of(Sort.Direction direction, javax.persistence.metamodel.Attribute<?,?>... attributes) Creates a new JpaSort for the given direction and attributes.
static JpaSort	of(Sort.Direction direction, JpaSort.Path<?,?>... paths) Creates a new JpaSort for the given direction and JpaSort.Paths.
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, sort, 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

and, and, and, and, empty, filter, flatMap, get, isEmpty, map, of, of, of, stream, toList, toSet, toStreamable, toStreamable

Methods inherited from interface java.lang.Iterable

forEach, spliterator

Constructor Detail

JpaSort

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

Deprecated. since 2.3, use of(Attribute...) instead.

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

Parameters:

attributes - must not be null or empty.

JpaSort

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

Deprecated. since 2.3, use JpaSort#of(Path...)) instead.

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

Parameters:

paths - must not be null or empty.

JpaSort

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

Deprecated. since 2.3, use JpaSort#of(Direction, Attribute...) instead.

Creates a new JpaSort for the given direction and attributes.

Parameters:

direction - the sorting direction.

attributes - must not be null or empty.

JpaSort

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

Deprecated. since 2.3, use JpaSort#of(Direction, Path...) instead.

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

of

public static JpaSort of(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.

of

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

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

Parameters:

paths - must not be null or empty.

of

public static JpaSort of(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.

of

public static JpaSort of(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.

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: