View Javadoc

1   /***
2    * DataSource.java
3    *
4    * This file is part of the creme library.
5    * The creme library intends to ease the development effort of large
6    * applications by providing easy to use support classes.
7    *
8    * Copyright (C) 2002 Denis Bregeon
9    *
10   * This library is free software; you can redistribute it and/or
11   * modify it under the terms of the GNU Lesser General Public
12   * License as published by the Free Software Foundation; either
13   * version 2.1 of the License, or (at your option) any later version.
14   *
15   * This library is distributed in the hope that it will be useful,
16   * but WITHOUT ANY WARRANTY; without even the implied warranty of
17   * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
18   * Lesser General Public License for more details.
19   *
20   * You should have received a copy of the GNU Lesser General Public
21   * License along with this library; if not, write to the Free Software
22   * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
23   *
24   * contact information: dbregeon@sourceforge.net
25   */
26  package org.jcreme.reporting;
27  
28  /***
29   * This is the general interface for all the DataSources. It provides the
30   * declaration of the event system support. DataSources can be used by reports
31   * to gain access to the data they need. It provides a great flexibility to
32   * assemble different data channels.
33   * 
34   * @author $Author: dbregeon $
35   * @version $Revision: 1.2 $
36   */
37  public interface DataSource {
38      /***
39       * Adds a DataChangeListener to this source. The listener will be notified
40       * of any data change detected by the source.
41       * 
42       * @param listener
43       *            the listener to add.
44       */
45      void addDataChangeListener(DataChangeListener listener);
46  
47      /***
48       * Removes a DataChangeListener from this source.
49       * 
50       * @param listener
51       *            the listener to remove.
52       */
53      void removeDataChangeListener(DataChangeListener listener);
54  }