Commit Graph

1004 Commits

Author SHA1 Message Date
Steve Ebersole d7201815d5 HHH-15977 - Deprecate @Persister 2023-01-04 13:36:04 -06:00
Akshit Agarwal 446908f643 HHH-14772: Fix filter direct fetching documentation 2023-01-04 10:00:27 +01:00
Steve Ebersole 263768d5c5 HHH-15930 - Support scalar resultClass in @NamedNativeQuery 2022-12-22 15:48:37 -06:00
Gavin 023e73cb46 promote trunc() / truncate() to the list of standard HQL functions
also support the single-argument form of round() for consistency
2022-12-21 14:25:35 +01:00
Gavin 3ad3c5a509 change default event timing for @Generated to event = INSERT
- this makes sense if @Generated con now be used on @Id properties
- but it's also convenient with @ColumnDefault
2022-12-20 01:38:55 +01:00
Marco Belladelli caaaa71ffd HHH-15550 New global and persistent temporary `create_tables` params 2022-12-16 08:25:41 +01:00
Gavin 7f72696fff HHH-15788 deprecate GenerationTime since it is a dupe of GenerationTiming
...and it was not even being consistently used in its own package!

(@CurrentTimestamp was already using GenerationTiming.)

What a mess.
2022-12-01 00:02:18 +01:00
Gavin 366a89ae71 reimplement @Source in an elegant way using the ValueGeneration machinery
... and finally delete two of my least-favorite classes!
2022-11-28 22:49:57 +01:00
Gavin 993aae6095 HHH-15774 @CurrentTimestamp takes over from @Source
... and make value generation work better with version properties.
2022-11-28 22:49:57 +01:00
Jan Schatteman 07274cd2ce HHH-15715 - Fix broken links in docs
Signed-off-by: Jan Schatteman <jschatte@redhat.com>
2022-11-28 18:03:26 +01:00
Marco Belladelli f38dd28043 HHH-15760 mass replace self-closing tags in javadoc 2022-11-26 09:49:56 +01:00
Gavin 5b5721f64b HHH-15739 deprecate @LazyToOne and @LazyCollection
and add some docs and cleanups
2022-11-25 02:42:58 +01:00
Sanne Grinovero d648adfd59 HHH-15692 Remove references to hibernate.query.factory_class config property 2022-11-17 13:39:56 +00:00
Christian Beikov 7a14e5c07f HHH-15631 Enable reflection optimizer by default Christian Beikov 2022-11-10 16:42:17 +01:00
Gavin King f1a5314e70 remove a big scary warning from docs because situation has been fixed in 6 2022-11-10 14:03:51 +01:00
Christian Beikov 90a752a0ee HHH-15328 Add support for CTE WITH clause 2022-11-10 13:25:21 +01:00
Jan Schatteman 85836fbcf8 Correction to the native sql queries section
Correction of broken link in Schema.adoc

