TestJob (Javadocs [I2P+ 2.13.0+] - API Version 0.9.70+)

java.lang.Object
- net.i2p.router.JobImpl
- - net.i2p.router.tunnel.pool.TestJob

All Implemented Interfaces:
Job
```
public class TestJob
extends JobImpl
```
Repeatedly tests a single tunnel for its lifetime to ensure it remains functional. Sends a garlic-encrypted DeliveryStatusMessage through the tunnel and validates the reply. Now includes adaptive backoff, avoids over-penalizing peers on transient failures, and limits the number of concurrent tunnel tests to avoid overwhelming the router.

Field Summary
Fields
Modifier and Type Field and Description
static int maxQueuedTests
Maximum number of TestJob instances that should be queued before deferring new ones.
- Fields inherited from class net.i2p.router.JobImpl
  _id

Fields
Modifier and Type	Field and Description
`static int`	`maxQueuedTests` Maximum number of TestJob instances that should be queued before deferring new ones.

Constructor Summary
Constructors
Constructor and Description
TestJob(RouterContext ctx, PooledTunnelCreatorConfig cfg, TunnelPool pool)
TestJob.

Constructors
Constructor and Description
`TestJob(RouterContext ctx, PooledTunnelCreatorConfig cfg, TunnelPool pool)` TestJob.

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`void`	`dropped()` Called when the job is dropped due to router overload.
`static int`	`getCurrentTestJobCount()` Get the current number of queued + active test jobs for capacity planning.
`static int`	`getHardLimit(RouterContext ctx)` Hard limit for total TestJob instances (queued + active).
`static int`	`getMaxTestJobs()` Get the maximum number of queued test jobs allowed before deferring.
`String`	`getName()` Descriptive name of the task
`boolean`	`isValid()` Check if this TestJob instance is valid and should be queued.
`void`	`runJob()` runJob.
`static boolean`	`shouldSchedule(RouterContext ctx, PooledTunnelCreatorConfig cfg)` Static method to check if a TestJob should be created and scheduled.
`void`	`testSuccessful(int ms)` Called when the tunnel test completes successfully.

Methods inherited from class net.i2p.router.JobImpl
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
  - maxQueuedTests
```
public static volatile int maxQueuedTests
```
    Maximum number of TestJob instances that should be queued before deferring new ones. Prevents job queue saturation from too many waiting tunnel tests. Tunable via i2p.tunnel.testJob.maxQueued (default: 192 fast / 96 slow)
- Constructor Detail
  - TestJob
```
public TestJob(RouterContext ctx,
               PooledTunnelCreatorConfig cfg,
               TunnelPool pool)
```
    TestJob.
- Method Detail
  - dropped
```
public void dropped()
```
    Called when the job is dropped due to router overload. Ensure we clean up the total job counter when dropped.
    Specified by:
    dropped in interface Job
    Overrides:
    dropped in class JobImpl
  - getCurrentTestJobCount
```
public static int getCurrentTestJobCount()
```
    Get the current number of queued + active test jobs for capacity planning.
    Returns:
    the current test job count
  - getHardLimit
```
public static int getHardLimit(RouterContext ctx)
```
    Hard limit for total TestJob instances (queued + active). Above this threshold, no new tests are scheduled until count decreases. Prevents ever-increasing backlogs that could cause job lag. Tunable via i2p.tunnel.testJob.hardLimit (default: 512 fast / 384 slow)
    Returns:
    the hard limit
  - getMaxTestJobs
```
public static int getMaxTestJobs()
```
    Get the maximum number of queued test jobs allowed before deferring.
    Returns:
    the max test jobs
  - getName
```
public String getName()
```
    Description copied from interface: Job
    Descriptive name of the task
    Returns:
    the name
  - isValid
```
public boolean isValid()
```
    Check if this TestJob instance is valid and should be queued.
    Returns:
    true if valid, false if it should not be queued
  - runJob
```
public void runJob()
```
    runJob.
  - shouldSchedule
```
public static boolean shouldSchedule(RouterContext ctx,
                                     PooledTunnelCreatorConfig cfg)
```
    Static method to check if a TestJob should be created and scheduled. This prevents creating invalid job objects that would have timing issues.
    Parameters:
    ctx - the router context
    cfg - the tunnel config
    Returns:
    true if the job should be created and scheduled, false otherwise
  - testSuccessful
```
public void testSuccessful(int ms)
```
    Called when the tunnel test completes successfully. Updates statistics and schedules the next test.
    Parameters:
    ms - time in milliseconds the test took to succeed

Class TestJob

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

maxQueuedTests

Constructor Detail

TestJob

Method Detail

dropped

getCurrentTestJobCount

getHardLimit

getMaxTestJobs

getName

isValid

runJob

shouldSchedule

testSuccessful