# memcached.distributedSession

**Repository Path**: ufo5260987423/memcached.distributedSession

## Basic Information

- **Project Name**: memcached.distributedSession
- **Description**: 基于MemCached的session共享插件，可以使得应用服务器集群通过Memcached集群共享session。目前支持Tomcat6以上版本。
- **Primary Language**: Java
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 91
- **Forks**: 34
- **Created**: 2015-01-29
- **Last Updated**: 2025-06-24

## Categories & Tags

**Categories**: web-dev-toolkits

**Tags**: None

## README

# memcached.distributedSession

------

Lastest Version:0.1.0-beta

------
## Introduce

This tool based on MemCached aims to act as a session-share-component for servers, which include Tomcat 6 and all the higher version.And what you really have to do is just write the configuration file and provide the necessary infomation of memcached servers .

#### Version 0.1.0's features

 1. **BackupControlerInf** allows you to set backup of sessions.And you can use "backupAmount" attribute to set the amount of backups.
 2. **DistributedSessionsConcurrentHashMap** allows your application servers regard MemCached Cluster as a giant concurrent hash map.

## How to use

### Configuration
Add listed code to $Catalina_Home/conf/context.xml and surround it with "context" tag.

    <Manager className="com.ufo5260987423.memcached.distributedSession.manageProxy.TomcatProxy"
	addresses="192.168.0.104:11211"
	nodeName="Jerry" />

And the addresses attribute is the string of MemCached Servers' addresses blanked with spaces.Further more, nodeName is the identifier of tomcat server.

### References package
It's necessary to add slf4j-api-1.7.5.jar and xmemcached-2.0.0.jar to $Catalina_Home/lib. Of course you should add this tool to the folder. And please run command "mvn package" in order to compile this jar.

### Attention
When Compile your own jar,please modify the /src/test/resources/applicationContext.xml for unit test.Or your compile may fail.