Caucho maker of Resin Server | Application Server (Java EE Certified) and Web Server


Resin Documentation

home company docs 
app server 
 Resin Server | Application Server (Java EE Certified) and Web Server

resin 3.1.0 release notes

Resin 3.1.x

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.

Servlet 2.5

Resin 3.1 adds Servlet 2.5 support. The Servlet 2.5 specification adds annotation-based injection to servlets, filters, and listeners. Servlets can now mark a field as a @Resource and Resin will assign the configured database, bean, or service to the field, avoiding the need for a JNDI lookup.

Database configuration
package example;

import javax.annotation.Resource;
import javax.servlet.*;
import javax.sql.*;

public class MyServlet extends GenericServlet {
  private DataSource _database;

  public void service(ServletRequest req, ServletResponse res)

Amber capabilities

With Resin 3.1, the JPA features have been reviewed. Amber now provides a near to complete and stable implementation of the JPA specification.

JPA queries are fully supported, including queries with parameters, named queries, and subqueries. The javax.persistence.Query API is also supported, including date/time (temporal) data types.

Embedded properties and optimistic-locking with version fields have been added to Amber in Resin 3.1. Also, inheritance combined with many-to-one, one-to-many, one-to-one, and many-to-many relationships have been reviewed and are now totally stable following the final release of the JPA specification.

Finally, an object relational mapping file (orm.xml) can now be merged together with annotations, when present. In other words, with Resin 3.1, the set of JPA features supported by Amber is near to complete, i.e., only a few unusual features will be added to the next release.

watchdog/startup changes

Resin 3.1 now uses a Java watchdog process to manage Resin instances for reliability. Like the older 3.0, it detects if the instance has stopped and restarts it automatically.

Because the watchdog is now a Java process, the Resin start and stop can now use a Java -jar command:

starting server web-a
unix> java -jar $RESIN_HOME/lib/resin.jar -server a start

Also, because the Resin instance is started from Java itself, the JVM command-line arguments must now be specified in the resin.conf.

JVM command-line arguments

With Resin 3.1, JVM command-line arguments are specified in the resin.conf. The watchdog JVM will read the resin.conf, select the proper <server>, and apply the server's arguments. As usual, the <server-default> tag can provide common defaults.

setting -Xmx and -Xss
<resin xmlns="">
  <cluster id="app-tier">


      <http port="8080"/>

    <server id="app-a" address="" port="6800"/>
    <server id="app-b" address="" port="6800"/>


resin.conf changes to cluster and server

Resin 3.1 has swapped the order of the <cluster> and <server> configuration tags to make the resin.conf more powerful and understandable. (The old Resin 3.0 syntax is still allowed for backwards compatibility.) In addition, the new configuration matches the JMX MXBeans more cleanly. With Resin 3.1, all servers in a load-balancing configuration can be defined in a single resin.conf.

A <server> configures a Resin JVM instance. It defines the <http> and cluster ports to listen to, JVM arguments, thread limits, keepalives and timeouts. In other words <server> configures JVM instance information which changes from instance to instance.

See <server> tag for the new server tags.

The <cluster> is a collection of servers serving identical content. So the <cluster> contains a set of <server> tags, plus the <host>, <resource>, and the <web-app> configuration common to all servers.

<cluster> tag for the new cluster tags.

The following example shows a basic load-balancing configuration in Resin 3.0 with a set of web-tier servers load balancing to a larger set of app-tier servers. Since the web-tier includes a proxy <cache> configuration, the web-tier will serve static files without extra overhead.

<resin xmlns="">
  <cluster id="web-tier">

       <http port="80"/>

    <server id="web-a" address="">
    <server id="web-b" address="">

    <cache disk-size="1024m" memory-size="128m"/>

    <host id="">
      <web-app id="/">
          <load-balance regexp="" cluster="app-tier"/>

  <cluster id="app-tier">

    <server id="app-a" address="">
    <server id="app-b" address="">
    <server id="app-c" address="">

      <web-app-deploy path="webapps"/>

    <host-deploy path="hosts"/>

Web services capabilities and configuration

Documentation for the new web services capabilities is in the web services section.

Resin has updated its configuration for web services like Hessian, and has extended the web service capabilities to include SOAP and VM-local requests.

Applications can write to standard @WebService APIs, using JAXB annotations for marshalled XML (or marshalled Hessian), and export the services as Hessian, SOAP or Rest.

Configuration has been simplified:

<web-service> configuration
<web-app xmlns="">

  <servlet-mapping url-pattern="/hello/*"

    <!-- jndi registration for direct VM calls -->

    <!-- IoC-style configuration -->
      <hello>hello, world</hello>

    <!-- soap, hessian, burlap protocols -->
    <protocol type="hessian">


The client proxy can now be configured as well. Applications can now write to the client APIs without worrying about proxy generation.

<web-app xmlns="">

<web-service-client jndi-name="hessian/HelloService">


JAXB for Config IoC

See JAXB Bean Configuration tutorial


Quercus now supports the i18n and l10n features of PHP. This includes gettext, iconv, and multi-byte strings. In addition, Quercus has PHP6 Unicode support in anticipation of the upcoming release of PHP6.

Added Java serialization support for Quercus/PHP types. Hessian/Burlap will be able to serialize/deserialize Quercus objects with no problem.

Revamped PHP-Java type marshaling.

Applications Running on Quercus

  1. DokuWiki 2006-11-06
  2. Dragonfly CMS
  3. Drupal 4.7.4
  4. Gallery2
  5. Joomla 1.0.11
  6. Mambo
  7. Mantis
  8. MediaWiki
  9. Phorum 5.1.16a
  10. phpBB 2.0.21
  11. phpMyAdmin
  12. PHProjekt 5.2
  13. PHP-Nuke
  14. Wordpress 2.0.5
  15. Xoops 2.0.16



Added clear() operation to clear idle connections in the pool.

Copyright © 1998-2015 Caucho Technology, Inc. All rights reserved. Resin ® is a registered trademark. Quercustm, and Hessiantm are trademarks of Caucho Technology.

Cloud-optimized Resin Server is a Java EE certified Java Application Server, and Web Server, and Distributed Cache Server (Memcached).
Leading companies worldwide with demand for reliability and high performance web applications including, CNET, DZone and many more are powered by Resin.

home company docs 
app server