org.refcodes.component.BidirectionalConnectionOpenableHandle Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of refcodes-component Show documentation
Artifact with common component definitions and functionality.
The newest version!
package org.refcodes.component;

import org.refcodes.component.ConnectionOpenable.ConnectionOpenAutomaton;

/**
 * The {@link BidirectionalConnectionOpenableHandle} interface defines those methods related
 * to the handle based open/connect life-cycle.
 * 
 * The handle reference requires the {@link BidirectionalConnectionOpenable} interface to be
 * implemented.
 *
 * @param  The type of the handle.
 * @param  The type of the input connection to be used.
 * @param  The type of the output connection to be used.
 */
public interface BidirectionalConnectionOpenableHandle {

	/**
	 * Determines whether the handle reference is {@link BidirectionalConnectionOpenable} by
	 * implementing the {@link BidirectionalConnectionOpenable} interface.
	 * 
	 * @param aHandle The handle to test whether the reference provides the
	 *        according functionality.
	 * 
	 * @return True in case the reference provides the according functionality.
	 * 
	 * @throws UnknownHandleRuntimeException in case the handle is unknown.
	 */
	boolean hasBidirectionalConnectionOpenable( H aHandle ) throws UnknownHandleRuntimeException;

	/**
	 * Open/connect the component identified by the given handle.
	 * 
	 * @param aInputConnection The input connection used for opening the
	 *        connection.
	 * 
	 * @param aOutputConnection The output connection used for opening the
	 *        connection.
	 * 
	 * @param aHandle The handle identifying the component.
	 * 
	 * @throws OpenException in case opening/connecting fails.
	 * 
	 * @throws UnsupportedHandleOperationRuntimeException in case the reference
	 *         of the handle does not support the requested operation.
	 * 
	 * @throws UnknownHandleRuntimeException in case the given handle is
	 *         unknown.
	 * 
	 * @throws IllegaleHandleStateChangeRuntimeException Thrown in case a state
	 *         change is not possible due to the current state the referenced
	 *         component is in.
	 */
	void open( H aHandle, INPUT aInputConnection, OUTPUT aOutputConnection ) throws OpenException, UnknownHandleRuntimeException, UnsupportedHandleOperationRuntimeException, IllegaleHandleStateChangeRuntimeException;

	/**
	 * The {@link BidirectionalConnectionOpenAutomatonHandle} interface defines those
	 * methods related to the handle based open/connect life-cycle.
	 * 
	 * The handle reference requires the {@link ConnectionOpenAutomaton}
	 * interface to be implemented.
	 * 
	 * @param  The type of the handle.
	 * @param  The type of the input connection to be used.
	 * @param  The type of the output connection to be used.
	 */
	public interface BidirectionalConnectionOpenAutomatonHandle extends BidirectionalConnectionOpenableHandle, OpenedHandle {

		/**
		 * Determines whether the handle reference is configurable by
		 * implementing the {@link ConnectionOpenAutomaton} interface.
		 * 
		 * @param aHandle The handle to test whether the reference provides the
		 *        according functionality.
		 * 
		 * @return True in case the reference provides the according
		 *         functionality.
		 * 
		 * @throws UnknownHandleRuntimeException in case the handle is unknown.
		 */
		boolean hasBidirectionalConnectionOpenAutomaton( H aHandle ) throws UnknownHandleRuntimeException;

		/**
		 * Determines whether the component identified by the given handle may
		 * get opened/connected.
		 * 
		 * @param aHandle The handle identifying the component.
		 * 
		 * @param aInputConnection The input connection used for opening the
		 *        connection.
		 * 
		 * @param aOutputConnection The output connection used for opening the
		 *        connection.
		 * 
		 * @return True if {@link #open(Object, Object)} is possible.
		 * 
		 * @throws UnsupportedHandleOperationRuntimeException in case the
		 *         reference of the handle does not support the requested
		 *         operation.
		 * 
		 * @throws UnknownHandleRuntimeException in case the given handle is
		 *         unknown.
		 */
		boolean isOpenable( H aHandle, INPUT aInputConnection, OUTPUT aOutputConnection ) throws UnknownHandleRuntimeException, UnsupportedHandleOperationRuntimeException;
	}
}