Commit Graph

1889 Commits

Author SHA1 Message Date
Gavin d5184d07d0 prevent orphaned table titles
split a section
2023-05-25 11:08:30 +02:00
Gavin 297140734b minor changes for spacing 2023-05-25 11:08:29 +02:00
Gavin cf09a8aa99 create two new sections of the Intro to improve organization 2023-05-25 09:48:08 +02:00
Gavin f881c5243f show off typesafety with the metamodel and new API of NaturalIdLoadAccess 2023-05-25 00:17:59 +02:00
Gavin f330c85c16 change the names in doc because Steve didn't like fetching()/loading() 2023-05-23 17:34:34 +02:00
Gavin 2e502215d5 update the docs with new @FetchProfileOverride
and the "default" profile
2023-05-23 16:50:25 +02:00
Gavin 201c08a8b7 upgrade all the jdbc drivers 2023-05-23 11:05:43 +01:00
Gavin 9cd1d788ea use Oracle driver odbc11 since we now depend on Java 11 2023-05-23 11:05:43 +01:00
Gavin bebde84992 add logo to PDF 2023-05-22 23:48:09 +02:00
Gavin 22a5cbb0a8 lots of new info on fetching and caching
- proper coverage of subselect fetching
- how to handle reference data
2023-05-22 23:43:23 +02:00
Gavin e12b82033e HHH-16666 document fetch profiles now they are nicer to use 2023-05-22 18:45:41 +02:00
Gavin 12e1a97e50 update the doc to show how to enable subselects 2023-05-22 18:45:28 +02:00
Felix 2b0bc61873 HHH-16652 fix the broken link: hql-string-functions 2023-05-22 13:42:35 +02:00
Gavin 7aa1883c6d more info about caching (Caffeine) and logging 2023-05-20 18:27:26 +02:00
Gavin a2e463801b improve discussion of fetching + new section on Statistics 2023-05-20 17:09:42 +02:00
Gavin 2bd5dc7e97 more information about proxies 2023-05-20 17:08:08 +02:00
Gavin 4c489eedbd add TIP about use of record types with 'select new' 2023-05-20 11:36:58 +02:00
Gavin ec03b6fd7f fix small error in doc 2023-05-19 23:03:48 +02:00
Gavin fa5adc1979 fix erroneous code example 2023-05-19 21:43:20 +02:00
Gavin f3ca2d67d5 talk about the MetamodelGenerator in Configuration
since it's used in two places now
2023-05-19 20:26:12 +02:00
Gavin 55d4f0f22c fix formatting in PDF 2023-05-19 16:27:55 +02:00
Gavin 8ddbb033cd document EntityGraphs 2023-05-19 15:48:53 +02:00
Gavin 56ffbc104c document @DialectOverride 2023-05-19 12:36:25 +02:00
Gavin 79d2e208a6 explain the usefulness of java.sql.Xlob 2023-05-19 11:26:47 +02:00
Gavin f0a17e98b9 doc new feature Steve just added 2023-05-19 10:19:46 +02:00
Gavin e4b31c192e add new section about bytecode enhancer to intro 2023-05-19 00:14:01 +02:00
Gavin 172b1c4d39 minor clarifications to named queries section 2023-05-18 22:11:57 +02:00
Gavin 03e6c74737 first draft of "general advice" section 2023-05-18 15:02:45 +02:00
Gavin 84a1f22799 warnings about pc lifecycle in doc 2023-05-18 15:02:45 +02:00
Gavin 96a291058b fix a diagram and add alt text 2023-05-18 12:59:11 +02:00
Gavin fbade45e7a add discrete headings to section on compositional basic types 2023-05-18 12:09:08 +02:00
Gavin 15be098de7 fix two more doc issues for Steve 2023-05-18 11:47:13 +02:00
Gavin 75e387e81b three clarifications from Steve 2023-05-18 11:26:34 +02:00
Gavin 15422ea13b improve section on versions 2023-05-18 11:26:34 +02:00
Gavin bb1f5bf8e3 move custom id generators to Advanced + expand it
fix an ambiguity around "natural id" for Steve
2023-05-18 11:26:33 +02:00
Gavin 787ba8532d add new section on @Any to new doc
stolen str8 from the javadoc
2023-05-17 21:44:25 +02:00
Gavin 2e921f7968 minor improvement to text 2023-05-17 21:22:44 +02:00
Gavin f800c3dbfc move sidebar and make it less verbose
so text flows much better in PDF
2023-05-17 21:18:18 +02:00
Gavin e4b14b9460 improve a bit of flow by splitting a section 2023-05-17 21:06:47 +02:00
Gavin d9a1980ee0 fix confusing/wrong para spotted by Steve 2023-05-17 21:01:04 +02:00
Gavin 23de8a5e5d mention dynamic models and Envers 2023-05-17 20:56:42 +02:00
Gavin eb21b1e052 remove unnecessary FUD against enhancer 2023-05-17 20:56:26 +02:00
Gavin 0d014be034 easier links to user guide
as suggested by Steve
2023-05-17 20:14:44 +02:00
Gavin da03293cef doc Filters 2023-05-17 18:15:04 +02:00
Gavin 491c02f935 some more tips 2023-05-17 18:15:04 +02:00
Gavin 7372d6dc08 intro doc for CRUD SQL and @Generated 2023-05-17 12:57:22 +02:00
Gavin 2d833133b6 intro doc for Hibernate Spatial 2023-05-17 11:34:01 +02:00
Gavin a498e4d501 doc multi-tenancy and naming strategies 2023-05-17 02:08:09 +02:00
Gavin e4539d9b44 quit using abbreviations
don't know quite what came over me...
2023-05-16 22:52:28 +02:00
Gavin King 6078e4792d more work on the preface to new doc 2023-05-16 22:29:21 +02:00
Gavin 8298a27bf9 add some more marketing I mean information to doc 2023-05-16 22:17:17 +02:00
Gavin f26b52c0c6 give the document title some more room to breathe 2023-05-16 20:39:24 +02:00
Gavin e2e834c05f split out a separate file for the Introduction of the Introduction 2023-05-16 20:27:19 +02:00
Gavin 362922512a use Noto Serif consistently in documentation
the combination of a serif body font with
sans serif headings just wasn't working for me
2023-05-16 20:16:38 +02:00
Gavin 03352d4857 customize the css for rouge highlighter 2023-05-16 20:16:38 +02:00
Gavin 2276e2049d integrate rouge source highlighter into adoc build
this is needed because prettify does not seem to
work for the PDF output (I have not dug deep)
2023-05-16 20:16:38 +02:00
Gavin bdc5d2fc60 push the fonts used for rendering the Introduction to Hibernate 6 PDF
I don't see any way to handle them as a regular dependency in Gradle

