Hibernate
/
hibernate-orm
mirror of https://github.com/hibernate/hibernate-orm
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

remove a big scary warning from docs because situation has been fixed in 6

This commit is contained in:
Gavin King 2022-11-10 14:03:40 +01:00
parent 90a752a0ee
commit f1a5314e70
1 changed files with 8 additions and 19 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

27
documentation/src/main/asciidoc/userguide/chapters/portability/Portability.adoc
View File

@ -82,38 +82,27 @@ For example, the `org.hibernate.id.enhanced.SequenceStyleGenerator` mimics the b
[[portability-functions]] [[portability-functions]]
=== Database functions === Database functions
HQL now provides a large set of functions which are portable between databases.
You can find them listed in <<hql-exp-functions,the chapter describing the query language>>.
There's even a way for a program to contribute its own <<hql-user-defined-functions,function definitions>>.
[WARNING] [WARNING]
==== Of course, SQL functions occurring in handwritten SQL fragments or queries usually aren't very portable.
When it comes to database functions, Hibernate could benefit from an improvement.
In terms of portability concerns, the function handling currently works pretty well in HQL, however, it is quite lacking in all other aspects.
====
SQL functions can be referenced in many ways by users.
However, not all databases support the same set of functions.
Hibernate provides a means of mapping a _logical_ function name to a delegate which knows how to render that particular function, perhaps even using a totally different physical function call.
[IMPORTANT]
====
Technically the SQL function registration is handled through the `org.hibernate.dialect.function.SQLFunctionRegistry` class which is intended to allow users to provide custom function definitions without having to provide a custom dialect.
This specific behavior is not fully completed as of yet.
It is sort of implemented such that users can programmatically register functions with the `org.hibernate.cfg.Configuration` and those functions will be recognized for HQL.
====
[[portability-types]] [[portability-types]]
=== Type mappings === Type mappings
TODO: document the following as well TODO
[[portability-types-lobs]] [[portability-types-lobs]]
==== BLOB/CLOB mappings ==== BLOB/CLOB mappings
TODO
[[portability-types-bool]] [[portability-types-bool]]
==== Boolean mappings ==== Boolean mappings
Jakarta Persistence portability ==== Jakarta Persistence portability
* HQL/JPQL differences * HQL/JPQL differences
* naming strategies * naming strategies