FileDocCategorySizeDatePackage
SimpleSession.javaAPI DocApache Axis 1.43752Sat Apr 22 18:57:28 BST 2006org.apache.axis.session

SimpleSession.java

/*
 * Copyright 2001-2004 The Apache Software Foundation.
 * 
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 * 
 *      http://www.apache.org/licenses/LICENSE-2.0
 * 
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

package org.apache.axis.session;

import java.util.Enumeration;
import java.util.Hashtable;

/**
 * A trivial session implementation.
 *
 * @author Glen Daniels (gdaniels@apache.org)
 */
public class SimpleSession implements Session
{
    private Hashtable rep = null;
    
    /** Inactivity timeout (in seconds).
     * Not used yet.
     */
    private int timeout = -1;
    private long lastTouched;
    
    /**
     * Default constructor - set lastTouched to now
     */ 
    public SimpleSession()
    {
        lastTouched = System.currentTimeMillis();
    }
                          
    /** Get a property from the session
     *
     * @param key the name of the property desired.
     */
    public Object get(String key)
    {
        if (rep == null)
            return null;
        lastTouched = System.currentTimeMillis();
        return rep.get(key);
    }
    
    /** Set a property in the session
     *
     * @param key the name of the property to set.
     * @param value the value of the property.
     */
    public void set(String key, Object value)
    {
        synchronized (this) {
            if (rep == null)
                rep = new Hashtable();
        }
        lastTouched = System.currentTimeMillis();
        rep.put(key, value);
    }
    
    /** Remove a property from the session
     *
     * @param key the name of the property desired.
     */
    public void remove(String key)
    {
        if (rep != null)
            rep.remove(key);
        lastTouched = System.currentTimeMillis();
    }

    /**
     * Get an enumeration of the keys in this session
     */
    public Enumeration getKeys() {
        if (rep != null)
            return rep.keys();
        return null;
    }

    /** Set the session's time-to-live.
     *
     * This is implementation-specific, but basically should be the #
     * of seconds of inactivity which will cause the session to time
     * out and invalidate.  "inactivity" is implementation-specific.
     */
    public void setTimeout(int timeout)
    {
        this.timeout = timeout;
    }
    
    public int getTimeout()
    {
        return timeout;
    }

    /**
     * "Touch" the session (mark it recently used)
     */
    public void touch() {
        lastTouched = System.currentTimeMillis();
    }

    /**
     * invalidate the session
     */
    public void invalidate() {
        rep = null;
        lastTouched = System.currentTimeMillis();
        timeout = -1;        
    }
    
    public long getLastAccessTime()
    {
        return lastTouched;
    }

    /**
     * Get an Object suitable for synchronizing the session.  This method
     * exists because different session implementations might provide
     * different ways of getting at shared data.  For a simple hashtable-
     * based session, this would just be the hashtable, but for sessions
     * which use database connections, etc. it might be an object wrapping
     * a table ID or somesuch.
     */
    public synchronized Object getLockObject() {
        if (rep == null) {
            rep = new Hashtable();
        }
        return rep;
    }
}