Hibernate Issues

JBPAPP-2440

When a cache provider could not be found, a NoClassDefFoundError was thrown with the message: net/sf/ehcache/CacheException.

When a connection provider could not be found, a HibernateException was thrown with the following message: Could not instantiate connection provider: " + providerClass

More informative messages are now thrown when these errors occur.

JBPAPP-3223

Hibernate Query Language (HQL) did not support tuple syntax. Additionally, on those databases that did not support tuple syntax, database criteria was not being translated from tuple syntax to an interpretable syntax. This caused issues with database queries and HQL searches. The fix now supports tuple syntax in HQL, and for those databases where tuple support is not available, Hibernate now converts the query to an appropriate format. For example:

where (a,b) in ( (1,2), (3,4) )

is now converted to:

where ( (a=1 AND b=2) OR ( (a=3 AND b=4) )

JBPAPP-3946

LikeExpression did not handle the ignoreCase flag properly when ignoreCase was set to false. The correct SQL property like ? was built, but the flag inside getTypedValues was not used, and a lowercase value was always produced. This issue has been fixed, and lowercase or the original case is used when ignoreCase is set to false.

JBPAPP-4088

When a column name was defined in backticks (`), @JoinTable and @JoinColumn mappings failed with AnnotationException when the column name with backticks was referenced. Hibernate now compares the referencedColumnName with the column's quote name rather than the table column's name.

JBPAPP-4095

When scrolling a HQL query with join fetch on a collection, FetchingScrollableResultsImpl.last() does not move to the last result if the cursor is positioned after the last result. Instead, the cursor stays in position after the last result. This can cause org.hibernate.exception.GenericJDBCException: could not perform sequential read of results. The fix ensures that the cursor moves to the last result as expected.

JBPAPP-4123

PostgreSQL failed to drop SchemaExport if constraint names changed, causing constraint errors. Hibernate now issues a cascade when it attempts to drop a table, fixing the issue.

JBPAPP-4326

The changes for JBPAPP-4471 caused an issue when users mapped non-JDK Serializable classes with SerializableType, and attempted to cache those values into a second level cache. SerializableType reported the classloader of java.io.Serializable as the classloader to use for deserialization. However, this classloader could not see into the classloader, or non-JDK classes.

The classloader from org.hibernate.util.SerializationHelper.deserialize(InputStream, ClassLoader) now attempts to resolve the classloader that needs to be deserialized. If it cannot do this successfully, it uses the context classloader from the current thread and the classloader that loads the Hibernate class.

JBPAPP-4599

A bug in Hibernate caused the following exception to be thrown: java.lang.IllegalArgumentException: alias not found: tbl. A table object could not be saved to Oracle. A temporary workaround was devised to use an enhanced sequence instead, but this was not an optimal solution. The Hibernate code was updated to fix this flaw. Table objects are now able to be saved to Oracle, as expected.

JBPAPP-4716

The annotation @Tables.values was a typographical error, and should have been @Tables.value. This was fixed in Hibernate, but the fix broke backward compatibility with code that depended on the old annotation. @Tables.values was added back in, and tagged with @Deprecated. It should not be used.

JBPAPP-4927

The cascade-save operation was incorrectly handling auto-incremented Primary Key (PK) tables that linked to parent tables with an assigned PK. The fix now allows the cascade-save operation to handle the parent-child relationship between tables.

JBPAPP-5156

The Hibernate Deployer (org.jboss.hibernate.jmx.Hibernate) controls .har deployments.

In JBoss Enterprise Application Platform 4.3.0 CP08, the Hibernate Deployer's AUTO_CLOSE_SESSION and FLUSH_BEFORE_COMPLETION parameters were set to true by default. Customers migrating from older versions of Hibernate were encountering errors when using session.close() in finally blocks. Session was already closed and Session is closed errors occurred when deploying Hibernate archives (.har). In this release, AUTO_CLOSE_SESSION and FLUSH_BEFORE_COMPLETION are set to false by default. This prevents issues with backwards compatibility, and returns functionality to expected behavior.

Clustering Issues

JBPAPP-4473

Single Sign On (SSO) is a specialized form of user authentication that enables a user to be authenticated once, and gain access to resources on multiple systems/web applications during that session.

Clustered SSO was not considering the Tomcat or JBoss Web host or context when counting SSO sessions. If a user was actively using multiple web applications with the same SSO session ID, the user could be logged out unexpectedly because the host or context of the application was excluded from the Clustered SSO session count. Clustered SSO interaction has been refactored with JBoss Cache (JBC) into a pluggable component that includes Tomcat and JBoss Web host and context. The refactored SSO corrects the problem with host and context issues.

General Issues

JBPAPP-4917

Xalan is an XSLT (Extensible Stylesheet Language Transformation) processor for transforming XML documents into HTML, text, or other XML document types. Cause:

The XMLReaderManager (org.apache.xml.utils.XMLReaderManager) class of Xalan was creating a XMLReader in ThreadLocal, but was not removing the XMLReader from ThreadLocal (setting to null) when the XMLReader finished.

This created a permanent leak for customers running Xalan under a JDK 1.5.0_6 environment. The magnitude of the leak was exacerbated by the size of the XML file the XMLReader was required to parse, and the load the server was under. Fix, and Result:

Changes to the way Xalan handles XMLReader in ThreadLocal have been made to Xalan 2.7.0 which prevent XLST transformations from creating erroneous extra nodes.

Seam1 Issues

JBPAPP-4803

An input sanitization flaw was found in the way JBoss Seam processed certain parametrized JBoss Expression Language (EL) expressions. A remote attacker could use this flaw to execute parameterless methods on Seam components via a URL, containing appended, specially-crafted expression language parameters, provided to certain applications based on the JBoss Seam framework. This release contains enhanced security that prevents malicious interaction using EL expressions.

Red Hat would like to thank Meder Kydyraliev of the Google Security Team for responsibly reporting this issue.

Seam2 Issues

JBPAPP-3125

The Drools version in JBoss Enterprise Application Platform has been upgraded to the binaries used in SOA 4.3 CP02, and the jBPM version is now upgraded to v3.2.9.

JBPAPP-4060

Short pause interval durations, and test method isolation issues were causing the Quartz example test to fail on RHEL4 and IBM JVM 1.6. The testsuite now isolates separate test methods using individual accounts for each test method, and the pause interval has been increased from 50ms to 1000ms. This results in better isolation between tests in the testsuite.

JBPAPP-4064

An incorrect version of RichFaces was bundled with Seam 2.0.2, causing some RichFaces components to fail or work incorrectly. This has now been fixed, by bundling the correct version of RichFaces (3.3.1) with Seam.

JBPAPP-4260

Seam-gen templates used resource:// for objects that were not on the classpath. This resulted in an error when trying to transform a RichFaces template (XCSS) into a CSS file. Seam-gen no longer uses resource://, fixing the issue.

JBPAPP-4316

Duplicate Seam components on the class path were not being ignored, which caused an IllegalStateException during initialization. Duplicate classes are now ignored, and different classes with the same component name and precedence are correctly detected. The expected exception is thrown when these conditions are not met.

JBPAPP-4492

A flaw in the PassivatedEntity.passivateEntity() method created the possibility of extra attributes being added to the conversation context during the passivation phase. A concurrentModificationException would be thrown. The flaw was addressed, and concurrentModificationException is no longer thrown.

JBPAPP-4686

An input sanitization flaw was found in the way JBoss Seam processed certain parametrized JBoss Expression Language (EL) expressions. A remote attacker could use this flaw to execute parameterless methods on Seam components via a URL, containing appended, specially-crafted expression language parameters, provided to certain applications based on the JBoss Seam framework. This release contains enhanced security that prevents malicious interaction using EL expressions.

Red Hat would like to thank Meder Kydyraliev of the Google Security Team for responsibly reporting this issue.

JBPAPP-5312

Bash script seam2/seam has executable permission only on some Linux systems. This is caused by a different zip utility implementation included in the distribution. Executable permissions are now assigned to seam2/seam correctly for the following operating systems:

• Fedora 13
• Red Hat Enterprise Linux 4
• Red Hat Enterprise Linux 5
• Red Hat Enterprise Linux 6

The fix is not available for the zip utility used on other operating systems such as Ubuntu.

JBPAPP-5379

When using the web services page of the Seambay example in Internet Explorer 8 (IE8), values entered in the user name and password fields were not propagating to the request area. Customers using Seambay were not able to proceed past the login screen without manually updating the values in the Request Area. The Seambay example now allows for the differing object model present in IE8 and checks for the Microsoft IE Document Object Model (DOM) implementation.

Documentation Issues

JBPAPP-2046

The Server Configuration Guide did not contain adequate sample configurations for data sources. Creating a datasource took more time and research than necessary. The Datasource Configuration chapter has been rewritten, and an appendix added with specific data sources for all certified databases. All certified databases now have sample configurations in the documentation.

JBPAPP-2950

Instructions for Specifying the Java Runtime Environment (JRE) for Windows users incorrectly suggested that the path to the JRE bin directory was required in Environment Variables. The procedure Specifying JRE for Windows in the Installation Guide now instructs users to set the JRE path to the JRE installation root directory, and includes instructions to set environment variables in Windows.

JBPAPP-3207

Customers were experiencing difficulties running the non-clustered Messaging examples using the All and Production server profiles because the Messaging User Guide did not contain clear instructions. Most Messaging examples are designed to run on non-clustered server profiles (all profiles, except All and Production). The chapter has been improved by separating the examples into clustered and unclustered sets, and also instructs the user to review the readme file shipped with each example for configuration instructions.

JBPAPP-4138

The Seam Reference Guide and Seam2 Reference Guide contained an incorrect reference to manually changing the mail-ra.rar component from the Seam project into the JBoss Application Server. Following these directions may have resulted in a customer implementing functionality that was not supported by Red Hat in the customer's production environment. The wording in the "Receiving Emails" section of both guides has been amended to guide the customer about the possible consequences of changing core components and the flow on effect to customer support.

JBPAPP-4638

The RNH section of the installation instructions for JBoss Enterprise Application Platform did not instruct customers to enable the Supplementary / Extra channel. The installation failed if the customer did not have the java-1.5.0-ibm and java-1.5.0-ibm-devel packages installed. The Installation Guide has been updated to include instructions for installing the Supplementary / Extra channel, and selecting the correct packages. RPM installation succeeds when following the updated instructions.

JBPAPP-5311

The JDK6 Compatibility Notes guide stated that JAX-WS support required the user to relocate certain .jar files to the jboss-as/lib/endorsed directory of the JBoss Enterprise Application Platform directory. The required files are now stored in the /endorsed directory by default. JAX-WS no longer requires special configuration in order for it to work.

EJB Issues

JBPAPP-4029

A Class Cast Exception (CCE) was thrown from a result set reader when user-type-mapped types were used in EJB-QL aggregate functions. EJB-QL functions are now implemented correctly, allowing user-type-mapped types to be used.

General Known Issues

JBPAPP-3050

When JBoss Enterprise Application Platform is started with the -b <hostname> flag, filtering by jboss.web:name=ajp-<hostname>/<ip_address>-8009,type=ThreadPool,* returns no results. This makes it impossible to use SNMP to export data to other monitoring tools because the configuration in deploy/snmp-adapter.sar/attributes.xml cannot find the bean.

It is worth noting that while the following definition does not work:

<mbean name="jboss.web:name=ajp-<hostname>/<ip_address>-8009,type=ThreadPool" oid-prefix=".1.2.3.4.1">

The following definition does work as expected:

<mbean name="jboss.web:name=ajp-<ip_address>-8009,type=ThreadPool" oid-prefix=".1.2.3.4.1">

JBPAPP-4172

Attempting to install the IBM JDK 1.5 on 64-bit Red Hat Enterprise Linux 5 results in broken links to Java binaries. This prevents the application server from starting. The workaround for this issue is to use the Sun JDK 1.6 instead.

JBPAPP-4917

When probe.sh terminates, it produces a list of terms that match a given string and a summary line that reflects the number of responses that matched the -match <string> parameter, for example:

Total responses=1, 1 matches, 3 non-matches

This summary line does not appear because a thread set up to close the multicast socket upon timeout causes the multicast socket to generate an exception and return before the summary line can be printed.

EJB Known Issues

JBPAPP-3908

When ValidateDTD is set to true in EJB deployer, standardjboss.xml validation fails because the properties for Message Driven Beans (such as those in JMSContainerInvoker) do not exist in jboss_4_2.dtd. To work around this issue, remove the reference to jboss_4_2.dtd in standardjboss.xml.

JBPAPP-5190

In clustered environments, the getCallerPrincipal method was causing an IllegalStateException when it was called from ejbActivate because StatefulHASessionPersistenceManager.synchroSession() did not allow getCallerPrincipal in the initial create method. The workaround for this issue is to move the getCallerPrincipal method from ejbActivate.

Messaging Known Issues

JBPAPP-2033

EnableMessageCounters on the jboss.messaging.ServerPeer JMX interface, cannot be set to true. A workaround to enable message counters is to invoke the enableMessageCounters() operation on the same JMX interface.

JBPAPP-3206

The JBoss Messaging examples included in the documentation bundle contain incorrect configuration information and do not work with JBoss Enterprise Application Platform. A corrected example archive is available for use with JBoss Enterprise Application Platform 4.3.0 CP09 from http://docs.redhat.com/docs/en-US/JBoss_Enterprise_Application_Platform/.

Replace the /docs/examples/jboss-messaging-examples directory in your distribution with the extracted contents of this archive. Further information is available from the JIRA if you wish to correct these examples manually. Note that the web service example does not work regardless.

JBPAPP-3352

If a message-driven bean is deployed with the default settings (useDLQ=true, DLQMaxResent=5) and message redelivery is prompted, messages remain in the queue in a "delivering" state even after the message is delivered to the dead letter queue.

The workaround for this issue is to disable the use of the dead letter queue: useDLQ=false.

JBPAPP-5420

Two JBoss Messaging Test Suite tests fail on Oracle 11g R1, R2 and RAC with the JDBC drivers v11.2.0.1.0 and v11.2.0.2.0:

• QueueManagementTest.testDestroyDestinationProgrammatically
• QueueManagementTest.testDestroyDestinationProgrammaticallyWithParams

These tests use a large value for the fullSize queue configuration parameter, which is passed to the setFetchSize method on the java.sql.PreparedStatement. A problem with the JDBC driver means that more than the usual amount of memory is consumed when executeQuery() is called, which results in a java.lang.OutOfMemoryError, causing the test to fail.

JBPAPP-5423

Oracle JDBC driver version 11.1.0.7.0 causes the JBoss Messaging Test Suite to fail with a SQLException ("Bigger type length than Maximum") on Oracle 11g R1. This was caused by a regression in Oracle JDBC driver 11.1.0.7.0.

To work around the issue, use Oracle JDBC driver version 11.2.0.2.0 with Oracle 11g R1, Oracle 11g R2, Oracle RAC 11g R1 and Oracle RAC 11g R2. Alternatively, you can set the FullSize attribute (defaults to 200000) in the Topic or Queue to a smaller value (for example, 65000) .

Hibernate Known Issues

JBPAPP-1545

On Sybase, when a query has an ANSI join with three or more joins, and one join involves a union subclass, the query may fail with SybSQLException because a column is not within the scope of the joined table expression. The current recommendation is to avoid using join fetches that involve union subclasses.

JBPAPP-1546

When using Sybase, SchemaExport cannot be used to create stored procedures while in chained transaction mode. The suggested workaround for this case is to add the following code after the new stored procedure definition:

<database-object>
   <create>sp_procxmode paramHandling, 'chained'</create>
   <drop/>
</database-object>

JBPAPP-1554

Sybase only allows only one entry (for example, column name or '*') in a subquery select list. The HQL function, elements(), fails when the collection elements have a composite ID, because the generated SQL contains a subquery select list with multiple entries. The workaround is to avoid using HQL elements() if the elements have a composite key. Instead, reformulate the HQL so that no subquery has multiple entries in its select list.

JBPAPP-1613

Null values for columns mapped as Boolean in Sybase are persisted as 0 instead of null. The workaround for this issue is to map type="org.hibernate.test.where.NumericTrueFalseType" instead of type="boolean".

JBPAPP-1709

The version of ejb3-persistence.jar shipped with the current version of JBoss Enterprise Application Platform 4.x is incorrect. Hibernate Entity Manager currently ships ejb3-persistence.jar 1.0.0.GA, but it should use ejb3-persistence.jar 1.0.1.GA. There are two changes between the 1.0.0.GA and 1.0.1.GA versions of the JAR:

1. The JPA specification defines the constant with a value that has a typo in the classname:

   javax.persistence.Persistence.PERSISTENCE_PROVIDER = "javax.persistence.spi.PeristenceProvider"

   Because the JAR inluded in the JBoss Enterprise Application Platform does not include this typo, it is not compliant with the JPA specification. See http://opensource.atlassian.com/projects/hibernate/browse/EJB-321 for details.
2. The Javadoc for javax.persistence.Query.getSingleResult() states that EntityNotFoundException will be thrown if there is no result. It should say NoResultException.

JBPAPP-1722

Sybase fails to insert a new entity if the entity overflows the column. However, it does not throw an exception, so Hibernate cannot tell that the insert has failed. To work around this issue, your application must validate entity properties to ensure that the value will not overflow the underlying column. Use one of the following workarounds:

1. Use jconn3.jar with DYNAMIC_PREPARE=true option (in Hibernate configuration file), and specify the correct JDBC driver. For example:

   <property name="connection.url">jdbc:sybase:Tds:aurum:1503/masterDb?   DYNAMIC_PREPARE=true</property>
   
   <property name="connection.driver_class">com.sybase.jdbc3.jdbc.SybDriver</ 
   property>

2. Use jconn4.jar, and specify the correct JDBC driver (in Hibernate configuration file). For example:

   <property name="connection.driver_class">com.sybase.jdbc4.jdbc.SybDriver</ 
   property>

JBPAPP-1895

The Hibernate tests JoinTest.java and QueryAndSQLTest.java fail when testing queries with untyped parameters for DB2 v91, which does not support untyped parameters. The UPPER function is very sensitive to parameter data types. Because a parameter marker doesn't have a type when it is pre-compiled, DB2 does not know what data type to use and raises an error.

Work around this issue by modifying queries so the parameters are cast to an appropriate data type. For example:.

UPPER(CAST(? AS CHAR(10)) 
UPPER(CAST(? AS VARCHAR(50))

JBPAPP-2315

Hibernate does not currently provide property types that enable applications to process data in a java.sql.Types.LONGVARCHAR or java.sql.Types.CLOB column as a Java String. Processing of a java.sql.Types.LONGVARBINARY or java.sql.Types.BLOB as a Java byte[] is also unavailable. These features are expected in JBoss Enterprise Application Platform 6 stream.

JBPAPP-2839

Failing to re-inject the interceptors for instrumented entities causes multiple NullPointerException when entities are retrieved from a deserialized PersistenceContext.

JBPAPP-2945

Setting the query timeout for a PreparedStatement is not supported by PostgreSQL 8.3.7. This limitation means that queries will fail if they use an annotation like the following:

@QueryHint(name = "org.hibernate.timeout", value = "100").

JBPAPP-3069

The QueryByExampleTest.testJunctionNotExpressionQBE builds a disjunction predicate such as ( OR^ (ex) (NOT ex) ). The test fails in Sybase because ansinull is set to off by default. This should match everything in the database, but because ANSI SQL evaluates all comparisons involving NULL values as UNKNOWN, not all matches are returned. The following workarounds exist:

1. Append the following string to the JDBC URL: ?SQLINITSTRING=set ansinull on
2. Execute the following Java code (or similar) after obtaining a Hibernate session s: s.connection().createStatement().execute("set ansinull on");

JBPAPP-3075

If a database reserved keyword is used as a property name with a Hibernate Validator annotation (for example, @Min or @Max), it will cause exceptions in SchemaExport, even if you specify a column name. This is because Hibernate ignores the name specified. The workaround is to map the property name to something that is not a database reserved keyword with the @Column annotation. The fix for this issue is expected in Hibernate 4.

JBPAPP-3913

In Oracle 11g R2 (both RAC and standalone), a sequence may start at 2 instead of 1. The root cause is still under analysis. There are currently two workarounds for this issue:

1. Use another ID generator class.
2. Disable deferred segment creation of Oracle by setting the initialization parameter DEFERRED_SEGMENT_CREATION to FALSE. The new clauses SEGMENT CREATION DEFERRED and SEGMENT CREATION IMMEDIATE are available for the CREATE TABLE statement. These clauses override the setting of the DEFERRED_SEGMENT_CREATION initialization parameter.

JBPAPP-4334

A bug in jConnect means that the FetchingScrollableResultsImpl.isResultSetEmpty() method returns the following to determine if a ResultSet is empty:

currentPosition == 0 && ! getResultSet().isBeforeFirst() && ! getResultSet().isAfterLast();

When the ResultSet is empty, FetchingScrollableResultsImpl.isResultSetEmpty()should return false but Sybase JDBC returns true. There is currently no workaround for this issue.

JBPAPP-4377

When Hibernate executes a cacheable query using a ResultTransformer, it will attempt to cache the results after applying the ResultTransformer. However, the data may be modified so that Hibernate cannot read it. In this case, a ClassCastException will occur when attempting to cache the results.

JBPAPP-4465

In Oracle 11g R2 (both RAC and standalone), a complex query with LockMode.UPGRADE (ie: "for update") may cause a No more data to read from socket error. The workaround is to not use LockMode.UPGRADE on such queries. The root cause analysis is still under investigation.

JBPAPP-5152

When a refresh() method is invoked immediately prior to an insert(), and second-level caching is enabled, the entity is inserted into the second-level cache. If the refresh() does not commit successfully, however, the cached data will not be automatically evicted. This occurs because refresh() does not track entity state. Since the refresh() operation is usually used for generated properties, one workaround for this issue is to use the @Generated annotation. Another workaround is to manually evict the cache entry.

Seam1 Known Issues

JBPAPP-4153

Java Server Faces applications that use ajax4jsf do not work with IBM JDK 1.6. The workaround for this issue is to use a different cache, such as OSCache, by setting the following environment variable:

org.ajax4jsf.cache.CacheFactory=org.ajax4jsf.cache.OSCacheCacheFactory

Alternatively, customers can turn off the cache by setting the following parameter in components.xml: enable-cache=false

components.xml is stored in the following locations within Seam:

• The WEB-INF directory of a WAR
• The META-INF directory of a JAR
• Any JAR directory containing classes with a @Name annotation.

Seam2 Known Issues

JBPAPP-4065

Several Seam 2.0.2 unit and integration tests fail on IBM JVM in Red Hat Enterprise Linux. The affected examples are the DVD store, booking, nested booking, register and seamdiscs examples.

JBPAPP-5350

Seam Expression Language (EL) code completion does not work in JBDS 4 for projects generated by seam-gen and imported into JBDS. To work around the issue, turn off Seam Support in the generated project, then reactivate it.