You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@commons.apache.org by oz...@apache.org on 2005/01/09 16:12:12 UTC
cvs commit: jakarta-commons/transaction/src/java/org/apache/commons/transaction/file JDK14URLEncodeIdMapper.java ResourceIdToPathMapper.java URLEncodeIdMapper.java
ozeigermann 2005/01/09 07:12:12
Modified: transaction/src/java/org/apache/commons/transaction/locking
ReadWriteUpgradeLock.java ReadWriteLockManager.java
MultiLevelLock2.java
ReadWriteUpgradeLockManager.java
GenericLockManager.java LockManager2.java
LockException.java GenericLock.java
transaction/src/java/org/apache/commons/transaction/file
JDK14URLEncodeIdMapper.java
ResourceIdToPathMapper.java URLEncodeIdMapper.java
Log:
Added since tags to new classes/methods
Revision Changes Path
1.3 +5 -4 jakarta-commons/transaction/src/java/org/apache/commons/transaction/locking/ReadWriteUpgradeLock.java
Index: ReadWriteUpgradeLock.java
===================================================================
RCS file: /home/cvs/jakarta-commons/transaction/src/java/org/apache/commons/transaction/locking/ReadWriteUpgradeLock.java,v
retrieving revision 1.2
retrieving revision 1.3
diff -u -r1.2 -r1.3
--- ReadWriteUpgradeLock.java 8 Jan 2005 18:57:38 -0000 1.2
+++ ReadWriteUpgradeLock.java 9 Jan 2005 15:12:11 -0000 1.3
@@ -61,6 +61,7 @@
* @see GenericLock
* @see org.apache.commons.transaction.locking.ReadWriteLock
* @see ReadWriteUpgradeLockManager
+ * @since 1.1
*/
public class ReadWriteUpgradeLock extends GenericLock {
1.4 +5 -4 jakarta-commons/transaction/src/java/org/apache/commons/transaction/locking/ReadWriteLockManager.java
Index: ReadWriteLockManager.java
===================================================================
RCS file: /home/cvs/jakarta-commons/transaction/src/java/org/apache/commons/transaction/locking/ReadWriteLockManager.java,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -r1.3 -r1.4
--- ReadWriteLockManager.java 7 Jan 2005 23:33:24 -0000 1.3
+++ ReadWriteLockManager.java 9 Jan 2005 15:12:11 -0000 1.4
@@ -29,6 +29,7 @@
* Manager for {@link org.apache.commons.transaction.locking.ReadWriteLock}s on resources.
*
* @version $Revision$
+ * @since 1.1
*/
public class ReadWriteLockManager extends GenericLockManager {
1.2 +3 -2 jakarta-commons/transaction/src/java/org/apache/commons/transaction/locking/MultiLevelLock2.java
Index: MultiLevelLock2.java
===================================================================
RCS file: /home/cvs/jakarta-commons/transaction/src/java/org/apache/commons/transaction/locking/MultiLevelLock2.java,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- MultiLevelLock2.java 8 Jan 2005 19:22:47 -0000 1.1
+++ MultiLevelLock2.java 9 Jan 2005 15:12:11 -0000 1.2
@@ -32,6 +32,7 @@
* @see LockManager2
* @see MultiLevelLock
* @see GenericLock
+ * @since 1.1
*/
public interface MultiLevelLock2 {
1.2 +3 -2 jakarta-commons/transaction/src/java/org/apache/commons/transaction/locking/ReadWriteUpgradeLockManager.java
Index: ReadWriteUpgradeLockManager.java
===================================================================
RCS file: /home/cvs/jakarta-commons/transaction/src/java/org/apache/commons/transaction/locking/ReadWriteUpgradeLockManager.java,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- ReadWriteUpgradeLockManager.java 17 Dec 2004 00:30:54 -0000 1.1
+++ ReadWriteUpgradeLockManager.java 9 Jan 2005 15:12:11 -0000 1.2
@@ -46,6 +46,7 @@
* @version $Revision$
*
* @see ReadWriteUpgradeLock
+ * @since 1.1
*/
public class ReadWriteUpgradeLockManager extends ReadWriteLockManager {
1.17 +15 -4 jakarta-commons/transaction/src/java/org/apache/commons/transaction/locking/GenericLockManager.java
Index: GenericLockManager.java
===================================================================
RCS file: /home/cvs/jakarta-commons/transaction/src/java/org/apache/commons/transaction/locking/GenericLockManager.java,v
retrieving revision 1.16
retrieving revision 1.17
diff -u -r1.16 -r1.17
--- GenericLockManager.java 8 Jan 2005 19:02:34 -0000 1.16
+++ GenericLockManager.java 9 Jan 2005 15:12:11 -0000 1.17
@@ -81,6 +81,8 @@
* it off and check for directly
* @throws IllegalArgumentException
* if maxLockLevel is less than 1
+ *
+ * @since 1.1
*/
public GenericLockManager(int maxLockLevel, LoggerFacade logger, long timeoutMSecs,
long checkThreshholdMSecs) throws IllegalArgumentException {
@@ -105,6 +107,7 @@
/**
* @see LockManager2#startGlobalTimeout(Object, long)
+ * @since 1.1
*/
public void startGlobalTimeout(Object ownerId, long timeoutMSecs) {
long now = System.currentTimeMillis();
@@ -114,6 +117,7 @@
/**
* @see LockManager2#tryLock(Object, Object, int, boolean)
+ * @since 1.1
*/
public boolean tryLock(Object ownerId, Object resourceId, int targetLockLevel, boolean reentrant) {
timeoutCheck(ownerId);
@@ -131,6 +135,7 @@
/**
* @see LockManager2#lock(Object, Object, int, boolean)
+ * @since 1.1
*/
public void lock(Object ownerId, Object resourceId, int targetLockLevel, boolean reentrant)
throws LockException {
@@ -139,6 +144,7 @@
/**
* @see LockManager2#lock(Object, Object, int, boolean, long)
+ * @since 1.1
*/
public void lock(Object ownerId, Object resourceId, int targetLockLevel, boolean reentrant,
long timeoutMSecs) throws LockException {
@@ -148,6 +154,7 @@
/**
* @see LockManager2#lock(Object, Object, int, int, boolean, long)
+ * @since 1.1
*/
public void lock(Object ownerId, Object resourceId, int targetLockLevel, int compatibility,
boolean preferred, long timeoutMSecs) throws LockException {
@@ -228,6 +235,7 @@
/**
* @see LockManager2#getLevel(Object, Object)
+ * @since 1.1
*/
public int getLevel(Object ownerId, Object resourceId) {
timeoutCheck(ownerId);
@@ -241,6 +249,7 @@
/**
* @see LockManager2#release(Object, Object)
+ * @since 1.1
*/
public void release(Object ownerId, Object resourceId) {
timeoutCheck(ownerId);
@@ -251,6 +260,7 @@
/**
* @see LockManager2#releaseAll(Object)
+ * @since 1.1
*/
public void releaseAll(Object ownerId) {
releaseAllNoTimeOutReset(ownerId);
@@ -274,6 +284,7 @@
/**
* @see LockManager2#getAll(Object)
+ * @since 1.1
*/
public Set getAll(Object ownerId) {
Set locks = (Set) globalOwners.get(ownerId);
1.4 +5 -4 jakarta-commons/transaction/src/java/org/apache/commons/transaction/locking/LockManager2.java
Index: LockManager2.java
===================================================================
RCS file: /home/cvs/jakarta-commons/transaction/src/java/org/apache/commons/transaction/locking/LockManager2.java,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -r1.3 -r1.4
--- LockManager2.java 8 Jan 2005 18:52:23 -0000 1.3
+++ LockManager2.java 9 Jan 2005 15:12:11 -0000 1.4
@@ -33,6 +33,7 @@
* @see MultiLevelLock
* @see LockManager
* @see GenericLockManager
+ * @since 1.1
*/
public interface LockManager2 {
1.2 +5 -4 jakarta-commons/transaction/src/java/org/apache/commons/transaction/locking/LockException.java
Index: LockException.java
===================================================================
RCS file: /home/cvs/jakarta-commons/transaction/src/java/org/apache/commons/transaction/locking/LockException.java,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- LockException.java 14 Dec 2004 12:12:46 -0000 1.1
+++ LockException.java 9 Jan 2005 15:12:11 -0000 1.2
@@ -27,6 +27,7 @@
* Exception displaying a lock problem.
*
* @version $Revision$
+ * @since 1.1
*/
public class LockException extends RuntimeException {
1.12 +7 -5 jakarta-commons/transaction/src/java/org/apache/commons/transaction/locking/GenericLock.java
Index: GenericLock.java
===================================================================
RCS file: /home/cvs/jakarta-commons/transaction/src/java/org/apache/commons/transaction/locking/GenericLock.java,v
retrieving revision 1.11
retrieving revision 1.12
diff -u -r1.11 -r1.12
--- GenericLock.java 8 Jan 2005 19:22:47 -0000 1.11
+++ GenericLock.java 9 Jan 2005 15:12:11 -0000 1.12
@@ -180,7 +180,7 @@
}
/**
- * @see #acquire(Object, int, boolean, int, boolean, long)
+ * @see #acquire(Object, int, boolean, int, boolean, long)
*/
public synchronized boolean acquire(Object ownerId, int targetLockLevel, boolean wait,
int compatibility, long timeoutMSecs) throws InterruptedException {
@@ -191,6 +191,7 @@
* Tries to blockingly acquire a lock which can be preferred.
*
* @see #acquire(Object, int, boolean, int, boolean, long)
+ * @since 1.1
*/
public synchronized boolean acquire(Object ownerId, int targetLockLevel, boolean preferred,
long timeoutMSecs) throws InterruptedException {
@@ -201,6 +202,7 @@
/**
* @see org.apache.commons.transaction.locking.MultiLevelLock2#acquire(Object,
* int, boolean, int, boolean, long)
+ * @since 1.1
*/
public synchronized boolean acquire(
Object ownerId,
1.2 +6 -4 jakarta-commons/transaction/src/java/org/apache/commons/transaction/file/JDK14URLEncodeIdMapper.java
Index: JDK14URLEncodeIdMapper.java
===================================================================
RCS file: /home/cvs/jakarta-commons/transaction/src/java/org/apache/commons/transaction/file/JDK14URLEncodeIdMapper.java,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- JDK14URLEncodeIdMapper.java 18 Dec 2004 23:19:09 -0000 1.1
+++ JDK14URLEncodeIdMapper.java 9 Jan 2005 15:12:12 -0000 1.2
@@ -27,7 +27,9 @@
import java.net.URLEncoder;
/**
- *
+ * URL encodes a resource id using JDK1.4 functionality.
+ *
+ * @since 1.1
*/
public class JDK14URLEncodeIdMapper implements ResourceIdToPathMapper {
public String getPathForId(Object resourceId) {
1.2 +6 -3 jakarta-commons/transaction/src/java/org/apache/commons/transaction/file/ResourceIdToPathMapper.java
Index: ResourceIdToPathMapper.java
===================================================================
RCS file: /home/cvs/jakarta-commons/transaction/src/java/org/apache/commons/transaction/file/ResourceIdToPathMapper.java,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- ResourceIdToPathMapper.java 18 Dec 2004 23:19:09 -0000 1.1
+++ ResourceIdToPathMapper.java 9 Jan 2005 15:12:12 -0000 1.2
@@ -25,9 +25,12 @@
/**
* Mapper from a resourceId to a path string.
+ *
+ * @since 1.1
*
*/
public interface ResourceIdToPathMapper {
+
/**
* Maps the resource id object to a path string.
*
1.2 +6 -4 jakarta-commons/transaction/src/java/org/apache/commons/transaction/file/URLEncodeIdMapper.java
Index: URLEncodeIdMapper.java
===================================================================
RCS file: /home/cvs/jakarta-commons/transaction/src/java/org/apache/commons/transaction/file/URLEncodeIdMapper.java,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- URLEncodeIdMapper.java 18 Dec 2004 23:19:09 -0000 1.1
+++ URLEncodeIdMapper.java 9 Jan 2005 15:12:12 -0000 1.2
@@ -29,7 +29,9 @@
import org.apache.commons.codec.binary.Base64;
/**
- *
+ * URL encodes a resource.
+ *
+ * @since 1.1
*/
public class URLEncodeIdMapper implements ResourceIdToPathMapper {
public String getPathForId(Object resourceId) {
---------------------------------------------------------------------
To unsubscribe, e-mail: commons-dev-unsubscribe@jakarta.apache.org
For additional commands, e-mail: commons-dev-help@jakarta.apache.org