(no commit message)
[utils] / test / enterprise / src / main / java / org / wamblee / test / transactions / TransactionResource.java
1 /*
2  * Copyright 2005-2010 the original author or authors.
3  * 
4  * Licensed under the Apache License, Version 2.0 (the "License");
5  * you may not use this file except in compliance with the License.
6  * You may obtain a copy of the License at
7  * 
8  *      http://www.apache.org/licenses/LICENSE-2.0
9  * 
10  * Unless required by applicable law or agreed to in writing, software
11  * distributed under the License is distributed on an "AS IS" BASIS,
12  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13  * See the License for the specific language governing permissions and
14  * limitations under the License.
15  */
16 package org.wamblee.test.transactions;
17
18
19 /**
20  * Interfaces to be implemented by resources that want to participate in transactions
21  * managed through {@link SimpleTransactionManager}.
22  * 
23  * @author Erik Brakkee
24  *
25  * @param <T>
26  */
27 public interface TransactionResource<T> {
28     
29     /**
30      * Begins a transaction. 
31      * @return Object that manages the transaction for the resource.
32      */
33     T begin(); 
34     
35     /**
36      * Rolls back a transaction.
37      * @param aT Object that manages the transaction for the resource. 
38      */
39     TransactionResult rollback(T aT); 
40     
41     /**
42      * Commits the transaction. 
43      * @param aT Object that manages the transaction for the resource. 
44      */
45     TransactionResult commit(T aT);
46     
47 }