com.groupbyinc.common.apache.commons.collections4.functors.CatchAndRethrowClosure Maven / Gradle / Ivy
/*
* Licensed to the Apache Software Foundation (ASF) under one or more
* contributor license agreements. See the NOTICE file distributed with
* this work for additional information regarding copyright ownership.
* The ASF licenses this file to You 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.apache.commons.collections4.functors;
import org.apache.commons.collections4.Closure;
import org.apache.commons.collections4.FunctorException;
/**
* {@link Closure} that catches any checked exception and re-throws it as a
* {@link FunctorException} runtime exception. Example usage:
*
*
* // Create a catch and re-throw closure via anonymous subclass
* CatchAndRethrowClosure<String> writer = new ThrowingClosure() {
* private java.io.Writer out = // some writer
*
* protected void executeAndThrow(String input) throws IOException {
* out.write(input); // throwing of IOException allowed
* }
* };
*
* // use catch and re-throw closure
* java.util.List strList = // some list
* try {
* CollctionUtils.forAllDo(strList, writer);
* } catch (FunctorException ex) {
* Throwable originalError = ex.getCause();
* // handle error
* }
*
*
* @since 4.0
* @version $Id: CatchAndRethrowClosure.java 1477798 2013-04-30 19:49:02Z tn $
*/
public abstract class CatchAndRethrowClosure implements Closure {
/**
* Execute this closure on the specified input object.
*
* @param input the input to execute on
* @throws FunctorException (runtime) if the closure execution resulted in a
* checked exception.
*/
public void execute(final E input) {
try {
executeAndThrow(input);
} catch (final RuntimeException ex) {
throw ex;
} catch (final Throwable t) {
throw new FunctorException(t);
}
}
/**
* Execute this closure on the specified input object.
*
* @param input the input to execute on
* @throws Throwable if the closure execution resulted in a checked
* exception.
*/
protected abstract void executeAndThrow(E input) throws Throwable;
}