/******************************************************************************* * Copyright (c) 2007, 2010 Association for Decentralized Information Management * in Industry THTH ry. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at * http://www.eclipse.org/legal/epl-v10.html * * Contributors: * VTT Technical Research Centre of Finland - initial API and implementation *******************************************************************************/ package org.simantics.db.common.request; import org.simantics.db.AsyncRequestProcessor; import org.simantics.db.RequestProcessor; import org.simantics.db.VirtualGraph; import org.simantics.db.exception.DatabaseException; import org.simantics.db.procedure.Procedure; import org.simantics.db.request.UndoTraits; import org.simantics.db.request.WriteInterface; import org.simantics.db.request.WriteOnly; import org.simantics.utils.datastructures.Callback; /** * TODO: fix this javadoc to document the correct class!! * * Usage samples: * *
* Synchronous read without checked exceptions: *
** Resource r = new SimpleReadGraphRequest<Resource>(session) { * {@code @Override} * public Resource run(Graph g) { * Resource r = doSomethingThatMayFail(); * return r; * } * }.sync(); ** *
* Synchronous read with a selected checked exception that may be thrown: *
** Resource r = new SimpleReadGraphRequest<Resource>(session) { * {@code @Override} * public Resource run(Graph g) throws CheckedException { * Resource r = doSomethingThatMayFailWithCheckedException(); * return r; * } * }.sync(CheckedException.class); ** *
* Asynchronous read with a completed() method for examining the result: *
** Resource r = new SimpleReadGraphRequest<Resource>(session) { * {@code @Override} * public Resource run(Graph g) { * Resource r = doSomethingThatMayFail(); * return r; * } * public void completed(Resource result) { * // quickly dispatch the result somewhere, do nothing serious in this code. * } * }.async(); ** * @param