Api Issue 686 - Mark some parts of library as Beta

https://codereview.appspot.com/8084043/

Author: peleyal

findbugs-exclude.xml

@@ -70,16 +70,8 @@
  <!-- May expose internal representation by incorporating reference to mutable object -->
  </And>
  <And>
- <Bug pattern="EXPERIMENTAL_CLASS_USAGE,EXPERIMENTAL_METHOD_USAGE"/>
- <!-- Usage of an &#64;Experimental class or method -->
- <Class name="com.google.api.client.http.HttpRequest"/>
- </And>
- <And>
- <Bug pattern="EXPERIMENTAL_CLASS_USAGE,EXPERIMENTAL_METHOD_USAGE"/>
- <Class name="com.google.api.client.http.HttpResponse"/>
- </And>
- <And>
- <Bug pattern="EXPERIMENTAL_CLASS_USAGE,EXPERIMENTAL_METHOD_USAGE"/>
+ <Bug pattern="BETA_CLASS_USAGE,BETA_METHOD_USAGE"/>
+ <!-- Usage of a &#64;Beta class or method -->
  <Class name="com.google.api.client.json.JsonParser"/>
  </And>
 </FindBugsFilter>

google-http-client-android/src/main/java/com/google/api/client/extensions/android/AndroidUtils.java

@@ -14,19 +14,19 @@
 
 package com.google.api.client.extensions.android;
 
-import com.google.api.client.util.Experimental;
+import com.google.api.client.util.Beta;
 import com.google.api.client.util.Preconditions;
 
 import android.os.Build;
 
 /**
- * {@link Experimental} <br/>
+ * {@link Beta} <br/>
  * Utilities for Android.
  *
  * @since 1.11
  * @author Yaniv Inbar
  */
