Skip to content

Commit 2f521ef

Browse files
committed
Point to docs.hibernate.org instead of docs.jboss.org/hibernate in various docs
1 parent 794eea1 commit 2f521ef

File tree

33 files changed

+89
-89
lines changed

33 files changed

+89
-89
lines changed

design/working/6.0-posts.adoc

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
Steve Ebersole
33
:awestruct-tags: ["Hibernate ORM"]
44
:awestruct-layout: blog-post
5-
:docs-url: https://docs.jboss.org/hibernate/orm/6.0
5+
:docs-url: https://docs.hibernate.org/orm/6.0
66
:javadocs-url: {docs-url}/javadocs
77
:migration-guide-url: {docs-url}/migration-guide/migration-guide.html
88
:user-guide-url: {docs-url}/userguide/html_single/Hibernate_User_Guide.html

documentation/src/main/asciidoc/querylanguage/Expressions.adoc

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -763,7 +763,7 @@ Recognized Field types are listed below.
763763
| `offset minute` | `Integer` | 0-59 | Minutes of offset | ✖
764764
|===
765765

766-
For a full list of field types, see the Javadoc for https://docs.jboss.org/hibernate/orm/{majorMinorVersion}/javadocs/org/hibernate/query/TemporalUnit.html[`TemporalUnit`].
766+
For a full list of field types, see the Javadoc for https://docs.hibernate.org/orm/{majorMinorVersion}/javadocs/org/hibernate/query/TemporalUnit.html[`TemporalUnit`].
767767

768768
[source, hql]
769769
----
@@ -811,7 +811,7 @@ The pattern must be written in a subset of the pattern language defined by Java'
811811
select format(local datetime as 'yyyy-MM-dd HH:mm:ss')
812812
----
813813

814-
For a full list of `format()` pattern elements, see the Javadoc for https://docs.jboss.org/hibernate/orm/{majorMinorVersion}/javadocs/org/hibernate/dialect/Dialect.html#appendDatetimeFormat[`Dialect.appendDatetimeFormat`].
814+
For a full list of `format()` pattern elements, see the Javadoc for https://docs.hibernate.org/orm/{majorMinorVersion}/javadocs/org/hibernate/dialect/Dialect.html#appendDatetimeFormat[`Dialect.appendDatetimeFormat`].
815815

816816
[[function-trunc-datetime]]
817817
[discrete]

documentation/src/main/asciidoc/shared/url-attributes.adoc

Lines changed: 10 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -4,21 +4,21 @@
44

55
include::./common-attributes.adoc[]
66

7-
:doc-base-url: https://docs.jboss.org/hibernate/orm
7+
:doc-base-url: https://docs.hibernate.org/orm
88
:doc-version-base-url: {doc-base-url}/{majorMinorVersion}
9-
:doc-migration-guide-url: {doc-version-base-url}/migration-guide/migration-guide.html
9+
:doc-migration-guide-url: {doc-version-base-url}/migration-guide/
1010
:doc-quick-start-url: {doc-version-base-url}/quickstart/html_single/
11-
:doc-query-language-url: {doc-version-base-url}/querylanguage/html_single/Hibernate_Query_Language.html
12-
:doc-introduction-url: {doc-version-base-url}/introduction/html_single/Hibernate_Introduction.html
13-
:doc-data-repositories-url: {doc-version-base-url}/repositories/html_single/Hibernate_Data_Repositories.html
14-
:doc-user-guide-url: {doc-version-base-url}/userguide/html_single/Hibernate_User_Guide.html
11+
:doc-query-language-url: {doc-version-base-url}/querylanguage/html_single/
12+
:doc-introduction-url: {doc-version-base-url}/introduction/html_single/
13+
:doc-data-repositories-url: {doc-version-base-url}/repositories/html_single/
14+
:doc-user-guide-url: {doc-version-base-url}/userguide/html_single/
1515
:doc-javadoc-url: {doc-version-base-url}/javadocs/
1616
:doc-topical-url: {doc-version-base-url}/topical/html_single/
17-
:doc-registries-url: {doc-topical-url}/registries/ServiceRegistries.html
18-
:doc-logging-url: {doc-topical-url}/logging/Logging.html
19-
:doc-dialect-url: {doc-version-base-url}/dialect/dialect.html
17+
:doc-registries-url: {doc-topical-url}/registries/
18+
:doc-logging-url: {doc-topical-url}/logging/
19+
:doc-dialect-url: {doc-version-base-url}/dialect/
2020

