FloodSearchJob (Javadocs [I2P+ 2.13.0+]

java.lang.Object
- net.i2p.router.JobImpl
- - net.i2p.router.networkdb.kademlia.FloodSearchJob

All Implemented Interfaces:
Job
Direct Known Subclasses:
FloodOnlySearchJob, IterativeSearchJob
```
abstract class FloodSearchJob
extends JobImpl
```
Base class for flood-based search operations with fallback to Kademlia.
Implements flood-based search strategy sending queries to floodfill peers. If no successful match is received within half the allowed timeout, falls back to standard Kademlia iterative search through normal channels. This reduces spurious lookups caused by response delays from floodfill peers.
Note: Unused directly - see FloodOnlySearchJob extension which overrides almost everything. This does NOT extend SearchJob.

Field Summary

Fields
Modifier and Type	Field and Description
`protected long`	`_created` System time when this search was created.
`protected boolean`	`_dead` Whether this search has been marked as completed.
`protected long`	`_expiration` Deadline after which the search expires.
`protected FloodfillNetworkDatabaseFacade`	`_facade` Floodfill network database facade.
`protected boolean`	`_isLease` Whether the target is a LeaseSet lookup.
`protected Hash`	`_key` Target database entry hash being searched.
`protected Log`	`_log` Class logger.
`protected AtomicInteger`	`_lookupsRemaining` Remaining flood lookups before fallback to iterative search.
`protected List<Job>`	`_onFailed` Callbacks for search failure.
`protected List<Job>`	`_onFind` Callbacks for successful search completion.
`protected boolean`	`_success` Whether the search completed successfully.
`protected int`	`_timeoutMs` Timeout for the search in milliseconds.
`protected static int`	`CONCURRENT_SEARCHES` Max simultaneous flood lookups before fallback.

Fields inherited from class net.i2p.router.JobImpl
_id

Constructor Summary
Constructors
Constructor and Description
FloodSearchJob(RouterContext ctx, FloodfillNetworkDatabaseFacade facade, Hash key, Job onFind, Job onFailed, int timeoutMs, boolean isLease)

Constructors
Constructor and Description
`FloodSearchJob(RouterContext ctx, FloodfillNetworkDatabaseFacade facade, Hash key, Job onFind, Job onFailed, int timeoutMs, boolean isLease)`

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`(package private) void`	`addDeferred(Job onFind, Job onFailed, long timeoutMs, boolean isLease)` Add jobs to an existing search
`protected int`	`decrementRemaining()`
`(package private) void`	`failed()` Deprecated, unused, see FOSJ override
`long`	`getCreated()` System time, NOT context time
`long`	`getExpiration()` using context clock
`Hash`	`getKey()`
`protected int`	`getLookupsRemaining()`
`String`	`getName()` Deprecated, unused, see FOSJ override
`void`	`runJob()` Deprecated, unused, see FOSJ override
`(package private) void`	`success()` Deprecated, unused, see FOSJ override

Methods inherited from class net.i2p.router.JobImpl
dropped, getContext, getJobId, getMadeReadyOn, getTiming, madeReady, requeue, toString

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

- Field Detail
  - _created
```
protected final long _created
```
    System time when this search was created.
  - _dead
```
protected volatile boolean _dead
```
    Whether this search has been marked as completed.
  - _expiration
```
protected long _expiration
```
    Deadline after which the search expires.
  - _facade
```
protected final FloodfillNetworkDatabaseFacade _facade
```
    Floodfill network database facade.
  - _isLease
```
protected final boolean _isLease
```
    Whether the target is a LeaseSet lookup.
  - _key
```
protected final Hash _key
```
    Target database entry hash being searched.
  - _log
```
protected final Log _log
```
    Class logger.
  - _lookupsRemaining
```
protected final AtomicInteger _lookupsRemaining
```
    Remaining flood lookups before fallback to iterative search.
  - _onFailed
```
protected final List<Job> _onFailed
```
    Callbacks for search failure.
  - _onFind
```
protected final List<Job> _onFind
```
    Callbacks for successful search completion.
  - _success
```
protected boolean _success
```
    Whether the search completed successfully.
  - _timeoutMs
```
protected int _timeoutMs
```
    Timeout for the search in milliseconds.
  - CONCURRENT_SEARCHES
```
protected static final int CONCURRENT_SEARCHES
```
    Max simultaneous flood lookups before fallback.
- Constructor Detail
  - FloodSearchJob
```
public FloodSearchJob(RouterContext ctx,
                      FloodfillNetworkDatabaseFacade facade,
                      Hash key,
                      Job onFind,
                      Job onFailed,
                      int timeoutMs,
                      boolean isLease)
```
    Parameters:
    onFind - may be null
    onFailed - may be null
- Method Detail
  - addDeferred
```
void addDeferred(Job onFind,
                 Job onFailed,
                 long timeoutMs,
                 boolean isLease)
```
    Add jobs to an existing search
    Parameters:
    onFind - may be null
    onFailed - may be null
    timeoutMs - search timeout in ms
    isLease - whether searching for lease set
  - decrementRemaining
```
protected int decrementRemaining()
```
    Returns:
    number remaining after decrementing
  - failed
```
void failed()
```
    Deprecated, unused, see FOSJ override
  - getCreated
```
public long getCreated()
```
    System time, NOT context time
  - getExpiration
```
public long getExpiration()
```
    using context clock
  - getKey
```
public Hash getKey()
```
    Returns:
    the database entry hash being searched
  - getLookupsRemaining
```
protected int getLookupsRemaining()
```
    Returns:
    number of flood lookups still pending
  - getName
```
public String getName()
```
    Deprecated, unused, see FOSJ override
    Returns:
    the name
  - runJob
```
public void runJob()
```
    Deprecated, unused, see FOSJ override
  - success
```
void success()
```
    Deprecated, unused, see FOSJ override

Class FloodSearchJob

Field Summary

Fields inherited from class net.i2p.router.JobImpl

Constructor Summary

Method Summary

Methods inherited from class net.i2p.router.JobImpl

Methods inherited from class java.lang.Object

Field Detail

_created

_dead

_expiration

_facade

_isLease

_key

_log

_lookupsRemaining

_onFailed

_onFind

_success

_timeoutMs

CONCURRENT_SEARCHES

Constructor Detail

FloodSearchJob

Method Detail

addDeferred

decrementRemaining

failed

getCreated

getExpiration

getKey

getLookupsRemaining

getName

runJob

success