-@Experimental
+@Beta
 public class AndroidUtils {
 
  /**

google-http-client-android/src/main/java/com/google/api/client/extensions/android/http/AndroidHttp.java

@@ -18,18 +18,18 @@
 import com.google.api.client.http.HttpTransport;
 import com.google.api.client.http.apache.ApacheHttpTransport;
 import com.google.api.client.http.javanet.NetHttpTransport;
-import com.google.api.client.util.Experimental;
+import com.google.api.client.util.Beta;
 
 import java.net.HttpURLConnection;
 
 /**
- * {@link Experimental} <br/>
+ * {@link Beta} <br/>
  * Utilities for Android HTTP transport.
  *
  * @since 1.11
  * @author Yaniv Inbar
  */
-@Experimental
+@Beta
 public class AndroidHttp {
 
  /**

google-http-client-android/src/main/java/com/google/api/client/extensions/android/http/package-info.java

@@ -13,11 +13,11 @@
  */
 
 /**
- * {@link com.google.api.client.util.Experimental} <br/>
+ * {@link com.google.api.client.util.Beta} <br/>
  * Utilities for Android HTTP transport.
  *
  * @since 1.11
  * @author Yaniv Inbar
  */
-@com.google.api.client.util.Experimental
+@com.google.api.client.util.Beta
 package com.google.api.client.extensions.android.http;

google-http-client-android/src/main/java/com/google/api/client/extensions/android/json/AndroidJsonFactory.java

@@ -18,8 +18,8 @@
 import com.google.api.client.json.JsonFactory;
 import com.google.api.client.json.JsonGenerator;
 import com.google.api.client.json.JsonParser;
+import com.google.api.client.util.Beta;
 import com.google.api.client.util.Charsets;
-import com.google.api.client.util.Experimental;
 
 import android.annotation.TargetApi;
 import android.util.JsonReader;
@@ -35,7 +35,7 @@
 import java.nio.charset.Charset;
 
 /**
- * {@link Experimental} <br/>
+ * {@link Beta} <br/>
  * Low-level JSON library implementation based on GSON.
  *
  * <p>
@@ -51,7 +51,7 @@
  * @author Yaniv Inbar
  */
 @TargetApi(11)
-@Experimental
+@Beta
 public class AndroidJsonFactory extends JsonFactory {
 
  // TODO(yanivi): figure out how to run unit tests based on Android platform

google-http-client-android/src/main/java/com/google/api/client/extensions/android/json/AndroidJsonGenerator.java

@@ -16,7 +16,7 @@
 
 import com.google.api.client.json.JsonFactory;
 import com.google.api.client.json.JsonGenerator;
-import com.google.api.client.util.Experimental;
+import com.google.api.client.util.Beta;
 
 import android.annotation.TargetApi;
 import android.util.JsonWriter;
@@ -26,7 +26,7 @@
 import java.math.BigInteger;
 
 /**
- * {@link Experimental} <br/>
+ * {@link Beta} <br/>
  * Low-level JSON serializer implementation based on GSON.
  *
  * <p>
@@ -36,7 +36,7 @@
  * @author Yaniv Inbar
  */
 @TargetApi(11)
-@Experimental
+@Beta
 class AndroidJsonGenerator extends JsonGenerator {
  private final JsonWriter writer;
  private final AndroidJsonFactory factory;

google-http-client-android/src/main/java/com/google/api/client/extensions/android/json/AndroidJsonParser.java

@@ -17,7 +17,7 @@
 import com.google.api.client.json.JsonFactory;
 import com.google.api.client.json.JsonParser;
 import com.google.api.client.json.JsonToken;
-import com.google.api.client.util.Experimental;
+import com.google.api.client.util.Beta;
 import com.google.api.client.util.Preconditions;
 
 import android.annotation.TargetApi;
@@ -31,7 +31,7 @@
 import java.util.List;
 
 /**
- * {@link Experimental} <br/>
+ * {@link Beta} <br/>
  * Low-level JSON serializer implementation based on GSON.
  *
  * <p>
@@ -41,7 +41,7 @@
  * @author Yaniv Inbar
  */
 @TargetApi(11)
-@Experimental
+@Beta
 class AndroidJsonParser extends JsonParser {
  private final JsonReader reader;
  private final AndroidJsonFactory factory;

google-http-client-android/src/main/java/com/google/api/client/extensions/android/json/package-info.java

@@ -13,11 +13,11 @@
  */
 
 /**
- * {@link com.google.api.client.util.Experimental} <br/>
+ * {@link com.google.api.client.util.Beta} <br/>
  * Low-level implementation of the GSON parser library built-in to the Android 3.0 SDK.
  *
  * @since 1.11
  * @author Yaniv Inbar
  */
-@com.google.api.client.util.Experimental
+@com.google.api.client.util.Beta
 package com.google.api.client.extensions.android.json;

google-http-client-android/src/main/java/com/google/api/client/extensions/android/package-info.java

@@ -13,11 +13,11 @@
  */
 
 /**
- * {@link com.google.api.client.util.Experimental} <br/>
+ * {@link com.google.api.client.util.Beta} <br/>
  * Utilities for Android.
  *
  * @since 1.11
  * @author Yaniv Inbar
  */
-@com.google.api.client.util.Experimental
+@com.google.api.client.util.Beta
 package com.google.api.client.extensions.android;

google-http-client-findbugs/google-http-client-findbugs-test/src/main/java/com/google/api/client/findbugs/test/ExperimentalClass.java renamed to google-http-client-findbugs/google-http-client-findbugs-test/src/main/java/com/google/api/client/findbugs/test/BetaClass.java

@@ -14,33 +14,33 @@
 
 package com.google.api.client.findbugs.test;
 
-import com.google.api.client.util.Experimental;
+import com.google.api.client.util.Beta;
 
-/** A class which annotated as {@link Experimental}. */
-@Experimental
-public class ExperimentalClass {
+/** A class which annotated as {@link Beta}. */
+@Beta
+public class BetaClass {
 
  public void method() {
  }
 
- @Experimental
- public void experimentalMethod() {
- ExperimentalClass2 exp2 = new ExperimentalClass2();
+ @Beta
+ public void betaMethod() {
+ BetaClass2 exp2 = new BetaClass2();
  exp2.foo();
  }
 
- public ExperimentalClass() {
+ public BetaClass() {
  field = 1;
- experimentalField = 2;
+ betaField = 2;
  }
 
  int field;
 
- @Experimental
- int experimentalField;
+ @Beta
+ int betaField;
 
  @Override
  public String toString() {
- return "Field: " + field + ", Experimental Field: " + experimentalField;
+ return "Field: " + field + ", Beta Field: " + betaField;
  }
 }