Merge "Add voicemail builder method for updating/syncing."

api/current.txt

@@ -29111,6 +29111,7 @@ package android.telecom {
 
   public class Voicemail implements android.os.Parcelable {
     method public static android.telecom.Voicemail.Builder createForInsertion(long, java.lang.String);
+    method public static android.telecom.Voicemail.Builder createForUpdate(long, java.lang.String);
     method public int describeContents();
     method public long getDuration();
     method public long getId();

api/system-current.txt

@@ -31430,6 +31430,7 @@ package android.telecom {
 
   public class Voicemail implements android.os.Parcelable {
     method public static android.telecom.Voicemail.Builder createForInsertion(long, java.lang.String);
+    method public static android.telecom.Voicemail.Builder createForUpdate(long, java.lang.String);
     method public int describeContents();
     method public long getDuration();
     method public long getId();

telecomm/java/android/telecom/Voicemail.java

@@ -56,6 +56,16 @@ public class Voicemail implements Parcelable {
         return new Builder().setNumber(number).setTimestamp(timestamp);
     }
 
+    /**
+     * Create a {@link Builder} for a {@link Voicemail} to be updated (or deleted).
+     * <p>
+     * The id and source data fields are mandatory for update - id is necessary for updating the
+     * database and source data is necessary for updating the server.
+     */
+    public static Builder createForUpdate(long id, String sourceData) {
+        return new Builder().setId(id).setSourceData(sourceData);
+    }
+
     /**
      * Builder pattern for creating a {@link Voicemail}. The builder must be created with the
      * {@link #createForInsertion(long, String)} method.