1   /**
    2    *  Licensed to the Apache Software Foundation (ASF) under one or more
    3    *  contributor license agreements.  See the NOTICE file distributed with
    4    *  this work for additional information regarding copyright ownership.
    5    *  The ASF licenses this file to You under the Apache License, Version 2.0
    6    *  (the "License"); you may not use this file except in compliance with
    7    *  the License.  You may obtain a copy of the License at
    8    *
    9    *     http://www.apache.org/licenses/LICENSE-2.0
   10    *
   11    *  Unless required by applicable law or agreed to in writing, software
   12    *  distributed under the License is distributed on an "AS IS" BASIS,
   13    *  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
   14    *  See the License for the specific language governing permissions and
   15    *  limitations under the License.
   16    */
   17   package org.apache.geronimo.management.geronimo.stats;
   18   
   19   import javax.management.j2ee.statistics.BoundedRangeStatistic;
   20   import javax.management.j2ee.statistics.CountStatistic;
   21   import javax.management.j2ee.statistics.Stats;
   22   
   23   /**
   24    * Statistics expected for a Thread Pool implementation
   25    *
   26    * @version $Rev: 476049 $ $Date: 2006-11-16 20:35:17 -0800 (Thu, 16 Nov 2006) $
   27    */
   28   public interface ThreadPoolStats extends Stats {
   29       /**
   30        * Gets the min and max pool size, as well as the most, least, and current
   31        * number of threads in use.
   32        */
   33       public BoundedRangeStatistic getThreadsInUse();
   34   
   35       /**
   36        * Gets a list of the known consumers of threads from this pool.  This may
   37        * not be all consumers, because they won't necessarily identify themselves,
   38        * but it's a start when tracking down what's using threads in a pool.
   39        */
   40       public String[] getThreadConsumers();
   41   
   42       /**
   43        * For each consumer listed by getThreadConsumers(), this can be used to
   44        * find out how many threads that consumer is consuming at the time these
   45        * statistics were generated.
   46        *
   47        * @param consumer The consumer you're inquiring about
   48        */
   49       public CountStatistic getCountForConsumer(String consumer);
   50   }