ToolkitLock (NativeWindow API -- 2.4 Specification)

```
public interface ToolkitLock
```
Marker for a singleton global recursive blocking lock implementation, optionally locking a native windowing toolkit as well.
Toolkit locks are created solely via NativeWindowFactory.

One use case is the AWT locking on X11, see NativeWindowFactory.getDefaultToolkitLock(String, long).

Field Summary

Fields
Modifier and Type Field Description

static boolean DEBUG

static boolean TRACE_LOCK

Method Summary

All Methods Instance Methods Abstract Methods
Modifier and Type	Method	Description
`void`	`dispose()`	Dispose this instance.
`void`	`lock()`	Blocking until the lock is acquired by this Thread or a timeout is reached.
`void`	`unlock()`	Release the lock.
`void`	`validateLocked()`

- Field Detail
  - DEBUG
```
static final boolean DEBUG
```
  - TRACE_LOCK
```
static final boolean TRACE_LOCK
```
- Method Detail
  - lock
```
void lock()
```
    Blocking until the lock is acquired by this Thread or a timeout is reached.
    Timeout is implementation specific, if used at all.
    
    Throws:
    
    RuntimeException - in case of a timeout
  - unlock
```
void unlock()
```
    Release the lock.
    
    Throws:
    
    RuntimeException - in case the lock is not acquired by this thread.
  - validateLocked
```
void validateLocked()
             throws RuntimeException
```
    Throws:
    
    RuntimeException - if current thread does not hold the lock
  - dispose
```
void dispose()
```
    Dispose this instance.
    Shall be called when instance is no more required.
    This allows implementations sharing a lock via resources to decrease the reference counter.