Commit Graph

1955 Commits

Author SHA1 Message Date
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
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