SessionsDB (Javadocs [I2P+ 2.13.0+]

java.lang.Object
- net.i2p.sam.SessionsDB

```
class SessionsDB
extends Object
```
A database of SAM sessions, mapping nicknames to SessionRecords. Provides synchronized access for concurrent SAM handlers.

Nested Class Summary

Nested Classes
Modifier and Type	Class and Description
`(package private) static class`	`SessionsDB.ExistingDestException` Exception thrown when attempting to create a session with an existing destination.
`(package private) static class`	`SessionsDB.ExistingIdException` Exception thrown when attempting to create a session with an existing ID.

Constructor Summary
Constructors
Constructor and Description
SessionsDB()
Create a new empty sessions database.

Constructors
Constructor and Description
`SessionsDB()` Create a new empty sessions database.

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`boolean`	`containsKey(String nick)` Check if a session with the given nickname exists.
`boolean`	`del(String nick)` Remove a session record by nickname.
`SessionRecord`	`get(String nick)` Get a session record by nickname.
`Map<String,SessionRecord>`	`getAllEntries()` Return a snapshot of all entries (nick -> SessionRecord).
`void`	`put(String nick, SessionRecord session)` Store a session record.
`void`	`putDupDestOK(String nick, SessionRecord session)` Store a session record, allowing duplicate destinations.
`int`	`removeStale(long maxAgeMs)` Remove sessions that have not been accessed for longer than maxAgeMs.
`int`	`size()` Get the number of registered sessions.

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Constructor Detail
  - SessionsDB
```
public SessionsDB()
```
    Create a new empty sessions database.
- Method Detail
  - containsKey
```
public boolean containsKey(String nick)
```
    Check if a session with the given nickname exists.
    Parameters:
    nick - the session nickname
    Returns:
    true if a session with this nick exists
  - del
```
public boolean del(String nick)
```
    Remove a session record by nickname.
    Parameters:
    nick - the session nickname
    Returns:
    true if removed, false if not found
  - get
```
public SessionRecord get(String nick)
```
    Get a session record by nickname. Updates the last-accessed timestamp.
    Parameters:
    nick - the session nickname
    Returns:
    the session record, or null if not found
  - getAllEntries
```
public Map<String,SessionRecord> getAllEntries()
```
    Return a snapshot of all entries (nick -> SessionRecord).
  - put
```
public void put(String nick,
                SessionRecord session)
         throws SessionsDB.ExistingIdException,
                SessionsDB.ExistingDestException
```
    Store a session record. Both the nick and destination must be unique.
    Parameters:
    nick - the session nickname
    session - the session
    Throws:
    SessionsDB.ExistingIdException - if a session with this nick already exists
    SessionsDB.ExistingDestException - if a session with this destination already exists
  - putDupDestOK
```
public void putDupDestOK(String nick,
                         SessionRecord session)
                  throws SessionsDB.ExistingIdException
```
    Store a session record, allowing duplicate destinations. Only the nick must be unique.
    Parameters:
    nick - the session nickname
    session - the session
    Throws:
    SessionsDB.ExistingIdException - if a session with this nick already exists
  - removeStale
```
public int removeStale(long maxAgeMs)
```
    Remove sessions that have not been accessed for longer than maxAgeMs. This handles zombie sessions left by clients that disconnect without sending SESSION DESTROY.
    Parameters:
    maxAgeMs - maximum age in milliseconds since last access
    Returns:
    number of sessions removed
  - size
```
public int size()
```
    Get the number of registered sessions.

Class SessionsDB

Nested Class Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Constructor Detail

SessionsDB

Method Detail

containsKey

del

get

getAllEntries

put

putDupDestOK

removeStale

size