net.m2technologies.open_arm.utilities.collections
Class ExceptionalClosure

java.lang.Object
  net.m2technologies.open_arm.utilities.collections.ExceptionalClosure

public abstract class ExceptionalClosure

extends java.lang.Object

Copyright 2005 Mark Masterson

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.

Description: Abstract class to use the Closure interface to handle checked exceptions. Normally, an iteration shouldn't cause any checked exceptions. Every checked exception is wrapped into a RuntimeClosureException. The user of this class has to rewrite the #basicExecute method. The usage of this class may be combined with a special #forAllDo method to clear the checked exception or unwrap it to throw it again.

Version:

0.009

Author:

Peter Ko�ek

Constructor Summary

ExceptionalClosure()

Method Summary

protected abstract void	basicExecute(java.lang.Object o) method to wrap any selecting code who can throw a checked exception.
void	execute(java.lang.Object o) redefine the #execute method to establish a mechanism to tunnel checked exceptions through the Commons-Collection API which doesn't know checked exceptions.

Methods inherited from class java.lang.Object

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

Constructor Detail

ExceptionalClosure

public ExceptionalClosure()

Method Detail

execute

public final void execute(java.lang.Object o)
                   throws RuntimeClosureException

redefine the #execute method to establish a mechanism to tunnel checked exceptions through the Commons-Collection API which doesn't know checked exceptions. The method is declared final because you should use #basicExecute now.

Throws:

RuntimeClosureException

See Also:

org.apache.commons.collections.Closure#execute

basicExecute

protected abstract void basicExecute(java.lang.Object o)
                              throws java.lang.Exception

method to wrap any selecting code who can throw a checked exception. This method is called by the #execute method of this class, which will wrap the exception into a RuntimeClosureException.

Throws:

java.lang.Exception