Signed-off-by: Jan Schatteman <jschatte@redhat.com>
2022-11-08 17:21:57 +01:00
Christian Beikov 0b733d4ba2 HHH-15641 Enable inlineDirtyChecking and lazyLoading for enhancement by default and deprecate the setting 2022-11-07 09:19:26 +01:00
Gavin King aef9ab2425 HHH-15570 allow @SqlInsert, @SqlUpdate, @SqlDelete for secondary tables 2022-11-04 17:51:00 +01:00
Andrea Boriero 20183269ad HHH-14544 Document Ehcache Performance degradation when the default cache is used 2022-10-27 17:08:57 +02:00
Gavin King 8f23e16a35 explain wtf 'join lateral' means
and that it's the same thing as 'cross apply'
2022-10-19 13:59:04 +02:00
Gavin King 4453af984b minor improvement to table in doc 2022-10-09 11:45:04 +02:00
Gavin King f324204514 HHH-15589 document var_xxx() and stddev_xxx() 2022-10-08 22:20:03 +02:00
Gavin King 477f1e7af6 HHH-15588 promote sinh(), cosh(), and tanh() 2022-10-08 18:58:42 +02:00
Gavin King 6ea6359638 add a couple of crosslinks to HQL chapter of doc 2022-10-08 14:09:10 +02:00
Gavin King 4451611311 HHH-15518 bless degrees() and radians() as standard
- add a test
- emulate them on HANA and Oracle
2022-10-06 23:20:02 +02:00
Gavin King 6de92c4f90 document window functions in HQL
thanks to @beikov who collected + wrote up most of the information here
2022-10-06 18:03:58 +02:00
Gavin King be4934d17d reorg the documentation of HQL functions 2022-10-06 14:37:46 +02:00
Gavin King f70d09175a update the HQL chapter to acknowledge changes in JPA 3.1 2022-10-05 17:12:52 +02:00
Gavin King a7bb19a2ea clarify semantics of query with no 'select' in documentation 2022-10-05 14:05:53 +02:00
Gavin King 3ddfa3f47c HHH-15516 add two-arg form of log() to HQL 2022-09-16 13:21:44 +02:00
Gavin King 1b5935e66d HHH-15515 make pi a portable HQL function 2022-09-16 13:21:44 +02:00
Jan Schatteman 3dec1ca4dc HHH-15447 - Remove references to deprecated dialects
Signed-off-by: Jan Schatteman <jschatte@redhat.com>
2022-09-12 16:05:00 +02:00
Andrea Boriero 6507ac4f88 HHH-15455 User Guide Contains a reference to hibernate-ehcache, no longer supported 2022-08-22 15:28:43 +02:00
Yoann Rodière 8c33056d93 Fix dead link in documentation section "Java API for HQL and JPQL"
See the link "next chapter" at the beginning of this section:

