StoreState (Javadocs [I2P+ 2.13.0+]

java.lang.Object
- net.i2p.router.networkdb.kademlia.StoreState

```
class StoreState
extends Object
```
Manages state for network database store operations.
Tracks peer interaction status, timing information, and operation progress for store operations. Maintains separate sets for pending, attempted, and successful operations to coordinate concurrent store operations and prevent duplicate queries.
Thread-safe implementation using synchronized collections and atomic counters for safe concurrent access from multiple store jobs.
Provides comprehensive state management for reliable data persistence with validation, timeout handling, and operation completion tracking.

Constructor Summary

Constructors
Constructor and Description
`StoreState(RouterContext ctx, Hash key, DatabaseEntry data)` StoreState.
`StoreState(RouterContext ctx, Hash key, DatabaseEntry data, Set<Hash> toSkip)` New store state tracking pending, attempted, and successful peers.

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`void`	`addPending(Hash peer)` Increments attempted count
`void`	`addPending(Hash peer, MessageWrapper.WrappedMessage msg)` Adds a pending message for tracking.
`void`	`addSkipped(Hash peer)` We aren't even going to try to contact this peer.
`void`	`complete(boolean completed)` Mark the store as completed at the current time, if not already.
`boolean`	`completed()` Whether the store has completed.
`long`	`confirmed(Hash peer)` Mark the peer as confirmed and return the response time.
`Set<Hash>`	`getAttempted()` The peers attempted OR skipped.
`int`	`getAttemptedCount()` The number of peers attempted.
`int`	`getCompleteCount()` Number of peers that confirmed the store.
`DatabaseEntry`	`getData()` The data being stored.
`int`	`getPendingCount()` Number of pending peers.
`MessageWrapper.WrappedMessage`	`getPendingMessage(Hash peer)` Returns the pending message for the specified peer.
`Hash`	`getSuccessful()` Return a successful peer (a random one if more than one was successful) or null.
`Hash`	`getTarget()` The DatabaseEntry hash target.
`long`	`getWhenCompleted()` Time the store completed, or -1 if not yet completed.
`long`	`getWhenStarted()` Time the store started.
`void`	`replyTimeout(Hash peer)` Remove the peer from pending on timeout.
`String`	`toString()` Debug string for this store state.

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

- Constructor Detail
  - StoreState
```
public StoreState(RouterContext ctx,
                  Hash key,
                  DatabaseEntry data)
```
    StoreState.
  - StoreState
```
public StoreState(RouterContext ctx,
                  Hash key,
                  DatabaseEntry data,
                  Set<Hash> toSkip)
```
    New store state tracking pending, attempted, and successful peers.
    Parameters:
    key - the DatabaseEntry hash
    toSkip - may be null, if non-null, all attempted and skipped targets will be added as of 0.9.53
- Method Detail
  - addPending
```
public void addPending(Hash peer)
```
    Increments attempted count
  - addPending
```
public void addPending(Hash peer,
                       MessageWrapper.WrappedMessage msg)
```
    Adds a pending message for tracking.
  - addSkipped
```
public void addSkipped(Hash peer)
```
    We aren't even going to try to contact this peer.
  - complete
```
public void complete(boolean completed)
```
    Mark the store as completed at the current time, if not already.
    Parameters:
    completed - whether to mark the store as completed
  - completed
```
public boolean completed()
```
    Whether the store has completed.
  - confirmed
```
public long confirmed(Hash peer)
```
    Mark the peer as confirmed and return the response time.
    Parameters:
    peer - the peer that confirmed
    Returns:
    the response time in ms, or -1 if unknown
  - getAttempted
```
public Set<Hash> getAttempted()
```
    The peers attempted OR skipped. DOES include skipped peers. Use getAttemptedCount for the number of attempts.
    Returns:
    the attempted
  - getAttemptedCount
```
public int getAttemptedCount()
```
    The number of peers attempted. Does not include skipped peers. Do not use getAttempted().size() as that does include skipped peers.
    Returns:
    the attempted count
  - getCompleteCount
```
public int getCompleteCount()
```
    Number of peers that confirmed the store.
    Returns:
    the complete count
  - getData
```
public DatabaseEntry getData()
```
    The data being stored.
    Returns:
    the data
  - getPendingCount
```
public int getPendingCount()
```
    Number of pending peers.
    Returns:
    the pending count
  - getPendingMessage
```
public MessageWrapper.WrappedMessage getPendingMessage(Hash peer)
```
    Returns the pending message for the specified peer.
    Returns:
    the message or null; will only return the message once, so tags are only acked or failed once.
  - getSuccessful
```
public Hash getSuccessful()
```
    Return a successful peer (a random one if more than one was successful) or null.
    Returns:
    the successful
  - getTarget
```
public Hash getTarget()
```
    The DatabaseEntry hash target.
    Returns:
    the target
  - getWhenCompleted
```
public long getWhenCompleted()
```
    Time the store completed, or -1 if not yet completed.
    Returns:
    the when completed
  - getWhenStarted
```
public long getWhenStarted()
```
    Time the store started.
    Returns:
    the when started
  - replyTimeout
```
public void replyTimeout(Hash peer)
```
    Remove the peer from pending on timeout.
    Parameters:
    peer - the peer that timed out
  - toString
```
public String toString()
```
    Debug string for this store state.
    Overrides:
    toString in class Object

Class StoreState

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Constructor Detail

StoreState

StoreState

Method Detail

addPending

addPending

addSkipped

complete

completed

confirmed

getAttempted

getAttemptedCount

getCompleteCount

getData

getPendingCount

getPendingMessage

getSuccessful

getTarget

getWhenCompleted

getWhenStarted

replyTimeout

toString