Not very happy about doing this but ¯\_(ツ)_/¯
2023-05-16 17:24:48 +02:00
Gavin 8a1938d1e2 add a diagram of entity lifecycle to new doc 2023-05-16 14:15:49 +02:00
Gavin f080a724a8 fix fonts and formatting of tables in pdf 2023-05-16 13:47:17 +02:00
Gavin 9ae78dd178 mis minor fixes to doc 2023-05-16 01:54:11 +02:00
Gavin 289a43c5b5 decent-looking pdf output 2023-05-15 23:24:37 +02:00
Gavin 47915cfe5f add a summary section to the doc 2023-05-15 16:50:05 +02:00
Gavin 43fd8a7ced note about embeddable types and polymorphism 2023-05-15 13:28:52 +02:00
Gavin c35b229ba2 add a very important admonition to docs 2023-05-15 13:14:14 +02:00
Gavin 3368c0c3ea using infinispan + improve section on cache config 2023-05-15 13:04:29 +02:00
Gavin 9aa6441212 document query cache 2023-05-15 10:56:18 +02:00
Gavin 32e13654c6 improve the list of optional deps 2023-05-15 00:38:31 +02:00
Gavin a4d9c85ba3 discuss mapping embeddables to UDTs or JSON 2023-05-15 00:27:06 +02:00
Gavin c76a36a1f2 add a diagram 2023-05-14 17:50:51 +02:00
Gavin 864d7ed39e fix typo 2023-05-14 13:03:22 +02:00
Gavin f84c533a6f fix section on getSingleResultOrNull() 2023-05-14 12:48:48 +02:00
Gavin 31574081b8 add some additional material to doc 2023-05-14 12:36:17 +02:00
Gavin bf580b9e72 add some words 2023-05-14 05:08:11 +02:00
Gavin 941fd14874 Blob, Clob 2023-05-13 21:08:47 +02:00
Gavin cc43b1fd1f add rant 2023-05-13 21:08:47 +02:00
Gavin c2fe18796f short section on named queries 2023-05-13 21:08:47 +02:00
Gavin 032fc0753f short section on named queries 2023-05-13 21:08:47 +02:00
Gavin f424a4b2f2 improve discussion of FlushModes and CacheModes 2023-05-13 21:08:47 +02:00
Gavin 99ba5cba1e improve section on not null 2023-05-13 21:08:47 +02:00
Gavin 12a380c6ea use Validator for @NotNull 2023-05-13 21:08:47 +02:00
Gavin a4392fdf2f calling jdbc 2023-05-13 21:08:47 +02:00
Gavin 5fd441df70 improve discussion of foreign key mappings 2023-05-13 21:08:47 +02:00
Gavin bb0acd2956 minor fixes 2023-05-13 21:08:47 +02:00
Gavin 53fb19e170 hello JPA world 2023-05-13 21:08:47 +02:00
Gavin b2509bbab6 hello world 2023-05-13 21:08:47 +02:00
Gavin fa25afad0f add a couple of links 2023-05-13 21:08:47 +02:00
Gavin f602b65b4f limits, pagination, and flush modes 2023-05-13 21:08:47 +02:00
Gavin d182331cc4 more presentation cleanups 2023-05-13 21:08:47 +02:00
Gavin 95b4829e08 more presentation cleanups 2023-05-13 21:08:47 +02:00
Gavin ccca560a91 get rid of useless titles on admonitions
failed experiment
2023-05-13 21:08:47 +02:00
Gavin 6369f29f1a get rid of useless titles on admonitions
failed experiment
2023-05-13 21:08:47 +02:00
Gavin 843cc499d1 clean up more admonitions 2023-05-13 21:08:47 +02:00
Gavin 259d86a4a2 discover sidebars 2023-05-13 21:08:47 +02:00
Gavin 48e5cfbf28 segues 2023-05-13 21:08:47 +02:00
Gavin 24334d1dff finish off the section on session operations 2023-05-13 21:08:47 +02:00
Gavin c2c7d4166b more explanation cribbed from my jdoc 2023-05-13 21:08:47 +02:00
Gavin b7a8f4940e pool configuration 2023-05-13 21:08:47 +02:00
Gavin 7b0e473358 more about natural ids 2023-05-13 21:08:47 +02:00
Gavin d14f3f011a native SQL queries and placeholders 2023-05-13 21:08:47 +02:00
Gavin 18e88b7358 executing queries 2023-05-13 21:08:47 +02:00
Gavin 5881da56c8 add diagram 2023-05-13 21:08:47 +02:00
Gavin 71d8002c1b add rant about repositories 2023-05-13 21:08:47 +02:00
Gavin 5c24af1ed6 reuse the query language chapter by reference 2023-05-13 21:08:47 +02:00
Gavin c6b63693c6 start on queries 2023-05-13 21:08:47 +02:00
Gavin 02c179d07f flushing, flush modes, and cache modes 2023-05-13 21:08:47 +02:00
Gavin 05f4ac6483 shill for HR 2023-05-13 21:08:47 +02:00
Gavin 85a156fd99 cannibalize some information from javadoc 2023-05-13 21:08:47 +02:00
Gavin f8fd02d5f9 sq 2023-05-13 21:08:47 +02:00
Gavin db4c0d02ec discuss pesistence contexts 2023-05-13 21:08:47 +02:00
Gavin bc85a250ef compile introduction to PDF 2023-05-13 21:08:47 +02:00
Gavin 2841388335 fix build 2023-05-13 21:08:47 +02:00
Gavin 5747725e02 cannibalize good content from HR docs 2023-05-13 21:08:47 +02:00
Gavin 7fd70a0284 mention constraints which Hibernate doesn't actually create due to bug 2023-05-13 21:08:47 +02:00
Gavin 1d3f4f47f1 diagram of associations 2023-05-13 21:08:47 +02:00
Gavin 3e187ad82a association table mappings 2023-05-13 21:08:47 +02:00
Gavin 6edefe6f4d column lengths and LOBs 2023-05-13 21:08:47 +02:00
Gavin e1160fec91 more about table mappings 2023-05-13 21:08:47 +02:00
Gavin 189951db10 join column mappings 2023-05-13 21:08:47 +02:00
Gavin f9e9c9db86 mapping tables and columns 2023-05-13 21:08:47 +02:00
Gavin 77a48de89c more impressive converter example 2023-05-13 21:08:47 +02:00
Gavin 16a1322974 more on inheritance 2023-05-13 21:08:47 +02:00
Gavin 25d341f297 start on inheritance mapping 2023-05-13 21:08:47 +02:00
Gavin eaa12db032 missed one 2023-05-13 21:08:47 +02:00
Gavin 349ecee462 mapped superclass, version, and summary 2023-05-13 21:08:47 +02:00
Gavin 7b5f66c292 @ElementCollection mappings, etc 2023-05-13 21:08:47 +02:00
Gavin fad5d6ee5b enum and array mappings 2023-05-13 21:08:47 +02:00
Gavin 7619313d2f many to many 2023-05-13 21:08:47 +02:00
Gavin 33a3af7abc one to one 2023-05-13 21:08:47 +02:00
Gavin f012afe95f many to one 2023-05-13 21:08:47 +02:00
Gavin d9fae9454c improve converters discussion 2023-05-13 21:08:47 +02:00
Gavin cf8aa0b02a add section on embeddables + and define "persistent identity" 2023-05-13 21:08:47 +02:00
Gavin 5a036069fb much more about basic types 2023-05-13 21:08:47 +02:00
Gavin 1f5a8c0f1b make start on basic types 2023-05-13 21:08:47 +02:00
Gavin 7a28b3caed finish section on ids 2023-05-13 21:08:47 +02:00
Gavin 50373633d6 make a start on Entities chapter 2023-05-13 21:08:47 +02:00
Gavin 9a726936e7 revise what I have so far 2023-05-13 21:08:47 +02:00
Gavin 01dcf0687d more on XxxxNamingStrategy 2023-05-13 21:08:47 +02:00
Gavin deb19d02d0 copy configuration section from HR intro 2023-05-13 21:08:47 +02:00
Gavin 42819dd6f9 add history of Hibernate 2023-05-13 21:08:47 +02:00
Gavin King 46ac4c07cf initial blurbs for Introduction document 2023-05-13 21:08:47 +02:00
Andrea Boriero cd0504ceda Add to documentation drop-down selector links to 6.0 and 6.1 documentation pages 2023-05-02 09:16:08 +02:00
Karel Maesen 174a9a7005 HHH-15160 - Properly validate the arguments in the distance operators. 2023-04-28 13:50:36 +02:00
Karel Maesen b46bc13813 HHH-15160 - Adds the Postgis distance operators 2023-04-28 13:50:36 +02:00
Marco Belladelli a9080f5f7d HHH-16392 Fix where clause in collection cleanup subqueries 2023-04-28 10:22:26 +02:00
Steve Ebersole c6389efb1b Add a Dialect report
Also added
* H2Dialect#getMinimumSupportedVersion
* DerbyDialect#getMinimumSupportedVersion
2023-04-27 11:28:35 -05:00
Gavin 0674300d87 fix outdated section of user guide relating to Dialects 2023-04-18 18:01:13 +02:00
Jan Schatteman 81d1d95e4c Add @EmbeddableInstantiator, @EmbeddableInstantiatorRegistration and @EmbeddableInstantiatorRegistrations to the annotations chapter of the user guide
Signed-off-by: Jan Schatteman <jschatte@redhat.com>
2023-04-13 23:58:13 +02:00
Gavin 511399c152 update the docs to reflect the new @SQL annotations 2023-04-09 19:32:59 +02:00
Steve Ebersole 4b8167c7fd PublishMigrationGuide task 2023-04-01 09:37:40 -05:00
Andrea Boriero 570ccae476 HHH-16097 Move all tests from documentation into hibernate-core 2023-03-24 07:43:13 -05:00
Christian Beikov 41bec6d5f9 HHH-16287 Consider hibernate.timezone.default_storage for OffsetTime typing and storage 2023-03-23 11:59:53 +01:00
Christian Beikov e632981e4b HHH-16333 Get rid of special Character[] and Byte[] handling 2023-03-22 17:27:26 +01:00
Christian Beikov 39f4fdda5e HHH-16316 Move version specific dialects of unsupported versions to hibernate-community-dialects 2023-03-17 10:12:34 +01:00
Steve Ebersole 85f98d21f9 HHH-16132 - Dirty checking for collection-as-basic mappings 2023-03-16 09:09:58 -05:00
Yoann Rodière d09640fe36 HHH-16302 Clarify that the JDBC timezone is supposed to match the database timezone
See https://hibernate.zulipchat.com/#narrow/stream/132094-hibernate-orm-dev/topic/hibernate.2Etimezone.2Edefault_storage/near/341706032
2023-03-15 15:36:47 +01:00
Yoann Rodière fa53e6da98 HHH-16302 Document all TimeZoneStorageType values in reference documentation 2023-03-15 15:36:47 +01:00
Yoann Rodière cc8f1f1020 HHH-16310 Update reference documentation regarding multitenancy
* Remove mentions of 'hibernate.multiTenancy'. This setting no longer exists.
* Fix a few other inconsistencies.
2023-03-15 12:05:51 +01:00
Florian Hof cc01f2da3f update maven dependency of hibernate-spatial
the new Maven group is org.hibernate.orm (and so referenced in Spring Boot 3)
2023-03-14 12:19:21 +01:00
Christian Beikov a32d741bbc HHH-15664 Fix array section in documentation 2023-03-14 12:17:56 +01:00
Christian Beikov b82fa307ea HHH-15802 - Fix some expression comparison type checks 2023-03-03 16:01:53 +01:00
Jan Schatteman 02b7c5afb5 Add a note w/ respect to native queries and inheritance
Signed-off-by: Jan Schatteman <jschatte@redhat.com>
2023-03-03 09:46:17 +01:00
Christian Beikov 1bd0180172 HHH-16182 Fix some tests for older databases and adapt assertion for boolean function 2023-03-03 09:38:33 +01:00
Christian Beikov 1ff682438d HHH-16179 Session.find should not apply filters 2023-03-02 20:38:18 +01:00
Christian Beikov f5741e9b7e Revert "HHH-14772: Fix filter direct fetching documentation"
This reverts commit 446908f643.
2023-03-02 20:38:18 +01:00
Steve Ebersole 3dc855aa31 HHH-16182 - Converted boolean values not always properly handled in predicates 2023-03-02 09:19:00 -06:00
Steve Ebersole abc44004ca test cleanup 2023-03-01 17:20:12 -06:00
Steve Ebersole e37db163a0 HHH-16182 - Converted boolean values not always properly handled in predicates 2023-03-01 13:49:53 -06:00
Steve Ebersole 31738d436a HHH-16182 - Converted boolean values not always properly handled in predicates 2023-03-01 13:49:53 -06:00
Steve Ebersole b8d500ec41 HHH-16182 - Converted boolean values not always properly handled in predicates 2023-03-01 13:49:53 -06:00
marko-bekhta 5d61b03b20 HHH-16217 Use only rendered Javadocs for collecting configuration properties 2023-03-01 13:26:49 -06:00
Marco Belladelli b16ad226ba HHH-16185 Custom trunc/truncate implementation that handles both numeric and datetimes 2023-02-27 17:01:45 +01:00
Jan Schatteman 0d729feb6a Fix broken doc link in native.adoc
Signed-off-by: Jan Schatteman <jschatte@redhat.com>
2023-02-22 21:10:32 +01:00
Steve Ebersole a82c2169cf HHH-16182 - JPA derived query methods failing when boolean mapping using YesNoConverter 2023-02-15 08:18:12 -06:00
Gavin King f3833e71a9 HHH-16174 support for extract(epoch from ...) in HQL 2023-02-13 15:40:24 +01:00
Steve Ebersole 973434c8f1 HHH-16148 - Introduce Immutability (MutabilityPlan) for use with @Mutability
HHH-16141 - Support @Mutability and @Immutable on UserType
HHH-16147 - Support @Mutability and @Immutable on AttributeConverter
HHH-16146 - Improve User Guide documentation for (im)mutability
2023-02-10 08:38:40 -06:00
Christian Beikov 2de37ed5e3 HHH-16143 Documentation for composite aggregates 2023-02-09 10:54:19 +01:00
Christian Beikov 0b4b52b08a HHH-16152 Documentation for @PartitionKey 2023-02-08 17:49:44 +01:00
Steve Ebersole fd3670bbeb Unify example includes in terms of well-defined asciidoc attributes
preparation step for moving tests out of `documentation` and into the proper projects (core, envers and spatial)
2023-01-27 17:25:22 -06:00
Christian Beikov 16ca1a0595 HHH-15443 Allow JdbcType to wrap read and write expressions 2023-01-27 14:26:42 -06:00
marko-bekhta 8fa8b23d63 Add tasks to process sources and collect config properties 2023-01-26 00:43:38 -06:00
Gavin 6ca9643c72 HHH-16035 document Duration -> NUMERIC mapping 2023-01-13 16:34:46 +01:00
Gavin 7444b26db4 HHH-15948 move org.hibernate.metamodel.model.convert to org.hibernate.type.descriptor.converter 2023-01-11 17:56:54 +01:00
Gavin 3ceb91d280 HHH-16000 Add @SQLSelect annotation as abbreviation for @NamedNativeQuery + @Loader 2023-01-07 15:02:42 +01:00
Gavin bfdd7f648b HHH-10557 fix @Loader applied to a collection
the issue here is we have no @CollectionResult for annotation-based result set mappings
2023-01-07 15:02:42 +01:00
Jan Schatteman 74689f26a5 Get rid of a bunch of deprecated api usages
Signed-off-by: Jan Schatteman <jschatte@redhat.com>
2023-01-06 14:02:43 +01:00
Gavin 5fb04fb6f6 give UserType.replace() a sensible default impl that's essentially always correct 2023-01-06 12:47:48 +01:00
Gavin fe9f909dce add an extended example to UserType jdoc 2023-01-06 12:47:48 +01:00
LLEFEVRE 9dad80c258 HHH-15975 documentation tests must rely on SharedDriverManagerConnectionProviderImpl instead of DriverManagerConnectionProviderImpl 2023-01-05 11:05:21 +01:00
Steve Ebersole d7201815d5 HHH-15977 - Deprecate @Persister 2023-01-04 13:36:04 -06:00
Gavin e3f1c2741d HHH-15960 make @Comment annotation repeatable and properly test it
I didn't quite nail this one first time round :-/
2023-01-04 13:40:44 +01:00
Akshit Agarwal 446908f643 HHH-14772: Fix filter direct fetching documentation 2023-01-04 10:00:27 +01:00
Gavin b7b5fb7559 avoid the use of TypeConfiguration.getServiceRegistry() 2023-01-03 21:06:49 +01:00
Christian Beikov 0962144583 Don't show SharedDriverManagerConnectionProviderImpl usage in event documentation 2023-01-03 10:31:05 +01:00
LLEFEVRE ccf4fac124 HHH-15961 Speed-up Oracle CI build 2023-01-03 10:26:46 +01:00
Gavin 7aa92a7c05 allow @Formulas to refer to columns of @SecondaryTables
(this is something that was previously only possible using hbm.xml)

also attempt a partial fixup of the initialization process where SessionFactoryImpl
constructor leaked out an uninitialized reference to itself (it still leaks, but
not as badly)
2023-01-02 21:45:02 +01:00
Gavin 1657c22aca automatically detect when a @Check refers to a @SecondaryTable
- also support named check constraints (multiple of them)
- also support check constraints on collection tables
2023-01-02 21:45:02 +01:00
Gavin 110a1f6a56 examples in javadoc for @Any and @ManyToAny 2022-12-26 18:22:06 +01:00
Jan Schatteman 974fe9e22d HHH-15914 - Add jira tag to some tests
Signed-off-by: Jan Schatteman <jschatte@redhat.com>
2022-12-23 17:40:38 +01:00
Jan Schatteman c45330023f HHH-15914 - remove deprecated method calls and provide an example of Tuple.class usage
Signed-off-by: Jan Schatteman <jschatte@redhat.com>
2022-12-23 16:05:18 +01:00
Steve Ebersole 51a50bed43 Add a deprecated.txt report to published docs collecting union of `@Deprecated` and `@Remove` 2022-12-22 16:55:02 -06:00