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

Commit 099f9518 authored Dec 09, 2016 by Tomasz Mikolajewski

Update API documentation about virtual files.

To say that virtual files must have at least one streamable type.

Test: None
Bug: 33463773
Change-Id: I9094686cb95ee0af1c01b2bf88550cd3bbfe572d

parent fdc5ea11

core/java/android/provider/DocumentsContract.java

+3 −0

Original line number	Diff line number	Diff line
		@@ -376,6 +376,9 @@ public final class DocumentsContract {
		* Flag indicating that a document is virtual, and doesn't have byte
		* representation in the MIME type specified as {@link #COLUMN_MIME_TYPE}.
		*
		* <p><em>Virtual documents must have at least one alternative streamable
		* format via {@link DocumentsProvider#openTypedDocument}</em>
		*
		* @see #COLUMN_FLAGS
		* @see #COLUMN_MIME_TYPE
		* @see DocumentsProvider#openTypedDocument(String, String, Bundle,

core/java/android/provider/DocumentsProvider.java

+4 −0

Original line number	Diff line number	Diff line
		@@ -575,6 +575,8 @@ public abstract class DocumentsProvider extends ContentProvider {
		* <p>
		* A provider may perform a conversion if the documents's MIME type is not
		* matching the specified MIME type filter.
		* <p>
		* Virtual documents must have at least one streamable format.
		*
		* @param documentId the document to return.
		* @param mimeTypeFilter the MIME type filter for the requested format. May
		@@ -1044,6 +1046,8 @@ public abstract class DocumentsProvider extends ContentProvider {
		* {@link #queryDocument(String, String[])} as long as it matches the filter and the document
		* does not have the {@link Document#FLAG_VIRTUAL_DOCUMENT} flag set.
		*
		* <p>Virtual documents must have at least one streamable format.
		*
		* @see #getStreamTypes(Uri, String)
		* @see #openTypedDocument(String, String, Bundle, CancellationSignal)
		*/