aQute.bnd.util.repository

Class DownloadListenerPromise

java.lang.Object

aQute.bnd.util.repository.DownloadListenerPromise

All Implemented Interfaces:

Failure, Success<java.io.File,java.lang.Void>

public class DownloadListenerPromise
extends java.lang.Object
implements Success<java.io.File,java.lang.Void>, Failure

Uses promises to signal the Download Listener from RepositoryPlugin

Constructor Summary

Constructors

Constructor and Description
DownloadListenerPromise(Reporter reporter, java.lang.String task, Promise<java.io.File> promise, RepositoryPlugin.DownloadListener... downloadListeners) Use the promise to signal the Download Listeners

Method Summary

Methods

Modifier and Type	Method and Description
Promise<java.lang.Void>	call(Promise<java.io.File> resolved) Success callback for a Promise.
void	fail(Promise<?> resolved) Failure callback for a Promise.
void	linkTo(java.io.File linked)
java.lang.String	toString()

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

DownloadListenerPromise

public DownloadListenerPromise(Reporter reporter,
                       java.lang.String task,
                       Promise<java.io.File> promise,
                       RepositoryPlugin.DownloadListener... downloadListeners)

Use the promise to signal the Download Listeners

Parameters:

reporter - a reporter or null (will use a SLF4 in that case)

task -

promise -

downloadListeners -

Method Detail

call

public Promise<java.lang.Void> call(Promise<java.io.File> resolved)
                             throws java.lang.Exception

Description copied from interface: Success

Success callback for a Promise.

This method is called if the Promise with which it is registered resolves successfully.

In the remainder of this description we will refer to the Promise returned by this method as the returned Promise and the Promise returned by Promise.then(Success) when this Success callback was registered as the chained Promise.

If the returned Promise is null then the chained Promise must resolve immediately with a successful value of null. If the returned Promise is not null then the chained Promise must be resolved when the returned Promise is resolved.

Specified by:

call in interface Success<java.io.File,java.lang.Void>

Parameters:

resolved - The successfully resolved Promise.

Returns:

The Promise to use to resolve the chained Promise, or null if the chained Promise is to be resolved immediately with the value null.

Throws:

java.lang.Exception - The chained Promise must be failed with the thrown exception.

fail

public void fail(Promise<?> resolved)
          throws java.lang.Exception

Description copied from interface: Failure

Failure callback for a Promise.

This method is called if the Promise with which it is registered resolves with a failure.

In the remainder of this description we will refer to the Promise returned by Promise.then(Success, Failure) when this Failure callback was registered as the chained Promise.

If this methods completes normally, the chained Promise must be failed with the same exception which failed the resolved Promise. If this method throws an exception, the chained Promise must be failed with the thrown exception.

Specified by:

fail in interface Failure

Parameters:

resolved - The failed resolved Promise.

Throws:

java.lang.Exception - The chained Promise must be failed with the thrown exception.

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object

linkTo

public void linkTo(java.io.File linked)