--- /dev/null
+/*\r
+\r
+ Derby - Class org.apache.derby.iapi.sql.execute.TargetResultSet\r
+\r
+ Licensed to the Apache Software Foundation (ASF) under one or more\r
+ contributor license agreements. See the NOTICE file distributed with\r
+ this work for additional information regarding copyright ownership.\r
+ The ASF licenses this file to you under the Apache License, Version 2.0\r
+ (the "License"); you may not use this file except in compliance with\r
+ the License. You may obtain a copy of the License at\r
+\r
+ http://www.apache.org/licenses/LICENSE-2.0\r
+\r
+ Unless required by applicable law or agreed to in writing, software\r
+ distributed under the License is distributed on an "AS IS" BASIS,\r
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\r
+ See the License for the specific language governing permissions and\r
+ limitations under the License.\r
+\r
+ */\r
+\r
+package org.apache.derby.iapi.sql.execute;\r
+\r
+import org.apache.derby.iapi.error.StandardException;\r
+\r
+import org.apache.derby.iapi.sql.execute.ExecRow;\r
+\r
+import org.apache.derby.iapi.sql.ResultSet;\r
+\r
+import org.apache.derby.iapi.types.RowLocation;\r
+\r
+/**\r
+ * The TargetResultSet interface is used to provide additional\r
+ * operations on result sets that are the target of a bulk insert \r
+ * or update. This is useful because bulk insert is upside down -\r
+ * the insert is done via the store.\r
+ *\r
+ */\r
+public interface TargetResultSet extends ResultSet\r
+{\r
+ /**\r
+ * Pass a changed row and the row location for that row\r
+ * to the target result set.\r
+ *\r
+ * @param execRow The changed row.\r
+ * @param rowLocation The row location of the row.\r
+ *\r
+ * @exception StandardException thrown if cursor finished.\r
+ */\r
+ public void changedRow(ExecRow execRow, RowLocation rowLocation) throws StandardException;\r
+\r
+ /**\r
+ * Preprocess the source row prior to getting it back from the source.\r
+ * This is useful for bulk insert where the store stands between the target and \r
+ * the source.\r
+ *\r
+ * @param sourceRow The source row.\r
+ *\r
+ * @return The preprocessed source row.\r
+ *\r
+ * @exception StandardException thrown if cursor finished.\r
+ */\r
+ public ExecRow preprocessSourceRow(ExecRow sourceRow) throws StandardException;\r
+}\r