| /* |
| * Licensed to the Apache Software Foundation (ASF) under one or more |
| * contributor license agreements. See the NOTICE file distributed with |
| * this work for additional information regarding copyright ownership. |
| * The ASF licenses this file to You 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. |
| */ |
| |
| package javax.sql; |
| |
| import java.util.EventListener; |
| |
| /** |
| * An interface used to send notification of events occurring in the context of |
| * a {@link RowSet}. To receive the notification events, an object must |
| * implement the {@code RowSetListener} interface and then register itself with |
| * the {@code RowSet} of interest using the |
| * {@link RowSet#addRowSetListener(RowSetListener)} method. |
| */ |
| public interface RowSetListener extends EventListener { |
| |
| /** |
| * Notifies the listener that the {@code RowSet}'s cursor in {@code |
| * theEvent.getSource} has moved. |
| * |
| * @param theEvent |
| * a {@code RowSetEvent} that contains information about the |
| * {@code RowSet} involved. This information can be used to |
| * retrieve information about the change, such as the updated |
| * data values. |
| */ |
| public void cursorMoved(RowSetEvent theEvent); |
| |
| /** |
| * Notifies the listener that one of the {@code RowSet}'s rows in {@code |
| * theEvent.getSource} has changed. |
| * |
| * @param theEvent |
| * a {@code RowSetEvent} that contains information about the |
| * {@code RowSet} involved. This information can be used to |
| * retrieve information about the change, such as the new cursor |
| * position. |
| */ |
| public void rowChanged(RowSetEvent theEvent); |
| |
| /** |
| * Notifies the listener that the {@code RowSet}'s entire contents in |
| * {@code theEvent.getSource} have been updated (an example is the execution |
| * of a command which retrieves new data from the database). |
| * |
| * @param theEvent |
| * a {@code RowSetEvent} that contains information about the |
| * {@code RowSet} involved. This information can be used to |
| * retrieve information about the change, such as the updated |
| * rows of data. |
| */ |
| public void rowSetChanged(RowSetEvent theEvent); |
| } |