1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
|
// Copyright 2013 The Chromium Authors
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.
#ifndef BASE_ANDROID_CONTENT_URI_UTILS_H_
#define BASE_ANDROID_CONTENT_URI_UTILS_H_
#include <jni.h>
#include <string>
#include <vector>
#include "base/android/scoped_java_ref.h"
#include "base/base_export.h"
#include "base/files/file.h"
#include "base/files/file_enumerator.h"
#include "base/files/file_path.h"
namespace base {
namespace internal {
// Check whether a content URI exists.
BASE_EXPORT bool ContentUriExists(const FilePath& content_uri);
// Translates File::FLAG_* `open_flags` bitset to Java mode from
// ParcelFileDescriptor#parseMode(): ("r", "w", "wt", "wa", "rw" or "rwt").
// Disallows "w" which has been the source of android security issues.
// Returns nullopt if `open_flags` are not supported.
BASE_EXPORT std::optional<std::string> TranslateOpenFlagsToJavaMode(
uint32_t open_flags);
// Opens a content URI and returns the Java ParcelFileDescriptor to the caller
// which will own the object. Callers should call ContentUriGetFd() to get the
// platform file descriptor, and call ContentUriClose() when the file is closed.
// `open_flags` is a bitmap of File::FLAG_* values.
// Returns null if the URI is invalid.
base::android::ScopedJavaLocalRef<jobject> OpenContentUri(
const FilePath& content_uri,
uint32_t open_flags);
// Returns the platform FD or -1 if `java_parcel_file_descriptor` is invalid.
int ContentUriGetFd(
const base::android::JavaRef<jobject>& java_parcel_file_descriptor);
// Closes `java_parcel_file_descriptor`.
void ContentUriClose(
const base::android::JavaRef<jobject>& java_parcel_file_descriptor);
// Returns true if file exists and results are populated, else returns false.
bool ContentUriGetFileInfo(const FilePath& content_uri,
FileEnumerator::FileInfo* results);
// Returns list of files in `content_uri` directory.
std::vector<FileEnumerator::FileInfo> ListContentUriDirectory(
const FilePath& content_uri);
// Deletes a content URI.
bool DeleteContentUri(const FilePath& content_uri);
// Returns whether `content_uri` is a Document URI.
bool IsDocumentUri(const FilePath& content_uri);
} // namespace internal
// Gets MIME type from a content URI. Returns an empty string if the URI is
// invalid.
BASE_EXPORT std::string GetContentUriMimeType(const FilePath& content_uri);
// Gets the display name from a content URI. Returns true if the name was found.
BASE_EXPORT bool MaybeGetFileDisplayName(const FilePath& content_uri,
std::u16string* file_display_name);
// Build URI using tree_uri and encoded_document_id.
BASE_EXPORT FilePath
ContentUriBuildDocumentUriUsingTree(const FilePath& tree_uri,
const std::string& encoded_document_id);
// Returns the URI of the matching document, or if document does not exist and
// `create` is true then returns a URI that can be used with
// ContentUriGetDocumentFromQuery() to create the specified document under
// `parent` directory with the specified `display_name` and `mime_type`.
BASE_EXPORT FilePath
ContentUriGetChildDocumentOrQuery(const FilePath& parent,
const std::string& display_name,
const std::string& mime_type,
bool is_directory,
bool create);
// Returns whether this is a create-child-document query returned by
// ContentUriGetChildDocumentOrQuery().
BASE_EXPORT bool ContentUriIsCreateChildDocumentQuery(
const FilePath& content_uri);
// Gets a document with the details encoded in `document_query` which must be
// the result of calling ContentUriGetChildDocumentOrQuery(). If `create` is
// true, the document will be created if it does not exist.
BASE_EXPORT FilePath
ContentUriGetDocumentFromQuery(const FilePath& document_query, bool create);
} // namespace base
#endif // BASE_ANDROID_CONTENT_URI_UTILS_H_
|
