Skip to content

Commit 66669fa

Browse files
committed
Polishing.
Refine antora documentation keys. See #3952
1 parent 1e49675 commit 66669fa

File tree

2 files changed

+7
-5
lines changed

2 files changed

+7
-5
lines changed

src/main/antora/modules/ROOT/pages/jpa/entity-persistence.adoc

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -19,7 +19,8 @@ Spring Data JPA offers the following strategies to detect whether an entity is n
1919
If the identifier property is `null`, then the entity is assumed to be new.
2020
Otherwise, it is assumed to be not new.
2121
In contrast to other Spring Data modules, JPA considers `0` (zero) as the first inserted version of an entity and therefore, a primitive version property cannot be used to determine whether an entity is new or not.
22-
2. Implementing `Persistable`: If an entity implements `Persistable`, Spring Data JPA delegates the new detection to the `isNew(…)` method of the entity. See the link:$$https://docs.spring.io/spring-data/data-commons/docs/current/api/index.html?org/springframework/data/domain/Persistable.html$$[JavaDoc] for details.
22+
2. Implementing `Persistable`: If an entity implements `Persistable`, Spring Data JPA delegates the new detection to the `isNew(…)` method of the entity.
23+
See the link:{spring-data-commons-javadoc-base}/org/springframework/data/domain/Persistable.html[JavaDoc] for details.
2324
3. Implementing `EntityInformation`: You can customize the `EntityInformation` abstraction used in the `SimpleJpaRepository` implementation by creating a subclass of `JpaRepositoryFactory` and overriding the `getEntityInformation(…)` method accordingly. You then have to register the custom implementation of `JpaRepositoryFactory` as a Spring bean. Note that this should be rarely necessary. See the javadoc:org.springframework.data.jpa.repository.support.JpaRepositoryFactory[JavaDoc] for details.
2425

2526
Option 1 is not an option for entities that use manually assigned identifiers and no version attribute as with those the identifier will always be non-`null`.

src/main/antora/resources/antora-resources/antora.yml

Lines changed: 5 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -3,18 +3,19 @@ prerelease: ${antora-component.prerelease}
33

44
asciidoc:
55
attributes:
6+
attribute-missing: 'warn'
7+
chomp: 'all'
68
version: ${project.version}
79
copyright-year: ${current.year}
810
springversionshort: ${spring.short}
911
springversion: ${spring}
10-
attribute-missing: 'warn'
1112
commons: ${springdata.commons.docs}
1213
include-xml-namespaces: false
13-
spring-data-commons-docs-url: https://docs.spring.io/spring-data/commons/reference
14-
spring-data-commons-javadoc-base: https://docs.spring.io/spring-data/commons/docs/${springdata.commons}/api/
14+
spring-data-commons-docs-url: https://docs.spring.io/spring-data/commons/reference/{commons}
15+
spring-data-commons-javadoc-base: '{spring-data-commons-docs-url}/api/java'
1516
springdocsurl: https://docs.spring.io/spring-framework/reference/{springversionshort}
16-
springjavadocurl: https://docs.spring.io/spring-framework/docs/${spring}/javadoc-api
1717
spring-framework-docs: '{springdocsurl}'
18+
springjavadocurl: https://docs.spring.io/spring-framework/docs/${spring}/javadoc-api
1819
spring-framework-javadoc: '{springjavadocurl}'
1920
springhateoasversion: ${spring-hateoas}
2021
hibernatejavadocurl: https://docs.jboss.org/hibernate/orm/6.6/javadocs/

0 commit comments

Comments
 (0)