https://docs.jboss.org/hibernate/orm/current/userguide/html_single/Hibernate_User_Guide.html#hql
2022-08-17 08:56:29 +02:00
Andrea Boriero e80fb85dae HHH-15420 Getting Started Guide Code does not build 2022-08-02 15:47:14 +02:00
Jan Schatteman d6f9b0b683 HHH-15401 - Update the topical guide
Signed-off-by: Jan Schatteman <jschatte@redhat.com>
2022-07-18 12:04:45 +01:00
Gavin King 6588d2db46 somewhat improve the documentation of StatelessSession
mention fetch()
2022-07-04 21:05:14 +02:00
Gavin King 7b8bf8b98e minor changes to HQL docs 2022-07-02 20:53:03 +02:00
Gavin King c3e0bc44ba document right/full join syntax 2022-07-02 20:50:13 +02:00
Gavin King bb29e3b060 document root joins 2022-06-24 17:14:13 +02:00
Gavin King 1eb75e22ef improve language and formatting in new HQL doc sections 2022-06-18 00:22:17 +02:00
Gavin King 58da5f24f9 "sub query" -> "subquery"
The word "sub" means "submarine", "submissive", or "substitute".
It's never an adjective.
2022-06-18 00:22:17 +02:00
Gavin King c163e1f2ed minor clarifications to HQL chapter 2022-06-17 18:14:30 +02:00
Gavin King c60fbc20ec documentation for hibernate.enable_lazy_load_no_trans 2022-06-10 17:00:29 +02:00
Christian Beikov 341267b133 HHH-3356 Support for normal and lateral subquery in from clause 2022-06-04 19:07:43 +02:00
Steve Ebersole a488e1a269 minor doc fix-up 2022-05-31 06:31:55 -05:00
Christian Beikov 497c09cddb HHH-10999 Remove configuration setting for configuring the JDBC type for arrays 2022-05-30 19:52:39 +02:00
Christian Beikov 45fc49314e HHH-10999 Add support for SQL array types mapped as Java arrays and collections 2022-05-30 19:52:39 +02:00
Nathan Xu 087b9d83ff HHH-15010 - update Java type list for '@CreationTimestamp' and '@UpdateTimestamp' in user guide 2022-05-23 15:37:18 +02:00
Christian Beikov a961ba45ac Add documentation for CompositeUserType 2022-05-05 09:18:19 +02:00
Christian Beikov c18e611ed6 HHH-15200 Add support for the SQLXML type 2022-05-05 09:07:37 +02:00
Nathan Xu 79adc41918 HHH-15224 update the module list in "getting started guide" 2022-05-03 10:20:40 +02:00
Nathan Xu 8af615386f HHH-15154 tweak verbiage in user guide on FetchMode.SUBSELECT 2022-05-03 10:15:06 +02:00
Hirosato Hano ef443b11ad HHH-15238 - Documentation: update JDBC logging configuration for 6.0 2022-05-02 13:10:04 +02:00
Nathan Xu 049a61479b HHH-15239 add 5.6 link in user guide after v6 became the new "current" 2022-05-02 09:13:56 +02:00
Jan Schatteman eab669f04e Some minor corrections to the docs
Signed-off-by: Jan Schatteman <jschatte@redhat.com>
2022-04-27 17:39:52 +02:00
Steve Ebersole 84cf4524ea HHH-15170 - Dedicated chapter for "Build Tool Support"
HHH-15171 - Add discussion of the Ant Plugin
2022-04-05 16:13:03 -05:00
Steve Ebersole 17bb4aa066 HHH-15170 - Dedicated chapter for "Build Tool Support"
HHH-15171 - Add discussion of the Ant Plugin
2022-04-05 15:25:34 -05:00
Steve Ebersole 9d3726e39d HHH-15170 - Dedicated chapter for "Build Tool Support" 2022-04-04 19:15:15 -05:00
Steve Ebersole 8d20c033b1 Address test failures in Gradle plugin module
- I was not able to figure this out, so simply disabled the TestKit related tests
- unfortunately, this means we have no automated functional testing of the plugin in the build
2022-03-31 07:49:28 -05:00
Christian Beikov 4334b46376 Update the bulk section of the batching documentation chapter for the new mutation strategies. Also implement the missing InlineUpdateHandler 2022-03-30 18:21:27 +02:00
Christian Beikov 111fe26ccc Fix some issues in the legacy type resolution documentation and raw types issues for UserType 2022-03-30 18:21:27 +02:00
Christian Beikov 29d457b16a Add documentation for the sql function 2022-03-30 18:21:27 +02:00
Christian Beikov 117e62195a Allow configuring the preferred JDBC type for Instant 2022-03-29 19:31:53 +02:00
Christian Beikov a9d1035806 Do some renaming for consistency and update documentation for new SQL types 2022-03-29 19:31:53 +02:00
Steve Ebersole 814c164c81 HHH-14672 - Allow specifying CHAR-based storage for UUID mappings 2022-03-29 16:53:35 +02:00
Christian Beikov b4a1b149fb Add support for specifying the SqlTypes field name when a type code is expected 2022-03-26 00:02:18 +01:00
Christian Beikov f2aa533dfc Switch back to numeric(21) with nanosecond resolution as fallback for mapping Duration to retain backwards compatibility 2022-03-25 20:20:28 +01:00
Christian Beikov 6801ff0f26 Introduce option to configure how to store java.time.Duration 2022-03-25 20:20:28 +01:00
Christian Beikov 4b48dd31f6 Get rid of MVCC JDBC connection parameter 2022-03-24 09:15:11 +01:00
Steve Ebersole 7a1d6f13dd doc fix-ups 2022-03-09 13:45:11 -06:00
Steve Ebersole b8c416744d not-found and fk() docs 2022-03-08 18:11:07 -06:00
Christian Beikov 964e72f536 Implement support for TimeZoneStorageType.COLUMN 2022-03-08 23:05:09 +01:00
Steve Ebersole d52ebfb41d HHH-15099 - Improve handling of associations marked with @NotFound
- Keep track of NotFoundAction into mapping model
- Fix tests with erroneous assertions about `@NotFound` associations allowed to be lazy
2022-03-05 08:59:31 -06:00
Christian Beikov 8183901cfe Add documentation notes about LIST semantics for mappedBy mappings 2022-03-02 17:02:53 +01:00
Christian Beikov 7aaeebe3af Switch back to bag by default for list semantics 2022-03-02 17:02:53 +01:00
Christian Beikov 5bfbc466eb Rename JPA copy compliance setting to `hibernate.criteria.copy_tree` 2022-02-10 18:24:23 +01:00
Gavin King 4d024fde8b update documentation to explain implicit collection joins 2022-02-09 22:05:21 +01:00
Gavin King 9ebac67737 change the new syntax for HQL collection-aggregates
this feels more consistent to me, and avoids introducing "new" syntax
2022-02-09 22:05:21 +01:00
Gavin King a25758f519 don't write @SuppressWarnings({ "unchecked" }) 2022-02-05 20:03:50 +01:00
Steve Ebersole 86cdf67016 HHH-15055 - Document SelectionQuery and MutationQuery 2022-02-05 10:50:13 -06:00
Gavin King f9392406b7 mention ordered set functions in documentation 2022-02-02 20:00:58 +01:00
Jan Schatteman d2b740ce5b
Jrenaat 6.0 deprecation removals (#4718)
* Removed deprecated org.hibernate.boot.jaxb.internal.stax.LocalSchema

Signed-off-by: Jan Schatteman <jschatte@redhat.com>

* Remove some deprecations from org.hibernate.engine.jdbc

Signed-off-by: Jan Schatteman <jschatte@redhat.com>

* Remove deprecated misspelled method in PostActionEventListener

Signed-off-by: Jan Schatteman <jschatte@redhat.com>

* Remove deprecated getSource() from AbstractPreDatabaseOperationEvent

Signed-off-by: Jan Schatteman <jschatte@redhat.com>

* Privatize deprecated buildOptimizer method in OptimizerFactory

Signed-off-by: Jan Schatteman <jschatte@redhat.com>

* Remove deprecated ServiceContributingIntegrator

Signed-off-by: Jan Schatteman <jschatte@redhat.com>

* Remove some more deprecated features

Signed-off-by: Jan Schatteman <jschatte@redhat.com>
2022-01-31 19:14:48 +01:00
Christian Beikov 0ad5796ffd Implement SQM copying for JPA Criteria API uses 2022-01-31 19:04:37 +01:00
Gavin King 6f3592ac25 Streams are no longer closed by terminal operations
This is no longer true, according to H6 migration guide, so undocument it
2022-01-30 18:35:08 +01:00
Gavin King 99e43537c1 fix a couple of minor errors in doc 2022-01-30 06:21:53 +01:00
Gavin King 1188c6e628 Use a table instead of a list 2022-01-29 20:01:20 +01:00
Gavin King b2a929a46e fix quoting 2022-01-29 19:42:59 +01:00
Gavin King 475d028981 remove @TimeZoneColumn for now because it's unimplemented
and there's no plan to implement it for 6.0

(we can put it back later if someone gets around to implementing it)
2022-01-28 16:01:58 +01:00
Gavin King e80892b77f fix typo 2022-01-27 20:31:05 +01:00
Steve Ebersole 3f879dc3db User Guide - collection mapping docs 2022-01-24 19:52:41 -06:00
Steve Ebersole a332d9191e Work on the User Guide section on @NotFound 2022-01-24 13:28:07 -06:00
Gavin King 766483e46d remove hibernate.query.omit_join_of_superclass_tables 2022-01-22 20:01:17 +01:00
Gavin King 2df71bb7ab remove some more deprecated stuff from Environment
and refresh its Javadoc
2022-01-21 16:52:09 +01:00
Gavin King 329b2fc9c4 remove hibernate.jdbc.use_streams_for_binary config property
this should be handled by the Dialects
2022-01-21 16:52:09 +01:00
Gavin King d385cc8825 remove hibernate.query.validate_parameters
in H6 we're going to always validate them
2022-01-20 23:20:16 +01:00
Gavin King a59bf70ccf remove hibernate.query.conventional_java_constants
this was apparently a sorta nasty bandaid to a performance problem in query compilation
and it caused problems for some users, breaking interpretation of enum values
2022-01-20 23:20:16 +01:00
Gavin King 846af92b54 remove JACC and JMX stuff from docs
it got left over somehow
2022-01-20 18:03:51 +01:00
Gavin King e7acffef15 remove some legacy config properties
the following are gone:

hibernate.ejb.resource_scanner
hibernate.query.substitutions
hibernate.jdbc.sql_exception_converter
hibernate.native_exception_handling_51_compliance
hibernate.legacy_limit_handler
hibernate.jdbc.wrap_result_sets
2022-01-20 18:03:51 +01:00
Steve Ebersole d2584730f3 Document @IdGeneratorType;
Some work to clean up User Guide sections on id-generators
2022-01-10 09:54:06 -06:00
Gavin King 64d25f16d1 make 'element' and 'value' synonyms in doc 2022-01-10 15:48:34 +01:00
Gavin King e6128551b3 document new collection aggregate function syntax
and fix some other problems I found in the examples
2022-01-10 15:48:34 +01:00
Gavin King 60ad64b2a6 update explanation of limit/fetch join problem for H6 2022-01-08 11:58:44 +01:00
Gavin King 3103d84949 fix an incorrect statement about case sensitivity 2022-01-08 02:31:20 +01:00
Steve Ebersole 448d678fb5 Drop `@CollectionClassificationType`;
Drop `@CollectionSemantics`;
Drop `@CollectionSemanticsRegistration(s)`;
Add `@CollectionTypeRegistration(s)`;
Rename `@CustomType` to `@Type`;
User Guide and Migration Guide changes
2022-01-06 21:46:48 -06:00
Gavin King a1ea84a3ac two very minor doc fixes 2022-01-06 23:26:21 +01:00
Gavin King c96f22dfe0 remove hibernate.dialect.show_hql_functions and just make it a log category
really unclear why I didn't do it that way in the first place
2022-01-06 15:24:35 +01:00
Steve Ebersole a71ba9e385 Initial work to re-organize the Collections chapter in the UserGuide;
Docs for @CollectionType, @CollectionClassificationType and @CollectionSemantics;
Some api/spi/internal work;
Migration Guide;
2022-01-05 16:26:58 -06:00
Gavin King bddbb4d287 examples for native functions 2022-01-05 13:16:52 +01:00
Gavin King e1d1d21a30 move a passage to a place it's easier to find 2022-01-05 00:42:05 +01:00
Gavin King 2d55d9a3a8 document id(), version(), naturalid() functions 2022-01-04 23:07:39 +01:00
Gavin King b1aea5f993 document the existence of quoted identifiers 2022-01-04 16:18:55 +01:00
Gavin King 1934236314 document that you can insert multiple rows with 'values' 2022-01-04 15:05:42 +01:00
Gavin King ef53b2a2de make the BNFs more readable
and add one for grouped item
2022-01-04 15:05:42 +01:00
Gavin King ae2b19cbb0 finally rewrite a sentence I wrote close to 20 years ago
I almost feel like I shouldn't push this...
2022-01-04 02:39:18 +01:00
Gavin King 59e36c46c4 better documentation for limit and friends
with code example
2022-01-04 00:22:57 +01:00
Gavin King b9a040effb switch to inconsolata for monospace font 2022-01-03 21:26:03 +01:00
Gavin King b72e2620c6 remove a strange statement that was simply wrong from the docs 2022-01-03 21:25:50 +01:00
Gavin King 0f9faf85e5 minor improvements to the beginning part of HQL chapter 2022-01-03 19:39:14 +01:00
Gavin b55ccabba1 slightly nicer css 2022-01-03 18:39:58 +01:00
Gavin 49d9155f4e do a much better job of explaining query language concepts
and add an example of a union query
2022-01-03 18:39:58 +01:00
Gavin cf4d2d4338 undocument a fixed limitation 2022-01-03 17:09:18 +01:00
Gavin King 948eaf7210 more comments on 'fetch join'
- and improve a table
- and add BNF for limit/offset and order by
2022-01-02 18:56:07 +01:00
Gavin King 6c28a133dd enum + Java constant examples
+ minor fixes
2022-01-02 16:51:50 +01:00
Gavin King 72889fe861 add some missing functions to docs 2022-01-02 16:10:33 +01:00
Gavin King c48be75d3b
add an examples with treat() (#4552)
and slightly reorg doc
2022-01-02 15:45:48 +01:00
Gavin King 5ae55d7bfb
redesign 'collate' and add tests
* and add tests and documentation for 'collate'
* much better and less-ambiguous syntax for collate(), consistent with cast() and treat()
* reimplement collate() using the function infrastructure
* implement collate() for HSQLDB

This feature was previously untested and at least partially broken, and was making a mess 
of the HQL grammar.
2022-01-02 13:39:33 +01:00
Gavin King 4509cad315 at least *mention* treat() 2022-01-02 03:33:08 +01:00
Gavin King 648dac628f minor fixes to docs 2022-01-02 03:33:08 +01:00
Gavin King de7aaa88dc clean up sample BNFs 2022-01-01 23:52:27 +01:00
Gavin King 9edcf6b0c0 moar tables 2022-01-01 23:52:27 +01:00
Gavin King cb787e87a8 mention OffsetDateTime in lterals 2022-01-01 23:52:27 +01:00
Gavin King ec6540ea56 get rid of useless headings on sample code fragments 2022-01-01 23:52:27 +01:00
Gavin King 0966c7be1d more HQL doc rewriting
much better documentation for HQL statement types
rewrite section on predicates and logical operators
rewrite from/join section
stop shouting so much
document that H6 auto-removes non-distinct entity results
document limit/offset
document set operators and 'cross join'
slight reorg of Query API chapter, and new title
use "ordinal" instead of "positional" for parameters
2022-01-01 23:52:27 +01:00
Steve Ebersole 7599d3b2dd Re-write of `Collections` domain model section
preliminary work
2021-12-31 16:37:55 -06:00
Steve Ebersole 7c475c8ac0 migration-guide 2021-12-31 16:21:32 -06:00
Fabio Massimo Ercoli f5fdb653a8 Remove not used examples from documentation 2021-12-31 11:46:10 -06:00
Gavin King 3f8a0b6776 HQL doc rewrite/restructure
- document new features of HQL (literals, functions, filter, rollup)
- rewrite parts of the section dealing with the Query API + execution
- split out a new chapter about the query language, and reorder sections
- remove material about deprecated/removed features
- get rid of use of java.sql.Timestamp from the code!
- make use of repeatable annotations in code examples
2021-12-31 18:35:14 +01:00
Steve Ebersole 9beab38716 Re-write of `Collections` domain model section
preliminary work
2021-12-31 11:32:44 -06:00
Steve Ebersole 4ea949d93d Re-write of `Collections` domain model section
preliminary work
2021-12-31 11:08:25 -06:00
Gavin King 5bcf691d2b mention @GeneratedColumn in the docs 2021-12-31 16:01:32 +01:00
Christian Beikov 1184a5963b Re-add AvailableSettings.JPA_METAMODEL_GENERATION and re-enable metamodel tests 2021-12-23 10:01:07 +01:00
Chris Cranford 99c13e5965 HHH-11595 Introduce `CollectionAuditTable` support 2021-12-18 22:53:42 -05:00
Steve Ebersole fe5a7466cf slightly expand the documentation for Boolean - minor fix-ups 2021-12-18 07:22:13 -06:00
Gavin King 7a81ec78ff slightly expand the documentation for Boolean 2021-12-18 07:22:13 -06:00
Gavin King a2272be61c documentation surrounding @Lob and Length 2021-12-18 05:05:55 -06:00
Chris Cranford b384b37f39 HHH-8051 Gracefully handle not-found to-one associations 2021-12-16 01:05:27 -05:00
Steve Ebersole 76c329f919 More work on ``@AttributeBinderType` 2021-12-09 12:54:20 -06:00
Steve Ebersole 1e33836632 to test pushing 2021-12-09 07:03:28 -06:00