jetty-session-redis

Jetty session clustering with Redis

License

License

Categories

Categories

Jetty Container Application Servers Redis Data Databases
GroupId

GroupId

com.ovea
ArtifactId

ArtifactId

jetty-session-redis
Last Version

Last Version

2.3.ga
Release Date

Release Date

Type

Type

jar
Description

Description

jetty-session-redis
Jetty session clustering with Redis
Project Organization

Project Organization

Ovea
Source Code Management

Source Code Management

http://github.com/Ovea/jetty-session-redis

Download jetty-session-redis

How to add to project

<!-- https://jarcasting.com/artifacts/com.ovea/jetty-session-redis/ -->
<dependency>
    <groupId>com.ovea</groupId>
    <artifactId>jetty-session-redis</artifactId>
    <version>2.3.ga</version>
</dependency>
// https://jarcasting.com/artifacts/com.ovea/jetty-session-redis/
implementation 'com.ovea:jetty-session-redis:2.3.ga'
// https://jarcasting.com/artifacts/com.ovea/jetty-session-redis/
implementation ("com.ovea:jetty-session-redis:2.3.ga")
'com.ovea:jetty-session-redis:jar:2.3.ga'
<dependency org="com.ovea" name="jetty-session-redis" rev="2.3.ga">
  <artifact name="jetty-session-redis" type="jar" />
</dependency>
@Grapes(
@Grab(group='com.ovea', module='jetty-session-redis', version='2.3.ga')
)
libraryDependencies += "com.ovea" % "jetty-session-redis" % "2.3.ga"
[com.ovea/jetty-session-redis "2.3.ga"]

Dependencies

compile (4)

Group / Artifact Type Version
org.codehaus.jackson : jackson-core-asl Optional jar 1.9.0
org.codehaus.jackson : jackson-mapper-asl Optional jar 1.9.0
com.thoughtworks.xstream : xstream Optional jar 1.3.1
trove : trove Optional jar 1.0.2

provided (2)

Group / Artifact Type Version
redis.clients : jedis jar 2.0.0
org.eclipse.jetty.aggregate : jetty-all jar 8.1.0.RC2

test (6)

Group / Artifact Type Version
org.testatoo.container : testatoo-container-jetty jar 1.0.ga
org.mortbay.jetty : jsp-2.1-glassfish jar 9.1.1.B60.25.p2
junit : junit jar 4.9
log4j : log4j jar 1.2.16
org.slf4j : slf4j-log4j12 jar 1.6.1
org.slf4j : slf4j-api jar 1.6.1

Project Modules

There are no modules declared in this project.

Jetty session clustering with REDIS

Build instruction:

git clone git://github.com/Ovea/jetty-session-redis.git
cd jetty-session-redis
mvn package

Download

All downloads are here. They will also be available in Maven central repository and also in Sonatype OSS repositories soon:

See the section below to know which package you need (the jar file or the -all bundle).

Installation

You need to put in Jetty's lib/ext folder:

  • jedis
  • commons-pool

and one of the following JAR:

  • jetty-session-redis-X.Y.jar (if you are going to put all serializer dependencies also as independant jar files)
  • jetty-session-redis-X.Y-all.jar (contains already packaged-relocated serializers)

I strongly recommand you use the jetty-session-redis-X.Y-all.jar because some serializers (like JBoss Serializer) have been improved for performance.

Configuration

In Jetty server configuration file (i.e. jetty.xml):

