1 //----------------------------------------------------------------------
2 //
3 // PerfectJPattern: "Design patterns are good but components are better!"
4 // ISessionStrategy.java Copyright (c) 2009 Giovanni Azua Garcia
5 // bravegag@hotmail.com
6 //
7 // This program is free software; you can redistribute it and/or
8 // modify it under the terms of the GNU General Public License
9 // as published by the Free Software Foundation; either version 3
10 // of the License, or (at your option) any later version.
11 //
12 // This program 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
15 // GNU General Public License for more details.
16 //
17 // You should have received a copy of the GNU General Public License
18 // along with this program; if not, see <http://www.gnu.org/licenses/>.
19 //
20 //----------------------------------------------------------------------
21 package org.perfectjpattern.jee.api.integration.dao;
22
23 import org.perfectjpattern.core.api.behavioral.strategy.*;
24
25 /**
26 * Abstract {@link IStrategy} reusable by {@link IGenericReadOnlyDao}
27 * that defines:
28 * <ul>
29 * <li>Defines retrieval of instances of JPA implementation-specific
30 * <code>Session</code> instances</li>
31 * <li>defines shutdown</li>
32 * </ul>
33 *
34 * @author <a href="mailto:bravegag@hotmail.com">Giovanni Azua</a>
35 * @version $Revision: 1.0 $Date: Feb 8, 2009 2:20:43 PM $
36 */
37 public
38 interface ISessionStrategy
39 extends IStrategy
40 {
41 //------------------------------------------------------------------------
42 // public
43 //------------------------------------------------------------------------
44 /**
45 * Returns the adapted JPA implementation-specific <code>ISession</code>
46 *
47 * @return adapted JPA implementation-specific <code>ISession</code>
48 */
49 public ISession
50 getSession();
51
52 //------------------------------------------------------------------------
53 /**
54 * Shutdown the underlying provider of <code>Session</code> instances
55 */
56 public void
57 shutdown();
58 }