001: /*
002: * Copyright (c) 1998-2008 Caucho Technology -- all rights reserved
003: *
004: * This file is part of Resin(R) Open Source
005: *
006: * Each copy or derived work must preserve the copyright notice and this
007: * notice unmodified.
008: *
009: * Resin Open Source is free software; you can redistribute it and/or modify
010: * it under the terms of the GNU General Public License as published by
011: * the Free Software Foundation; either version 2 of the License, or
012: * (at your option) any later version.
013: *
014: * Resin Open Source is distributed in the hope that it will be useful,
015: * but WITHOUT ANY WARRANTY; without even the implied warranty of
016: * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE, or any warranty
017: * of NON-INFRINGEMENT. See the GNU General Public License for more
018: * details.
019: *
020: * You should have received a copy of the GNU General Public License
021: * along with Resin Open Source; if not, write to the
022: *
023: * Free Software Foundation, Inc.
024: * 59 Temple Place, Suite 330
025: * Boston, MA 02111-1307 USA
026: *
027: * @author Scott Ferguson
028: */
029:
030: package com.caucho.management.server;
031:
032: import com.caucho.jmx.Description;
033: import com.caucho.jmx.Units;
034:
035: import java.util.Date;
036:
037: /**
038: * MBean API for a JDBC driver.
039: *
040: * <pre>
041: * resin:type=JdbcDriver,name=jdbc/resin,...
042: * </pre>
043: */
044: @Description("A JDBC database driver")
045: public interface JdbcDriverMXBean extends ManagedObjectMXBean {
046: //
047: // Configuration
048: //
049:
050: /**
051: * Returns the driver class
052: */
053: @Description("The driver class")
054: public String getClassName();
055:
056: /**
057: * Returns the URL
058: */
059: @Description("The driver URL")
060: public String getUrl();
061:
062: //
063: // state
064: //
065: @Description("Returns the current state")
066: public String getState();
067:
068: //
069: // Statistics
070: //
071:
072: /**
073: * Returns the total number of connections.
074: */
075: @Description("The total number of connections")
076: public long getConnectionCountTotal();
077:
078: /**
079: * Returns the total number of failed connections.
080: */
081: @Description("The total number of failed connections")
082: public long getConnectionFailCountTotal();
083:
084: /**
085: * Returns the last connection fail time.
086: */
087: @Description("The last connection fail time")
088: public Date getLastFailTime();
089:
090: //
091: // Operations
092: //
093:
094: /**
095: * Enables the driver.
096: */
097: @Description("enable the driver")
098: public boolean start();
099:
100: /**
101: * Disables the driver.
102: */
103: @Description("disble the driver")
104: public boolean stop();
105: }
|