<?xml version="1.0"?>
<!DOCTYPE Configure PUBLIC "-//Jetty//Configure//EN" "http://www.eclipse.org/jetty/configure.dtd">
<Configure id="Server" class="org.eclipse.jetty.server.Server">

    <!--
        Configure session id management
    -->
    <Set name="sessionIdManager">
        <New class="com.ovea.jetty.session.redis.RedisSessionIdManager">
            <Arg>
                <Ref id="Server"/>
            </Arg>
            <Arg>session/redis</Arg>
            <!-- time interval to check for expired sessions in redis cache, in milliseconds. Defaults to 1 min -->
            <Set name="scavengerInterval">30000</Set>
            <!-- cluster node name -->
            <Set name="workerName">
                <SystemProperty name="jetty.node" default="node1"/>
            </Set>
        </New>
    </Set>

    <!--
        Provides a Redis Pool for session management on server and each webapp
    -->
    <New class="org.eclipse.jetty.plus.jndi.Resource">
        <Arg>session/redis</Arg>
        <Arg>
            <New class="redis.clients.jedis.JedisPool">
                <Arg>
                    <New class="org.apache.commons.pool.impl.GenericObjectPool$Config">
                        <Set type="int" name="minIdle">5</Set>
                        <Set type="int" name="maxActive">15</Set>
                        <Set type="boolean" name="testOnBorrow">true</Set>
                    </New>
                </Arg>
                <Arg>127.0.0.1</Arg>
                <Arg type="int">6379</Arg>
            </New>
        </Arg>
    </New>

</Configure>

In each web application context file using session clustering (i.e. in WEB-INF/jetty-env.xml):

<Configure id="webappContext" class="org.eclipse.jetty.webapp.WebAppContext">

    <Set name="contextPath">/webapp1</Set>

    <Set name="sessionHandler">
        <New class="org.eclipse.jetty.server.session.SessionHandler">
            <Arg>
                <New class="com.ovea.jetty.session.redis.RedisSessionManager">
                    <Arg>session/redis</Arg>
                    <Arg>
                        <New class="com.ovea.jetty.session.serializer.JsonSerializer"/>
                    </Arg>
                    <!-- set the interval in seconds to force session persistence event if it didn't changed. Default to 60 seconds -->
                    <Set name="saveInterval">20</Set>
                    <!-- set the cookie domain -->
                    <Set name="sessionDomain">127.0.0.1</Set>
                    <!-- set the cookie path -->
                    <Set name="sessionPath">/</Set>
                    <!-- set the cookie max age in seconds. Default is -1 (no max age). 1 day = 86400 seconds -->
                    <Set name="maxCookieAge">86400</Set>
                    <!-- set the interval in seconds to refresh the cookie max age. Default to 0. This number should be lower than the session expirity time. -->
                    <Set name="refreshCookieAge">300</Set>
                </New>
            </Arg>
        </New>
    </Set>

</Configure>

Note: Jetty's default for maxCookieAge is -1 and as per my tests, setting it to a too short value may cause issues in session retrieval.

Controlling session serialization

By default, session attributes are serialized using XStream, but this is clearly the worst serializer and you must make sure that you configure the serializer according to your needs. If you have small sessions with simple types, consider the JsonSerializer. If you have complexe objects but all serializable, you can consider the JbossSerializer. You can also create your own ones byt implementing the Serializer class of a provided skeleton (see examples here).

Here is the list of provided Serializer:

  • com.ovea.jetty.session.serializer.JsonSerializer

  • com.ovea.jetty.session.serializer.JdkSerializer

  • com.ovea.jetty.session.serializer.XStreamSerializer

  • com.ovea.jetty.session.serializer.JBossSerializer

    session/redis

Debugging

If you need to troobleshoot something, you can put Jetty in DEBUG mode and see the traces from RedisSessionManager and RedisSessionIdManager.

Also, with Redis you have the ability to monitor all the calls. Simply issue in a command-line:

redis-cli monitor

To see all Redis requests going to the Redis server. If you are using a String serializer such as XStream of Json, you'll be able to see all your session attributes into.

Versions & Compatibility

The latest release (>= 2.1.ga) must be used with at least these dependencies:

  • com.ovea:jetty-session-redis:2.1.ga:serialjson
  • org.eclipse.jetty.aggregate:jetty-all:8.0.2.v20111006
  • org.mortbay.jetty:servlet-api:3.0.20100224
  • redis.clients:jedis:2.0.0
  • commons-pool:commons-pool:1.5.6

Authors and help

com.ovea

OVEA

Versions

Version
2.3.ga
2.2.ga
2.1.ga
2.0.ga
2.0.rc1
1.0