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-bundle Show documentation
Show all versions of cos_api-bundle Show documentation
A single bundled dependency that includes all service and dependent JARs with third-party libraries
relocated to different namespaces.
/*
* Copyright 2010-2019 Amazon.com, Inc. or its affiliates. All Rights Reserved.
*
* Licensed under the Apache License, Version 2.0 (the "License").
* You may not use this file except in compliance with the License.
* A copy of the License is located at
*
* http://aws.amazon.com/apache2.0
*
* or in the "license" file accompanying this file. This file is distributed
* on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either
* express or implied. See the License for the specific language governing
* permissions and limitations under the License.
* According to cos feature, we modify some class,comment, field name, etc.
*/
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;
}
}
© 2015 - 2024 Weber Informatics LLC | Privacy Policy