Package org.refcodes.component

Interface ProgressHandle<H>

  • Type Parameters:
    H - the generic type
    All Known Subinterfaces:
    CompositeComponentHandle<H,REF>
    public interface ProgressHandle<H>
    Whenever a handle is associated with a progress, then a component providing such handles should implement this interface.

    The handle reference requires the ProgressAccessor interface to be implemented.

    • Method Detail

      • hasProgress

        boolean hasProgress​(H aHandle)
             throws UnknownHandleRuntimeException
        Determines whether the handle reference provides a progress by implementing the ProgressAccessor interface.
        Parameters:
        aHandle - The handle to test whether the reference provides the according functionality.
        Returns:
        True in case the reference provides the according functionality.
        Throws:
        UnknownHandleRuntimeException - Thrown in case the handle is unknown (there is none reference for this handle).

      • getProgress

        float getProgress​(H aHandle)
           throws UnsupportedHandleOperationRuntimeException,
                  UnknownHandleRuntimeException
        The progress of a handle can be queried by this method. A value of zero ("0") indicates that there was no progress so far, a value of one ("1") indicates that the progress is 100%. The handle association requires the ProgressAccessor interface to be implemented.
        Parameters:
        aHandle - The handle for which to determine the current progress.
        Returns:
        A value between zero ("0") and one ("1") determining the progress related to the given handle.
        Throws:
        UnsupportedHandleOperationRuntimeException - in case the reference of the handle does not support the requested operation.
        UnknownHandleRuntimeException - Thrown in case the handle is unknown (there is none reference for this handle).