Deprecate PagedListHolder and PropertyComparator for removal

Closes spring-projectsgh-36139

Author: jhoeller

spring-beans/src/main/java/org/springframework/beans/support/MutableSortDefinition.java

@@ -30,8 +30,11 @@
  * @author Jean-Pierre Pawlak
  * @since 26.05.2003
  * @see #setToggleAscendingOnProperty
+ * @deprecated as severely outdated and superseded by more modern solutions,
+ * for example in Spring Data Commons
  */
-@SuppressWarnings("serial")
+@Deprecated(since = "7.0.3", forRemoval = true)
+@SuppressWarnings({"removal", "serial"})
 public class MutableSortDefinition implements SortDefinition, Serializable {
 
 	private String property = "";

spring-beans/src/main/java/org/springframework/beans/support/PagedListHolder.java

@@ -49,9 +49,11 @@
  * @since 19.05.2003
  * @param <E> the element type
  * @see #getPageList()
- * @see org.springframework.beans.support.MutableSortDefinition
+ * @deprecated as severely outdated and superseded by more modern solutions,
+ * for example in Spring Data Commons
  */
-@SuppressWarnings("serial")
+@Deprecated(since = "7.0.3", forRemoval = true)
+@SuppressWarnings({"removal", "serial"})
 public class PagedListHolder<E> implements Serializable {
 
 	/**

spring-beans/src/main/java/org/springframework/beans/support/PropertyComparator.java

@@ -38,7 +38,11 @@
  * @since 19.05.2003
  * @param <T> the type of objects that may be compared by this comparator
  * @see org.springframework.beans.BeanWrapper
+ * @deprecated as severely outdated and superseded by more modern solutions,
+ * for example in Spring Data Commons
  */
+@Deprecated(since = "7.0.3", forRemoval = true)
+@SuppressWarnings("removal")
 public class PropertyComparator<T> implements Comparator<T> {
 
 	protected final Log logger = LogFactory.getLog(getClass());

spring-beans/src/main/java/org/springframework/beans/support/SortDefinition.java

@@ -21,7 +21,10 @@
  *
  * @author Juergen Hoeller
  * @since 26.05.2003
+ * @deprecated as severely outdated and superseded by more modern solutions,
+ * for example in Spring Data Commons
  */
+@Deprecated(since = "7.0.3", forRemoval = true)
 public interface SortDefinition {
 
 	/**

spring-beans/src/test/java/org/springframework/beans/support/PagedListHolderTests.java

@@ -32,6 +32,8 @@
  * @author Chris Beams
  * @since 20.05.2003
  */
+@Deprecated(since = "7.0.3", forRemoval = true)
+@SuppressWarnings("removal")
 class PagedListHolderTests {
 
 	@Test

spring-beans/src/test/java/org/springframework/beans/support/PropertyComparatorTests.java

@@ -28,6 +28,8 @@
  * @author Keith Donald
  * @author Chris Beams
  */
+@Deprecated(since = "7.0.3", forRemoval = true)
+@SuppressWarnings("removal")
 class PropertyComparatorTests {
 
 	@Test