Interface SessionStore

All Known Implementing Classes:
Sessions.Db, Sessions.Memory
public interface SessionStore

Where HttpSessions are kept between requests.

Two are provided, chosen by cn1.session.store: memory (the default) and db, which keeps them in the server's database so any instance behind a load balancer can serve any client. Implement this for another -- a cache server -- and pass it to Sessions.setStore(SessionStore).

  • Method Summary

    Modifier and Type
    Method
    Description
    void
    delete(String id)
    Forgets a session.
    HttpSession
    load(String id)
    The session with this id, or null when there is none or it expired.
    int
    purgeExpired(long now)
    Drops every session that has expired by now; answers how many.
    void
    save(HttpSession session, String previousId)
    Records a session after a request that created or changed it.
    int
    size()
    How many sessions are kept, or -1 when that is expensive to know.

  • Method Details

    • load

      HttpSession load(String id) throws IOException
      The session with this id, or null when there is none or it expired.
      Throws:
      IOException

    • save

      void save(HttpSession session, String previousId) throws IOException
      Records a session after a request that created or changed it. When its id changed, previousId names the entry to drop; otherwise it is null.
      Throws:
      IOException

    • delete

      void delete(String id) throws IOException
      Forgets a session.
      Throws:
      IOException

    • purgeExpired

      int purgeExpired(long now) throws IOException
      Drops every session that has expired by now; answers how many.
      Throws:
      IOException

    • size

      int size()
      How many sessions are kept, or -1 when that is expensive to know.