From 321a2b3b349c9046eebac22e90778eab367dcae2 Mon Sep 17 00:00:00 2001
From: "Brian S. O'Neill" <bronee@gmail.com>
Date: Sun, 29 Apr 2007 19:33:18 +0000
Subject: Added @since tags.

---
 .../java/com/amazon/carbonado/raw/CustomStorableCodec.java     | 10 ++++++++++
 .../com/amazon/carbonado/raw/CustomStorableCodecFactory.java   |  2 ++
 .../java/com/amazon/carbonado/raw/GenericStorableCodec.java    |  5 +++++
 .../com/amazon/carbonado/raw/GenericStorableCodecFactory.java  |  1 +
 src/main/java/com/amazon/carbonado/raw/StorableCodec.java      |  4 ++++
 .../java/com/amazon/carbonado/raw/StorableCodecFactory.java    |  1 +
 6 files changed, 23 insertions(+)

(limited to 'src/main/java/com/amazon/carbonado/raw')

diff --git a/src/main/java/com/amazon/carbonado/raw/CustomStorableCodec.java b/src/main/java/com/amazon/carbonado/raw/CustomStorableCodec.java
index cfb0883..b13a761 100644
--- a/src/main/java/com/amazon/carbonado/raw/CustomStorableCodec.java
+++ b/src/main/java/com/amazon/carbonado/raw/CustomStorableCodec.java
@@ -255,6 +255,7 @@ public abstract class CustomStorableCodec<S extends Storable> implements Storabl
     /**
      * @param isMaster when true, version properties and sequences are managed
      * @throws SupportException if Storable is not supported
+     * @since 1.2
      */
     public CustomStorableCodec(Class<S> type, boolean isMaster, RawSupport<S> support)
         throws SupportException
@@ -271,11 +272,17 @@ public abstract class CustomStorableCodec<S extends Storable> implements Storabl
         return mType;
     }
 
+    /**
+     * @since 1.2
+     */
     @SuppressWarnings("unchecked")
     public S instantiate() {
         return (S) mInstanceFactory.instantiate(support(), this);
     }
 
+    /**
+     * @since 1.2
+     */
     @SuppressWarnings("unchecked")
     public S instantiate(byte[] key, byte[] value)
         throws FetchException
@@ -303,6 +310,9 @@ public abstract class CustomStorableCodec<S extends Storable> implements Storabl
         return encodePrimaryKey(values, 0, mPkPropertyCount);
     }
 
+    /**
+     * @since 1.2
+     */
     public RawSupport<S> getSupport() {
         return mSupport;
     }
diff --git a/src/main/java/com/amazon/carbonado/raw/CustomStorableCodecFactory.java b/src/main/java/com/amazon/carbonado/raw/CustomStorableCodecFactory.java
index a3af33f..43efe57 100644
--- a/src/main/java/com/amazon/carbonado/raw/CustomStorableCodecFactory.java
+++ b/src/main/java/com/amazon/carbonado/raw/CustomStorableCodecFactory.java
@@ -65,6 +65,7 @@ public abstract class CustomStorableCodecFactory implements StorableCodecFactory
      * generation value in each storable
      * @param support binds generated storable with a storage layer
      * @throws SupportException if type is not supported
