Donate to e Foundation | Murena handsets with /e/OS | Own a part of Murena! Learn more

Commit 846eb30f authored by David Brown's avatar David Brown
Browse files

Add SipAddress to ContactsContract. 

This is a new data kind representing a SIP address for a contact.
The new class is ContactsContract.CommonDataKinds.SipAddress,
and the new mime type is "vnd.android.cursor.item/sip_address".

It's pretty generic right now (basically a single text field, like
"Website") but we may eventually want to extend it later to have multiple
labels+types (like phone numbers.)

Bug: 2942998

Change-Id: I45d90a680a3badf60bccb5aafdc2397037494e95
parent 02486b13

api/current.xml

+33 −0
Original line number Diff line number Diff line
@@ -137505,6 +137505,39 @@ 
>

</field>

</class>

<class name="ContactsContract.CommonDataKinds.SipAddress"

 extends="java.lang.Object"

 abstract="false"

 static="true"

 final="true"

 deprecated="not deprecated"

 visibility="public"

>

<implements name="android.provider.ContactsContract.DataColumnsWithJoins">

</implements>

<field name="CONTENT_ITEM_TYPE"

 type="java.lang.String"

 transient="false"

 volatile="false"

 value="&quot;vnd.android.cursor.item/sip_address&quot;"

 static="true"

 final="true"

 deprecated="not deprecated"

 visibility="public"

>

</field>

<field name="SIP_ADDRESS"

 type="java.lang.String"

 transient="false"

 volatile="false"

 value="&quot;data1&quot;"

 static="true"

 final="true"

 deprecated="not deprecated"

 visibility="public"

>

</field>

</class>

<class name="ContactsContract.CommonDataKinds.StructuredName"

 extends="java.lang.Object"

 abstract="false"

core/java/android/provider/ContactsContract.java

+47 −0
Original line number Diff line number Diff line
@@ -2305,6 +2305,7 @@ public final class ContactsContract { 
     * <li>{@link CommonDataKinds.Website Website.CONTENT_ITEM_TYPE}</li>

     * <li>{@link CommonDataKinds.Event Event.CONTENT_ITEM_TYPE}</li>

     * <li>{@link CommonDataKinds.Relation Relation.CONTENT_ITEM_TYPE}</li>

     * <li>{@link CommonDataKinds.SipAddress SipAddress.CONTENT_ITEM_TYPE}</li>

     * </ul>

     * </p>

     * </td>
@@ -4860,6 +4861,52 @@ public final class ContactsContract { 
             */

            public static final String URL = DATA;

        }



        /**

         * <p>

         * A data kind representing a SIP address for the contact.

         * </p>

         * <p>

         * You can use all columns defined for {@link ContactsContract.Data} as

         * well as the following aliases.

         * </p>

         * <h2>Column aliases</h2>

         * <table class="jd-sumtable">

         * <tr>

         * <th>Type</th>

         * <th>Alias</th><th colspan='2'>Data column</th>

         * </tr>

         * <tr>

         * <td>String</td>

         * <td>{@link #SIP_ADDRESS}</td>

         * <td>{@link #DATA1}</td>

         * <td></td>

         * </tr>

         * </table>

         */

        public static final class SipAddress implements DataColumnsWithJoins {

            // TODO: Ultimately this class will probably implement

            // CommonColumns too (in addition to DataColumnsWithJoins)

            // since it may make sense to have multiple SIP addresses with

            // different types+labels, just like with phone numbers.

            //

            // But that can be extended in the future without breaking any

            // public API, so let's keep this class ultra-simple for now.



            /**

             * This utility class cannot be instantiated

             */

            private SipAddress() {}



            /** MIME type used when storing this in data table. */

            public static final String CONTENT_ITEM_TYPE = "vnd.android.cursor.item/sip_address";



            /**

             * The SIP address.

             * <P>Type: TEXT</P>

             */

            public static final String SIP_ADDRESS = DATA1;

        }

    }



    /**