Module jdk.jdi
Package com.sun.jdi.request

# Interface ThreadDeathRequest

All Superinterfaces:
  `EventRequest`, `Mirror`

public interface ThreadDeathRequest extends EventRequest
Request for notification when a thread terminates in the target VM. When an enabled ThreadDeathRequest is satisfied, an `event set` containing a `ThreadDeathEvent` will be placed on the `EventQueue`. The collection of existing ThreadDeathRequests is managed by the `EventRequestManager`

Since:
  1.3
See Also:
  - `ThreadDeathEvent`
  - `EventQueue`
  - `EventRequestManager`

## Field Summary

### Fields declared in interface com.sun.jdi.request.EventRequest

`SUSPEND_ALL, SUSPEND_EVENT_THREAD, SUSPEND_NONE`

## Method Summary

Modifier and Type
Method
Description
`default void`
`addPlatformThreadsOnlyFilter()`
Restricts the events generated by this request to only platform threads.
`void`
`addThreadFilter(ThreadReference thread)`
Restricts the events generated by this request to those in the given thread.

### Methods declared in interface com.sun.jdi.request.EventRequest

`addCountFilter, disable, enable, getProperty, isEnabled, putProperty, setEnabled, setSuspendPolicy, suspendPolicy`

### Methods declared in interface com.sun.jdi.Mirror

`toString, virtualMachine`

## Method Details

### addThreadFilter

void addThreadFilter(ThreadReference thread)
Restricts the events generated by this request to those in the given thread.

Parameters:
  `thread` - the thread to filter on.
Throws:
  `InvalidRequestStateException` - if this request is currently enabled or has been deleted. Filters may be added only to disabled requests.

### addPlatformThreadsOnlyFilter

default void addPlatformThreadsOnlyFilter()
Restricts the events generated by this request to only platform threads.

Implementation Requirements:
  The default implementation throws `UnsupportedOperationException`.
Throws:
  `InvalidRequestStateException` - if this request is currently enabled or has been deleted
Since:
  21