org.apache.jcs.auxiliary.lateral.socket.tcp
Class LateralTCPService

java.lang.Object
  org.apache.jcs.auxiliary.lateral.socket.tcp.LateralTCPService

All Implemented Interfaces:

ICacheObserver, ICacheService, ILateralCacheObserver, ILateralCacheService

public class LateralTCPService

extends java.lang.Object

implements ILateralCacheService, ILateralCacheObserver

A lateral cache service implementation. Does not implement getGroupKey

Version:

$Id: LateralTCPService.java 374766 2006-02-03 22:37:10Z asmuts $

Constructor Summary

LateralTCPService(ITCPLateralCacheAttributes lca)
Constructor for the LateralTCPService object

Method Summary

void	addCacheListener(ICacheListener obj) Subscribes to all caches.
void	addCacheListener(java.lang.String cacheName, ICacheListener obj) Subscribes to the specified cache.
void	dispose(java.lang.String cache) Will close the connection.
java.io.Serializable	get(java.lang.String key) The service does not get via this method, so this return null
ICacheElement	get(java.lang.String cacheName, java.io.Serializable key) Returns a cache bean from the specified cache; or null if the key does not exist.
java.util.Set	getGroupKeys(java.lang.String cacheName, java.lang.String group) Gets the set of keys of objects currently in the group throws UnsupportedOperationException
protected long	getListenerId()
ITCPLateralCacheAttributes	getTcpLateralCacheAttributes()
static void	main(java.lang.String[] args)
void	release() Frees all caches.
void	remove(java.lang.String cacheName, java.io.Serializable key) Removes the given key from the specified cache.
void	remove(java.lang.String cacheName, java.io.Serializable key, long requesterId) Removes the given key from the specified cache.
void	removeAll(java.lang.String cacheName) Remove all keys from the sepcified cache.
void	removeAll(java.lang.String cacheName, long requesterId) Remove all keys from the sepcified cache.
void	removeCacheListener(ICacheListener obj) Unsubscribes from all caches.
void	removeCacheListener(java.lang.String cacheName, ICacheListener obj) Unsubscribes from the specified cache.
protected void	setListenerId(long listernId)
void	setTcpLateralCacheAttributes(ITCPLateralCacheAttributes tcpLateralCacheAttributes)
void	update(ICacheElement item) Puts a cache item to the cache.
void	update(ICacheElement item, long requesterId) Puts a cache item to the cache.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

LateralTCPService

public LateralTCPService(ITCPLateralCacheAttributes lca)
                  throws java.io.IOException

Constructor for the LateralTCPService object

Parameters:

lca - ITCPLateralCacheAttributes

Throws:

java.io.IOException

Method Detail

update

public void update(ICacheElement item)
            throws java.io.IOException

Description copied from interface: ICacheService

Puts a cache item to the cache.

Specified by:

update in interface ICacheService

Parameters:

item -

Throws:

java.io.IOException

update

public void update(ICacheElement item,
                   long requesterId)
            throws java.io.IOException

Description copied from interface: ILateralCacheService

Puts a cache item to the cache.

Specified by:

update in interface ILateralCacheService

Parameters:

item -

requesterId -

Throws:

java.io.IOException

remove

public void remove(java.lang.String cacheName,
                   java.io.Serializable key)
            throws java.io.IOException

Description copied from interface: ICacheService

Removes the given key from the specified cache.

Specified by:

remove in interface ICacheService

Parameters:

cacheName -

key -

Throws:

java.io.IOException

remove

public void remove(java.lang.String cacheName,
                   java.io.Serializable key,
                   long requesterId)
            throws java.io.IOException

Description copied from interface: ILateralCacheService

Removes the given key from the specified cache.

Specified by:

remove in interface ILateralCacheService

Parameters:

cacheName -

key -

requesterId -

Throws:

java.io.IOException

release

public void release()
             throws java.io.IOException

Description copied from interface: ICacheService

Frees all caches.

Specified by:

release in interface ICacheService

Throws:

java.io.IOException

dispose

public void dispose(java.lang.String cache)
             throws java.io.IOException

Will close the connection.

Specified by:

dispose in interface ICacheService

Parameters:

cache -

Throws:

java.io.IOException

get

public java.io.Serializable get(java.lang.String key)
                         throws java.io.IOException

The service does not get via this method, so this return null

Parameters:

key -

Returns:

always null.

Throws:

java.io.IOException

get

public ICacheElement get(java.lang.String cacheName,
                         java.io.Serializable key)
                  throws java.io.IOException

Description copied from interface: ICacheService

Returns a cache bean from the specified cache; or null if the key does not exist.

Specified by:

get in interface ICacheService

Parameters:

cacheName -

key -

Returns:

Throws:

java.io.IOException

getGroupKeys

public java.util.Set getGroupKeys(java.lang.String cacheName,
                                  java.lang.String group)

Gets the set of keys of objects currently in the group throws UnsupportedOperationException

Specified by:

getGroupKeys in interface ILateralCacheService

Parameters:

cacheName -

group -

Returns:

Set

removeAll

public void removeAll(java.lang.String cacheName)
               throws java.io.IOException

Description copied from interface: ICacheService

Remove all keys from the sepcified cache.

Specified by:

removeAll in interface ICacheService

Parameters:

cacheName -

Throws:

java.io.IOException

removeAll

public void removeAll(java.lang.String cacheName,
                      long requesterId)
               throws java.io.IOException

Description copied from interface: ILateralCacheService

Remove all keys from the sepcified cache.

Specified by:

removeAll in interface ILateralCacheService

Parameters:

cacheName -

requesterId -

Throws:

java.io.IOException

main

public static void main(java.lang.String[] args)

Parameters:

args -

addCacheListener

public void addCacheListener(java.lang.String cacheName,
                             ICacheListener obj)
                      throws java.io.IOException

Description copied from interface: ICacheObserver

Subscribes to the specified cache.

Specified by:

addCacheListener in interface ICacheObserver

Parameters:

cacheName - the specified cache.

obj - object to notify for cache changes.

Throws:

java.io.IOException

addCacheListener

public void addCacheListener(ICacheListener obj)
                      throws java.io.IOException

Description copied from interface: ICacheObserver

Subscribes to all caches.

Specified by:

addCacheListener in interface ICacheObserver

Parameters:

obj - object to notify for all cache changes.

Throws:

java.io.IOException

removeCacheListener

public void removeCacheListener(java.lang.String cacheName,
                                ICacheListener obj)
                         throws java.io.IOException

Description copied from interface: ICacheObserver

Unsubscribes from the specified cache.

Specified by:

removeCacheListener in interface ICacheObserver

Parameters:

cacheName -

obj - existing subscriber.

Throws:

java.io.IOException

removeCacheListener

public void removeCacheListener(ICacheListener obj)
                         throws java.io.IOException

Description copied from interface: ICacheObserver

Unsubscribes from all caches.

Specified by:

removeCacheListener in interface ICacheObserver

Parameters:

obj - existing subscriber.

Throws:

java.io.IOException

setListenerId

protected void setListenerId(long listernId)

Parameters:

listernId - The listernId to set.

getListenerId

protected long getListenerId()

Returns:

Returns the listernId.

setTcpLateralCacheAttributes

public void setTcpLateralCacheAttributes(ITCPLateralCacheAttributes tcpLateralCacheAttributes)

Parameters:

tcpLateralCacheAttributes - The tcpLateralCacheAttributes to set.

getTcpLateralCacheAttributes

public ITCPLateralCacheAttributes getTcpLateralCacheAttributes()

Returns:

Returns the tcpLateralCacheAttributes.