Tweaks to download manager API based on API review feedback

* improved documentation of the default destination on the download
  cache and the concomitant consequences

* removed NETWORK_WIMAX flag for setting allowed networks

* changed request headers behavior to support multiple instances of
  the same header (as allowed in the HTTP spec), renamed
  setRequestHeader() to addRequestHeader()

* accept user-facing strings as CharSequences instead of Strings

* new convenience methods setDestinationInExternalFilesDir() and
  setDestinationInExternalPublicDir() for setting a destination in
  either shared or app-private external storage directories

* renamed setMediaType() to setMimeType()

Change-Id: I8781e2214d939c340209cab917bbbba264ab919c

1 files changed, 41 insertions, 20 deletions

diff --git a/api/current.xml b/api/current.xml
index 52b5342..956f2b8 100644
--- a/api/current.xml
+++ b/api/current.xml
@@ -95779,6 +95779,21 @@
 <parameter name="uri" type="android.net.Uri">
 </parameter>
 </constructor>
+<method name="addRequestHeader"
+ return="android.net.DownloadManager.Request"
+ abstract="false"
+ native="false"
+ synchronized="false"
+ static="false"
+ final="false"
+ deprecated="not deprecated"
+ visibility="public"
+>
+<parameter name="header" type="java.lang.String">
+</parameter>
+<parameter name="value" type="java.lang.String">
+</parameter>
+</method>
 <method name="setAllowedNetworkTypes"
  return="android.net.DownloadManager.Request"
  abstract="false"
@@ -95815,10 +95830,10 @@
  deprecated="not deprecated"
  visibility="public"
 >
-<parameter name="description" type="java.lang.String">
+<parameter name="description" type="java.lang.CharSequence">
 </parameter>
 </method>
-<method name="setDestinationUri"
+<method name="setDestinationInExternalFilesDir"
  return="android.net.DownloadManager.Request"
  abstract="false"
  native="false"
@@ -95828,10 +95843,14 @@
  deprecated="not deprecated"
  visibility="public"
 >
-<parameter name="uri" type="android.net.Uri">
+<parameter name="context" type="android.content.Context">
+</parameter>
+<parameter name="dirType" type="java.lang.String">
+</parameter>
+<parameter name="subPath" type="java.lang.String">
 </parameter>
 </method>
-<method name="setMediaType"
+<method name="setDestinationInExternalPublicDir"
  return="android.net.DownloadManager.Request"
  abstract="false"
  native="false"
@@ -95841,10 +95860,12 @@
  deprecated="not deprecated"
  visibility="public"
 >
-<parameter name="mediaType" type="java.lang.String">
+<parameter name="dirType" type="java.lang.String">
+</parameter>
+<parameter name="subPath" type="java.lang.String">
 </parameter>
 </method>
-<method name="setRequestHeader"
+<method name="setDestinationUri"
  return="android.net.DownloadManager.Request"
  abstract="false"
  native="false"
@@ -95854,9 +95875,20 @@
  deprecated="not deprecated"
  visibility="public"
 >
-<parameter name="header" type="java.lang.String">
+<parameter name="uri" type="android.net.Uri">
 </parameter>
-<parameter name="value" type="java.lang.String">
+</method>
+<method name="setMimeType"
+ return="android.net.DownloadManager.Request"
+ abstract="false"
+ native="false"
+ synchronized="false"
+ static="false"
+ final="false"
+ deprecated="not deprecated"
+ visibility="public"
+>
+<parameter name="mimeType" type="java.lang.String">
 </parameter>
 </method>
 <method name="setShowRunningNotification"
@@ -95882,7 +95914,7 @@
  deprecated="not deprecated"
  visibility="public"
 >
-<parameter name="title" type="java.lang.String">
+<parameter name="title" type="java.lang.CharSequence">
 </parameter>
 </method>
 <method name="setVisibleInDownloadsUi"
@@ -95920,17 +95952,6 @@
  visibility="public"
 >
 </field>
-<field name="NETWORK_WIMAX"
- type="int"
- transient="false"
- volatile="false"
- value="4"
- static="true"
- final="true"
- deprecated="not deprecated"
- visibility="public"
->
-</field>
 </class>
 <class name="LocalServerSocket"
  extends="java.lang.Object"