+     * @since 1.2
      */
     public <S extends Storable> CustomStorableCodec<S> createCodec(Class<S> type,
                                                                    StorableIndex pkIndex,
@@ -99,6 +100,7 @@ public abstract class CustomStorableCodecFactory implements StorableCodecFactory
      * generation value in each storable
      * @param support binds generated storable with a storage layer
      * @throws SupportException if type is not supported
+     * @since 1.2
      */
     // Note: This factory method is not abstract for backwards compatibility.
     protected <S extends Storable> CustomStorableCodec<S>
diff --git a/src/main/java/com/amazon/carbonado/raw/GenericStorableCodec.java b/src/main/java/com/amazon/carbonado/raw/GenericStorableCodec.java
index 2532556..6a5d89d 100644
--- a/src/main/java/com/amazon/carbonado/raw/GenericStorableCodec.java
+++ b/src/main/java/com/amazon/carbonado/raw/GenericStorableCodec.java
@@ -376,6 +376,7 @@ public class GenericStorableCodec<S extends Storable> implements StorableCodec<S
      * {@link RawSupport} is supplied to the instance.
      *
      * @throws IllegalStateException if no default support exists
+     * @since 1.2
      */
     @SuppressWarnings("unchecked")
     public S instantiate() {
@@ -387,6 +388,7 @@ public class GenericStorableCodec<S extends Storable> implements StorableCodec<S
      * {@link RawSupport} is supplied to the instance.
      *
      * @throws IllegalStateException if no default support exists
+     * @since 1.2
      */
     @SuppressWarnings("unchecked")
     public S instantiate(byte[] key, byte[] value) throws FetchException {
@@ -453,6 +455,9 @@ public class GenericStorableCodec<S extends Storable> implements StorableCodec<S
         return mPrimaryKeyFactory.encodeSearchKeyPrefix();
     }
 
+    /**
+     * @since 1.2
+     */
     public RawSupport<S> getSupport() {
         return mSupport;
     }
diff --git a/src/main/java/com/amazon/carbonado/raw/GenericStorableCodecFactory.java b/src/main/java/com/amazon/carbonado/raw/GenericStorableCodecFactory.java
index 3885505..770e4e2 100644
--- a/src/main/java/com/amazon/carbonado/raw/GenericStorableCodecFactory.java
+++ b/src/main/java/com/amazon/carbonado/raw/GenericStorableCodecFactory.java
@@ -69,6 +69,7 @@ public class GenericStorableCodecFactory implements StorableCodecFactory {
      * 128..max is encoded in four bytes, with the most significant bit set.
      * @param support binds generated storable with a storage layer
      * @throws SupportException if type is not supported
+     * @since 1.2
      */
     @SuppressWarnings("unchecked")
     public <S extends Storable> GenericStorableCodec<S> createCodec(Class<S> type,
diff --git a/src/main/java/com/amazon/carbonado/raw/StorableCodec.java b/src/main/java/com/amazon/carbonado/raw/StorableCodec.java
index f9e347c..fefb0fe 100644
--- a/src/main/java/com/amazon/carbonado/raw/StorableCodec.java
+++ b/src/main/java/com/amazon/carbonado/raw/StorableCodec.java
@@ -39,6 +39,7 @@ public interface StorableCodec<S extends Storable> {
      * {@link RawSupport} is supplied to the instance.
      *
      * @throws IllegalStateException if no default support exists
+     * @since 1.2
      */
     S instantiate();
 
@@ -47,6 +48,7 @@ public interface StorableCodec<S extends Storable> {
      * {@link RawSupport} is supplied to the instance.
      *
      * @throws IllegalStateException if no default support exists
+     * @since 1.2
      */
     S instantiate(byte[] key, byte[] value) throws FetchException;
 
@@ -134,6 +136,8 @@ public interface StorableCodec<S extends Storable> {
     /**
      * Returns the default {@link RawSupport} object that is supplied to
      * Storable instances produced by this codec.
+     *
+     * @since 1.2
      */
     RawSupport<S> getSupport();
 }
diff --git a/src/main/java/com/amazon/carbonado/raw/StorableCodecFactory.java b/src/main/java/com/amazon/carbonado/raw/StorableCodecFactory.java
index db05a9e..8cc5be2 100644
--- a/src/main/java/com/amazon/carbonado/raw/StorableCodecFactory.java
+++ b/src/main/java/com/amazon/carbonado/raw/StorableCodecFactory.java
@@ -60,6 +60,7 @@ public interface StorableCodecFactory {
      * generation value in each storable
      * @param support binds generated storable with a storage layer
      * @throws SupportException if type is not supported
+     * @since 1.2
      */
     <S extends Storable> StorableCodec<S> createCodec(Class<S> type,
                                                       StorableIndex pkIndex,
-- 
cgit v1.2.3