H
- The type of the handle.CON
- The connection used to open the referenced instance.ConnectionComponentHandle<H,CON>
, ConnectionComponentHandle.ConnectionAutomatonHandle<H,CON>
, ConnectionOpenableHandle.ConnectionOpenAutomatonHandle<H,CON>
public interface ConnectionOpenableHandle<H,CON>
ConnectionOpenableHandle
interface defines those methods related
to the handle based open/connect life-cycle.
The handle reference requires the ConnectionOpenable
interface to be
implemented.
Modifier and Type | Interface | Description |
---|---|---|
static interface |
ConnectionOpenableHandle.ConnectionOpenAutomatonHandle<H,CON> |
The
ConnectionOpenableHandle.ConnectionOpenAutomatonHandle interface defines those methods
related to the handle based open/connect life-cycle. |
Modifier and Type | Method | Description |
---|---|---|
boolean |
hasConnectionOpenable(H aHandle) |
Determines whether the handle reference is
ConnectionOpenable by
implementing the ConnectionOpenable interface. |
void |
open(H aHandle,
CON aConnection) |
Open/connect the component identified by the given handle.
|
default void |
openUnchecked(H aHandle,
CON aConnection) |
Opens the component by calling
open(Object, Object) without you
to require catching an IOException . |
boolean hasConnectionOpenable(H aHandle) throws UnknownHandleRuntimeException
ConnectionOpenable
by
implementing the ConnectionOpenable
interface.aHandle
- The handle to test whether the reference provides the
according functionality.UnknownHandleRuntimeException
- in case the handle is unknown.void open(H aHandle, CON aConnection) throws IOException, UnknownHandleRuntimeException, UnsupportedHandleOperationRuntimeException, IllegalHandleStateChangeRuntimeException
aHandle
- The handle identifying the component.aConnection
- The connection to be passed to the implementing
instance.IOException
- in case opening/connecting fails.UnknownHandleRuntimeException
- in case the given handle is
unknown.UnsupportedHandleOperationRuntimeException
- in case the reference
of the handle does not support the requested operation.IllegalHandleStateChangeRuntimeException
- Thrown in case a state
change is not possible due to the current state the referenced
component is in.default void openUnchecked(H aHandle, CON aConnection)
open(Object, Object)
without you
to require catching an IOException
.aHandle
- The handle identifying the component.aConnection
- The connection to be passed to the implementing
instance.org.refcodes.exception.HiddenException
- encapsulates the cause and is thrown upon
encountering a IOException
exceptionCopyright © 2021. All rights reserved.