Issue #1498: Deprecate the implementations of the clone method. (#1500)

Author: thboileau

changes.md

@@ -5,8 +5,9 @@ Changes log
     - Bugs fixed
         - Reuse an instance of Random class in RandomUtils. Issue #1487.
         - Complete test classes. Issue #1490.
-        - Avoid non-short-circuit logic in FileClientHelper. Issue #1495.
-- 
+        - Deprecate the implementations of the clone method. Issue #1498.
+        - Avoid non-short-circuit logic in FileClientHelper. Issue #1495. 
+
 - 2.6.0 (29-06-2025)
 
 - 2.6 Release Candidate 2 (21-06-2025)

org.restlet.gwt/org.restlet.gwt/src/main/java/org/restlet/client/engine/util/ImmutableDate.java

@@ -38,7 +38,7 @@ public ImmutableDate(Date date) {
 
 	/** {@inheritDoc} */
 	@Override
-	public Object clone() {
+	public Object clone() throws UnsupportedOperationException {
 		throw new UnsupportedOperationException("ImmutableDate is immutable");
 	}
 

org.restlet.java/org.restlet/src/main/java/org/restlet/data/Reference.java

@@ -638,16 +638,24 @@ public Reference addSegment(String value) {
 		return this;
 	}
 
+	/**
+	 * @deprecated Use the {@code copy} method instead.
+	 */
 	@Override
+	@Deprecated
 	public Reference clone() {
+		return copy();
+	}
+
+	public Reference copy() {
 		final Reference newRef = new Reference();
 
 		if (this.baseRef == null) {
 			newRef.baseRef = null;
 		} else if (equals(this.baseRef)) {
 			newRef.baseRef = newRef;
 		} else {
-			newRef.baseRef = this.baseRef.clone();
+			newRef.baseRef = this.baseRef.copy();
 		}
 
 		newRef.fragmentIndex = this.fragmentIndex;