@@ -17,64 +17,13 @@ Use <<other-integrations-jakarta,Jakarta EE>> instead.
17
17
[[other-integrations-orm6]]
18
18
== Hibernate ORM 6
19
19
20
- include::components/incubating-warning.asciidoc[]
20
+ In previous versions, Hibernate Search's main Maven artifacts used to target Hibernate ORM 5,
21
+ while separate, dedicated Maven artifacts targeted Hibernate ORM 6.
21
22
22
- Hibernate Search includes experimental support for link:{hibernateOrm6DocUrl}[Hibernate ORM 6],
23
- and it requires only one small change:
24
- when declaring the dependencies of your project,
25
- you must add `-orm6` to some artifact identifiers.
23
+ This is no longer the case: the main Maven artifacts now target Hibernate ORM 6,
24
+ and Hibernate ORM 5 is no longer compatible.
26
25
27
- [WARNING]
28
- ====
29
- The experimental support for Hibernate ORM 6 in Hibernate Search {hibernateSearchVersion}
30
- targets Hibernate ORM version {hibernateOrm6Version}.
31
-
32
- Newer versions of Hibernate ORM 6 may introduce breaking changes,
33
- in which case they will no longer be compatible with
34
- the experimental support for Hibernate ORM 6 in Hibernate Search {hibernateSearchVersion},
35
- until Hibernate Search catches up in its next release.
36
- ====
37
-
38
-
39
- For example, an application using Hibernate ORM 6 and the Elasticsearch backend
40
- will need to update its dependencies as follows:
41
-
42
- [source, XML, subs="+attributes"]
43
- ----
44
- <dependency>
45
- <groupId>org.hibernate.orm</groupId> <!--1-->
46
- <artifactId>hibernate-core</artifactId>
47
- <version>{hibernateOrm6Version}</version>
48
- </dependency>
49
- <dependency>
50
- <groupId>org.hibernate.search</groupId>
51
- <artifactId>hibernate-search-mapper-orm-orm6</artifactId> <!--2-->
52
- <version>{hibernateSearchVersion}</version>
53
- </dependency>
54
- <dependency>
55
- <groupId>org.hibernate.search</groupId>
56
- <artifactId>hibernate-search-backend-elasticsearch</artifactId> <!--3-->
57
- <version>{hibernateSearchVersion}</version>
58
- </dependency>
59
- ----
60
- <1> Replaces `org.hibernate:hibernate-core`; notice how the groupId changed in Hibernate ORM 6.
61
- <2> Replaces `hibernate-search-mapper-orm`.
62
- <3> No replacement necessary: this artifact does not rely on Java EE or Hibernate ORM.
63
-
64
- All artifacts relying directly or indirectly on Java EE or Hibernate ORM must be replaced with their ORM 6 counterpart.
65
- This includes in particular:
66
-
67
- * https://in.relation.to/2018/12/06/hibernate-orm-600-alpha1-out/#artifacts[Hibernate ORM artifacts]
68
- * `hibernate-search-mapper-orm` => `hibernate-search-mapper-orm-orm6`
69
- * `hibernate-search-mapper-orm-batch-jsr352-core` => `hibernate-search-mapper-orm-batch-jsr352-core-orm6`
70
- * ...
71
-
72
- Artifacts that do not rely on Java EE or Hibernate ORM at all, on the other hand,
73
- do not have an ORM 6 counterpart and must not be replaced.
74
- These artifacts should be excluded from your replacements in particular:
75
-
76
- * `hibernate-search-engine`
77
- * `hibernate-search-backend-lucene`
78
- * `hibernate-search-backend-elasticsearch`
79
- * `hibernate-search-backend-elasticsearch-aws`
80
- * ...
26
+ If your dependencies include references to artifacts ending with `-orm6`
27
+ (e.g. `hibernate-search-mapper-orm-orm6`)
28
+ just remove the `-orm6` (e.g. use `hibernate-search-mapper-orm` instead)
29
+ when you upgrade to this version of Hibernate Search.
0 commit comments