diff --git a/ArjunaCore/arjuna/classes/com/arjuna/ats/arjuna/objectstore/jdbc/JDBCAccess.java b/ArjunaCore/arjuna/classes/com/arjuna/ats/arjuna/objectstore/jdbc/JDBCAccess.java index 79d01152f3..f77bb64f2a 100644 --- a/ArjunaCore/arjuna/classes/com/arjuna/ats/arjuna/objectstore/jdbc/JDBCAccess.java +++ b/ArjunaCore/arjuna/classes/com/arjuna/ats/arjuna/objectstore/jdbc/JDBCAccess.java @@ -37,6 +37,8 @@ import javax.naming.NamingException; +import com.arjuna.ats.arjuna.exceptions.FatalError; + /** * Do not return a connection which participates within the * transaction 2-phase commit protocol! All connections will have @@ -53,6 +55,7 @@ public interface JDBCAccess * connections is used, this method may be called up to maxpoolsize * times. It must not return the same connection each time. * @throws NamingException + * @throws {@link FatalError} In case the configured store cannot be connected to */ public Connection getConnection () throws SQLException; @@ -60,6 +63,7 @@ public interface JDBCAccess /** * This method can be used to pass additional information to the * implementation. + * @throws {@link FatalError} In case the configured store cannot be connected to */ public void initialise (StringTokenizer stringTokenizer); diff --git a/ArjunaCore/arjuna/classes/com/arjuna/ats/internal/arjuna/objectstore/jdbc/JDBCImple_driver.java b/ArjunaCore/arjuna/classes/com/arjuna/ats/internal/arjuna/objectstore/jdbc/JDBCImple_driver.java index 86cf4ade99..27c7926266 100644 --- a/ArjunaCore/arjuna/classes/com/arjuna/ats/internal/arjuna/objectstore/jdbc/JDBCImple_driver.java +++ b/ArjunaCore/arjuna/classes/com/arjuna/ats/internal/arjuna/objectstore/jdbc/JDBCImple_driver.java @@ -42,6 +42,7 @@ import com.arjuna.ats.arjuna.common.ObjectStoreEnvironmentBean; import com.arjuna.ats.arjuna.common.Uid; +import com.arjuna.ats.arjuna.exceptions.FatalError; import com.arjuna.ats.arjuna.exceptions.ObjectStoreException; import com.arjuna.ats.arjuna.logging.tsLogger; import com.arjuna.ats.arjuna.objectstore.StateStatus; @@ -624,6 +625,7 @@ public boolean write_state(Uid objUid, String typeName, * Set up the store for use. * * @throws NamingException + * @throws {@link FatalError} In case the configured store cannot be connected to */ public void initialise(final JDBCAccess jdbcAccess, String tableName, ObjectStoreEnvironmentBean jdbcStoreEnvironmentBean) diff --git a/ArjunaCore/arjuna/classes/com/arjuna/ats/internal/arjuna/objectstore/jdbc/JDBCStore.java b/ArjunaCore/arjuna/classes/com/arjuna/ats/internal/arjuna/objectstore/jdbc/JDBCStore.java index 4bb1f0960a..7c27e26cf3 100644 --- a/ArjunaCore/arjuna/classes/com/arjuna/ats/internal/arjuna/objectstore/jdbc/JDBCStore.java +++ b/ArjunaCore/arjuna/classes/com/arjuna/ats/internal/arjuna/objectstore/jdbc/JDBCStore.java @@ -38,6 +38,7 @@ import com.arjuna.ats.arjuna.common.ObjectStoreEnvironmentBean; import com.arjuna.ats.arjuna.common.Uid; +import com.arjuna.ats.arjuna.exceptions.FatalError; import com.arjuna.ats.arjuna.exceptions.ObjectStoreException; import com.arjuna.ats.arjuna.logging.tsLogger; import com.arjuna.ats.arjuna.objectstore.ObjectStoreAPI; @@ -192,6 +193,13 @@ public synchronized void unpackFrom(InputBuffer buff) throws IOException { this.tableName = buff.unpackString(); } + /** + * Create a new JDBCStore + * + * @param jdbcStoreEnvironmentBean The environment bean containing the configuration + * @throws ObjectStoreException In case the store environment bean was not correctly configured + * @throws {@link FatalError} In case the configured store cannot be connected to + */ public JDBCStore(ObjectStoreEnvironmentBean jdbcStoreEnvironmentBean) throws ObjectStoreException { this.jdbcStoreEnvironmentBean = jdbcStoreEnvironmentBean;