01: /*
02: * HA-JDBC: High-Availability JDBC
03: * Copyright (c) 2004-2007 Paul Ferraro
04: *
05: * This library is free software; you can redistribute it and/or modify it
06: * under the terms of the GNU Lesser General Public License as published by the
07: * Free Software Foundation; either version 2.1 of the License, or (at your
08: * option) any later version.
09: *
10: * This library is distributed in the hope that it will be useful, but WITHOUT
11: * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
12: * FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License
13: * for more details.
14: *
15: * You should have received a copy of the GNU Lesser General Public License
16: * along with this library; if not, write to the Free Software Foundation,
17: * Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
18: *
19: * Contact: ferraro@users.sourceforge.net
20: */
21: package net.sf.hajdbc;
22:
23: import java.util.concurrent.locks.Lock;
24:
25: import net.sf.hajdbc.util.Strings;
26:
27: /**
28: * Manages a set of named read/write locks. A global lock is represented by an empty name (i.e "").
29: * Obtaining a named read or write lock should implicitly obtain a global read lock.
30: * Consequently, all named locks are blocked if a global write lock is obtained.
31: * @author Paul Ferraro
32: */
33: public interface LockManager {
34: public static final String GLOBAL = Strings.EMPTY;
35:
36: /**
37: * Obtains a named read lock.
38: * @param object an object to lock
39: * @return a read lock
40: */
41: public Lock readLock(String object);
42:
43: /**
44: * Obtains a named write lock.
45: * @param object an object to lock
46: * @return a write lock
47: */
48: public Lock writeLock(String object);
49:
50: public void start() throws Exception;
51:
52: public void stop();
53: }
|