diff options
Diffstat (limited to 'bundles/org.eclipse.osgi.util/src/org/osgi/util/promise/FailedPromisesException.java')
-rw-r--r-- | bundles/org.eclipse.osgi.util/src/org/osgi/util/promise/FailedPromisesException.java | 55 |
1 files changed, 55 insertions, 0 deletions
diff --git a/bundles/org.eclipse.osgi.util/src/org/osgi/util/promise/FailedPromisesException.java b/bundles/org.eclipse.osgi.util/src/org/osgi/util/promise/FailedPromisesException.java new file mode 100644 index 000000000..95546abe5 --- /dev/null +++ b/bundles/org.eclipse.osgi.util/src/org/osgi/util/promise/FailedPromisesException.java @@ -0,0 +1,55 @@ +/* + * Copyright (c) OSGi Alliance (2014). 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. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License 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. + */ + +package org.osgi.util.promise; + +import java.util.Collection; +import java.util.Collections; + +/** + * Promise failure exception for a collection of failed Promises. + * + * @author $Id$ + */ +public class FailedPromisesException extends RuntimeException { + private static final long serialVersionUID = 1L; + private final Collection<Promise<?>> failed; + + /** + * Create a new FailedPromisesException with the specified Promises. + * + * @param failed A collection of Promises that have been resolved with a + * failure. Must not be {@code null}, must not be empty and all of + * the elements in the collection must not be {@code null}. + * @param cause The cause of this exception. This is typically the failure + * of the first Promise in the specified collection. + */ + public FailedPromisesException(Collection<Promise<?>> failed, Throwable cause) { + super(cause); + this.failed = Collections.unmodifiableCollection(failed); + } + + /** + * Returns the collection of Promises that have been resolved with a + * failure. + * + * @return The collection of Promises that have been resolved with a + * failure. The returned collection is unmodifiable. + */ + public Collection<Promise<?>> getFailedPromises() { + return failed; + } +} |