Commit Graph

20103 Commits

Author SHA1 Message Date
Gavin King eedcab3c17 fix Javadoc warning 2024-12-16 22:57:29 +01:00
Gavin King 46430a4698 remove additional modules which don't contain APIs from the generated Javadoc
These modules don't contain APIs which are called by users or implemented by
integrators. Including them in the generated Javadoc results in confusion
for users and makes the Javadoc much more difficult to navigate and consume.

In particular, we definitely don't want packages like these included in the
main Javadoc distribution for Hibernate ORM:

  org.hibernate.testing.orm.domain.gambit
  org.hibernate.testing.orm.domain.helpdesk

"Good documentation" isn't about having the maximum possible quantity of
documentation; it's about having documentation where people actually have a
hope of finding what they're looking for. In general, generated Javadoc is
entirely useless except when we've actually taken time to actually write
meaningful and readable prose. If all I need is a list of classes and their
methods, my IDE is quite capable of presenting that information to me.

Worse, documentation for things that aren't API appears to invite users to
interact with these things, which is precisely what we don't want them to do!

I'm leaving Envers alone, but I'm honestly not even sure if the Envers packages
belong here, since it doesn't look like anyone has actually spent much time
writing Javadoc for these packages. If Envers Javadoc is useful, it would be
better to put it in a separate Javadoc build, IMO.
2024-12-16 22:57:29 +01:00
Gavin King 831d4cdb47 tune the documentation CSS 2024-12-16 22:50:46 +01:00
Gavin King ecd9917c6f use an anon function 2024-12-16 21:28:11 +01:00
Gavin King b712fa0296 HHH-18949 fix underscores within uppercase names 2024-12-16 21:28:11 +01:00
Gavin King f7e3177dba very minor code changes 2024-12-16 11:23:55 +01:00
Gavin King 05cf85b61a improve some exception and log messages 2024-12-16 11:23:55 +01:00
Gavin King bd2be3f38f write jdoc for HibernatePersistenceConfiguration 2024-12-16 10:03:57 +01:00
Gavin King edb3c335b2 javadoc about properties in Configuration 2024-12-16 10:03:57 +01:00
Gavin King af679e1d96 mention Hibernate JFR in the Short Guide 2024-12-16 02:01:56 +01:00
Gavin King 597f74f23e fix tests which were asserting stuff about JPA compliance for a non-JPA method
The JPA spec does not have anything to say about our beginTransaction() method
2024-12-16 01:15:55 +01:00
Gavin King 945ec124fc correctly implement the documented semantics of beginTransaction()
and clarify its semantics in the jdoc
2024-12-16 01:15:55 +01:00
Gavin King b1eb194794 HHH-18942 JFR lock entity event 2024-12-16 00:26:43 +01:00
Gavin King 1d3124e06d very minor cleanup in SessionImpl 2024-12-15 18:37:37 +01:00
Gavin King fd1a957c13 add upserts to micrometer metrics 2024-12-15 18:36:55 +01:00
Gavin King d3ce8d45ea HHH-18942 JFR events for stateless sessions
also add Statistics for upsert
2024-12-15 18:36:55 +01:00
Gavin King caed673720 HHH-18942 JFR events for collection recreate/update/remove 2024-12-15 18:36:55 +01:00
Gavin King ad1a86f570 don't disable stack traces for JFR events 2024-12-15 18:36:55 +01:00
Gavin King 225c411d86 HHH-18942 JFR events for entity insert/update/delete 2024-12-15 18:36:55 +01:00
Gavin King dd7fb9cab8 add missing finals 2024-12-15 18:36:55 +01:00
nathan.xu ee3b3390e5 fix some obvious defect in javadoc for resource/transaction package 2024-12-15 13:13:12 +01:00
Gavin King 86a43ca9dd remove use of SharedSessionContractImplementor in UserType
it was arguably a layer-breaker
2024-12-14 19:33:22 +01:00
Gavin King c5c9f1184d remove use of SessionFactoryImplementor in Instantiators and CompositeUserType
it was not needed and arguably a layer-breaker
2024-12-14 19:33:22 +01:00
Nathan Xu 2df92c25b8
improve integration doc (#9322)
* improve integration doc

Co-authored-by: nathan.xu <nathan.xu@procor.com>
Co-authored-by: Gavin King <gavin@hibernate.org>
2024-12-14 17:06:35 +01:00
Gavin King 9a0948a32c more extreme solution 2024-12-14 15:50:13 +01:00
Gavin King a1b0fac8f1 various cleanups 2024-12-14 15:50:13 +01:00
Gavin King 8b4d6b75bc clean up formatters and remove TypeConfigurationWrapperOptions
It's wrong to build a WrapperOptions from a TypeConfiguration
2024-12-14 15:50:13 +01:00
Gavin King 626f9a7281 remove logging that doesn't belong 2024-12-13 10:18:14 +01:00
Gavin King d43a383f10 some minor refactoring 2024-12-13 10:18:14 +01:00
Gavin King d83abc6f80 modernize some typecasts in Initiators 2024-12-13 10:18:14 +01:00
Gavin King dec2716459 clean imports 2024-12-13 01:50:37 +01:00
Gavin King aa6e46eb79 get rid of use of tracev()
- at most one of these is worse without it
- there was even a performance bug due to missing isTraceEnabled()
2024-12-13 01:50:37 +01:00
Gavin King 1b1dfaecd0 finally kill of Lifecycle after all these years 2024-12-13 01:50:37 +01:00
Gavin King 2a03f97b73 remove deprecated operations of LockOptions 2024-12-13 01:50:37 +01:00
Gavin King 9823fccfe8 remove a deprecated operation 2024-12-13 01:50:37 +01:00
Gavin King 399a1d0071 add forRemoval=true in two places 2024-12-13 01:50:37 +01:00
Gavin King c8e4fead2c remove some unused deprecated operations 2024-12-13 01:50:37 +01:00
Gavin King 7f8b685973 HHH-18929 generate check constraints for discriminator columns 2024-12-12 23:15:10 +01:00
Gavin King 18d6a993b2 HHH-18929 fix a test that looks wrong 2024-12-12 23:15:10 +01:00
Gavin King 3f92cfb98e very minor 2024-12-12 19:43:39 +01:00
Gavin King 8782cb689e add missing jdoc for hibernate.discriminator.force_in_select setting 2024-12-12 19:43:39 +01:00
Christian Beikov 301c38bf7d HHH-18932 Use target table columns for SQM joins, except for join table associations 2024-12-12 17:02:11 +01:00
marko-bekhta 58d2239d85 Do not rely on expressly for Hibernate Validator message interpolation 2024-12-12 17:01:38 +01:00
Rguihard 4b52bff090 HHH-18916: regex completion
According to mysql and postgresql, add "cross" and "full" keywords in the regex
https://dev.mysql.com/doc/refman/8.4/en/join.html
https://www.postgresql.org/docs/current/queries-table-expressions.html#id-1.5.6.6.5.6.4.3.1.1
2024-12-12 16:52:56 +01:00
Rguihard a03d22190d HHH-18916 - extends addQueryHints behavior
QUERY_PATTERN regex handles queries with natural, left/right, inner/outer join

Add unit test to check existing behavior
2024-12-12 16:52:56 +01:00
Christian Beikov a893f15884 Drop JDK 20 and add JDK 25-ea testing 2024-12-12 14:52:04 +01:00
Christian Beikov 32d1455326 Fix ReSaveReferencedDeletedEntity for CockroachDB and HANA 2024-12-12 14:20:11 +01:00
Christian Beikov e93a07b4f9 Only cast LONG32 to text on PG to avoid type comparison related issues 2024-12-12 14:20:11 +01:00
Gavin King fc58d614d6 improve documentation of stats.spi 2024-12-12 11:44:28 +01:00
Dmitriy Churilov 7780b74c21 HHH-13790 Temporary session not being closed 2024-12-12 11:34:33 +01:00