<document>
<localtoc/>

Resin 3.1.x is a development branch. New capabilities will be added along with bug fixes for future versions of the Resin 3.1.x branch.

Deployments which need a Resin version with only bug fixes should use the Resin 3.0.x branch.

A number of bugs in Amber have been fixed in Resin 3.1.1. If you were trying JPA with Resin 3.1, we strongly recommend that you upgrade to the latest version.

The current stage is recommended if you want to create applications with JPA or if you are moving applications to JPA. Either way, it will be worth the effort since you will not need to wait until the next official release to start developing applications.

For now, the default persistence context type (TRANSACTION) is fully supported, while the EXTENDED type is not yet implemented, but will be included with the next release. Also, with the next release, we are expecting significant performance gains when compared to other JPA implementations.

Quercus is now faster in both interpreted and compiled mode, due to smarter handling of strings and faster function calls.

Java classes are now treated the same as PHP classes. This means that PHP classes can now extend Java classes and you can instantiate a Java class using the 'new CLASSNAME()' syntax.

Quercus supports the Quercus-only 'import' keyword within PHP scripts. It is used to automatically import Java classes and PHP classes when needed.

Quercus supports the overloading of Java functions. Quercus will determine which function to call based on the number and type of arguments passed in.

PHP's try-catch will now catch Java Exceptions.

Header conditions are now available in rewrite-dispatch.

<example> <web-app xmlns="http://caucho.com/ns/resin"> <rewrite-dispatch> <redirect regexp="/test" target="/google"> <require header="Referer" regexp="google"/> </redirect> </rewrite-dispatch> </web-app> </example>

Resin 3.1.1 adds a --log-directory argument to configure the location for the watchdog-manager.out and jvm-*.log files.

The log directory is relative to the --root-directory and defaults to "log".

Resin 3.1.1 features development versions of JAXB, JAX-WS, and SAAJ. All of the most common features have been implemented, except for Java code generation from Schema or WSDL.

Resin's JAX-WS and Service-Oriented Architecture (SOA) features easy deployment for services and proxy creation for clients.

Resin's administration page has been cleaned up and now includes new features including:

- Thread dumps
- Profiling
- Heap dumps
- Cache statistics

The profiling has a relatively low overhead, so many deployments can use it on live servers to get accurate performance information.

We strongly recommend Resin users look at the new administration features.

</document>