Steve McKay | d3f6f14 | 2015-10-27 15:57:53 -0700 | [diff] [blame] | 1 | /* |
| 2 | * Copyright (C) 2015 The Android Open Source Project |
| 3 | * |
| 4 | * Licensed under the Apache License, Version 2.0 (the "License"); |
| 5 | * you may not use this file except in compliance with the License. |
| 6 | * You may obtain a copy of the License at |
| 7 | * |
| 8 | * http://www.apache.org/licenses/LICENSE-2.0 |
| 9 | * |
| 10 | * Unless required by applicable law or agreed to in writing, software |
| 11 | * distributed under the License is distributed on an "AS IS" BASIS, |
| 12 | * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. |
| 13 | * See the License for the specific language governing permissions and |
| 14 | * limitations under the License. |
| 15 | */ |
| 16 | |
| 17 | package com.android.documentsui.dirlist; |
| 18 | |
| 19 | import static com.android.documentsui.State.ACTION_BROWSE; |
Steve McKay | f69502c | 2015-11-09 17:38:35 +0900 | [diff] [blame] | 20 | import static com.android.documentsui.State.ACTION_CREATE; |
| 21 | import static com.android.documentsui.State.ACTION_GET_CONTENT; |
Steve McKay | d3f6f14 | 2015-10-27 15:57:53 -0700 | [diff] [blame] | 22 | import static com.android.documentsui.State.ACTION_MANAGE; |
Steve McKay | f69502c | 2015-11-09 17:38:35 +0900 | [diff] [blame] | 23 | import static com.android.documentsui.State.ACTION_OPEN; |
| 24 | import static com.android.documentsui.State.ACTION_OPEN_TREE; |
Steve McKay | d3f6f14 | 2015-10-27 15:57:53 -0700 | [diff] [blame] | 25 | import static com.android.internal.util.Preconditions.checkArgument; |
| 26 | |
Steve McKay | aa15dae | 2016-02-09 16:17:24 -0800 | [diff] [blame] | 27 | import android.content.Context; |
Steve McKay | aa15dae | 2016-02-09 16:17:24 -0800 | [diff] [blame] | 28 | import android.provider.DocumentsContract.Document; |
Steve McKay | aa15dae | 2016-02-09 16:17:24 -0800 | [diff] [blame] | 29 | import android.view.Menu; |
| 30 | import android.view.MenuItem; |
| 31 | |
Steve McKay | c95d87c | 2016-02-23 14:34:50 -0800 | [diff] [blame] | 32 | import com.android.documentsui.BaseActivity; |
Steve McKay | d3f6f14 | 2015-10-27 15:57:53 -0700 | [diff] [blame] | 33 | import com.android.documentsui.Menus; |
Steve McKay | f69502c | 2015-11-09 17:38:35 +0900 | [diff] [blame] | 34 | import com.android.documentsui.MimePredicate; |
Steve McKay | d3f6f14 | 2015-10-27 15:57:53 -0700 | [diff] [blame] | 35 | import com.android.documentsui.R; |
| 36 | import com.android.documentsui.State; |
Steve McKay | aa15dae | 2016-02-09 16:17:24 -0800 | [diff] [blame] | 37 | import com.android.documentsui.dirlist.DirectoryFragment.ResultType; |
Steve McKay | f69502c | 2015-11-09 17:38:35 +0900 | [diff] [blame] | 38 | |
Steve McKay | d3f6f14 | 2015-10-27 15:57:53 -0700 | [diff] [blame] | 39 | /** |
| 40 | * Providers support for specializing the DirectoryFragment to the "host" Activity. |
| 41 | * Feel free to expand the role of this class to handle other specializations. |
| 42 | */ |
| 43 | public abstract class FragmentTuner { |
Steve McKay | f69502c | 2015-11-09 17:38:35 +0900 | [diff] [blame] | 44 | |
Steve McKay | aa15dae | 2016-02-09 16:17:24 -0800 | [diff] [blame] | 45 | final Context mContext; |
Steve McKay | f69502c | 2015-11-09 17:38:35 +0900 | [diff] [blame] | 46 | final State mState; |
| 47 | |
Steve McKay | aa15dae | 2016-02-09 16:17:24 -0800 | [diff] [blame] | 48 | public FragmentTuner(Context context, State state) { |
| 49 | mContext = context; |
Steve McKay | f69502c | 2015-11-09 17:38:35 +0900 | [diff] [blame] | 50 | mState = state; |
| 51 | } |
| 52 | |
Steve McKay | aa15dae | 2016-02-09 16:17:24 -0800 | [diff] [blame] | 53 | public static FragmentTuner pick(Context context, State state) { |
Steve McKay | d3f6f14 | 2015-10-27 15:57:53 -0700 | [diff] [blame] | 54 | switch (state.action) { |
| 55 | case ACTION_BROWSE: |
Steve McKay | aa15dae | 2016-02-09 16:17:24 -0800 | [diff] [blame] | 56 | return new FilesTuner(context, state); |
Steve McKay | d3f6f14 | 2015-10-27 15:57:53 -0700 | [diff] [blame] | 57 | case ACTION_MANAGE: |
Steve McKay | aa15dae | 2016-02-09 16:17:24 -0800 | [diff] [blame] | 58 | return new DownloadsTuner(context, state); |
Steve McKay | d3f6f14 | 2015-10-27 15:57:53 -0700 | [diff] [blame] | 59 | default: |
Steve McKay | aa15dae | 2016-02-09 16:17:24 -0800 | [diff] [blame] | 60 | return new DocumentsTuner(context, state); |
Steve McKay | d3f6f14 | 2015-10-27 15:57:53 -0700 | [diff] [blame] | 61 | } |
| 62 | } |
| 63 | |
Steve McKay | f69502c | 2015-11-09 17:38:35 +0900 | [diff] [blame] | 64 | |
Steve McKay | 27d20a3 | 2016-02-22 18:38:09 -0800 | [diff] [blame] | 65 | public abstract void updateActionMenu( |
| 66 | Menu menu, @ResultType int dirType, boolean canDelete, boolean canRename); |
Steve McKay | d3f6f14 | 2015-10-27 15:57:53 -0700 | [diff] [blame] | 67 | |
Steve McKay | f69502c | 2015-11-09 17:38:35 +0900 | [diff] [blame] | 68 | // Subtly different from isDocumentEnabled. The reason may be illuminated as follows. |
| 69 | // A folder is enabled such that it may be double clicked, even in settings |
| 70 | // when the folder itself cannot be selected. This may also be true of container types. |
Tomasz Mikolajewski | a8057a9 | 2015-11-16 11:41:28 +0900 | [diff] [blame] | 71 | public boolean canSelectType(String docMimeType, int docFlags) { |
Steve McKay | f69502c | 2015-11-09 17:38:35 +0900 | [diff] [blame] | 72 | return true; |
| 73 | } |
| 74 | |
| 75 | public boolean isDocumentEnabled(String docMimeType, int docFlags) { |
| 76 | if (isDirectory(docMimeType)) { |
| 77 | return true; |
| 78 | } |
| 79 | |
| 80 | return MimePredicate.mimeMatches(mState.acceptMimes, docMimeType); |
| 81 | } |
| 82 | |
Aga Wronska | 893390b | 2016-02-17 13:50:42 -0800 | [diff] [blame] | 83 | abstract void onModelLoaded(Model model, @ResultType int resultType, boolean isSearch); |
Steve McKay | aa15dae | 2016-02-09 16:17:24 -0800 | [diff] [blame] | 84 | |
Steve McKay | d3f6f14 | 2015-10-27 15:57:53 -0700 | [diff] [blame] | 85 | /** |
| 86 | * Provides support for Platform specific specializations of DirectoryFragment. |
| 87 | */ |
| 88 | private static final class DocumentsTuner extends FragmentTuner { |
Steve McKay | f69502c | 2015-11-09 17:38:35 +0900 | [diff] [blame] | 89 | |
Steve McKay | aa15dae | 2016-02-09 16:17:24 -0800 | [diff] [blame] | 90 | public DocumentsTuner(Context context, State state) { |
| 91 | super(context, state); |
Steve McKay | f69502c | 2015-11-09 17:38:35 +0900 | [diff] [blame] | 92 | } |
| 93 | |
| 94 | @Override |
Tomasz Mikolajewski | a8057a9 | 2015-11-16 11:41:28 +0900 | [diff] [blame] | 95 | public boolean canSelectType(String docMimeType, int docFlags) { |
| 96 | if (!isDocumentEnabled(docMimeType, docFlags)) { |
| 97 | return false; |
Steve McKay | f69502c | 2015-11-09 17:38:35 +0900 | [diff] [blame] | 98 | } |
Tomasz Mikolajewski | a8057a9 | 2015-11-16 11:41:28 +0900 | [diff] [blame] | 99 | |
| 100 | if (isDirectory(docMimeType)) { |
| 101 | return false; |
| 102 | } |
| 103 | |
| 104 | if (mState.action == ACTION_OPEN_TREE) { |
| 105 | // In this case nothing *ever* is selectable...the expected user behavior is |
| 106 | // they navigate *into* a folder, then click a confirmation button indicating |
| 107 | // that the current directory is the directory they are picking. |
| 108 | return false; |
| 109 | } |
| 110 | |
Steve McKay | f69502c | 2015-11-09 17:38:35 +0900 | [diff] [blame] | 111 | return true; |
| 112 | } |
| 113 | |
| 114 | @Override |
| 115 | public boolean isDocumentEnabled(String docMimeType, int docFlags) { |
Tomasz Mikolajewski | a8057a9 | 2015-11-16 11:41:28 +0900 | [diff] [blame] | 116 | // Directories are always enabled. |
Steve McKay | f69502c | 2015-11-09 17:38:35 +0900 | [diff] [blame] | 117 | if (isDirectory(docMimeType)) { |
| 118 | return true; |
| 119 | } |
| 120 | |
Tomasz Mikolajewski | a8057a9 | 2015-11-16 11:41:28 +0900 | [diff] [blame] | 121 | switch (mState.action) { |
| 122 | case ACTION_CREATE: |
| 123 | // Read-only files are disabled when creating. |
| 124 | if ((docFlags & Document.FLAG_SUPPORTS_WRITE) == 0) { |
| 125 | return false; |
| 126 | } |
| 127 | case ACTION_OPEN: |
| 128 | case ACTION_GET_CONTENT: |
| 129 | final boolean isVirtual = (docFlags & Document.FLAG_VIRTUAL_DOCUMENT) != 0; |
| 130 | if (isVirtual && mState.openableOnly) { |
| 131 | return false; |
| 132 | } |
Steve McKay | f69502c | 2015-11-09 17:38:35 +0900 | [diff] [blame] | 133 | } |
| 134 | |
| 135 | return MimePredicate.mimeMatches(mState.acceptMimes, docMimeType); |
| 136 | } |
| 137 | |
Steve McKay | d3f6f14 | 2015-10-27 15:57:53 -0700 | [diff] [blame] | 138 | @Override |
Steve McKay | 27d20a3 | 2016-02-22 18:38:09 -0800 | [diff] [blame] | 139 | public void updateActionMenu( |
| 140 | Menu menu, @ResultType int dirType, boolean canDelete, boolean canRename) { |
Steve McKay | d3f6f14 | 2015-10-27 15:57:53 -0700 | [diff] [blame] | 141 | |
Steve McKay | 27d20a3 | 2016-02-22 18:38:09 -0800 | [diff] [blame] | 142 | MenuItem open = menu.findItem(R.id.menu_open); |
| 143 | MenuItem share = menu.findItem(R.id.menu_share); |
| 144 | MenuItem delete = menu.findItem(R.id.menu_delete); |
| 145 | MenuItem rename = menu.findItem(R.id.menu_rename); |
Steve McKay | d3f6f14 | 2015-10-27 15:57:53 -0700 | [diff] [blame] | 146 | |
| 147 | open.setVisible(true); |
| 148 | share.setVisible(false); |
| 149 | delete.setVisible(false); |
Aga Wronska | 3b327ef | 2016-01-20 16:32:33 -0800 | [diff] [blame] | 150 | rename.setVisible(false); |
Steve McKay | d3f6f14 | 2015-10-27 15:57:53 -0700 | [diff] [blame] | 151 | } |
Steve McKay | aa15dae | 2016-02-09 16:17:24 -0800 | [diff] [blame] | 152 | |
| 153 | @Override |
Aga Wronska | 893390b | 2016-02-17 13:50:42 -0800 | [diff] [blame] | 154 | void onModelLoaded(Model model, @ResultType int resultType, boolean isSearch) { |
Steve McKay | c95d87c | 2016-02-23 14:34:50 -0800 | [diff] [blame] | 155 | // When launched into empty root, open drawer. |
| 156 | if (model.isEmpty() && !mState.hasInitialLocationChanged() && !isSearch) { |
| 157 | // This noops on layouts without drawer, so no need to guard. |
| 158 | ((BaseActivity) mContext).setRootsDrawerOpen(true); |
Steve McKay | aa15dae | 2016-02-09 16:17:24 -0800 | [diff] [blame] | 159 | } |
| 160 | } |
Steve McKay | d3f6f14 | 2015-10-27 15:57:53 -0700 | [diff] [blame] | 161 | } |
| 162 | |
| 163 | /** |
| 164 | * Provides support for Platform specific specializations of DirectoryFragment. |
| 165 | */ |
Steve McKay | f69502c | 2015-11-09 17:38:35 +0900 | [diff] [blame] | 166 | private static final class DownloadsTuner extends FragmentTuner { |
| 167 | |
Steve McKay | aa15dae | 2016-02-09 16:17:24 -0800 | [diff] [blame] | 168 | public DownloadsTuner(Context context, State state) { |
| 169 | super(context, state); |
Steve McKay | f69502c | 2015-11-09 17:38:35 +0900 | [diff] [blame] | 170 | } |
Steve McKay | d3f6f14 | 2015-10-27 15:57:53 -0700 | [diff] [blame] | 171 | |
| 172 | @Override |
Steve McKay | 27d20a3 | 2016-02-22 18:38:09 -0800 | [diff] [blame] | 173 | public void updateActionMenu( |
| 174 | Menu menu, @ResultType int resultType, boolean canDelete, boolean canRename) { |
| 175 | checkArgument(resultType != DirectoryFragment.TYPE_RECENT_OPEN); |
Steve McKay | d3f6f14 | 2015-10-27 15:57:53 -0700 | [diff] [blame] | 176 | |
Steve McKay | 27d20a3 | 2016-02-22 18:38:09 -0800 | [diff] [blame] | 177 | MenuItem open = menu.findItem(R.id.menu_open); |
| 178 | MenuItem delete = menu.findItem(R.id.menu_delete); |
| 179 | MenuItem copyTo = menu.findItem(R.id.menu_copy_to); |
| 180 | MenuItem moveTo = menu.findItem(R.id.menu_move_to); |
| 181 | MenuItem rename = menu.findItem(R.id.menu_rename); |
| 182 | MenuItem copy = menu.findItem(R.id.menu_copy_to_clipboard); |
Steve McKay | d3f6f14 | 2015-10-27 15:57:53 -0700 | [diff] [blame] | 183 | |
| 184 | open.setVisible(false); |
Steve McKay | d3f6f14 | 2015-10-27 15:57:53 -0700 | [diff] [blame] | 185 | delete.setVisible(canDelete); |
Steve McKay | 27d20a3 | 2016-02-22 18:38:09 -0800 | [diff] [blame] | 186 | copy.setEnabled(true); // to clipboard |
Steve McKay | d3f6f14 | 2015-10-27 15:57:53 -0700 | [diff] [blame] | 187 | copyTo.setVisible(true); |
| 188 | copyTo.setEnabled(true); |
Steve McKay | 27d20a3 | 2016-02-22 18:38:09 -0800 | [diff] [blame] | 189 | moveTo.setVisible(true); |
| 190 | moveTo.setEnabled(true); |
Aga Wronska | 3b327ef | 2016-01-20 16:32:33 -0800 | [diff] [blame] | 191 | rename.setVisible(false); |
Steve McKay | d3f6f14 | 2015-10-27 15:57:53 -0700 | [diff] [blame] | 192 | } |
Steve McKay | aa15dae | 2016-02-09 16:17:24 -0800 | [diff] [blame] | 193 | |
| 194 | @Override |
Aga Wronska | 893390b | 2016-02-17 13:50:42 -0800 | [diff] [blame] | 195 | void onModelLoaded(Model model, @ResultType int resultType, boolean isSearch) {} |
Steve McKay | d3f6f14 | 2015-10-27 15:57:53 -0700 | [diff] [blame] | 196 | } |
| 197 | |
| 198 | /** |
| 199 | * Provides support for Files activity specific specializations of DirectoryFragment. |
| 200 | */ |
| 201 | private static final class FilesTuner extends FragmentTuner { |
Steve McKay | f69502c | 2015-11-09 17:38:35 +0900 | [diff] [blame] | 202 | |
Steve McKay | aa15dae | 2016-02-09 16:17:24 -0800 | [diff] [blame] | 203 | public FilesTuner(Context context, State state) { |
| 204 | super(context, state); |
Steve McKay | f69502c | 2015-11-09 17:38:35 +0900 | [diff] [blame] | 205 | } |
| 206 | |
Steve McKay | d3f6f14 | 2015-10-27 15:57:53 -0700 | [diff] [blame] | 207 | @Override |
Steve McKay | 27d20a3 | 2016-02-22 18:38:09 -0800 | [diff] [blame] | 208 | public void updateActionMenu( |
| 209 | Menu menu, @ResultType int dirType, boolean canDelete, boolean canRename) { |
Steve McKay | d3f6f14 | 2015-10-27 15:57:53 -0700 | [diff] [blame] | 210 | |
| 211 | MenuItem copy = menu.findItem(R.id.menu_copy_to_clipboard); |
| 212 | MenuItem paste = menu.findItem(R.id.menu_paste_from_clipboard); |
| 213 | copy.setEnabled(dirType != DirectoryFragment.TYPE_RECENT_OPEN); |
| 214 | |
Aga Wronska | 3b327ef | 2016-01-20 16:32:33 -0800 | [diff] [blame] | 215 | MenuItem rename = menu.findItem(R.id.menu_rename); |
| 216 | rename.setVisible(true); |
| 217 | rename.setEnabled(canRename); |
| 218 | |
Steve McKay | d3f6f14 | 2015-10-27 15:57:53 -0700 | [diff] [blame] | 219 | menu.findItem(R.id.menu_share).setVisible(true); |
| 220 | menu.findItem(R.id.menu_delete).setVisible(canDelete); |
Steve McKay | d3f6f14 | 2015-10-27 15:57:53 -0700 | [diff] [blame] | 221 | menu.findItem(R.id.menu_open).setVisible(false); |
| 222 | menu.findItem(R.id.menu_copy_to).setVisible(true); |
| 223 | menu.findItem(R.id.menu_move_to).setVisible(true); |
Steve McKay | 27d20a3 | 2016-02-22 18:38:09 -0800 | [diff] [blame] | 224 | menu.findItem(R.id.menu_move_to).setEnabled(canDelete); |
Steve McKay | d3f6f14 | 2015-10-27 15:57:53 -0700 | [diff] [blame] | 225 | |
| 226 | Menus.disableHiddenItems(menu, copy, paste); |
| 227 | } |
Steve McKay | aa15dae | 2016-02-09 16:17:24 -0800 | [diff] [blame] | 228 | |
| 229 | @Override |
Aga Wronska | 893390b | 2016-02-17 13:50:42 -0800 | [diff] [blame] | 230 | void onModelLoaded(Model model, @ResultType int resultType, boolean isSearch) { |
Steve McKay | aa15dae | 2016-02-09 16:17:24 -0800 | [diff] [blame] | 231 | // When launched into empty root, open drawer. |
Steve McKay | c95d87c | 2016-02-23 14:34:50 -0800 | [diff] [blame] | 232 | if (model.isEmpty() && !mState.hasInitialLocationChanged() && !isSearch) { |
Steve McKay | aa15dae | 2016-02-09 16:17:24 -0800 | [diff] [blame] | 233 | // This noops on layouts without drawer, so no need to guard. |
Steve McKay | c95d87c | 2016-02-23 14:34:50 -0800 | [diff] [blame] | 234 | ((BaseActivity) mContext).setRootsDrawerOpen(true); |
Steve McKay | aa15dae | 2016-02-09 16:17:24 -0800 | [diff] [blame] | 235 | } |
Steve McKay | aa15dae | 2016-02-09 16:17:24 -0800 | [diff] [blame] | 236 | } |
Steve McKay | d3f6f14 | 2015-10-27 15:57:53 -0700 | [diff] [blame] | 237 | } |
Steve McKay | f69502c | 2015-11-09 17:38:35 +0900 | [diff] [blame] | 238 | |
| 239 | private static boolean isDirectory(String mimeType) { |
| 240 | return Document.MIME_TYPE_DIR.equals(mimeType); |
| 241 | } |
Steve McKay | d3f6f14 | 2015-10-27 15:57:53 -0700 | [diff] [blame] | 242 | } |