01: /*
02: (c) Copyright 2003, 2004, 2005, 2006, 2007, 2008 Hewlett-Packard Development Company, LP
03: [See end of file]
04: $Id: TransactionHandler.java,v 1.7 2008/01/02 12:06:55 andy_seaborne Exp $
05: */
06:
07: package com.hp.hpl.jena.graph;
08:
09: import com.hp.hpl.jena.shared.*;
10:
11: /**
12: Preliminary interface for graphs supporting transactions.
13:
14: @author kers
15: */
16: public interface TransactionHandler {
17: /**
18: Does this handler support transactions at all?
19:
20: @return true iff begin/abort/commit are implemented and make sense.
21: */
22: boolean transactionsSupported();
23:
24: /**
25: If transactions are supported, begin a new transaction. If tranactions are
26: not supported, or they are but this tranaction is nested and nested transactions
27: are not supported, throw an UnsupportedOperationException.
28: */
29: void begin();
30:
31: /**
32: If transactions are supported and there is a tranaction in progress, abort
33: it. If transactions are not supported, or there is no transaction in progress,
34: throw an UnsupportedOperationException.
35: */
36: void abort();
37:
38: /**
39: If transactions are supported and there is a tranaction in progress, commit
40: it. If transactions are not supported, , or there is no transaction in progress,
41: throw an UnsupportedOperationException.
42: */
43: void commit();
44:
45: /**
46: If transactions are supported, execute the command c within a transaction
47: and return its result. If not, throw an UnsupportedOperationException.
48: */
49: Object executeInTransaction(Command c);
50: }
51:
52: /*
53: (c) Copyright 2002, 2003, 2004, 2005, 2006, 2007, 2008 Hewlett-Packard Development Company, LP
54: All rights reserved.
55:
56: Redistribution and use in source and binary forms, with or without
57: modification, are permitted provided that the following conditions
58: are met:
59:
60: 1. Redistributions of source code must retain the above copyright
61: notice, this list of conditions and the following disclaimer.
62:
63: 2. Redistributions in binary form must reproduce the above copyright
64: notice, this list of conditions and the following disclaimer in the
65: documentation and/or other materials provided with the distribution.
66:
67: 3. The name of the author may not be used to endorse or promote products
68: derived from this software without specific prior written permission.
69:
70: THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
71: IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
72: OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
73: IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
74: INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
75: NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
76: DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
77: THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
78: (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
79: THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
80: */
|