I2PAppThread

net.i2p.util.I2PAppThread

All Implemented Interfaces:: Runnable

Direct Known Subclasses:: DaemonThread, I2PTunnelOutproxyRunner, I2PTunnelRunner, InternalSocketRunner, UpdateRunner

public class I2PAppThreadextends I2PThread

Like I2PThread but with per-thread OOM listeners, rather than a static router-wide listener list, so that an OOM in an app won't call the router listener to shutdown the whole router.

This is preferred for application use. See I2PThread for features.

Nested Class Summary
Nested classes/interfaces inherited from class I2PThread
I2PThread.OOMEventListener
Modifier and Type
Class
Description
static interface
I2PThread.OOMEventListener
Listener for out-of-memory events.
Nested classes/interfaces inherited from class Thread
Thread.Builder, Thread.State, Thread.UncaughtExceptionHandler
Field Summary
Fields inherited from class Thread
MAX_PRIORITY, MIN_PRIORITY, NORM_PRIORITY
Constructor Summary
Constructors
Constructor
Description
I2PAppThread()
Creates a new I2PAppThread with no target or name.
I2PAppThread(Runnable r)
Creates a new I2PAppThread with the given target runnable.
I2PAppThread(Runnable r, String name)
Creates a new I2PAppThread with the given target and name.
I2PAppThread(Runnable r, String name, boolean isDaemon)
Creates a new I2PAppThread with the given target, name, and daemon status.
I2PAppThread(String name)
Creates a new I2PAppThread with the given name.
I2PAppThread(ThreadGroup group, Runnable r, String name)
Creates a new I2PAppThread in the given thread group.
Method Summary
All Methods
Modifier and Type
Method
Description
void
addOOMEventThreadListener(I2PThread.OOMEventListener lsnr)
Register a new component that wants notification of OOM events.
protected void
fireOOM(OutOfMemoryError oom)
Notify listeners that an OutOfMemoryError occurred.
void
removeOOMEventThreadListener(I2PThread.OOMEventListener lsnr)
Unregister a component that wants notification of OOM events.
Methods inherited from class I2PThread
addOOMEventListener, removeOOMEventListener, run, start
Modifier and Type
Method
Description
static void
addOOMEventListener(I2PThread.OOMEventListener lsnr)
Register a new component that wants notification of OOM events.
static void
removeOOMEventListener(I2PThread.OOMEventListener lsnr)
Unregister a component that wants notification of OOM events.
void
run()
Run the thread, catching and reporting OOM and other failures.
void
start()
Overridden to provide useful info to users on OOM, and to prevent shutting down the whole JVM for what is most likely not a heap issue.
Methods inherited from class Thread
activeCount, clone, currentThread, dumpStack, enumerate, getAllStackTraces, getContextClassLoader, getDefaultUncaughtExceptionHandler, getName, getPriority, getStackTrace, getState, getThreadGroup, getUncaughtExceptionHandler, holdsLock, interrupt, interrupted, isAlive, isDaemon, isInterrupted, isVirtual, join, join, join, join, ofPlatform, ofVirtual, onSpinWait, setContextClassLoader, setDaemon, setDefaultUncaughtExceptionHandler, setName, setPriority, setUncaughtExceptionHandler, sleep, sleep, sleep, startVirtualThread, threadId, toString, yield
Methods inherited from class Object
equals, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Details
- I2PAppThread
  public I2PAppThread()
  Creates a new I2PAppThread with no target or name.
- I2PAppThread
  public I2PAppThread(String name)
  Creates a new I2PAppThread with the given name.
  Parameters:
  name - the thread name
- I2PAppThread
  public I2PAppThread(Runnable r)
  Creates a new I2PAppThread with the given target runnable.
  Parameters:
  r - the target runnable
- I2PAppThread
  public I2PAppThread(Runnable r, String name)
  Creates a new I2PAppThread with the given target and name.
  Parameters:
  r - the target runnable
  name - the thread name
- I2PAppThread
  public I2PAppThread(Runnable r, String name, boolean isDaemon)
  Creates a new I2PAppThread with the given target, name, and daemon status.
  Parameters:
  r - the target runnable
  name - the thread name
  isDaemon - whether the thread is a daemon
- I2PAppThread
  public I2PAppThread(ThreadGroup group, Runnable r, String name)
  Creates a new I2PAppThread in the given thread group.
  Parameters:
  group - the thread group
  r - the target runnable
  name - the thread name
Method Details
- fireOOM
  protected void fireOOM(OutOfMemoryError oom)
  Description copied from class: I2PThread
  Notify listeners that an OutOfMemoryError occurred.
  Overrides:
  fireOOM in class I2PThread
  Parameters:
  oom - the error passed to every registered listener
- addOOMEventThreadListener
  public void addOOMEventThreadListener(I2PThread.OOMEventListener lsnr)
  Register a new component that wants notification of OOM events.
  Parameters:
  lsnr - the listener to register
- removeOOMEventThreadListener
  public void removeOOMEventThreadListener(I2PThread.OOMEventListener lsnr)
  Unregister a component that wants notification of OOM events.
  Parameters:
  lsnr - the listener to unregister

Nested Class Summary

Nested classes/interfaces inherited from class I2PThread

Nested classes/interfaces inherited from class Thread

Field Summary

Fields inherited from class Thread

Constructor Summary

Method Summary

Methods inherited from class I2PThread

Methods inherited from class Thread

Methods inherited from class Object

Constructor Details

I2PAppThread

I2PAppThread

I2PAppThread

I2PAppThread

I2PAppThread

Method Details

fireOOM

addOOMEventThreadListener

removeOOMEventThreadListener