Module org.tquadrat.foundation.base

Package org.tquadrat.foundation.lang

Class ThreadGroupExt

java.lang.Object

java.lang.ThreadGroup

org.tquadrat.foundation.lang.ThreadGroupExt

All Implemented Interfaces:

Thread.UncaughtExceptionHandler

@ClassVersion(sourceVersion="$Id: ThreadGroupExt.java 1118 2024-03-15 16:14:15Z tquadrat $")
@API(status=STABLE,
     since="0.1.0")
public class ThreadGroupExt
extends ThreadGroup

An implementation of ThreadGroup that allows to configure the behaviour of uncaughtException(Thread, Throwable).

This class is not final, to allow further modifications.

Author:

Thomas Thrien (thomas.thrien@tquadrat.org)

Version:

$Id: ThreadGroupExt.java 1118 2024-03-15 16:14:15Z tquadrat $

Since:

0.1.0

UML Diagram

⁠

UML Diagram for "org.tquadrat.foundation.lang.ThreadGroupExt"

⁠

Field Summary

Fields

Modifier and Type	Field	Description
private final Thread.UncaughtExceptionHandler	m_UncaughtExceptionHandler	The Thread.UncaughtExceptionHandler for this thread group.

Constructor Summary

Constructors

Constructor	Description
ThreadGroupExt(String name)	Constructs a new thread group.
ThreadGroupExt(String name, Thread.UncaughtExceptionHandler handler)	Constructs a new thread group.
ThreadGroupExt(ThreadGroup parent, String name)	Constructs a new thread group.
ThreadGroupExt(ThreadGroup parent, String name, Thread.UncaughtExceptionHandler handler)	Constructs a new thread group.

Method Summary

Modifier and Type	Method	Description
final void	uncaughtException(Thread t, Throwable e)

Methods inherited from class java.lang.ThreadGroup

activeCount, activeGroupCount, checkAccess, destroy, enumerate, enumerate, enumerate, enumerate, getMaxPriority, getName, getParent, interrupt, isDaemon, isDestroyed, list, parentOf, resume, setDaemon, setMaxPriority, stop, suspend, toString

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Field Details

m_UncaughtExceptionHandler

private final Thread.UncaughtExceptionHandler m_UncaughtExceptionHandler

The Thread.UncaughtExceptionHandler for this thread group. It can be null.

Constructor Details

ThreadGroupExt

public ThreadGroupExt(String name)
               throws IllegalArgumentException

Constructs a new thread group.

The parent of this new group is the thread group of the currently running thread.

The behaviour of uncaughtException(Thread, Throwable) is that of the superclass.

Parameters:

name - The name of the new thread group.

Throws:

IllegalArgumentException - The name argument is either null, empty or blank.

SecurityException - The current thread cannot create a thread in this thread group.

ThreadGroupExt

public ThreadGroupExt(ThreadGroup parent,
 String name)
               throws IllegalArgumentException

Constructs a new thread group.

The parent of this new group is the specified thread group.

The behaviour of uncaughtException(Thread, Throwable) is that of the superclass.

Parameters:

parent - The parent thread group.

name - The name of the new thread group.

Throws:

IllegalArgumentException - The name argument is either null, empty or blank, or the parent thread group argument is null.

SecurityException - The current thread cannot create a thread in this thread group.

ThreadGroupExt

public ThreadGroupExt(String name,
 Thread.UncaughtExceptionHandler handler)
               throws IllegalArgumentException

Constructs a new thread group.

The parent of this new group is the thread group of the currently running thread.

The behaviour of uncaughtException(Thread, Throwable) is determined by the provided handler.

Parameters:

name - The name of the new thread group.

handler - The handler for the uncaught exceptions.

Throws:

IllegalArgumentException - The name argument is either null, empty or blank, or the handler argument is null.

SecurityException - The current thread cannot create a thread in this thread group.

ThreadGroupExt

public ThreadGroupExt(ThreadGroup parent,
 String name,
 Thread.UncaughtExceptionHandler handler)
               throws IllegalArgumentException

Constructs a new thread group.

The parent of this new group is the specified thread group.

The behaviour of uncaughtException(Thread, Throwable) is determined by the provided handler.

Parameters:

parent - The parent thread group.

name - The name of the new thread group.

handler - The handler for the uncaught exceptions.

Throws:

IllegalArgumentException - The name argument is either null, empty or blank, or one of the parent thread group or the handler arguments is null.

SecurityException - The current thread cannot create a thread in this thread group.

Method Details

uncaughtException

public final void uncaughtException(Thread t,
 Throwable e)

Specified by:

uncaughtException in interface Thread.UncaughtExceptionHandler

Overrides:

uncaughtException in class ThreadGroup