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
18package javax.sql;
19
20import java.io.Serializable;
21import 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 */
37public 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