1 /** 2 * EasyBeans 3 * Copyright (C) 2006 Bull S.A.S. 4 * Contact: easybeans@objectweb.org 5 * 6 * This library is free software; you can redistribute it and/or 7 * modify it under the terms of the GNU Lesser General Public 8 * License as published by the Free Software Foundation; either 9 * version 2.1 of the License, or any later version. 10 * 11 * This library 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 GNU 14 * Lesser General Public License for more details. 15 * 16 * You should have received a copy of the GNU Lesser General Public 17 * License along with this library; if not, write to the Free Software 18 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 19 * USA 20 * 21 * -------------------------------------------------------------------------- 22 * $Id: PoolAttributes.java 940 2006-07-26 09:05:27Z benoitf $ 23 * -------------------------------------------------------------------------- 24 */ 25 26 package org.objectweb.easybeans.api.pool; 27 28 /** 29 * Defines the interface used to collect/set information on this pool. 30 * @author Florent Benoit 31 */ 32 public interface PoolAttributes { 33 // 34 // /** 35 // * <b>getMaxAge</b> gets the max age for a pool entry. 36 // * @return int max number of minutes to keep a connection in the pool. 37 // */ 38 // int getMaxAge(); 39 // 40 // /** 41 // * <b>getMaxOpentime</b> gets the max age for a pool entry. 42 // * @return int max number of minutes to keep a connection in the pool. 43 // */ 44 // int getMaxOpentime(); 45 // 46 // /** 47 // * <b>getMaxSize</b> retrieves the maximum size assigned to this Pool. 48 // * @return The maximum size currently assigned to this Pool. 49 // */ 50 // int getMaxSize(); 51 // 52 // /** 53 // * <b>getMaxWaiters</b> gets the maximum number of waiters for a connection 54 // * in this Pool. 55 // * @return int maximum number of waiters 56 // */ 57 // int getMaxWaiters(); 58 // 59 // /** 60 // * <b>getMaxWaitTime</b> gets the maximum number of seconds to wait for a 61 // * connection in this Pool. 62 // * @return int maximum number of seconds to wait 63 // */ 64 // int getMaxWaitTime(); 65 // 66 // /** 67 // * <b>getMinSize</b> retrieves the minimum size assigned to this Pool. 68 // * @return The minimum size currently assigned to this Pool. 69 // */ 70 // int getMinSize(); 71 // 72 // /** 73 // * <b>getSamplingPeriod</b> gets the number of seconds between statistics 74 // * sampling for this Pool. 75 // * @return int number of seconds between samplings 76 // */ 77 // int getSamplingPeriod(); 78 // 79 // /** 80 // * <b>getTimeout</b> retrieves the timeout assigned to this Pool. 81 // * @return The timeout currently assigned to this Pool. 82 // */ 83 // long getTimeout(); 84 // 85 // /** 86 // * <b>getSize</b> retrieves the current size of this Pool. 87 // * @return The current size of this Pool. 88 // */ 89 // int getSize(); 90 // 91 // /** 92 // * @return init The pool init size. 93 // */ 94 // int getInitSize(); 95 // 96 // /** 97 // * <b>setInitSize</b> creates initsize resoures to this Pool. 98 // * @param initsize The init size to be created. 99 // * @throws Exception if an error occurs 100 // */ 101 // void setInitSize(int initsize) throws Exception; 102 // 103 // /** 104 // * <b>setMaxAge</b> sets the max age for a pool entry. 105 // * @param maxAge int max number of minutes to keep a connection in the pool. 106 // */ 107 // void setMaxAge(int maxAge); 108 // 109 // /** 110 // * <b>setMaxOpentime</b> sets the max age for an entry to be opened. 111 // * @param maxOpentime int max number of minutes to keep a connection opened. 112 // */ 113 // void setMaxOpentime(int maxOpentime); 114 // 115 // /** 116 // * <b>setMaxSize</b> assigns a maximum size to this Pool. 117 // * @param maxsize int maximum size to be assigned. 118 // * @throws Exception if an error occurs 119 // */ 120 // void setMaxSize(int maxsize) throws Exception; 121 // 122 // /** 123 // * <b>setMaxWaiters</b> sets the maximum number of waiters for a connection 124 // * in this Pool. 125 // * @param maxWaiters int maximum number of waiters 126 // */ 127 // void setMaxWaiters(int maxWaiters); 128 // 129 // /** 130 // * <b>setMaxWaitTime</b> sets the maximum number of seconds to wait for a 131 // * connection in this Pool. 132 // * @param maxWaitTime int maximum number of seconds to wait 133 // */ 134 // void setMaxWaitTime(int maxWaitTime); 135 // 136 // /** 137 // * <b>setMinSize</b> assigns a minimum size to this Pool. 138 // * @param minsize int minimum size to be assigned. 139 // * @throws Exception if an error occurs 140 // */ 141 // void setMinSize(int minsize) throws Exception; 142 // 143 // /** 144 // * <b>setSamplingPeriod</b> sets the number of seconds between statistics 145 // * sampling for this Pool. 146 // * @param samplingPeriod int number of seconds between samplings 147 // */ 148 // void setSamplingPeriod(int samplingPeriod); 149 // 150 // /** 151 // * <b>setTimeout</b> assigns a timeout to this Pool. 152 // * @param crto long timeout to be assigned. 153 // */ 154 // void setTimeout(long crto); 155 // 156 // 157 // /** 158 // * @return int number of busy connections 159 // */ 160 // int getCurrentBusy(); 161 // 162 // /** 163 // * @return int number of opened connections 164 // */ 165 // int getCurrentOpened(); 166 // 167 // /** 168 // * @return maximum nb of busy connections in last sampling period 169 // */ 170 // int getBusyMaxRecent(); 171 // 172 // /** 173 // * @return minimum nb of busy connections in last sampling period 174 // */ 175 // int getBusyMinRecent(); 176 // 177 // /** 178 // * @return current number of connection waiters 179 // */ 180 // int getCurrentWaiters(); 181 // 182 // /** 183 // * @return int number of physical jdbc connection opened 184 // */ 185 // int getOpenedCount(); 186 // 187 // /** 188 // * @return int number of connection failures on open 189 // */ 190 // int getConnectionFailures(); 191 // 192 // /** 193 // * @return int number of connection leaks 194 // */ 195 // int getConnectionLeaks(); 196 // 197 // /** 198 // * @return int number of connection served 199 // */ 200 // int getServedOpen(); 201 // 202 // /** 203 // * @return int number of open calls that were rejected due to waiter 204 // * overflow 205 // */ 206 // int getRejectedFull(); 207 // 208 // /** 209 // * @return int number of open calls that were rejected by timeout 210 // */ 211 // int getRejectedTimeout(); 212 // 213 // /** 214 // * @return int number of open calls that were rejected 215 // */ 216 // int getRejectedOther(); 217 // 218 // /** 219 // * @return int number of open calls that were rejected 220 // */ 221 // int getRejectedOpen(); 222 // 223 // /** 224 // * @return maximum nb of waiters since the datasource creation 225 // */ 226 // int getWaitersHigh(); 227 // 228 // /** 229 // * @return maximum nb of waiters in last sampling period 230 // */ 231 // int getWaitersHighRecent(); 232 // 233 // /** 234 // * @return total nb of waiters since the datasource creation 235 // */ 236 // int getWaiterCount(); 237 // 238 // /** 239 // * @return total waiting time since the datasource creation 240 // */ 241 // long getWaitingTime(); 242 // 243 // /** 244 // * @return max waiting time since the datasource creation 245 // */ 246 // long getWaitingHigh(); 247 // 248 // /** 249 // * @return max waiting time in last sampling period 250 // */ 251 // long getWaitingHighRecent(); 252 // 253 } 254