From bc866e3a061b307608dbf02e59cdb8c186406244 Mon Sep 17 00:00:00 2001
From: Mark Paluch <mpaluch@vmware.com>
Date: Fri, 1 Oct 2021 10:33:46 +0200
Subject: [PATCH] Polishing.

Add missing deprecation annotation. Fix since tags.

See #1053
Original pull request: #1060.
---
 .../mapping/event/AbstractRelationalEventListener.java    | 2 ++
 .../core/mapping/event/AfterConvertCallback.java          | 4 ++--
 .../relational/core/mapping/event/AfterConvertEvent.java  | 8 ++++----
 .../relational/core/mapping/event/AfterLoadEvent.java     | 4 ++--
 4 files changed, 10 insertions(+), 8 deletions(-)

diff --git a/spring-data-relational/src/main/java/org/springframework/data/relational/core/mapping/event/AbstractRelationalEventListener.java b/spring-data-relational/src/main/java/org/springframework/data/relational/core/mapping/event/AbstractRelationalEventListener.java
index dee5ae0e..a0eece89 100644
--- a/spring-data-relational/src/main/java/org/springframework/data/relational/core/mapping/event/AbstractRelationalEventListener.java
+++ b/spring-data-relational/src/main/java/org/springframework/data/relational/core/mapping/event/AbstractRelationalEventListener.java
@@ -114,6 +114,7 @@ public class AbstractRelationalEventListener<E> implements ApplicationListener<A
 	 * @param event will never be {@literal null}.
 	 * @deprecated use {@link #onAfterConvert(AfterConvertEvent)} instead.
 	 */
+	@Deprecated
 	protected void onAfterLoad(AfterLoadEvent<E> event) {
 
 		if (LOG.isDebugEnabled()) {
@@ -125,6 +126,7 @@ public class AbstractRelationalEventListener<E> implements ApplicationListener<A
 	 * Captures {@link AfterConvertEvent}.
 	 *
 	 * @param event will never be {@literal null}.
+	 * @since 2.3
 	 */
 	protected void onAfterConvert(AfterConvertEvent<E> event) {
 
diff --git a/spring-data-relational/src/main/java/org/springframework/data/relational/core/mapping/event/AfterConvertCallback.java b/spring-data-relational/src/main/java/org/springframework/data/relational/core/mapping/event/AfterConvertCallback.java
index f2ca2ec7..28389a07 100644
--- a/spring-data-relational/src/main/java/org/springframework/data/relational/core/mapping/event/AfterConvertCallback.java
+++ b/spring-data-relational/src/main/java/org/springframework/data/relational/core/mapping/event/AfterConvertCallback.java
@@ -1,5 +1,5 @@
 /*
- * Copyright 2019-2021 the original author or authors.
+ * Copyright 2021 the original author or authors.
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -21,7 +21,7 @@ import org.springframework.data.mapping.callback.EntityCallback;
  * An {@link EntityCallback} that gets invoked after an aggregate was converted from the database into an entity.
  *
  * @author Jens Schauder
- * @since 2.6
+ * @since 2.3
  */
 @FunctionalInterface
 public interface AfterConvertCallback<T> extends EntityCallback<T> {
diff --git a/spring-data-relational/src/main/java/org/springframework/data/relational/core/mapping/event/AfterConvertEvent.java b/spring-data-relational/src/main/java/org/springframework/data/relational/core/mapping/event/AfterConvertEvent.java
index c47b003b..2de9c71c 100644
--- a/spring-data-relational/src/main/java/org/springframework/data/relational/core/mapping/event/AfterConvertEvent.java
+++ b/spring-data-relational/src/main/java/org/springframework/data/relational/core/mapping/event/AfterConvertEvent.java
@@ -1,5 +1,5 @@
 /*
- * Copyright 2017-2021 the original author or authors.
+ * Copyright 2021 the original author or authors.
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -16,11 +16,11 @@
 package org.springframework.data.relational.core.mapping.event;
 
 /**
- * Gets published after instantiation and setting of all the properties of an entity. This allows to do some
- * postprocessing of entities if the entities are mutable. For immutable entities use {@link AfterConvertCallback}.
+ * Gets published after instantiation and setting of all the properties of an entity. If you want to mutate an entity
+ * after loading, use {@link AfterConvertCallback}.
  *
  * @author Jens Schauder
- * @since 2.6
+ * @since 2.3
  */
 public class AfterConvertEvent<E> extends RelationalEventWithEntity<E> {
 
diff --git a/spring-data-relational/src/main/java/org/springframework/data/relational/core/mapping/event/AfterLoadEvent.java b/spring-data-relational/src/main/java/org/springframework/data/relational/core/mapping/event/AfterLoadEvent.java
index c1a03468..8c343ea7 100644
--- a/spring-data-relational/src/main/java/org/springframework/data/relational/core/mapping/event/AfterLoadEvent.java
+++ b/spring-data-relational/src/main/java/org/springframework/data/relational/core/mapping/event/AfterLoadEvent.java
@@ -16,8 +16,8 @@
 package org.springframework.data.relational.core.mapping.event;
 
 /**
- * Gets published after instantiation and setting of all the properties of an entity. This allows to do some
- * postprocessing of entities if the entities are mutable. For immutable entities use {@link AfterLoadCallback}.
+ * Gets published after instantiation and setting of all the properties of an entity. If you want to mutate an entity
+ * after loading, use {@link AfterConvertCallback}.
  *
  * @author Jens Schauder
  * @deprecated Use {@link AfterConvertEvent} instead.