Basic types

Abstract supertype of resources which may be obtained at the beginning of a `try` statement and then released when the statement completes. Unlike a `Destroyable` resource, a single instance of `Obtainable` may be reused between multiple `try` statements or multiple executions of the same `try` statement.

    Lock lock = ... ;
    try (lock) {
        ...
    }

- `obtain()` is called before the body of the `try` statement is executed, and
- `release()` is called when execution of the body of the `try` statement ends, even if an exception propagates out of the body of the `try`.

A class which satisfies `Obtainable` may impose constraints on the ordering and nesting of invocations of `obtain()` and `release()`. For example, it may be not be possible to obtain a resource that has already been obtained. Those methods should produce an `AssertionError` when any such constraint is violated.

See also `Destroyable`
Since 1.1.0

no type hierarchy

- `Obtainable`
  - `Usable`

no subtypes hierarchy

Inherited Attributes
Attributes inherited from: `Object` `hash`, `string`

Methods
`obtain` | Source Code `shared formal void obtain()` Obtain this resource. Called before the body of a `try` statement is executed. If an exception is thrown by `obtain()`, then `release()` will not be called. Throws `AssertionError` if an illegal state is detected
`release` | Source Code `shared formal void release(Throwable? error)` Release this resource. Called when execution of the body of a `try` statement ends, even if an exception propagates out of the body of the `try`. Parameters: `error` The exception propagating out of the body of the `try` statement, or `null` if no exception was propagated. Throws `AssertionError` if an illegal state is detected

Inherited Methods
Methods inherited from: `Object` `equals()`