com.qcloud.cos.event.COSProgressPublisher Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of cos_api Show documentation
qcloud cos sdk for inner tencentyun
The newest version!
package com.qcloud.cos.event;

import java.util.concurrent.Future;

import org.slf4j.LoggerFactory;

import com.qcloud.cos.transfer.PersistableTransfer;

/**
 * Used to publish transfer events.
 */
public class COSProgressPublisher extends SDKProgressPublisher {
    /**
     * Used to deliver a persistable transfer to the given cos listener.
     * 
     * @param listener only listener of type {@link COSProgressListener} will be
     * notified.
     * 
     * @return the future of a submitted task; or null if the delivery is
     * synchronous with no future task involved.  Note a listener should never
     * block, and therefore returning null is the typical case.
     */
    public static Future publishTransferPersistable(
            final ProgressListener listener,
            final PersistableTransfer persistableTransfer) {
        if (persistableTransfer == null 
        || !(listener instanceof COSProgressListener))
            return null;
        final COSProgressListener coslistener = (COSProgressListener)listener;
        return deliverEvent(coslistener, persistableTransfer);
    }

    private static Future deliverEvent(final COSProgressListener listener,
            final PersistableTransfer persistableTransfer) {
        if (SYNC) { // forces all callbacks to be made synchronously
            return quietlyCallListener(listener, persistableTransfer);
        }
        if (!ASYNC) { // forces all callbacks to be made asynchronously
            if (listener instanceof DeliveryMode) {
                DeliveryMode mode = (DeliveryMode) listener;
                if (mode.isSyncCallSafe()) {
                    // Safe to call the listener directly
                    return quietlyCallListener(listener, persistableTransfer);
                }
            }
        }
        // Not safe to call the listener directly; so submit an async task.
        // This is unfortunate as the listener should never block in the first
        // place, but such task submission is necessary to remain backward
        // compatible.
        return setLatestFutureTask(getExecutorService().submit(new Runnable() {
            @Override public void run() {
                listener.onPersistableTransfer(persistableTransfer);
            }
        }));
    }

    private static Future quietlyCallListener(
            final COSProgressListener listener,
            final PersistableTransfer persistableTransfer) {
        try {
            listener.onPersistableTransfer(persistableTransfer);
        } catch(Throwable t) {
            // That's right, we need to suppress all errors so as to be on par
            // with the async mode where all failures will be ignored.
            LoggerFactory.getLogger(COSProgressPublisher.class)
                .debug("Failure from the event listener", t);
        }
        return null;
    }
}