2121
:report-deprecation-url: {doc-version-base-url}/deprecated/deprecating.txt
2222
:report-incubating-url: {doc-version-base-url}/incubating/incubating.txt
2323
:report-internals-url: {doc-version-base-url}/internals/internal.txt
24-
:report-logging-url: {doc-version-base-url}/logging/logging.html
24+
:report-logging-url: {doc-version-base-url}/logging/

documentation/src/main/asciidoc/userguide/appendices/LegacyBasicTypeResolution.adoc

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -122,7 +122,7 @@ But first, let's explore how implicit resolution works and how applications can
122122
====
123123
A thorough discussion of `BasicTypeRegistry` and all the different ways to contribute types is beyond the scope of this documentation.
124124
125-
Please see the http://docs.jboss.org/hibernate/orm/{majorMinorVersion}/integrationguide/html_single/Hibernate_Integration_Guide.html[Integration Guide] for complete details.
125+
Please see the http://docs.hibernate.org/orm/{majorMinorVersion}/integrationguide/html_single/Hibernate_Integration_Guide.html[Integration Guide] for complete details.
126126
====
127127

128128
As an example, take a String attribute such as we saw before with Product#sku.
@@ -319,4 +319,4 @@ When running the previous test case against the `BitSetUserType` entity mapping,
319319
----
320320
include::{originalextrasdir}/basic/basic-custom-type-BitSetUserType-persistence-sql-example.sql[]
321321
----
322-
====
322+
====

documentation/src/main/asciidoc/userguide/chapters/caching/Caching.adoc

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -39,7 +39,7 @@ Besides provider specific configuration, there are a number of configurations op
3939

4040
`hibernate.cache.use_second_level_cache`::
4141
Enable or disable second level caching overall. By default, if the currently configured
42-
https://docs.jboss.org/hibernate/orm/{majorMinorVersion}/javadocs/org/hibernate/cache/spi/RegionFactory.html[`RegionFactory`] is not the `NoCachingRegionFactory`, then the second-level cache is going to be enabled. Otherwise, the second-level cache is disabled.
42+
https://docs.hibernate.org/orm/{majorMinorVersion}/javadocs/org/hibernate/cache/spi/RegionFactory.html[`RegionFactory`] is not the `NoCachingRegionFactory`, then the second-level cache is going to be enabled. Otherwise, the second-level cache is disabled.
4343
`hibernate.cache.use_query_cache`::
4444
Enable or disable second level caching of query results. The default is false.
4545
`hibernate.cache.query_cache_factory`::
@@ -120,7 +120,7 @@ transactional::
120120
====
121121
Rather than using a global setting, it is recommended to define the cache concurrency strategy on a per entity basis.
122122
123-
Use the https://docs.jboss.org/hibernate/orm/{majorMinorVersion}/javadocs/org/hibernate/annotations/Cache.html[`@org.hibernate.annotations.Cache`] annotation for this purpose.
123+
Use the https://docs.hibernate.org/orm/{majorMinorVersion}/javadocs/org/hibernate/annotations/Cache.html[`@org.hibernate.annotations.Cache`] annotation for this purpose.
124124
====
125125

