org.apache.catalina

Interface Store

public interface Store

A Store is the abstraction of a Catalina component that provides persistent storage and loading of Sessions and their associated user data. Implementations are free to save and load the Sessions to any media they wish, but it is assumed that saved Sessions are persistent across server or context restarts.

Version: $Revision: 467222 $ $Date: 2006-10-24 05:17:11 +0200 (Tue, 24 Oct 2006) $

Author: Craig R. McClanahan

Method Summary
voidaddPropertyChangeListener(PropertyChangeListener listener)
Add a property change listener to this component.
voidclear()
Remove all Sessions from this Store.
StringgetInfo()
Return descriptive information about this Store implementation and the corresponding version number, in the format <description>/<version>.
ManagergetManager()
Return the Manager instance associated with this Store.
intgetSize()
Return the number of Sessions present in this Store.
String[]keys()
Return an array containing the session identifiers of all Sessions currently saved in this Store.
Sessionload(String id)
Load and return the Session associated with the specified session identifier from this Store, without removing it.
voidremove(String id)
Remove the Session with the specified session identifier from this Store, if present.
voidremovePropertyChangeListener(PropertyChangeListener listener)
Remove a property change listener from this component.
voidsave(Session session)
Save the specified Session into this Store.
voidsetManager(Manager manager)
Set the Manager associated with this Store.

Method Detail

addPropertyChangeListener

public void addPropertyChangeListener(PropertyChangeListener listener)
Add a property change listener to this component.

Parameters: listener The listener to add

clear

public void clear()
Remove all Sessions from this Store.

getInfo

public String getInfo()
Return descriptive information about this Store implementation and the corresponding version number, in the format <description>/<version>.

getManager

public Manager getManager()
Return the Manager instance associated with this Store.

getSize

public int getSize()
Return the number of Sessions present in this Store.

Throws: IOException if an input/output error occurs

keys

public String[] keys()
Return an array containing the session identifiers of all Sessions currently saved in this Store. If there are no such Sessions, a zero-length array is returned.

Throws: IOException if an input/output error occurred

load

public Session load(String id)
Load and return the Session associated with the specified session identifier from this Store, without removing it. If there is no such stored Session, return null.

Parameters: id Session identifier of the session to load

Throws: ClassNotFoundException if a deserialization error occurs IOException if an input/output error occurs

remove

public void remove(String id)
Remove the Session with the specified session identifier from this Store, if present. If no such Session is present, this method takes no action.

Parameters: id Session identifier of the Session to be removed

Throws: IOException if an input/output error occurs

removePropertyChangeListener

public void removePropertyChangeListener(PropertyChangeListener listener)
Remove a property change listener from this component.

Parameters: listener The listener to remove

save

public void save(Session session)
Save the specified Session into this Store. Any previously saved information for the associated session identifier is replaced.

Parameters: session Session to be saved

Throws: IOException if an input/output error occurs

setManager

public void setManager(Manager manager)
Set the Manager associated with this Store.

Parameters: manager The Manager which will use this Store.

Copyright © 2000-2011 Apache Software Foundation. All Rights Reserved.