KickJava   Java API By Example, From Geeks To Geeks.

Java > Open Source Codes > org > jboss > ejb3 > Pool


1 /*
2   * JBoss, Home of Professional Open Source
3   * Copyright 2005, JBoss Inc., and individual contributors as indicated
4   * by the @authors tag. See the copyright.txt in the distribution for a
5   * full listing of individual contributors.
6   *
7   * This is free software; you can redistribute it and/or modify it
8   * under the terms of the GNU Lesser General Public License as
9   * published by the Free Software Foundation; either version 2.1 of
10   * the License, or (at your option) any later version.
11   *
12   * This software is distributed in the hope that it will be useful,
13   * but WITHOUT ANY WARRANTY; without even the implied warranty of
14   * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
15   * Lesser General Public License for more details.
16   *
17   * You should have received a copy of the GNU Lesser General Public
18   * License along with this software; if not, write to the Free
19   * Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
20   * 02110-1301 USA, or see the FSF site: http://www.fsf.org.
21   */
22 package org.jboss.ejb3;
23
24 import org.jboss.injection.Injector;
25
26 /**
27  * Minimally a pool acts as a factory for a bean. It will handle callbacks
28  * to ejbCreate and ejbRemove as well.
29  *
30  * @author <a HREF="mailto:bill@jboss.org">Bill Burke</a>
31  * @version $Revision: 55144 $
32  */
33 public interface Pool
34 {
35    /**
36     * Creates if no object is available in pool. ejbCreate will be called if created
37     */
38    BeanContext get();
39
40    BeanContext get(Class JavaDoc[] initTypes, Object JavaDoc[] initValues);
41
42    /**
43     * Put bean back in pool
44     */
45    void release(BeanContext obj);
46
47    /**
48     * Destroy bean. ejbRemove callback is executed
49     */
50    void remove(BeanContext obj);
51
52    /**
53     * Discard the bean. Called in different context as remove. If there is a system exception this is
54     * called.
55     *
56     * @param obj
57     */
58    void discard(BeanContext obj);
59
60    public void setInjectors(Injector[] injectors);
61
62    void initialize(Container container, Class JavaDoc contextClass, Class JavaDoc beanClass, int maxSize, long timeout);
63
64    void setMaxSize(int maxSize);
65 }
66
Popular Tags