126126
The `@Cache` annotation define three attributes:
@@ -377,7 +377,7 @@ include::{example-dir-caching}/SecondLevelCacheTest.java[tags=caching-query-regi
377377

378378
[NOTE]
379379
====
380-
When using {jpaJavadocUrlPrefix}CacheStoreMode.html#REFRESH[`CacheStoreMode.REFRESH`] or https://docs.jboss.org/hibernate/orm/{majorMinorVersion}/javadocs/org/hibernate/CacheMode.html#REFRESH[`CacheMode.REFRESH`] in conjunction with the region you have defined for the given query,
380+
When using {jpaJavadocUrlPrefix}CacheStoreMode.html#REFRESH[`CacheStoreMode.REFRESH`] or https://docs.hibernate.org/orm/{majorMinorVersion}/javadocs/org/hibernate/CacheMode.html#REFRESH[`CacheMode.REFRESH`] in conjunction with the region you have defined for the given query,
381381
Hibernate will selectively force the results cached in that particular region to be refreshed.
382382
383383
This behavior is particularly useful in cases when the underlying data may have been updated via a separate process
@@ -419,7 +419,7 @@ by placing the annotation on the entity class or the persistent collection attri
419419
[[caching-management]]
420420
=== Managing the cached data
421421

422-
Traditionally, Hibernate defined the https://docs.jboss.org/hibernate/orm/{majorMinorVersion}/javadocs/org/hibernate/CacheMode.html[`CacheMode`] enumeration to describe
422+
Traditionally, Hibernate defined the https://docs.hibernate.org/orm/{majorMinorVersion}/javadocs/org/hibernate/CacheMode.html[`CacheMode`] enumeration to describe
423423
the ways of interactions with the cached data.
424424
Jakarta Persistence split cache modes by storage ({jpaJavadocUrlPrefix}CacheStoreMode.html[`CacheStoreMode`])
425425
and retrieval ({jpaJavadocUrlPrefix}CacheRetrieveMode.html[`CacheRetrieveMode`]).
@@ -495,7 +495,7 @@ include::{example-dir-caching}/SecondLevelCacheTest.java[tags=caching-management
495495
====
496496

497497
Hibernate is much more flexible in this regard as it offers fine-grained control over what needs to be evicted.
498-
The https://docs.jboss.org/hibernate/orm/{majorMinorVersion}/javadocs/org/hibernate/Cache.html[`org.hibernate.Cache`] interface defines various evicting strategies:
498+
The https://docs.hibernate.org/orm/{majorMinorVersion}/javadocs/org/hibernate/Cache.html[`org.hibernate.Cache`] interface defines various evicting strategies:
499499

500500
- entities (by their class or region)
501501
- entities stored using the natural-id (by their class or region)
@@ -518,7 +518,7 @@ If you enable the `hibernate.generate_statistics` configuration property,
518518
Hibernate will expose a number of metrics via `SessionFactory.getStatistics()`.
519519
Hibernate can even be configured to expose these statistics via JMX.
520520

521-
This way, you can get access to the https://docs.jboss.org/hibernate/orm/{majorMinorVersion}/javadocs/org/hibernate/stat/Statistics.html[`Statistics`] class which comprises all sort of
521+
This way, you can get access to the https://docs.hibernate.org/orm/{majorMinorVersion}/javadocs/org/hibernate/stat/Statistics.html[`Statistics`] class which comprises all sort of
522522
second-level cache metrics.
523523

524524
[[caching-statistics-example]]

documentation/src/main/asciidoc/userguide/chapters/domain/associations.adoc

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -756,7 +756,7 @@ include::{extrasdir}/associations-many-to-any-example.sql[]
756756
[[associations-JoinFormula]]
757757
==== `@JoinFormula` mapping
758758

759-
The https://docs.jboss.org/hibernate/orm/{majorMinorVersion}/javadocs/org/hibernate/annotations/JoinFormula.html[`@JoinFormula`] annotation is used to customize the join between a child Foreign Key and a parent row Primary Key.
759+
The https://docs.hibernate.org/orm/{majorMinorVersion}/javadocs/org/hibernate/annotations/JoinFormula.html[`@JoinFormula`] annotation is used to customize the join between a child Foreign Key and a parent row Primary Key.
760760

761761
[[associations-JoinFormula-example]]
762762
.`@JoinFormula` mapping usage
@@ -806,7 +806,7 @@ Therefore, the `@JoinFormula` annotation is used to define a custom join associa
806806
[[associations-JoinColumnOrFormula]]
807807
==== `@JoinColumnOrFormula` mapping
808808

809-
The https://docs.jboss.org/hibernate/orm/{majorMinorVersion}/javadocs/org/hibernate/annotations/JoinColumnOrFormula.html[`@JoinColumnOrFormula`] annotation is used to customize the join between a child Foreign Key and a parent row Primary Key when we need to take into consideration a column value as well as a `@JoinFormula`.
809+
The https://docs.hibernate.org/orm/{majorMinorVersion}/javadocs/org/hibernate/annotations/JoinColumnOrFormula.html[`@JoinColumnOrFormula`] annotation is used to customize the join between a child Foreign Key and a parent row Primary Key when we need to take into consideration a column value as well as a `@JoinFormula`.
810810

811811
[[associations-JoinColumnOrFormula-example]]
812812
.`@JoinColumnOrFormula` mapping usage

documentation/src/main/asciidoc/userguide/chapters/domain/basic_types.adoc

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -2023,7 +2023,7 @@ include::{example-dir-resources}/mapping/converter/hbm/MoneyConverterHbmTest.hbm
20232023
A basic type that's converted by a Jakarta Persistence `AttributeConverter` is immutable if the underlying Java type is immutable
20242024
and is mutable if the associated attribute type is mutable as well.
20252025

2026-
Therefore, mutability is given by the https://docs.jboss.org/hibernate/orm/{majorMinorVersion}/javadocs/org/hibernate/type/descriptor/java/JavaType.html#getMutabilityPlan--[`JavaType#getMutabilityPlan`]
2026+
Therefore, mutability is given by the https://docs.hibernate.org/orm/{majorMinorVersion}/javadocs/org/hibernate/type/descriptor/java/JavaType.html#getMutabilityPlan--[`JavaType#getMutabilityPlan`]
20272027
of the associated entity attribute type.
20282028

20292029
This can be adjusted by using `@Immutable` or `@Mutability` on any of:
@@ -2602,8 +2602,8 @@ include::{example-dir-generated}/temporals/GeneratedUuidTests.java[tags=mapping-
26022602
----
26032603
====
26042604

2605-
See https://docs.jboss.org/hibernate/orm/{majorMinorVersion}/javadocs/org/hibernate/annotations/ValueGenerationType.html[`@ValueGenerationType`]
2606-
and https://docs.jboss.org/hibernate/orm/{majorMinorVersion}/javadocs/org/hibernate/generator/AnnotationValueGeneration.html[`AnnotationBasedGenerator`]
2605+
See https://docs.hibernate.org/orm/{majorMinorVersion}/javadocs/org/hibernate/annotations/ValueGenerationType.html[`@ValueGenerationType`]
2606+
and https://docs.hibernate.org/orm/{majorMinorVersion}/javadocs/org/hibernate/generator/AnnotationValueGeneration.html[`AnnotationBasedGenerator`]
26072607
for details of each contract
26082608

26092609

documentation/src/main/asciidoc/userguide/chapters/domain/collections.adoc

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@
44
:core-project-dir: {root-project-dir}/hibernate-core
55
:core-test-base: {core-project-dir}/src/test/java
66
:example-dir-collection: {core-test-base}/org/hibernate/orm/test/mapping/collections
7-
:docs-base: https://docs.jboss.org/hibernate/orm/{majorMinorVersion}
7+
:docs-base: https://docs.hibernate.org/orm/{majorMinorVersion}
88
:javadoc-base: {docs-base}/javadocs
99
:java-javadoc-base: https://docs.oracle.com/en/java/javase/11/docs/api/java.base
1010
:extrasdir: extras/collections
@@ -723,7 +723,7 @@ When fetching the collection, Hibernate will use the fetched ordered columns to
723723
[[collections-customizing-ordered-list-ordinal]]
724724
===== Customizing ordered list ordinal
725725

726-
You can customize the ordinal of the underlying ordered list by using the https://docs.jboss.org/hibernate/orm/{majorMinorVersion}/javadocs/org/hibernate/annotations/ListIndexBase.html[`@ListIndexBase`] annotation.
726+
You can customize the ordinal of the underlying ordered list by using the https://docs.hibernate.org/orm/{majorMinorVersion}/javadocs/org/hibernate/annotations/ListIndexBase.html[`@ListIndexBase`] annotation.
727727

728728
[[collections-customizing-ordered-list-ordinal-mapping-example]]
729729
.`@ListIndexBase` mapping example
@@ -756,7 +756,7 @@ include::{extrasdir}/collections-customizing-ordered-list-ordinal-persist-exampl
756756
While the Jakarta Persistence
757757
{jpaJavadocUrlPrefix}OrderBy.html[`@OrderBy`] annotation allows you to specify the entity attributes used for sorting
758758
when fetching the current annotated collection, the Hibernate specific
759-
https://docs.jboss.org/hibernate/orm/{majorMinorVersion}/javadocs/org/hibernate/annotations/OrderBy.html[`@OrderBy`] annotation is used to specify a *SQL* clause instead.
759+
https://docs.hibernate.org/orm/{majorMinorVersion}/javadocs/org/hibernate/annotations/OrderBy.html[`@OrderBy`] annotation is used to specify a *SQL* clause instead.
760760

761761
In the following example, the `@OrderBy` annotation uses the `CHAR_LENGTH` SQL function to order the `Article` entities
762762
by the number of characters of the `name` attribute.
@@ -937,7 +937,7 @@ include::{extrasdir}/collections-map-value-type-entity-key-add-example.sql[]
937937
===== Maps with a custom key type
938938

939939
Hibernate defines the
940-
https://docs.jboss.org/hibernate/orm/{majorMinorVersion}/javadocs/org/hibernate/annotations/MapKeyType.html[`@MapKeyType`] annotation
940+
https://docs.hibernate.org/orm/{majorMinorVersion}/javadocs/org/hibernate/annotations/MapKeyType.html[`@MapKeyType`] annotation
941941
which you can use to customize the `Map` key type.
942942

943943
Considering you have the following tables in your database:

documentation/src/main/asciidoc/userguide/chapters/domain/embeddables.adoc

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -303,7 +303,7 @@ Embeddable types that are used as collection entries, map keys or entity type id
303303
[[embeddable-Target]]
304304
==== `@TargetEmbeddable` mapping
305305

306-
The https://docs.jboss.org/hibernate/orm/{majorMinorVersion}/javadocs/org/hibernate/annotations/TargetEmbeddable.html[`@TargetEmbeddable`] annotation is used to specify the implementation class of an embeddable-valued mapping when the declared type is a non-concrete type (interface, etc).
306+
The https://docs.hibernate.org/orm/{majorMinorVersion}/javadocs/org/hibernate/annotations/TargetEmbeddable.html[`@TargetEmbeddable`] annotation is used to specify the implementation class of an embeddable-valued mapping when the declared type is a non-concrete type (interface, etc).
307307

308308
As an example, consider an `@Embedded` attribute (`City.coordinates`) whose declared type (`Coordinates`) is an interface. However, Hibernate needs to know about the concrete type to use, which is `GPS` in this case. The `@TargetEmbeddable` annotation is used to provide this information.
309309

@@ -764,4 +764,4 @@ Again, the name and the nullability of the `aggregate` column can be refined thr
764764
Mapping <<chapters/domain/collections.adoc#collections,collections>> inside an `@Embeddable` value is supported in most cases. There are a couple exceptions:
765765

766766
* If the values of an <<chapters/domain/collections.adoc#collections-elemental,@ElementCollection>> is of embeddable type, that embeddable cannot contain nested collections;
767-
* Explicitly selecting an embeddable that contains collections in a query is currently not supported (we wouldn't be able to correctly initialize the collection since its owning entity instance would be missing from the Persistence Context).
767+
* Explicitly selecting an embeddable that contains collections in a query is currently not supported (we wouldn't be able to correctly initialize the collection since its owning entity instance would be missing from the Persistence Context).

documentation/src/main/asciidoc/userguide/chapters/domain/entity.adoc

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -405,7 +405,7 @@ For details on mapping the identifier, see the <<chapters/domain/identifiers.ado
405405
[[entity-sql-query-mapping]]
406406
==== Mapping the entity to a SQL query
407407

408-
You can map an entity to a SQL query using the https://docs.jboss.org/hibernate/orm/{majorMinorVersion}/javadocs/org/hibernate/annotations/Subselect.html[`@Subselect`] annotation.
408+
You can map an entity to a SQL query using the https://docs.hibernate.org/orm/{majorMinorVersion}/javadocs/org/hibernate/annotations/Subselect.html[`@Subselect`] annotation.
409409

410410
[[mapping-Subselect-example]]
411411
.`@Subselect` entity mapping
@@ -464,7 +464,7 @@ Hibernate will trigger a Persistence Context flush if there are pending `Account
464464

465465
When working with lazy associations or entity references for types that define and inheritance hierarchy Hibernate often creates proxies starting from the root class, with no information about the actual subtype that's referenced by the lazy instance. This can be a problem when using `instanceof` to check the type of said lazy entity references or when trying to cast to the concrete subtype.
466466

467-
The https://docs.jboss.org/hibernate/orm/{majorMinorVersion}/javadocs/org/hibernate/annotations/ConcreteProxy.html[`@ConcreteProxy`] annotation can be used on an entity hierarchy root mapping to specify that Hibernate should always try to resolve the actual subtype corresponding to the proxy instance created. This effectively means that proxies for that entity hierarchy will always be created from the correct subclass, allowing to preserve laziness and enable using type checks and casts.
467+
The https://docs.hibernate.org/orm/{majorMinorVersion}/javadocs/org/hibernate/annotations/ConcreteProxy.html[`@ConcreteProxy`] annotation can be used on an entity hierarchy root mapping to specify that Hibernate should always try to resolve the actual subtype corresponding to the proxy instance created. This effectively means that proxies for that entity hierarchy will always be created from the correct subclass, allowing to preserve laziness and enable using type checks and casts.
468468

469469
[[entity-concrete-proxy-mapping]]
470470
.Root entity class annotated with `@ConcreteProxy`

0 commit comments

Comments
 (0)