Skip to content

Commit 8942271

Browse files
committed
Polishing.
Replace javadoc macros with absolute Javadoc links to skip inclusion verification. See: #3400
1 parent cbc9115 commit 8942271

File tree

1 file changed

+3
-3
lines changed

1 file changed

+3
-3
lines changed

src/main/antora/modules/ROOT/pages/property-paths.adoc

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -106,7 +106,7 @@ NOTE: For implementation details, refer to <<property-path-internals>> for more
106106
=== Property Path Internals
107107

108108
The {spring-data-commons-javadoc-base}/org/springframework/data/core/package-summary.html[`org.springframework.data.core`] package is the basis for Spring Data's navigation across domain classes.
109-
The javadoc:org.springframework.data.core.TypeInformation[] interface provides type introspection capable of resolving the type of a property. javadoc:org.springframework.data.core.PropertyPath[] represents a textual navigation path through a domain class.
109+
The {spring-data-commons-javadoc-base}/org/springframework/data/core/TypeInformation.java[`TypeInformation`] interface provides type introspection capable of resolving the type of a property. {spring-data-commons-javadoc-base}/org/springframework/data/core/PropertyPath.java[`PropertyPath`] represents a textual navigation path through a domain class.
110110

111111
Together they provide:
112112

@@ -121,7 +121,7 @@ Type-safe property-references eliminate a common source of errors in data access
121121
This section explains how method references can be used to express refactoring-safe property paths.
122122

123123
While a property path is a simple representation of object navigation, String-based property paths are inherently fragile during refactoring as they can be easily missed with an increasing distance between the property definition and its usage.
124-
Type-safe alternatives derive property paths from method references, enabling the compiler to validate property names and IDEs to support refactoring operations.
124+
Type-safe alternatives through {spring-data-commons-javadoc-base}/org/springframework/data/core/TypedPropertyPath.java[`TypedPropertyPath`] derive property paths from method references, enabling the compiler to validate property names and IDEs to support refactoring operations.
125125

126126
[tabs]
127127
======
@@ -194,7 +194,7 @@ TypedPropertyPath.of(Person::address / Address::city)
194194
When using (or building) APIs using type-safe property-references, consider the following recommendations:
195195

196196
* **Use method references**: Accept method references (e.g., `Person::getFirstName`) instead of strings to leverage compile-time validation and IDE refactoring support.
197-
Method references are preferred as they share similary representations with both Java and Kotlin.
197+
Method references are preferred as they share similar representations with both Java and Kotlin.
198198
Additionally, method references provide a better performance baseline compared to lambdas due to their simpler representation.
199199
* **Leverage the `T` type of `TypedPropertyPath`**: Whenever accepting a typed property path, consider using the generic type `T` of `TypedPropertyPath<T, P>`.
200200
Limiting property paths to a specific domain type that is used within the current operation reduces the potential of using unintended properties from other types. +

0 commit comments

Comments
 (0)