Operation Result

public class Foo {
	private ResourceWhatever resource;

	// We are getting parentResult here. It is the result that "belongs" to the caller.
	public void bar(String param1,OperationResult parentResult)) {

		// Create "result" for this operation from the parentResult.
		// The "result" will be automatically added as subresult of parentResult
		// Operation name is a full name of class with method name (by convention)
		OperationResult result = parentResult.createSubresult(Foo.class.getName()+ ".bar");

		// Add parameters and "context" to the result. This helps in diagnosing the problems.
		result.addParam("param1", param1);
		result.addContext("resource", resource);

		try {
			// Do something. Use my result as a parent result for the invoked method

			resource.doSomething("some","params",result);

			// If we have got here the operation was obviously successful. Therefore set the result status to success.
			result.recordSuccess();

			// that's all we have do to. The result is already attached to parentResult. So just let the method return.

		} catch (NonCriticalException ex) {
			// This expression indicates that something was done and the invocation is not a complete failure.
			// In other words: we can somehow ignore this error.
			// Therefore set result status to a partial failure and return as usual (this will continue execution).
			result.recordPartialError(ex);
			// Do NOT re-throw the exception

		} catch (CriticalException ex) {
			// This is critical. The operation is a complete failure and there is no point in continuing.
			// Therefore record fatal error and re-throw the exception (this will "break" the execution).
			result.recordFatalError("Bar has failed. All the rum is gone.",ex);
			throw ex;
		}
}