X-Git-Url: https://gerrit.simantics.org/r/gitweb?a=blobdiff_plain;f=bundles%2Forg.simantics.db%2Fsrc%2Forg%2Fsimantics%2Fdb%2Fprocedure%2FStatementProcedure.java;h=e03b46888810484d4174f4f8c57b7fee7de0d0ea;hb=93e70f713558f9826b78ad54929f80e52d8c824b;hp=622277300ab6922a5e84071c64520ea8a50c4235;hpb=969bd23cab98a79ca9101af33334000879fb60c5;p=simantics%2Fplatform.git diff --git a/bundles/org.simantics.db/src/org/simantics/db/procedure/StatementProcedure.java b/bundles/org.simantics.db/src/org/simantics/db/procedure/StatementProcedure.java index 622277300..e03b46888 100644 --- a/bundles/org.simantics.db/src/org/simantics/db/procedure/StatementProcedure.java +++ b/bundles/org.simantics.db/src/org/simantics/db/procedure/StatementProcedure.java @@ -1,60 +1,60 @@ -/******************************************************************************* - * 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.procedure; - -import java.util.List; - -import org.simantics.db.AsyncReadGraph; -import org.simantics.db.Statement; - -/** - * @author Antti Villberg - * - * First execute is called k times. After this finished or exception is called exactly once. - * - * @param the result object type accepted by the procedure - */ -public interface StatementProcedure extends List { - - /** - * Invoked once for each separate result of the request with potentially - * multiple results. It shall be guaranteed that all execute - * invocations have been completed when either - * {@link #finished(AsyncReadGraph)} or - * {@link #exception(AsyncReadGraph, Throwable)} are called and that no - * execute invocations will follow afterwards. - * - * @param graph asynchronous graph access - * @param result a single result of the multiresult procedure - */ - void execute(AsyncReadGraph graph, int s, int p, int o); - - /** - * Invoked after all {@link #execute(AsyncReadGraph, Object)} calls have - * been finished successfully. This method will not be invoked if case of - * errors in {@link #execute(AsyncReadGraph, Object)} or the performed - * request that provides the results to this procedure. - * - * @param graph asynchronous graph access - */ - void finished(AsyncReadGraph graph); - - /** - * If an error occurs in the processing of the database request that - * produces the results for this procedure. - * - * @param graph asynchronous graph access - * @param throwable the exception that occurred - */ - void exception(AsyncReadGraph graph, Throwable throwable); - -} +/******************************************************************************* + * 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.procedure; + +import java.util.List; + +import org.simantics.db.AsyncReadGraph; +import org.simantics.db.Statement; + +/** + * @author Antti Villberg + * + * First execute is called k times. After this finished or exception is called exactly once. + * + * @param the result object type accepted by the procedure + */ +public interface StatementProcedure extends List { + + /** + * Invoked once for each separate result of the request with potentially + * multiple results. It shall be guaranteed that all execute + * invocations have been completed when either + * {@link #finished(AsyncReadGraph)} or + * {@link #exception(AsyncReadGraph, Throwable)} are called and that no + * execute invocations will follow afterwards. + * + * @param graph asynchronous graph access + * @param result a single result of the multiresult procedure + */ + void execute(AsyncReadGraph graph, int s, int p, int o); + + /** + * Invoked after all {@link #execute(AsyncReadGraph, Object)} calls have + * been finished successfully. This method will not be invoked if case of + * errors in {@link #execute(AsyncReadGraph, Object)} or the performed + * request that provides the results to this procedure. + * + * @param graph asynchronous graph access + */ + void finished(AsyncReadGraph graph); + + /** + * If an error occurs in the processing of the database request that + * produces the results for this procedure. + * + * @param graph asynchronous graph access + * @param throwable the exception that occurred + */ + void exception(AsyncReadGraph graph, Throwable throwable); + +}