This is an automated email from the ASF dual-hosted git repository. ahuber pushed a commit to branch CAUSEWAY-3955 in repository https://gitbox.apache.org/repos/asf/causeway.git
commit f9358ec22def45bbd54339505cf3a146a520dcae Author: andi-huber <[email protected]> AuthorDate: Thu Jan 15 13:00:21 2026 +0100 CAUSEWAY-3955: [v2] adds java doc to ease migration --- .../main/java/org/apache/causeway/applib/Identifier.java | 15 +++++++++++++++ .../org/apache/causeway/applib/id/HasLogicalType.java | 6 ++++++ .../java/org/apache/causeway/applib/id/LogicalType.java | 9 +++++++++ .../applib/value/semantics/ValueSemanticsProvider.java | 8 ++++++++ .../core/metamodel/spec/HasObjectSpecification.java | 11 ++++++++++- 5 files changed, 48 insertions(+), 1 deletion(-) diff --git a/api/applib/src/main/java/org/apache/causeway/applib/Identifier.java b/api/applib/src/main/java/org/apache/causeway/applib/Identifier.java index 00a93b4332b..400262332f5 100644 --- a/api/applib/src/main/java/org/apache/causeway/applib/Identifier.java +++ b/api/applib/src/main/java/org/apache/causeway/applib/Identifier.java @@ -331,22 +331,37 @@ private static Can<String> naturalNames(final Can<String> names) { // -- DEPRECATIONS + /** + * @deprecated use {@link #logicalType()} instead + */ @Deprecated(forRemoval = true) public final LogicalType getLogicalType() { return logicalType(); } + /** + * @deprecated use {@link #memberLogicalName()} instead + */ @Deprecated(forRemoval = true) public final String getMemberLogicalName() { return memberLogicalName(); } + /** + * @deprecated use {@link #memberParameterClassNames()} instead + */ @Deprecated(forRemoval = true) public final Can<String> getMemberParameterClassNames() { return memberParameterClassNames(); } + /** + * @deprecated use {@link #type()} instead + */ @Deprecated(forRemoval = true) public final Type getType() { return type(); } + /** + * @deprecated use {@link #parameterIndex()} instead + */ @Deprecated(forRemoval = true) public final int getParameterIndex() { return parameterIndex(); diff --git a/api/applib/src/main/java/org/apache/causeway/applib/id/HasLogicalType.java b/api/applib/src/main/java/org/apache/causeway/applib/id/HasLogicalType.java index 29e72b741b4..6d69066e0d9 100644 --- a/api/applib/src/main/java/org/apache/causeway/applib/id/HasLogicalType.java +++ b/api/applib/src/main/java/org/apache/causeway/applib/id/HasLogicalType.java @@ -38,11 +38,17 @@ public interface HasLogicalType { // -- DEPRECATIONS + /** + * @deprecated use {@link #logicalType()} instead + */ @Deprecated(forRemoval = true) default LogicalType getLogicalType() { return logicalType(); } + /** + * @deprecated use {@link #logicalTypeName()} instead + */ @Deprecated(forRemoval = true) default String getLogicalTypeName() { return logicalTypeName(); diff --git a/api/applib/src/main/java/org/apache/causeway/applib/id/LogicalType.java b/api/applib/src/main/java/org/apache/causeway/applib/id/LogicalType.java index 782b043adb1..5a57ad167a2 100644 --- a/api/applib/src/main/java/org/apache/causeway/applib/id/LogicalType.java +++ b/api/applib/src/main/java/org/apache/causeway/applib/id/LogicalType.java @@ -318,16 +318,25 @@ private Object readResolve() { // -- DEPRECATIONS + /** + * @deprecated use {@link #logicalName()} instead + */ @Deprecated(forRemoval = true) public final String getLogicalTypeName() { return logicalName(); } + /** + * @deprecated use {@link #correspondingClass()} instead + */ @Deprecated(forRemoval = true) public final Class<?> getCorrespondingClass() { return correspondingClass(); } + /** + * @deprecated use {@link #className()} instead + */ @Deprecated(forRemoval = true) public String getClassName() { return className(); diff --git a/api/applib/src/main/java/org/apache/causeway/applib/value/semantics/ValueSemanticsProvider.java b/api/applib/src/main/java/org/apache/causeway/applib/value/semantics/ValueSemanticsProvider.java index b942eaec2d5..ae50225f1df 100644 --- a/api/applib/src/main/java/org/apache/causeway/applib/value/semantics/ValueSemanticsProvider.java +++ b/api/applib/src/main/java/org/apache/causeway/applib/value/semantics/ValueSemanticsProvider.java @@ -59,8 +59,16 @@ public interface ValueSemanticsProvider<T> { class Context { private final @Nullable Identifier featureIdentifier; private final @Nullable InteractionContext interactionContext; + + /** + * @deprecated use {@link #featureIdentifier()} instead + */ @Deprecated(forRemoval = true) // replaced by a record in future versions public final @Nullable Identifier getFeatureIdentifier() { return featureIdentifier; } + + /** + * @deprecated use {@link #interactionContext()} instead + */ @Deprecated(forRemoval = true) // replaced by a record in future versions public final @Nullable InteractionContext getInteractionContext() { return interactionContext; } } diff --git a/core/metamodel/src/main/java/org/apache/causeway/core/metamodel/spec/HasObjectSpecification.java b/core/metamodel/src/main/java/org/apache/causeway/core/metamodel/spec/HasObjectSpecification.java index 0a5efe8c034..46e41222c89 100644 --- a/core/metamodel/src/main/java/org/apache/causeway/core/metamodel/spec/HasObjectSpecification.java +++ b/core/metamodel/src/main/java/org/apache/causeway/core/metamodel/spec/HasObjectSpecification.java @@ -60,17 +60,26 @@ default Bookmark createBookmark(final @NonNull String urlSafeIdentifier) { // -- DEPRECATIONS + /** + * @deprecated use {@link #objSpec()} instead + */ @Deprecated(forRemoval = true) default ObjectSpecification getSpecification() { return objSpec(); } + /** + * @deprecated use {@link #logicalType()} instead + */ @Deprecated(forRemoval = true) default LogicalType getLogicalType() { return logicalType(); } + /** + * @deprecated use {@link #logicalTypeName()} instead + */ @Deprecated(forRemoval = true) default String getLogicalTypeName() { - return getSpecification().logicalTypeName(); + return logicalTypeName(); } }
