01: /*
02: * HA-JDBC: High-Availability JDBC
03: * Copyright (c) 2004-2007 Paul Ferraro
04: *
05: * This library is free software; you can redistribute it and/or modify it
06: * under the terms of the GNU Lesser General Public License as published by the
07: * Free Software Foundation; either version 2.1 of the License, or (at your
08: * option) any later version.
09: *
10: * This library is distributed in the hope that it will be useful, but WITHOUT
11: * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
12: * FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License
13: * for more details.
14: *
15: * You should have received a copy of the GNU Lesser General Public License
16: * along with this library; if not, write to the Free Software Foundation,
17: * Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
18: *
19: * Contact: ferraro@users.sourceforge.net
20: */
21: package net.sf.hajdbc;
22:
23: import java.sql.Connection;
24: import java.sql.SQLException;
25:
26: import javax.management.DynamicMBean;
27:
28: /**
29: * @author Paul Ferraro
30: * @version $Revision: 1536 $
31: * @param <D> either java.sql.Driver or javax.sql.DataSource
32: * @since 1.0
33: */
34: public interface Database<D> extends InactiveDatabaseMBean,
35: Comparable<Database<D>> {
36: /**
37: * Connects to the database using the specified connection factory.
38: * @param connectionFactory a factory object for creating connections
39: * @return a database connection
40: * @throws SQLException if connection fails
41: */
42: public Connection connect(D connectionFactory) throws SQLException;
43:
44: /**
45: * Factory method for creating a connection factory object for this database.
46: * @return a connection factory object
47: * @throws IllegalArgumentException if connection factory could not be created
48: */
49: public D createConnectionFactory();
50:
51: public DynamicMBean getActiveMBean();
52:
53: public DynamicMBean getInactiveMBean();
54:
55: public boolean isDirty();
56:
57: public void clean();
58: }
|