com.antelmann.db
Interface TransactionRequired

All Known Subinterfaces:

CategoryManager, DBClassStore<T>, ImageEntryManager<T>, ObjectRowMapper<T>, PropertyEntryMapping, RelationshipManager, RoleManager<R>, SQLColumnInfo, TaggableMapping

All Known Implementing Classes:

AbstractDBClassStore, AddressableMapper, ArchiveDBClassStore, BaseDocumentMapper, BaseRowMapper, BeanMapper, CategoryStore, CollectionClassStore, Country.Store, DBClassStoreCache, DBDocumentStore, DBDocumentStore.Mapper, DetailRowStore, EnumDBStore, FileClassStore, FriendsEntryStore, GenericPropertyEntryMapper, GenericPropertyEntryStore, GPersonRelationStore, GPersonStore, ImageURLEntryMapper, ImageURLEntrySQLStore, JDBCRowStore, MappedEntryMapper, MessageEntryMapper, MySqlQueryToViewMapper, PropertyEntryHeaderStore, PropertyEntryTableStore, PropertyMapper, ReadOnlyCacheStore, ReadOnlyStore, RelationshipStore, RelationshipStore.Mapper, SerializedEntrySQLMapper, SortedGroupableSQLStore, SQLColumnInfoStore, TaggableHeaderStore, TaggableMappingImpl, TaggablePropertyEntrySQLStore, TaggableSQLStore, ThumbnailMapper, UnionSqlStore, UserImplMapper, UserImplStore, WrappedDBClassStore, WrappedDBClassStoreMapping, WrappedObjectRowMapper

public interface TransactionRequired

This annotation suggests that implementations of these methods (or all methods of that type) should always be called only in a proper transactional context. Since the wrapping of methods would always throw DatabaseException (if not a RuntimeException), it is generally recommended to allow interface methods to throw the same. If an inheriting interface is queried by an AbstractDatabase, it is wrapped so that each method call is automatically run in a transactional context.

Since:

20.01.2009, 19:28:16

Author:

Holger Antelmann

See Also:

Database.queryStoreForInterface(Class, Class), AbstractDatabase.queryStoreForInterface(Class, Class), DBTransaction, DBUtils.runInTransaction(com.antelmann.util.Task, DBTransaction, boolean), DBUtils.runInTransaction(java.util.concurrent.Callable, DBTransaction, boolean)