1 /** 2 * com.mckoi.database.jdbc.DatabaseCallBack 02 Oct 2000 3 * 4 * Mckoi SQL Database ( http://www.mckoi.com/database ) 5 * Copyright (C) 2000, 2001, 2002 Diehl and Associates, Inc. 6 * 7 * This program is free software; you can redistribute it and/or 8 * modify it under the terms of the GNU General Public License 9 * Version 2 as published by the Free Software Foundation. 10 * 11 * This program is distributed in the hope that it will be useful, 12 * but WITHOUT ANY WARRANTY; without even the implied warranty of 13 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the 14 * GNU General Public License Version 2 for more details. 15 * 16 * You should have received a copy of the GNU General Public License 17 * Version 2 along with this program; if not, write to the Free Software 18 * Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. 19 * 20 * Change Log: 21 * 22 * 23 */ 24 25 package com.mckoi.database.jdbc; 26 27 /** 28 * An interface that is input to the DatabaseInterface as a way to be 29 * notified of event information from inside the database. 30 * 31 * @author Tobias Downer 32 */ 33 34 public interface DatabaseCallBack { 35 36 /** 37 * Called when the database has generated an event that this user is 38 * listening for. 39 * <p> 40 * NOTE: The thread that calls back these events is always a volatile 41 * thread that may not block. It is especially important that no queries 42 * are executed when this calls back. To safely act on events, it is 43 * advisable to dispatch onto another thread such as the 44 * SwingEventDispatcher thread. 45 */ 46 void databaseEvent(int event_type, String event_message); 47 48 } 49