===============
SpaceMemcached
===============

memcached(http://danga.com/memcached) is a high-performance, distributed memory
object caching system, generic in nature, but intended for use in speeding up
dynamic web applications by alleviating database load.

SpaceMemcached is one memcached server implemented by pure java language.includes:
- Memcached protocol implemented in Grizzly(https://grizzly.dev.java.net) nio server.
- Cache implemented with GigaSpaces(http://www.gigaspaces.com) back end .

Currently it's beta not feature complete, supports only part of the memcached protocol.

===================
How To Start
===================
1. move this directory as C:\GigaSpacesXAP6.0\SpaceMemcached ("C:\GigaSpacesXAP6.0" iswhere your gigaspaces installed)

2. Run "bin/SpacesMemcached.bat -h" to see help infomation:
 -h,--help      help infomation
 -l,--listen    address, your IP or hostname, default is 127.0.0.1
 -p,--port      port, default is 11211
 -s,--space     space url, default is "/./memcachedSpace"
 -v,--version   version

If you want to use your running space(assume its url is "jini://localhost/*/mySpaceMap"), you could use follow:
bin/SpacesMemcached.bat -s jini://localhost/*/mySpaceMap
OR, If you want use default space to demo, just run
bin/SpacesMemcached.bat
It's OK.


===================
How To Run the Demo
===================
1. move this directory as C:\GigaSpacesXAP6.0\SpaceMemcached ("C:\GigaSpacesXAP6.0" iswhere your gigaspaces installed)
   now your structure is like :
		C:\GIGASPACESXAP6.0
		\---SpaceMemcached
		    +---bin
		    +---classes
		    +---docs
		    +---lib
		    +---README.txt
		    +---build.xml
		    \---src
2. build source code: ant compile
3. run demo space: bin/run_gs.bat
4. run spacememcached: bin/run_SpaceMemcached.bat
5. test the protocols: bin/run_Test.bat
   now you could see follow results:
    [true]set
    [true]get
    [true]gets
    [true]add
    [true]replace
    [true]delete
    [true]incr
    [true]decr
    [true]flush_all
    {localhost/127.0.0.1:11211=0.5}

TODO
-----
- Command(cas,STAT,verbosity),
- binary protocol
- UDP connection