Home | History | Annotate | Download | only in sql
      1 /*
      2  * Licensed to the Apache Software Foundation (ASF) under one or more
      3  * contributor license agreements.  See the NOTICE file distributed with
      4  * this work for additional information regarding copyright ownership.
      5  * The ASF licenses this file to You under the Apache License, Version 2.0
      6  * (the "License"); you may not use this file except in compliance with
      7  * the License.  You may obtain a copy of the License at
      8  *
      9  *     http://www.apache.org/licenses/LICENSE-2.0
     10  *
     11  * Unless required by applicable law or agreed to in writing, software
     12  * distributed under the License is distributed on an "AS IS" BASIS,
     13  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
     14  * See the License for the specific language governing permissions and
     15  * limitations under the License.
     16  */
     17 
     18 package javax.sql;
     19 
     20 import java.io.Serializable;
     21 import java.util.EventObject;
     22 
     23 /**
     24  * An event which is sent when specific events happen to a {@link RowSet}
     25  * object. The events are sent to inform registered listeners that changes have
     26  * occurred to the {@code RowSet}. The events covered are:
     27  * <ol>
     28  * <li>A single row in the {@code RowSet} changes.</li>
     29  * <li>The whole set of data in the {@code RowSet} changes.</li>
     30  * <li>The {@code RowSet} cursor position changes.</li>
     31  * </ol>
     32  * <p>
     33  * The event contains a reference to the {@code RowSet} object which generated
     34  * the message so that the listeners can extract whatever information they need
     35  * from that reference.
     36  */
     37 public class RowSetEvent extends EventObject implements Serializable {
     38 
     39     private static final long serialVersionUID = -1875450876546332005L;
     40 
     41     /**
     42      * Creates a {@code RowSetEvent} object containing a reference to the
     43      * {@link RowSet} object that generated the event. Information about the
     44      * changes that have occurred to the {@code RowSet} can be extracted from
     45      * the {@code RowSet} using one or more of the query methods available on
     46      * the {@code RowSet}.
     47      *
     48      * @param theSource
     49      *            the {@code RowSet} which generated the event.
     50      */
     51     public RowSetEvent(RowSet theSource) {
     52         super(theSource);
     53     }
     54 }
     55