Commit Graph

2000 Commits

Author SHA1 Message Date
Gavin King b54598312a minor change to table 2023-09-01 22:59:33 +02:00
Gavin King f9a0065976 minor language changes to HQL doc 2023-09-01 19:29:44 +02:00
Steve Ebersole 32f635e752 HHH-16962 - General documentation improvements
https://hibernate.atlassian.net/browse/HHH-16962
2023-09-01 11:40:43 -05:00
Gavin King b82d4c3c74 put Hibernate logo back in PDF QL doc 2023-08-31 19:53:44 +02:00
Steve Ebersole 60d8037ccd HHH-17014 - Complete "Mapping Maps" chapter of User Guide
https://hibernate.atlassian.net/browse/HHH-17014
2023-08-30 06:41:01 -05:00
Steve Ebersole a2d45a2679 HHH-16962 - General documentation improvements
HHH-17141 - Prepare for 6.3.0 release

https://hibernate.atlassian.net/browse/HHH-16962
https://hibernate.atlassian.net/browse/HHH-17141
2023-08-29 13:20:19 -05:00
Steve Ebersole fd961cebb1 HHH-17082 - Improve documentation of configuration settings
https://hibernate.atlassian.net/browse/HHH-17082
2023-08-28 10:19:37 -05:00
sujl95 6ac0c24bb3 Fix typo in Caching.adoc 2023-08-22 11:11:32 +02:00
Sanne Grinovero 4e16d00a26 HHH-16073 Remove deprecated cfg property 'hibernate.bytecode.use_reflection_optimizer' 2023-08-22 11:06:28 +02:00
Gavin King bdd78fe39c document that duration addition/subtraction is legal 2023-08-21 22:14:21 +02:00
Jan Schatteman 7939bd8fce HHH-17107 - Add missing @CompositeType, @CompositeTypeRegistration and @CompositeTypeRegistrations to user guide
Signed-off-by: Jan Schatteman <jschatte@redhat.com>
2023-08-21 13:02:18 +02:00
Gavin King 8461ba2078 document a (possibly temporary) restriction 2023-08-18 15:36:20 +02:00
Gavin King 5bfe11fd27 document @Index and @UniqueConstraint
and clear up a mistake I made conflating "load scripts" with "create scripts"
2023-08-18 13:46:50 +02:00
Steve Ebersole e753da11f8 HHH-16962 - General documentation improvements
https://hibernate.atlassian.net/browse/HHH-16962
2023-08-16 11:22:42 -05:00
Steve Ebersole a6b43a6a45 HHH-17047 - Follow up tasks for Gradle 8.2 upgrade
- toolchains
- lazy Task creation
- documentation (documentation/ and release/) tasks
2023-08-14 07:57:49 -05:00
marko-bekhta ffa2ee1443 HHH-17047 - Follow up tasks for Gradle 8.2 upgrade
- tweak how see additional links section is rendered
- update external javadoc links
2023-08-14 07:57:49 -05:00
Steve Ebersole 9e2108e7d7 HHH-17047 - Follow up tasks for Gradle 8.2 upgrade
- toolchains
- lazy Task creation
- documentation (documentation/ and release/) tasks
2023-08-14 07:57:48 -05:00
Steve Ebersole d3a1bd70ae HHH-17047 - Follow up tasks for Gradle 8.2 upgrade
- toolchains
- lazy Task creation
- documentation (documentation/ and release/) tasks
2023-08-14 07:57:48 -05:00
Steve Ebersole d8d1113293 HHH-17047 - Follow up tasks for Gradle 8.2 upgrade
- toolchains
- lazy Task creation
- documentation (documentation/ and release/) tasks
2023-08-14 07:57:44 -05:00
Gavin King 599b064b8e fix errors in code examples and add subsection on pad() to HQL guide 2023-08-13 10:27:06 +02:00
Gavin King 09dd5daa73 HHH-16973 document optional 'from' clause and use it in @HQL examples 2023-08-10 20:20:02 +02:00
Gavin King c70b6946b1 mention Persistence.generateSchema() in doc 2023-08-09 19:58:03 +02:00
Cedomir Igaly 280ff719bb HHH-16591 - See documentation 2.2.21 - "By default, Hibernate maps Duration to the NUMERIC SQL type." 2023-08-09 09:33:27 +02:00
marko-bekhta c1ecd20850 HHH-16591 Update the docs to use `JdbcTypeCode` instead of `JdbcType` to override an SQL type for Duration 2023-08-09 09:33:27 +02:00
Gavin King ffbced83a9 HHH-17039 fix Session vs EntityManager confusion in doc code examples 2023-08-07 12:44:05 +02:00
Andrea Boriero 345598aab6 Fix documentation build error with Gradle 8 2023-08-04 14:49:21 +02:00
joohyukkim ba25ebbfb5 Update Database_Access.adoc 2023-07-31 07:21:28 -04:00
joohyukkim 9d4d728867 FIx typo 2023-07-31 07:21:28 -04:00
Gavin King f161386b36 add a HINT and mention an alternative API 2023-07-25 20:54:15 +02:00
Gavin King 147cf6b112 remove CAUTION from doc because actually this is safe enough 2023-07-25 18:47:49 +02:00
Gavin King 1994a5d14b remove unnecessary spacing in doc 2023-07-21 20:04:32 +02:00
Steve Ebersole db90880661 HHH-16598 - Add new documentation artifacts to release upload
https://hibernate.atlassian.net/browse/HHH-16598
2023-07-20 14:12:43 -05:00
Steve Ebersole 787244b988 HHH-16598 - Add new documentation artifacts to release upload
https://hibernate.atlassian.net/browse/HHH-16598
2023-07-20 13:41:26 -05:00
Steve Ebersole 4726bf016e HHH-16598 - Add Introduction to Hibernate 6 to the website
https://hibernate.atlassian.net/browse/HHH-16598
2023-07-20 11:42:02 -05:00
Steve Ebersole d80e27a17d HHH-16598 - Add Introduction to Hibernate 6 to the website
https://hibernate.atlassian.net/browse/HHH-16598
2023-07-20 11:23:45 -05:00
Gavin King 58aff00957 update doc about query method return types 2023-07-16 19:13:13 +02:00
Gavin King 7634795f83 improved reasoning around nullability of finder method parameters 2023-07-16 09:10:40 +02:00
Gavin King 7f003150da mention schema validation, and the need for @Entity etc annotations 2023-07-15 13:40:52 +02:00
Gavin King 06ed2072ce mention path-based matching in section on @Find methods 2023-07-15 00:18:23 +02:00
Gavin King 57e47e0ba1 very minor improvements first doc chapter 2023-07-14 23:23:09 +02:00
Gavin King be75adbec8 aesthetic improvements to pdf docs 2023-07-14 22:28:29 +02:00
Gavin King 781cdc8804 more improvements to the new chapter 2023-07-14 17:50:22 +02:00
Gavin King a80224f921 improvements to Generator doc chapter 2023-07-14 15:08:17 +02:00
Gavin King dc22773a9f document CriteriaDefinition 2023-07-13 20:38:01 +02:00
Gavin King 8031952d86 document Query Validator, and add a TIP about Metamodel 2023-07-13 14:03:30 +02:00
Gavin King 69e0809bf4 new documentation chapter for @HQL, @SQL, and @Find methods 2023-07-12 21:41:24 +02:00
Gavin King 3e8e9dd219 new doc section on slow queries and SQL comments 2023-07-07 13:25:00 +02:00
Gavin King 84714ed585 more information about query methods and testing for first chapter of new doc 2023-07-06 22:58:46 +02:00
Gavin King 1f30de0ba2 fix typo 2023-07-05 15:06:11 +02:00
Gavin King 5591423756 update doc to latest work in 6.3 2023-07-05 14:45:40 +02:00
Gavin King 1e46146b54 HHH-16815 more convenient pagination via Query API
- add Page convenience class
- add Query.paginate(int, int)
- add Query.paginate(Page)
2023-07-05 13:23:15 +02:00
Gavin King 58006ddf31 improvements to second half of entities chapter of new doc 2023-06-29 10:13:28 +02:00
Gavin King bdbff50dc2 add a tip about @ManyToMany 2023-06-29 03:05:01 +02:00
Gavin King e76d1e5752 document some more things about criteria queries and names queries 2023-06-27 16:38:26 +02:00
Andrea Boriero 6328af32a9 HHH-16820 updated userguide 2023-06-27 10:18:20 +02:00
ats1999 3eb7e7aea9 HHH-16842 Fixed typo - changed tye to type 2023-06-26 12:39:40 +02:00
Gavin King e15bee589f fix a couple of mistakes in operator precedence list 2023-06-25 16:51:06 +02:00
Gavin King d1bb2f4402 HHH-16801 doc precedence of 'is true', 'is false' 2023-06-25 16:29:09 +02:00
Gavin King 0126d96d03 HHH-16801 document 'is true', 'is not true', 'is false', 'is not false' operators 2023-06-25 15:18:27 +02:00
Gavin King f32f6b5515 document hibernate.properties in intro doc 2023-06-24 13:58:07 +02:00
Gavin King a851f1cf8b new doc section on testing, and simpler REST example 2023-06-24 13:58:07 +02:00
Yoann Rodière 1797a9196e Add some missing names in the user guide credits
I tried to filter out contributors who only fixed typos,
hopefully I didn't forget anyone.
2023-06-23 11:48:29 -05:00
Yoann Rodière 1c1c6bf06b Move credits to a dedicated section of the user guide 2023-06-23 11:48:29 -05:00
Gavin King 2f1f766097 document ascending()/descending() 2023-06-21 22:27:10 +02:00
Gavin e051613637 two better words 2023-06-21 21:44:17 +02:00
Gavin 550417be12 more work on the Introduction of the Introduction
it's finally starting to come together
2023-06-21 21:33:23 +02:00
Gavin King 88e07652c9 more work on architecture session of doc 2023-06-21 17:43:55 +02:00
Gavin King 8a82f0e63b add an image 2023-06-21 01:16:27 +02:00
Gavin King c29837366a discuss how to make use of query methods on first section of Introduction.adoc doc 2023-06-20 21:26:02 +02:00
Gavin King e2714627d6 mention Envers in optional deps 2023-06-16 16:01:05 +02:00
Gavin King 7bec00cc86 (finally) document sorted/ordered collections and map keys 2023-06-16 13:58:28 +02:00
Gavin King 8b86cb1cdf add sidebar discussing Envers to Introduction 2023-06-16 12:29:40 +02:00
Gavin King 8761d6abb7 very minor "you" to "we" 2023-06-16 08:00:43 +02:00
Gavin King c937ac6f9d mention upsert() in the doc 2023-06-16 07:56:22 +02:00
Gavin King 7cf4fd0626
update the QuickStart guide (#6807)
* update the code examples in the quickstart

* update the quickstart document

* slightly restructure the quickstart document
2023-06-15 23:52:49 +02:00
Gavin King 13dcc0721e add a TIP and whitespace in some code fragments 2023-06-14 13:31:18 +02:00
Gavin King 70d8b8b10d fix section title 2023-06-14 01:24:28 +02:00
Gavin King 9c4dc02b96 fix up flow of section on join fetching
fix a link
2023-06-14 01:18:33 +02:00
Gavin 95d3dfb85b more use of typesafe metamodel gen refs 2023-06-13 22:50:49 +02:00
Gavin fbb9df37bf mention alternative APIs in doc 2023-06-13 22:50:49 +02:00
Gavin 781b19d136 document new features for typesafety 2023-06-13 22:50:49 +02:00
Gavin 2e5a2143fb refs to companion docs in preface 2023-06-12 13:28:28 +02:00
Gavin 0f8a7f83bd minor improvs to section on join fetching, and a nice TIP 2023-06-12 13:27:01 +02:00
Gavin 069a28970b fix ambiguity in wording 2023-06-12 12:08:05 +02:00
Gavin 4317215ee1 nice tip and segue into caching 2023-06-11 15:01:01 +02:00
Gavin 711c22a712 better explanation of batch/subselect fetching 2023-06-11 15:00:36 +02:00
Gavin d7e55367b5 new section on selective column updates in Advanced chapter 2023-06-11 11:02:19 +02:00
Gavin eb1f840d01 minor improvements to Advanced chapter 2023-06-11 10:36:44 +02:00
Gavin King f36f7a0885 fix minor errors in queries in querylanguage doc 2023-06-05 22:10:04 +02:00
Gavin 280df7c98d fix javax package name + minor code example errors
(spotted by @andrei-ivanov)
2023-06-05 20:12:01 +02:00
Gavin ed75e24d94 move some material to 1st chapter of HQL guide 2023-06-05 20:12:01 +02:00
Gavin cf74308318 update docs with implicit instantiation 2023-06-05 20:12:01 +02:00
Gavin f22d7e1328 fix doc because @AnyKeyJavaClass seems to be required 2023-06-01 01:16:34 +02:00
Gavin 85db7ace9d minor table formatting fix 2023-05-30 18:35:52 +02:00
Gavin 6ea37bfc30 improvements to documentation of HQL functions
- especially the collection-related functions
- also explain path expressions
2023-05-30 15:22:30 +02:00
Gavin 1f45639a5d add table of operator precedence to HQL guide 2023-05-29 20:35:19 +02:00
Gavin 5315bb7840 very tiny fix to code example 2023-05-29 17:41:15 +02:00
Gavin f278923c60 fix formatting of two code examples in intro 2023-05-29 13:37:50 +02:00
Gavin c85cd22956 improve code example of tuple criteria 2023-05-29 13:37:50 +02:00
Gavin 2728cbe014 improve code examples for generated ids in Intro 2023-05-29 13:37:50 +02:00
Gavin 81d0bbccc6 fill out section on lexical structure in HQL guide 2023-05-29 13:37:50 +02:00
Gavin 0c45185499 improve rendering of subheadings 2023-05-29 13:37:50 +02:00
Gavin d8fb935ae0 fix minor typo 2023-05-28 01:54:25 +02:00
Gavin 406b039f50 add a very nice criteria example to Intro doc 2023-05-28 01:40:56 +02:00
Gavin fab058a3a1 minor improvements to new HQL guide 2023-05-28 01:01:33 +02:00
Gavin f3fddf02da split up chapters of HQL 2023-05-27 22:33:12 +02:00
Gavin 9360af5d6b slight restructure of HQL guide 2023-05-27 22:33:12 +02:00
Gavin 4c8ed70a69 split + rewrite query language chapter to new HQL guide document 2023-05-27 22:33:12 +02:00
bradbalogh cf9e57007a HHH-16706 fix spelling mistake in Envers.adoc 2023-05-26 23:47:08 +01:00
Gavin ed897c4208 HHH-16699 add repeat() function to docs 2023-05-26 08:55:56 +02:00
Gavin 908630a7f2 more accurate cross-links in doc 2023-05-25 11:46:10 +02:00
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