From hibernate-commits at lists.jboss.org Mon May 12 16:14:57 2008 Content-Type: multipart/mixed; boundary="===============0083856428689136419==" MIME-Version: 1.0 From: hibernate-commits at lists.jboss.org To: hibernate-commits at lists.jboss.org Subject: [hibernate-commits] Hibernate SVN: r14658 - core/branches/Branch_3_2_4_SP1_CP/doc/release_notes/src/main/docbook/en-US. Date: Mon, 12 May 2008 16:14:57 -0400 Message-ID: --===============0083856428689136419== Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable Author: bsatguna Date: 2008-05-12 16:14:57 -0400 (Mon, 12 May 2008) New Revision: 14658 Added: core/branches/Branch_3_2_4_SP1_CP/doc/release_notes/src/main/docbook/en-= US/Release_Notes.ent Removed: core/branches/Branch_3_2_4_SP1_CP/doc/release_notes/src/main/docbook/en-= US/Book_Info.xml Modified: core/branches/Branch_3_2_4_SP1_CP/doc/release_notes/src/main/docbook/en-= US/Article_Info.xml core/branches/Branch_3_2_4_SP1_CP/doc/release_notes/src/main/docbook/en-= US/Release_Notes.xml Log: updated content to reflect latest changes in redhat svn: release notes for = 3.2.4.sp01.cp03 Modified: core/branches/Branch_3_2_4_SP1_CP/doc/release_notes/src/main/docb= ook/en-US/Article_Info.xml =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D --- core/branches/Branch_3_2_4_SP1_CP/doc/release_notes/src/main/docbook/en= -US/Article_Info.xml 2008-05-10 22:58:25 UTC (rev 14657) +++ core/branches/Branch_3_2_4_SP1_CP/doc/release_notes/src/main/docbook/en= -US/Article_Info.xml 2008-05-12 20:14:57 UTC (rev 14658) @@ -2,12 +2,12 @@ = - - Enterprise Hibernate x.y.z Release Notes + + Hibernate Release Notes - 0.1 - 0 - This document outlines information necessary for installa= tion, migration and bug fixes. + 3.2.4 + 0.1 + This document contains release notes for new and existing= users of Hibernate regarding Hibernate &VERSION; release. It provides inst= allation and migration notes, document sources and bug fixes for this relea= se. Deleted: core/branches/Branch_3_2_4_SP1_CP/doc/release_notes/src/main/docbo= ok/en-US/Book_Info.xml =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D --- core/branches/Branch_3_2_4_SP1_CP/doc/release_notes/src/main/docbook/en= -US/Book_Info.xml 2008-05-10 22:58:25 UTC (rev 14657) +++ core/branches/Branch_3_2_4_SP1_CP/doc/release_notes/src/main/docbook/en= -US/Book_Info.xml 2008-05-12 20:14:57 UTC (rev 14658) @@ -1,27 +0,0 @@ - - - - - Product Name and Version - Release Notes - 0.1 - 0 - This book is about... (Be brief; this para is used for th= e RPM spec - file) - - - - - - - - &YEAR; - &HOLDER; - - - - - - - Added: core/branches/Branch_3_2_4_SP1_CP/doc/release_notes/src/main/docbook= /en-US/Release_Notes.ent =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D --- core/branches/Branch_3_2_4_SP1_CP/doc/release_notes/src/main/docbook/en= -US/Release_Notes.ent (rev 0) +++ core/branches/Branch_3_2_4_SP1_CP/doc/release_notes/src/main/docbook/en= -US/Release_Notes.ent 2008-05-12 20:14:57 UTC (rev 14658) @@ -0,0 +1,4 @@ + + + + Modified: core/branches/Branch_3_2_4_SP1_CP/doc/release_notes/src/main/docb= ook/en-US/Release_Notes.xml =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D --- core/branches/Branch_3_2_4_SP1_CP/doc/release_notes/src/main/docbook/en= -US/Release_Notes.xml 2008-05-10 22:58:25 UTC (rev 14657) +++ core/branches/Branch_3_2_4_SP1_CP/doc/release_notes/src/main/docbook/en= -US/Release_Notes.xml 2008-05-12 20:14:57 UTC (rev 14658) @@ -8,63 +8,396 @@ Overview - These release notes contain important information regarding Hibernate &= VERSION;. This document covers installation and migration notes, new featur= es and bug fixes. = + These release notes contain important information regarding Hibernate &= VERSION; release. This document lists the necessary software that must be i= nstalled before using Hibernate. Users of previous versions of Hibernate ma= y refer to to find the latest JIRA issue f= ixes. In addition, the latest , product su= pport and license links are also provided. = =
Background - Hibernate is a powerful object/relational mapping tool for building Ja= va applications. It significantly reduces repetitive persistence related pr= ogramming tasks by mapping the object model's data representation to a rela= tional data model. Hibernate offers a sophisticated object-oriented HQL (Hi= bernate query language) allowing the programmer to make use of polymorphic = queries. Queries can be expressed in native SQL or using Criteria and examp= le queries. A full feature datasheet is available here for download = + Hibernate is a powerful object/relational mapping tool and a query ser= vice for building Java applications. Hibernate offers a sophisticated objec= t-oriented HQL (Hibernate query language) allowing the programmer to make u= se of polymorphic queries. Queries can be expressed in native SQL or using = Java-based Criteria and Example queries. A full feature datasheet is availa= ble h= ere for download. + + Hibernate can be integrated with any Java EE middleware platform. This= release is also embedded in JBoss Enterprise Application platform versions= 4.2 CP 03 and 4.3 CP 01 releases. Hence, the jar file= s remain the same as the ones distributed with JBoss Enterprise Application= Platform 4.2 CP 03 and 4.3 CP 01 releases. = + + + This Hibernate version is available through subscriptions which offers= certified software, industry-leading support, updates and patches, documen= tation, and multi-year maintenance policies. +
Installation And Migration Guide - This section contains all information related to installing hibernate, = testing the installation and running some examples. + This section lists the software that must be installed on your local ma= chine before beginning to use Hibernate. Migration notes are also listed in= this section for users who will be using existing databases along with Hib= ernate. + = +
+ Prerequisites + + The software required for setting up Hibernate for use will depend on = whether you would also like to build and test the Hibernate source files or= use the jar files directly. = + = +
+ Using Hibernate + JDK 1.5 + + To build Java applications with Hibernate you must have = JDK 1.5 version installed. While this version is compatible w= ith Hibernate, version 1.4 is no longer supported. You must ensure that aft= er installation, the environment variables are set for use. = + + = +
+ = +
+ Testing Hibernate and Running the demo + + To test Hibernate and run the demo, you will need Apache= Ant 1.7.0 and JUnit 3.8.1. = + + = + = + + Apache Ant 1.7.0 + Apache Ant can be downloaded from this link. You must set the ANT_HOME = environment variable to point to the Apache Ant install location. You may r= efer to the manual available on their website for installing and setting up= Apache Ant for use. + + + JUnit 3.8.1 + + To run JUnit tests, you may use JUnit 3.8.1 version which can be do= wnloaded from here. After inst= allation, copy junit.jar to $ANT_HOME/lib directory. Documentation to help you get started on running sample t= est cases are available on their website. provides further notes on running JUnit tests. = + + = + = + + = + = +
= +
+ =
Installation Notes - We advise users to ensure that adequate disk space is available for th= e installation of Hibernate, JDK 1.4 (or above) and the database. = - + Extract files from the Hibernate ZIP file to the de= sired location. Open the directory where you have extracted these files. To= use Hibernate, you must configure the project's classpath settings to poin= t to the jar files. Settings for individual IDEs diffe= r, but normally you would add the jar files as externa= l library files. = +
+ Hibernate Dependencies + + The lib directory contains all the dependencies required to use Hiber= nate in a supported fashion. Certain dependencies from the community build= s (such as connection pool integration and second-level cache providers oth= er than the JBoss Cache provider) are not included as they are not supporte= d. + +
+ =
-
- Migration Guide - - Information regarding upgrades = - +
+ Migration Notes +
+ Configuring your database + + To use your database with Hibernate, copy your JDBC driver into the lib directory. Then edit the hibernate.properties file in the etc directo= ry. Additional configuration notes are available in Hibernate Reference Guide, chapter 3: Configuration. The H= ibernate supported databases are: Oracle9i, Oracle10g, MS SQL 2005, Postgre= SQL and MySQL. + +
+ Oracle users + + OracleDialect and Oracle9Dialect have been deprecated. Oracle8iDiale= ct, Oracle9iDialect, or Oracle10gDialect should be used instead. = + +
+
-
- New features and bug fixes + = +
+ Certified Configurations = - All new features and bug fixes mentioned in these release notes are app= licable to VERSION;. = + Certified Configurations are a defined set of validated, tested, and re= commended Operating Systems, chip architectures, JVM, and database combinat= ions. These configurations have been tested and validated against the Hiber= nate &VERSION; release. -
- New Features + + Compatible Operating systems, chip architecture and JVMs. + + + + Operating System + Chip Architecture + Java Virtual Machine(s) + + + + + Red Hat Enterprise Linux v5 + x86, x86_64 + Sun JDK 1.5.0_11, BEA JRockit JDK 1.5.0_08 + = + + + Red Hat Enterprise Linux v4.5 + x86, x86_64 + Sun JDK 1.5.0_11, BEA JRockit JDK 1.5.0_08, Azul JDK 1.5.0_11= + = + = + + + Microsoft Windows 2003 + x86 + Sun JDK 1.5.0_11, BEA JRockit JDK 1.5.0_10 + = + + + Microsoft Windows 2003 + x86_64 + Sun JDK 1.5.0_11, BEA JRockit JDK 1.5.0_08 + = + + + Solaris 10 + x86, SPARC + Sun JDK 1.5.0_11 + + + Solaris 9 + SPARC + Sun JDK 1.5.0_11 + + + HP-UX i2 + RISC, ia64 = + HP-UX JDK 1.5.0.06 + + + +
+ = + The following databases and database drivers were validated and ce= rtified as part of the Hibernate &VERSION; release process: + + Compatible databases and database drivers + + + + Database + Database Driver + = + + + + Oracle 10g R2 + Oracle JDBC driver v10.2.0.1, Oracle JDBC driver v10.2.0.2 + + + Oracle 9i + Oracle JDBC driver v10.2.0.1, Oracle JDBC driver v10.2.0.2 + + + Microsoft SQL Server 2005 + Microsoft SQL Server 2005 driver, v1.1.1501.101 + + + MySQL v5.0 + mysql-connector-java v5.0.4 + + + PostgreSQL v8.1 + PostgreSQL v8.2 JDBC3 with SSL (build 504) + + + +
+
+ = +
+ Running JUnit Tests + = - Provide a summary of new features applicable to this release. = + It is recommended that the Hibernate unit tests be executed using the = same dialect and version of JDBC that will be used in production, to ensure= that the configuration setting, hibernate.jdbc.batch_versioned_d= ata, is set properly. The value for hibernate.jdbc.ba= tch_versioned_data determines if Hibernate will use batches for = updating versioned data (an optimization). = -
-
- Bug Fixes - The following bugs have been addressed and resolved in this release. = + Optimistic locking relies on the ability to obtain the number of rows = updated. If the JDBC driver does not return update counts for each command = in a batch, then hibernate.jdbc.batch_versioned_data s= hould be set to "false". = + + The unit tests use the settings in etc/hibernate.properties<= /filename>. The value for hibernate.jdbc.batch_versioned_data is set to true in that file. If the unit tes= ts involving optimistic locking fail, then the appropriate value for this f= lag is false. Some versions of Oracle JDBC do not s= upport returning update counts for each command in a batch, so it is partic= ularly important to test using the same version of JDBC as will be used in = production. + + = +
+ Expected failures and tests + + The following unit tests are expected to fail: + + = + = + + Ehcache tests (Ehcache is not provided in this distribution): + + + org.hibernate.test.cache.ehcache.EhCacheTest.testQueryCacheInvalidat= ion + org.hibernate.test.cache.ehcache.EhCacheTest.testEmptySecondLevelCac= heEntry + org.hibernate.test.cache.ehcache.EhCacheTest.testStaleWritesLeaveCac= heConsistent + + + + Expected unit test failure against MS SQL 2005 + + org.hibernate.test.legacy.MasterDetailTest.testCachedCollectionRefre= sh + + + + + "FailureExpected" tests (known issues to be addressed in the future)= : = + + + org.hibernate.test.hql.ASTParserLoadingTest.testParameterTypeMismatc= hFailureExpected + org.hibernate.test.hql.CriteriaHQLAlignmentTest.testCriteriaAggregat= ionReturnTypeFailureExpected + org.hibernate.test.hql.HQLTest.testEmptyInListFailureExpected = + org.hibernate.test.hql.HQLTest.testMaxindexHqlFuncttestMultipleEleme= ntAccessorOperatorsFailureExpectedionInElementAccessorFailureExpected + org.hibernate.test.hql.HQLTest.testMultipleElementAccessorOperatorsF= ailureExpected + org.hibernate.test.hql.HQLTest.testKeyManyToOneJoinFailureExpected + org.hibernate.test.hql.HQLTest.testDuplicateExplicitJoinFailureExpec= ted + org.hibernate.test.keymanytoone.bidir.component.EagerKeyManyToOneTes= t.testLoadEntityWithEagerFetchingToKeyManyToOneReferenceBackToSelfFailureEx= pected + org.hibernate.test.legacy.SQLLoaderTest.testReturnPropertyComponentR= enameFailureExpected + org.hibernate.test.readonly.ReadOnlyTest.testReadOnlyOnProxiesFailur= eExpected + org.hibernate.test.sql.hand.query.NativeSQLQueriesTest.testComposite= IdJoinsFailureExpected = + + =
-
+
+ Fixed Issues + + + <ulink url=3D"http://jira.jboss.org/jira/browse/HIBERNATE-92">HIBERNAT= E-92</ulink> - Update dependencies to be consistent with EAP 4.2 CP03 + + + This release bundle has been made consistent with the Hibernate releas= e embedded in JBoss EAP version 4.2 CP03. = + + + + + <ulink url=3D"http://jira.jboss.org/jira/browse/JBPAPP-357">JBPAPP-357= / HHH-2542</ulink> - <parameter>NullPointerException</parameter> in <prope= rty>TypeFactory.replaceAssociations</property> for <property>ComponentType<= /property> = + + + This bug which arises when a NULL value has been pa= ssed into ComponentType object has been fixed. + + + + + <ulink url=3D"http://opensource.atlassian.com/projects/hibernate/brows= e/HHH-1569">JBPAPP-740 / HHH-1569</ulink> - Immutable Natural Id can fail w= ith ArrayIndexOutOfBounds in some cases + + + When the natural-id has been set with = mutable as false, then it may cause ArrayIndexOutOfBounds errors in some cases. This issue h= as been resolved. + + + + + <ulink url=3D"http://opensource.atlassian.com/projects/hibernate/brows= e/HHH-2631">JBPAPP-742 / HHH-2631</ulink> - Leaking <property>PreparedState= ment</property> and <parameter>ResultSet</parameter> via <property>Collecti= onLoadContext</property> instances maintained in Map <property>collectionLo= adContexts</property> in <property>LoadContexts</property> + + + The number of PreparedStatement and Re= sultSet instances had increased causing memory consumption in o= ne instance. The JIRA issue contains the full details. + + + + + <ulink url=3D"http://opensource.atlassian.com/projects/hibernate/brows= e/HHH-2662">JBPAPP-741 / HHH-2662</ulink> - Workarounds for <application>Po= stgreSQL</application> issues arising from test suite + + + Few issues that arose from test suite with PostgreSQL has been resolved. + + + + + <ulink url=3D"http://jira.jboss.org/jira/browse/JBPAPP-743">JBPAPP-743= / HHH-2663</ulink> - Map <property>java.sql.Types.REAL</property> to Hiber= nate <property>FloatType</property> = + + + This is an added functionality to allow the use of REAL type. + + + + + <ulink url=3D"http://jira.jboss.org/jira/browse/JBPAPP-744">JBPAPP-744= / HHH-2665</ulink> - Split <property>Oracle9Dialect</property> into <prope= rty>Oracle9iDialect</property> and <property>Oracle10gDialect</property> + + + Hibernate now checks Oracle database dialec= ts for versions 9i and 10g. = + + + + + <ulink url=3D"http://jira.jboss.org/jira/browse/JBPAPP-188">JBPAPP-18= 8 / HHH-2630</ulink> - Hibernate Dialect is not auto-detected for <applicat= ion>Sybase ASE</application> and <application>DB2</application> = + + + Auto detection of these two dialects are now enabled in this release. + + + = +
+
Documentation - - List all the documentation links here and where to find them. = - = + + + + The Hibernate reference guide= is a comprehensive source of material for learning about Hibernate. It kic= ks off with an example to get you started with Hibernate, lists the major f= unctionality of Hibernate, offers design solutions and suggests best practi= ses. = + = + + + + The Hibernate Core API Reference guide will be helpful during application development. + + +
- Product Support - - List all the links here. = - = + Product Support and License Website Links + + Support Processes + + http://www.redha= t.com/support/process/ + + + = + + + Production Support Scope of Coverage + + + htt= p://www.redhat.com/support/policy/soc/production + + + = + + + Production Support Service Level Agreement + + = + + ht= tp://www.redhat.com/support/policy/sla/production/ + + + = + + + Developer Support Scope of Coverage + + = + + htt= p://www.redhat.com/support/policy/soc/developer/ + + + = + + + Developer Support Service Level Agreement + + = + + htt= p://www.redhat.com/support/policy/sla/developer/ + + + = + + + Product Update and Support Policy by Product + + = + + htt= p://www.redhat.com/security/updates/jboss_notes/ + + + = + + + JBoss End User License Agreement + + = + + http://w= ww.redhat.com/licenses/jboss_eula.html + +
--===============0083856428689136419==--