17c9e879fdec06cad0266b5c9498274729d11dac
[PrivacyBrowser.git] / app / src / main / java / com / stoutner / privacybrowser / activities / BookmarksDatabaseViewActivity.java
1 /*
2  * Copyright © 2016-2020 Soren Stoutner <soren@stoutner.com>.
3  *
4  * This file is part of Privacy Browser <https://www.stoutner.com/privacy-browser>.
5  *
6  * Privacy Browser is free software: you can redistribute it and/or modify
7  * it under the terms of the GNU General Public License as published by
8  * the Free Software Foundation, either version 3 of the License, or
9  * (at your option) any later version.
10  *
11  * Privacy Browser is distributed in the hope that it will be useful,
12  * but WITHOUT ANY WARRANTY; without even the implied warranty of
13  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
14  * GNU General Public License for more details.
15  *
16  * You should have received a copy of the GNU General Public License
17  * along with Privacy Browser.  If not, see <http://www.gnu.org/licenses/>.
18  */
19
20 package com.stoutner.privacybrowser.activities;
21
22 import android.annotation.SuppressLint;
23 import android.app.Dialog;
24 import android.content.Context;
25 import android.content.Intent;
26 import android.content.SharedPreferences;
27 import android.content.res.Configuration;
28 import android.database.Cursor;
29 import android.database.MatrixCursor;
30 import android.database.MergeCursor;
31 import android.graphics.Bitmap;
32 import android.graphics.BitmapFactory;
33 import android.graphics.Typeface;
34 import android.graphics.drawable.BitmapDrawable;
35 import android.graphics.drawable.Drawable;
36 import android.os.Bundle;
37 import android.preference.PreferenceManager;
38 import android.util.SparseBooleanArray;
39 import android.view.ActionMode;
40 import android.view.Menu;
41 import android.view.MenuItem;
42 import android.view.View;
43 import android.view.ViewGroup;
44 import android.view.WindowManager;
45 import android.widget.AbsListView;
46 import android.widget.AdapterView;
47 import android.widget.EditText;
48 import android.widget.ImageView;
49 import android.widget.ListView;
50 import android.widget.RadioButton;
51 import android.widget.ResourceCursorAdapter;
52 import android.widget.Spinner;
53 import android.widget.TextView;
54
55 import androidx.annotation.NonNull;
56 import androidx.appcompat.app.ActionBar;
57 import androidx.appcompat.app.AppCompatActivity;
58 import androidx.appcompat.widget.Toolbar;  // The AndroidX toolbar must be used until the minimum API is >= 21.
59 import androidx.core.content.ContextCompat;
60 import androidx.cursoradapter.widget.CursorAdapter;
61 import androidx.fragment.app.DialogFragment;  // The AndroidX dialog fragment must be used or an error is produced on API <=22.
62
63 import com.google.android.material.snackbar.Snackbar;
64
65 import com.stoutner.privacybrowser.R;
66 import com.stoutner.privacybrowser.dialogs.EditBookmarkDatabaseViewDialog;
67 import com.stoutner.privacybrowser.dialogs.EditBookmarkFolderDatabaseViewDialog;
68 import com.stoutner.privacybrowser.helpers.BookmarksDatabaseHelper;
69
70 import java.io.ByteArrayOutputStream;
71 import java.util.Arrays;
72
73 public class BookmarksDatabaseViewActivity extends AppCompatActivity implements EditBookmarkDatabaseViewDialog.EditBookmarkDatabaseViewListener,
74         EditBookmarkFolderDatabaseViewDialog.EditBookmarkFolderDatabaseViewListener {
75     // Define the class constants.
76     private static final int ALL_FOLDERS_DATABASE_ID = -2;
77     public static final int HOME_FOLDER_DATABASE_ID = -1;
78
79     // Define the saved instance state constants.
80     private final String CURRENT_FOLDER_DATABASE_ID = "current_folder_database_id";
81     private final String CURRENT_FOLDER_NAME = "current_folder_name";
82     private final String SORT_BY_DISPLAY_ORDER = "sort_by_display_order";
83
84     // Define the class variables.
85     private int currentFolderDatabaseId;
86     private String currentFolderName;
87     private boolean sortByDisplayOrder;
88     private BookmarksDatabaseHelper bookmarksDatabaseHelper;
89     private Cursor bookmarksCursor;
90     private CursorAdapter bookmarksCursorAdapter;
91     private String oldFolderNameString;
92     private Snackbar bookmarksDeletedSnackbar;
93     private boolean closeActivityAfterDismissingSnackbar;
94
95     @Override
96     public void onCreate(Bundle savedInstanceState) {
97         // Get a handle for the shared preferences.
98         SharedPreferences sharedPreferences = PreferenceManager.getDefaultSharedPreferences(this);
99
100         // Get the screenshot preference.
101         boolean allowScreenshots = sharedPreferences.getBoolean("allow_screenshots", false);
102
103         // Disable screenshots if not allowed.
104         if (!allowScreenshots) {
105             getWindow().addFlags(WindowManager.LayoutParams.FLAG_SECURE);
106         }
107
108         // Set the activity theme.
109         setTheme(R.style.PrivacyBrowser);
110
111         // Run the default commands.
112         super.onCreate(savedInstanceState);
113
114         // Get the intent that launched the activity.
115         Intent launchingIntent = getIntent();
116
117         // Get the favorite icon byte array.
118         byte[] favoriteIconByteArray = launchingIntent.getByteArrayExtra("favorite_icon_byte_array");
119
120         // Remove the incorrect lint warning below that the favorite icon byte array might be null.
121         assert favoriteIconByteArray != null;
122
123         // Convert the favorite icon byte array to a bitmap and store it in a class variable.
124         Bitmap favoriteIconBitmap = BitmapFactory.decodeByteArray(favoriteIconByteArray, 0, favoriteIconByteArray.length);
125
126         // Set the content view.
127         setContentView(R.layout.bookmarks_databaseview_coordinatorlayout);
128
129         // Get a handle for the toolbar.
130         Toolbar toolbar = findViewById(R.id.bookmarks_databaseview_toolbar);
131
132         // Set the support action bar.
133         setSupportActionBar(toolbar);
134
135         // Get a handle for the action bar.
136         ActionBar actionBar = getSupportActionBar();
137
138         // Remove the incorrect lint warning that the action bar might be null.
139         assert actionBar != null;
140
141         // Display the spinner and the back arrow in the action bar.
142         actionBar.setCustomView(R.layout.spinner);
143         actionBar.setDisplayOptions(ActionBar.DISPLAY_SHOW_CUSTOM | ActionBar.DISPLAY_HOME_AS_UP);
144
145         // Initialize the database handler.  The `0` is to specify a database version, but that is set instead using a constant in `BookmarksDatabaseHelper`.
146         bookmarksDatabaseHelper = new BookmarksDatabaseHelper(this, null, null, 0);
147
148         // Setup a matrix cursor for "All Folders" and "Home Folder".
149         String[] matrixCursorColumnNames = {BookmarksDatabaseHelper._ID, BookmarksDatabaseHelper.BOOKMARK_NAME};
150         MatrixCursor matrixCursor = new MatrixCursor(matrixCursorColumnNames);
151         matrixCursor.addRow(new Object[]{ALL_FOLDERS_DATABASE_ID, getString(R.string.all_folders)});
152         matrixCursor.addRow(new Object[]{HOME_FOLDER_DATABASE_ID, getString(R.string.home_folder)});
153
154         // Get a cursor with the list of all the folders.
155         Cursor foldersCursor = bookmarksDatabaseHelper.getAllFolders();
156
157         // Combine the matrix cursor and the folders cursor.
158         MergeCursor foldersMergeCursor = new MergeCursor(new Cursor[]{matrixCursor, foldersCursor});
159
160
161         // Get the default folder bitmap.  `ContextCompat` must be used until the minimum API >= 21.
162         Drawable defaultFolderDrawable = ContextCompat.getDrawable(getApplicationContext(), R.drawable.folder_blue_bitmap);
163
164         // Cast the default folder drawable to a bitmap drawable.
165         BitmapDrawable defaultFolderBitmapDrawable = (BitmapDrawable) defaultFolderDrawable;
166
167         // Remove the incorrect lint warning that `.getBitmap()` might be null.
168         assert defaultFolderBitmapDrawable != null;
169
170         // Convert the default folder bitmap drawable to a bitmap.
171         Bitmap defaultFolderBitmap = defaultFolderBitmapDrawable.getBitmap();
172
173
174         // Create a resource cursor adapter for the spinner.
175         ResourceCursorAdapter foldersCursorAdapter = new ResourceCursorAdapter(this, R.layout.appbar_spinner_item, foldersMergeCursor, 0) {
176             @Override
177             public void bindView(View view, Context context, Cursor cursor) {
178                 // Get handles for the spinner views.
179                 ImageView spinnerItemImageView = view.findViewById(R.id.spinner_item_imageview);
180                 TextView spinnerItemTextView = view.findViewById(R.id.spinner_item_textview);
181
182                 // Set the folder icon according to the type.
183                 if (foldersMergeCursor.getPosition() > 1) {  // Set a user folder icon.
184                     // Initialize a default folder icon byte array output stream.
185                     ByteArrayOutputStream defaultFolderIconByteArrayOutputStream = new ByteArrayOutputStream();
186
187                     // Covert the default folder bitmap to a PNG and store it in the output stream.  `0` is for lossless compression (the only option for a PNG).
188                     defaultFolderBitmap.compress(Bitmap.CompressFormat.PNG, 0, defaultFolderIconByteArrayOutputStream);
189
190                     // Convert the default folder icon output stream to a byte array.
191                     byte[] defaultFolderIconByteArray = defaultFolderIconByteArrayOutputStream.toByteArray();
192
193
194                     // Get the folder icon byte array from the cursor.
195                     byte[] folderIconByteArray = cursor.getBlob(cursor.getColumnIndex(BookmarksDatabaseHelper.FAVORITE_ICON));
196
197                     // Convert the byte array to a bitmap beginning at the first byte and ending at the last.
198                     Bitmap folderIconBitmap = BitmapFactory.decodeByteArray(folderIconByteArray, 0, folderIconByteArray.length);
199
200
201                     // Set the icon according to the type.
202                     if (Arrays.equals(folderIconByteArray, defaultFolderIconByteArray)) {  // The default folder icon is used.
203                         // Set a smaller and darker folder icon, which works well with the spinner.
204                         spinnerItemImageView.setImageDrawable(ContextCompat.getDrawable(context, R.drawable.folder_dark_blue));
205                     } else {  // A custom folder icon is uses.
206                         // Set the folder image stored in the cursor.
207                         spinnerItemImageView.setImageBitmap(folderIconBitmap);
208                     }
209                 } else {  // Set the `All Folders` or `Home Folder` icon.
210                     // Set the gray folder image.  `ContextCompat` must be used until the minimum API >= 21.
211                     spinnerItemImageView.setImageDrawable(ContextCompat.getDrawable(context, R.drawable.folder_gray));
212                 }
213
214                 // Set the text view to display the folder name.
215                 spinnerItemTextView.setText(cursor.getString(cursor.getColumnIndex(BookmarksDatabaseHelper.BOOKMARK_NAME)));
216             }
217         };
218
219         // Set the resource cursor adapter drop drown view resource.
220         foldersCursorAdapter.setDropDownViewResource(R.layout.appbar_spinner_dropdown_item);
221
222         // Get a handle for the folder spinner and set the adapter.
223         Spinner folderSpinner = findViewById(R.id.spinner);
224         folderSpinner.setAdapter(foldersCursorAdapter);
225
226         // Wait to set the on item selected listener until the spinner has been inflated.  Otherwise the activity will crash on restart.
227         folderSpinner.post(() -> {
228             // Handle taps on the spinner dropdown.
229             folderSpinner.setOnItemSelectedListener(new AdapterView.OnItemSelectedListener() {
230                 @Override
231                 public void onItemSelected(AdapterView<?> parent, View view, int position, long id) {
232                     // Store the current folder database ID.
233                     currentFolderDatabaseId = (int) id;
234
235                     // Get a handle for the selected view.
236                     TextView selectedFolderTextView = findViewById(R.id.spinner_item_textview);
237
238                     // Store the current folder name.
239                     currentFolderName = selectedFolderTextView.getText().toString();
240
241                     // Update the list view.
242                     updateBookmarksListView();
243                 }
244
245                 @Override
246                 public void onNothingSelected(AdapterView<?> parent) {
247                     // Do nothing.
248                 }
249             });
250         });
251
252
253         // Get a handle for the bookmarks listview.
254         ListView bookmarksListView = findViewById(R.id.bookmarks_databaseview_listview);
255
256         // Check to see if the activity was restarted.
257         if (savedInstanceState == null) {  // The activity was not restarted.
258             // Set the default current folder database ID.
259             currentFolderDatabaseId = ALL_FOLDERS_DATABASE_ID;
260         } else {  // The activity was restarted.
261             // Restore the class variables from the saved instance state.
262             currentFolderDatabaseId = savedInstanceState.getInt(CURRENT_FOLDER_DATABASE_ID);
263             currentFolderName = savedInstanceState.getString(CURRENT_FOLDER_NAME);
264             sortByDisplayOrder = savedInstanceState.getBoolean(SORT_BY_DISPLAY_ORDER);
265
266             // Update the spinner if the home folder is selected.  Android handles this by default for the main cursor but not the matrix cursor.
267             if (currentFolderDatabaseId == HOME_FOLDER_DATABASE_ID) {
268                 folderSpinner.setSelection(1);
269             }
270         }
271
272         // Update the bookmarks listview.
273         updateBookmarksListView();
274
275         // Setup a `CursorAdapter` with `this` context.  `false` disables autoRequery.
276         bookmarksCursorAdapter = new CursorAdapter(this, bookmarksCursor, false) {
277             @Override
278             public View newView(Context context, Cursor cursor, ViewGroup parent) {
279                 // Inflate the individual item layout.  `false` does not attach it to the root.
280                 return getLayoutInflater().inflate(R.layout.bookmarks_databaseview_item_linearlayout, parent, false);
281             }
282
283             @Override
284             public void bindView(View view, Context context, Cursor cursor) {
285                 boolean isFolder = (cursor.getInt(cursor.getColumnIndex(BookmarksDatabaseHelper.IS_FOLDER)) == 1);
286
287                 // Get the database ID from the `Cursor` and display it in `bookmarkDatabaseIdTextView`.
288                 int bookmarkDatabaseId = cursor.getInt(cursor.getColumnIndex(BookmarksDatabaseHelper._ID));
289                 TextView bookmarkDatabaseIdTextView = view.findViewById(R.id.bookmarks_databaseview_database_id);
290                 bookmarkDatabaseIdTextView.setText(String.valueOf(bookmarkDatabaseId));
291
292                 // Get the favorite icon byte array from the `Cursor`.
293                 byte[] favoriteIconByteArray = cursor.getBlob(cursor.getColumnIndex(BookmarksDatabaseHelper.FAVORITE_ICON));
294                 // Convert the byte array to a `Bitmap` beginning at the beginning at the first byte and ending at the last.
295                 Bitmap favoriteIconBitmap = BitmapFactory.decodeByteArray(favoriteIconByteArray, 0, favoriteIconByteArray.length);
296                 // Display the bitmap in `bookmarkFavoriteIcon`.
297                 ImageView bookmarkFavoriteIcon = view.findViewById(R.id.bookmarks_databaseview_favorite_icon);
298                 bookmarkFavoriteIcon.setImageBitmap(favoriteIconBitmap);
299
300                 // Get the bookmark name from the `Cursor` and display it in `bookmarkNameTextView`.
301                 String bookmarkNameString = cursor.getString(cursor.getColumnIndex(BookmarksDatabaseHelper.BOOKMARK_NAME));
302                 TextView bookmarkNameTextView = view.findViewById(R.id.bookmarks_databaseview_bookmark_name);
303                 bookmarkNameTextView.setText(bookmarkNameString);
304
305                 // Make the font bold for folders.
306                 if (isFolder) {
307                     // The first argument is `null` prevent changing of the font.
308                     bookmarkNameTextView.setTypeface(null, Typeface.BOLD);
309                 } else {  // Reset the font to default.
310                     bookmarkNameTextView.setTypeface(Typeface.DEFAULT);
311                 }
312
313                 // Get the bookmark URL form the `Cursor` and display it in `bookmarkUrlTextView`.
314                 String bookmarkUrlString = cursor.getString(cursor.getColumnIndex(BookmarksDatabaseHelper.BOOKMARK_URL));
315                 TextView bookmarkUrlTextView = view.findViewById(R.id.bookmarks_databaseview_bookmark_url);
316                 bookmarkUrlTextView.setText(bookmarkUrlString);
317
318                 // Hide the URL if the bookmark is a folder.
319                 if (isFolder) {
320                     bookmarkUrlTextView.setVisibility(View.GONE);
321                 } else {
322                     bookmarkUrlTextView.setVisibility(View.VISIBLE);
323                 }
324
325                 // Get the display order from the `Cursor` and display it in `bookmarkDisplayOrderTextView`.
326                 int bookmarkDisplayOrder = cursor.getInt(cursor.getColumnIndex(BookmarksDatabaseHelper.DISPLAY_ORDER));
327                 TextView bookmarkDisplayOrderTextView = view.findViewById(R.id.bookmarks_databaseview_display_order);
328                 bookmarkDisplayOrderTextView.setText(String.valueOf(bookmarkDisplayOrder));
329
330                 // Get the parent folder from the `Cursor` and display it in `bookmarkParentFolder`.
331                 String bookmarkParentFolder = cursor.getString(cursor.getColumnIndex(BookmarksDatabaseHelper.PARENT_FOLDER));
332                 ImageView parentFolderImageView = view.findViewById(R.id.bookmarks_databaseview_parent_folder_icon);
333                 TextView bookmarkParentFolderTextView = view.findViewById(R.id.bookmarks_databaseview_parent_folder);
334
335                 // Make the folder name gray if it is the home folder.
336                 if (bookmarkParentFolder.isEmpty()) {
337                     parentFolderImageView.setImageDrawable(ContextCompat.getDrawable(getApplicationContext(), R.drawable.folder_gray));
338                     bookmarkParentFolderTextView.setText(R.string.home_folder);
339                     bookmarkParentFolderTextView.setTextColor(ContextCompat.getColor(getApplicationContext(), R.color.gray_500));
340                 } else {
341                     parentFolderImageView.setImageDrawable(ContextCompat.getDrawable(getApplicationContext(), R.drawable.folder_dark_blue));
342                     bookmarkParentFolderTextView.setText(bookmarkParentFolder);
343
344                     // Get the current theme status.
345                     int currentThemeStatus = getResources().getConfiguration().uiMode & Configuration.UI_MODE_NIGHT_MASK;
346
347                     // Set the text color according to the theme.
348                     if (currentThemeStatus == Configuration.UI_MODE_NIGHT_YES) {
349                         // This color is a little darker than the default night mode text.  But the effect is rather nice.
350                         bookmarkParentFolderTextView.setTextColor(ContextCompat.getColor(getApplicationContext(), R.color.gray_300));
351                     } else {
352                         bookmarkParentFolderTextView.setTextColor(ContextCompat.getColor(getApplicationContext(), R.color.black));
353                     }
354                 }
355             }
356         };
357
358         // Update the ListView.
359         bookmarksListView.setAdapter(bookmarksCursorAdapter);
360
361         // Set a listener to edit a bookmark when it is tapped.
362         bookmarksListView.setOnItemClickListener((AdapterView<?> parent, View view, int position, long id) -> {
363             // Convert the database ID to an int.
364             int databaseId = (int) id;
365
366             // Show the edit bookmark or edit bookmark folder dialog.
367             if (bookmarksDatabaseHelper.isFolder(databaseId)) {
368                 // Save the current folder name, which is used in `onSaveBookmarkFolder()`.
369                 oldFolderNameString = bookmarksCursor.getString(bookmarksCursor.getColumnIndex(BookmarksDatabaseHelper.BOOKMARK_NAME));
370
371                 // Show the edit bookmark folder dialog.
372                 DialogFragment editBookmarkFolderDatabaseViewDialog = EditBookmarkFolderDatabaseViewDialog.folderDatabaseId(databaseId, favoriteIconBitmap);
373                 editBookmarkFolderDatabaseViewDialog.show(getSupportFragmentManager(), getResources().getString(R.string.edit_folder));
374             } else {
375                 // Show the edit bookmark dialog.
376                 DialogFragment editBookmarkDatabaseViewDialog = EditBookmarkDatabaseViewDialog.bookmarkDatabaseId(databaseId, favoriteIconBitmap);
377                 editBookmarkDatabaseViewDialog.show(getSupportFragmentManager(), getResources().getString(R.string.edit_bookmark));
378             }
379         });
380
381         // Handle long presses on the list view.
382         bookmarksListView.setMultiChoiceModeListener(new AbsListView.MultiChoiceModeListener() {
383             // Instantiate the common variables.
384             MenuItem selectAllMenuItem;
385             MenuItem deleteMenuItem;
386             boolean deletingBookmarks;
387
388             @Override
389             public boolean onCreateActionMode(ActionMode mode, Menu menu) {
390                 // Inflate the menu for the contextual app bar.
391                 getMenuInflater().inflate(R.menu.bookmarks_databaseview_context_menu, menu);
392
393                 // Set the title.
394                 mode.setTitle(R.string.bookmarks);
395
396                 // Get handles for the menu items.
397                 selectAllMenuItem = menu.findItem(R.id.select_all);
398                 deleteMenuItem = menu.findItem(R.id.delete);
399
400                 // Disable the delete menu item if a delete is pending.
401                 deleteMenuItem.setEnabled(!deletingBookmarks);
402
403                 // Get the number of currently selected bookmarks.
404                 int numberOfSelectedBookmarks = bookmarksListView.getCheckedItemCount();
405
406                 // Set the action mode subtitle according to the number of selected bookmarks.  This must be set here or it will be missing if the activity is restarted.
407                 mode.setSubtitle(getString(R.string.selected) + "  " + numberOfSelectedBookmarks);
408
409                 // Do not show the select all menu item if all the bookmarks are already checked.
410                 if (bookmarksListView.getCheckedItemCount() == bookmarksListView.getCount()) {
411                     selectAllMenuItem.setVisible(false);
412                 }
413
414                 // Make it so.
415                 return true;
416             }
417
418             @Override
419             public boolean onPrepareActionMode(ActionMode mode, Menu menu) {
420                 // Do nothing.
421                 return false;
422             }
423
424             @Override
425             public void onItemCheckedStateChanged(ActionMode mode, int position, long id, boolean checked) {
426                 // Calculate the number of selected bookmarks.
427                 int numberOfSelectedBookmarks = bookmarksListView.getCheckedItemCount();
428
429                 // Update the action mode subtitle according to the number of selected bookmarks.
430                 mode.setSubtitle(getString(R.string.selected) + "  " + numberOfSelectedBookmarks);
431
432                 // Update the visibility of the the select all menu.
433                 if (bookmarksListView.getCheckedItemCount() == bookmarksListView.getCount()) {  // All of the bookmarks are checked.
434                     // Hide the select all menu item.
435                     selectAllMenuItem.setVisible(false);
436                 } else {  // Not all of the bookmarks are checked.
437                     // Show the select all menu item.
438                     selectAllMenuItem.setVisible(true);
439                 }
440
441                 // Convert the database ID to an int.
442                 int databaseId = (int) id;
443
444                 // If a folder was selected, also select all the contents.
445                 if (checked && bookmarksDatabaseHelper.isFolder(databaseId)) {
446                     selectAllBookmarksInFolder(databaseId);
447                 }
448
449                 // Do not allow a bookmark to be deselected if the folder is selected.
450                 if (!checked) {
451                     // Get the folder name.
452                     String folderName = bookmarksDatabaseHelper.getParentFolderName((int) id);
453
454                     // If the bookmark is not in the root folder, check to see if the folder is selected.
455                     if (!folderName.isEmpty()) {
456                         // Get the database ID of the folder.
457                         int folderDatabaseId = bookmarksDatabaseHelper.getFolderDatabaseId(folderName);
458
459                         // Move the bookmarks cursor to the first position.
460                         bookmarksCursor.moveToFirst();
461
462                         // Initialize the folder position variable.
463                         int folderPosition = -1;
464
465                         // Get the position of the folder in the bookmarks cursor.
466                         while ((folderPosition < 0) && (bookmarksCursor.getPosition() < bookmarksCursor.getCount())) {
467                             // Check if the folder database ID matches the bookmark database ID.
468                             if (folderDatabaseId == bookmarksCursor.getInt((bookmarksCursor.getColumnIndex(BookmarksDatabaseHelper._ID)))) {
469                                 // Get the folder position.
470                                 folderPosition = bookmarksCursor.getPosition();
471
472                                 // Check if the folder is selected.
473                                 if (bookmarksListView.isItemChecked(folderPosition)) {
474                                     // Reselect the bookmark.
475                                     bookmarksListView.setItemChecked(position, true);
476
477                                     // Display a snackbar explaining why the bookmark cannot be deselected.
478                                     Snackbar.make(bookmarksListView, R.string.cannot_deselect_bookmark, Snackbar.LENGTH_LONG).show();
479                                 }
480                             }
481
482                             // Increment the bookmarks cursor.
483                             bookmarksCursor.moveToNext();
484                         }
485                     }
486                 }
487             }
488
489             @Override
490             public boolean onActionItemClicked(ActionMode mode, MenuItem item) {
491                 switch (item.getItemId()) {
492                     case R.id.select_all:
493                         // Get the total number of bookmarks.
494                         int numberOfBookmarks = bookmarksListView.getCount();
495
496                         // Select them all.
497                         for (int i = 0; i < numberOfBookmarks; i++) {
498                             bookmarksListView.setItemChecked(i, true);
499                         }
500                         break;
501
502                     case R.id.delete:
503                         // Set the deleting bookmarks flag, which prevents the delete menu item from being enabled until the current process finishes.
504                         deletingBookmarks = true;
505
506                         // Get an array of the selected row IDs.
507                         long[] selectedBookmarksIdsLongArray = bookmarksListView.getCheckedItemIds();
508
509                         // Get an array of checked bookmarks.  `.clone()` makes a copy that won't change if the list view is reloaded, which is needed for re-selecting the bookmarks on undelete.
510                         SparseBooleanArray selectedBookmarksPositionsSparseBooleanArray = bookmarksListView.getCheckedItemPositions().clone();
511
512                         // Update the bookmarks cursor with the current contents of the bookmarks database except for the specified database IDs.
513                         switch (currentFolderDatabaseId) {
514                             // Get a cursor with all the folders.
515                             case ALL_FOLDERS_DATABASE_ID:
516                                 if (sortByDisplayOrder) {
517                                     bookmarksCursor = bookmarksDatabaseHelper.getAllBookmarksByDisplayOrderExcept(selectedBookmarksIdsLongArray);
518                                 } else {
519                                     bookmarksCursor = bookmarksDatabaseHelper.getAllBookmarksExcept(selectedBookmarksIdsLongArray);
520                                 }
521                                 break;
522
523                             // Get a cursor for the home folder.
524                             case HOME_FOLDER_DATABASE_ID:
525                                 if (sortByDisplayOrder) {
526                                     bookmarksCursor = bookmarksDatabaseHelper.getBookmarksByDisplayOrderExcept(selectedBookmarksIdsLongArray, "");
527                                 } else {
528                                     bookmarksCursor = bookmarksDatabaseHelper.getBookmarksExcept(selectedBookmarksIdsLongArray, "");
529                                 }
530                                 break;
531
532                             // Display the selected folder.
533                             default:
534                                 // Get a cursor for the selected folder.
535                                 if (sortByDisplayOrder) {
536                                     bookmarksCursor = bookmarksDatabaseHelper.getBookmarksByDisplayOrderExcept(selectedBookmarksIdsLongArray, currentFolderName);
537                                 } else {
538                                     bookmarksCursor = bookmarksDatabaseHelper.getBookmarksExcept(selectedBookmarksIdsLongArray, currentFolderName);
539                                 }
540                         }
541
542                         // Update the list view.
543                         bookmarksCursorAdapter.changeCursor(bookmarksCursor);
544
545                         // Create a Snackbar with the number of deleted bookmarks.
546                         bookmarksDeletedSnackbar = Snackbar.make(findViewById(R.id.bookmarks_databaseview_coordinatorlayout),
547                                 getString(R.string.bookmarks_deleted) + "  " + selectedBookmarksIdsLongArray.length, Snackbar.LENGTH_LONG)
548                                 .setAction(R.string.undo, view -> {
549                                     // Do nothing because everything will be handled by `onDismissed()` below.
550                                 })
551                                 .addCallback(new Snackbar.Callback() {
552                                     @SuppressLint("SwitchIntDef")  // Ignore the lint warning about not handling the other possible events as they are covered by `default:`.
553                                     @Override
554                                     public void onDismissed(Snackbar snackbar, int event) {
555                                         if (event == Snackbar.Callback.DISMISS_EVENT_ACTION) {  // The user pushed the undo button.
556                                             // Update the bookmarks list view with the current contents of the bookmarks database, including the "deleted bookmarks.
557                                             updateBookmarksListView();
558
559                                             // Re-select the previously selected bookmarks.
560                                             for (int i = 0; i < selectedBookmarksPositionsSparseBooleanArray.size(); i++) {
561                                                 bookmarksListView.setItemChecked(selectedBookmarksPositionsSparseBooleanArray.keyAt(i), true);
562                                             }
563                                         } else {  // The Snackbar was dismissed without the undo button being pushed.
564                                             // Delete each selected bookmark.
565                                             for (long databaseIdLong : selectedBookmarksIdsLongArray) {
566                                                 // Convert `databaseIdLong` to an int.
567                                                 int databaseIdInt = (int) databaseIdLong;
568
569                                                 // Delete the selected bookmark.
570                                                 bookmarksDatabaseHelper.deleteBookmark(databaseIdInt);
571                                             }
572                                         }
573
574                                         // Reset the deleting bookmarks flag.
575                                         deletingBookmarks = false;
576
577                                         // Enable the delete menu item.
578                                         deleteMenuItem.setEnabled(true);
579
580                                         // Close the activity if back has been pressed.
581                                         if (closeActivityAfterDismissingSnackbar) {
582                                             onBackPressed();
583                                         }
584                                     }
585                                 });
586
587                         // Show the Snackbar.
588                         bookmarksDeletedSnackbar.show();
589                         break;
590                 }
591
592                 // Consume the click.
593                 return false;
594             }
595
596             @Override
597             public void onDestroyActionMode(ActionMode mode) {
598                 // Do nothing.
599             }
600         });
601     }
602
603     @Override
604     public boolean onCreateOptionsMenu(Menu menu) {
605         // Inflate the menu.
606         getMenuInflater().inflate(R.menu.bookmarks_databaseview_options_menu, menu);
607
608         // Get the current theme status.
609         int currentThemeStatus = getResources().getConfiguration().uiMode & Configuration.UI_MODE_NIGHT_MASK;
610
611         // Get a handle for the sort menu item.
612         MenuItem sortMenuItem = menu.findItem(R.id.sort);
613
614         // Change the sort menu item icon if the listview is sorted by display order, which restores the state after a restart.
615         if (sortByDisplayOrder) {
616             if (currentThemeStatus == Configuration.UI_MODE_NIGHT_NO) {
617                 sortMenuItem.setIcon(R.drawable.sort_selected_day);
618             } else {
619                 sortMenuItem.setIcon(R.drawable.sort_selected_night);
620             }
621         }
622
623         // Success.
624         return true;
625     }
626
627     @Override
628     public boolean onOptionsItemSelected(MenuItem menuItem) {
629         // Get the ID of the menu item that was selected.
630         int menuItemId = menuItem.getItemId();
631
632         // Run the command that corresponds to the selected menu item.
633         switch (menuItemId) {
634             case android.R.id.home:  // The home arrow is identified as `android.R.id.home`, not just `R.id.home`.
635                 // Exit the activity.
636                 onBackPressed();
637                 break;
638
639             case R.id.sort:
640                 // Update the sort by display order tracker.
641                 sortByDisplayOrder = !sortByDisplayOrder;
642
643                 // Get a handle for the bookmarks list view.
644                 ListView bookmarksListView = findViewById(R.id.bookmarks_databaseview_listview);
645
646                 // Get the current theme status.
647                 int currentThemeStatus = getResources().getConfiguration().uiMode & Configuration.UI_MODE_NIGHT_MASK;
648
649                 // Update the icon and display a snackbar.
650                 if (sortByDisplayOrder) {  // Sort by display order.
651                     // Update the icon according to the theme.
652                     if (currentThemeStatus == Configuration.UI_MODE_NIGHT_NO) {
653                         menuItem.setIcon(R.drawable.sort_selected_day);
654                     } else {
655                         menuItem.setIcon(R.drawable.sort_selected_night);
656                     }
657
658                     // Display a Snackbar indicating the current sort type.
659                     Snackbar.make(bookmarksListView, R.string.sorted_by_display_order, Snackbar.LENGTH_SHORT).show();
660                 } else {  // Sort by database id.
661                     // Update the icon according to the theme.
662                     if (currentThemeStatus == Configuration.UI_MODE_NIGHT_NO) {
663                         menuItem.setIcon(R.drawable.sort_day);
664                     } else {
665                         menuItem.setIcon(R.drawable.sort_night);
666                     }
667
668                     // Display a Snackbar indicating the current sort type.
669                     Snackbar.make(bookmarksListView, R.string.sorted_by_database_id, Snackbar.LENGTH_SHORT).show();
670                 }
671
672                 // Update the list view.
673                 updateBookmarksListView();
674                 break;
675         }
676         return true;
677     }
678
679     @Override
680     public void onSaveInstanceState (@NonNull Bundle savedInstanceState) {
681         // Run the default commands.
682         super.onSaveInstanceState(savedInstanceState);
683
684         // Store the class variables in the bundle.
685         savedInstanceState.putInt(CURRENT_FOLDER_DATABASE_ID, currentFolderDatabaseId);
686         savedInstanceState.putString(CURRENT_FOLDER_NAME, currentFolderName);
687         savedInstanceState.putBoolean(SORT_BY_DISPLAY_ORDER, sortByDisplayOrder);
688     }
689
690     @Override
691     public void onBackPressed() {
692         // Check to see if a snackbar is currently displayed.  If so, it must be closed before existing so that a pending delete is completed before reloading the list view in the bookmarks activity.
693         if ((bookmarksDeletedSnackbar != null) && bookmarksDeletedSnackbar.isShown()) { // Close the bookmarks deleted snackbar before going home.
694             // Set the close flag.
695             closeActivityAfterDismissingSnackbar = true;
696
697             // Dismiss the snackbar.
698             bookmarksDeletedSnackbar.dismiss();
699         } else {  // Go home immediately.
700             // Update the current folder in the bookmarks activity.
701             if ((currentFolderDatabaseId == ALL_FOLDERS_DATABASE_ID) || (currentFolderDatabaseId == HOME_FOLDER_DATABASE_ID)) {  // All folders or the the home folder are currently displayed.
702                 // Load the home folder.
703                 BookmarksActivity.currentFolder = "";
704             } else {  // A subfolder is currently displayed.
705                 // Load the current folder.
706                 BookmarksActivity.currentFolder = currentFolderName;
707             }
708
709             // Reload the bookmarks list view when returning to the bookmarks activity.
710             BookmarksActivity.restartFromBookmarksDatabaseViewActivity = true;
711
712             // Exit the bookmarks database view activity.
713             super.onBackPressed();
714         }
715     }
716
717     private void updateBookmarksListView() {
718         // Populate the bookmarks list view based on the spinner selection.
719         switch (currentFolderDatabaseId) {
720             // Get a cursor with all the folders.
721             case ALL_FOLDERS_DATABASE_ID:
722                 if (sortByDisplayOrder) {
723                     bookmarksCursor = bookmarksDatabaseHelper.getAllBookmarksByDisplayOrder();
724                 } else {
725                     bookmarksCursor = bookmarksDatabaseHelper.getAllBookmarks();
726                 }
727                 break;
728
729             // Get a cursor for the home folder.
730             case HOME_FOLDER_DATABASE_ID:
731                 if (sortByDisplayOrder) {
732                     bookmarksCursor = bookmarksDatabaseHelper.getBookmarksByDisplayOrder("");
733                 } else {
734                     bookmarksCursor = bookmarksDatabaseHelper.getBookmarks("");
735                 }
736                 break;
737
738             // Display the selected folder.
739             default:
740                 // Get a cursor for the selected folder.
741                 if (sortByDisplayOrder) {
742                     bookmarksCursor = bookmarksDatabaseHelper.getBookmarksByDisplayOrder(currentFolderName);
743                 } else {
744                     bookmarksCursor = bookmarksDatabaseHelper.getBookmarks(currentFolderName);
745                 }
746         }
747
748         // Update the cursor adapter if it isn't null, which happens when the activity is restarted.
749         if (bookmarksCursorAdapter != null) {
750             bookmarksCursorAdapter.changeCursor(bookmarksCursor);
751         }
752     }
753
754     private void selectAllBookmarksInFolder(int folderId) {
755         // Get a handle for the bookmarks list view.
756         ListView bookmarksListView = findViewById(R.id.bookmarks_databaseview_listview);
757
758         // Get the folder name.
759         String folderName = bookmarksDatabaseHelper.getFolderName(folderId);
760
761         // Get a cursor with the contents of the folder.
762         Cursor folderCursor = bookmarksDatabaseHelper.getBookmarks(folderName);
763
764         // Move to the beginning of the cursor.
765         folderCursor.moveToFirst();
766
767         while (folderCursor.getPosition() < folderCursor.getCount()) {
768             // Get the bookmark database ID.
769             int bookmarkId = folderCursor.getInt(folderCursor.getColumnIndex(BookmarksDatabaseHelper._ID));
770
771             // Move the bookmarks cursor to the first position.
772             bookmarksCursor.moveToFirst();
773
774             // Initialize the bookmark position variable.
775             int bookmarkPosition = -1;
776
777             // Get the position of this bookmark in the bookmarks cursor.
778             while ((bookmarkPosition < 0) && (bookmarksCursor.getPosition() < bookmarksCursor.getCount())) {
779                 // Check if the bookmark IDs match.
780                 if (bookmarkId == bookmarksCursor.getInt(bookmarksCursor.getColumnIndex(BookmarksDatabaseHelper._ID))) {
781                     // Get the bookmark position.
782                     bookmarkPosition = bookmarksCursor.getPosition();
783
784                     // If this bookmark is a folder, select all the bookmarks inside it.
785                     if (bookmarksDatabaseHelper.isFolder(bookmarkId)) {
786                         selectAllBookmarksInFolder(bookmarkId);
787                     }
788
789                     // Select the bookmark.
790                     bookmarksListView.setItemChecked(bookmarkPosition, true);
791                 }
792
793                 // Increment the bookmarks cursor position.
794                 bookmarksCursor.moveToNext();
795             }
796
797             // Move to the next position.
798             folderCursor.moveToNext();
799         }
800     }
801
802     @Override
803     public void onSaveBookmark(DialogFragment dialogFragment, int selectedBookmarkDatabaseId, @NonNull Bitmap favoriteIconBitmap) {
804         // Get the dialog from the dialog fragment.
805         Dialog dialog = dialogFragment.getDialog();
806
807         // Remove the incorrect lint warning below that the dialog might be null.
808         assert dialog != null;
809
810         // Get handles for the views from dialog fragment.
811         RadioButton currentBookmarkIconRadioButton = dialog.findViewById(R.id.edit_bookmark_current_icon_radiobutton);
812         EditText editBookmarkNameEditText = dialog.findViewById(R.id.edit_bookmark_name_edittext);
813         EditText editBookmarkUrlEditText = dialog.findViewById(R.id.edit_bookmark_url_edittext);
814         Spinner folderSpinner = dialog.findViewById(R.id.edit_bookmark_folder_spinner);
815         EditText displayOrderEditText = dialog.findViewById(R.id.edit_bookmark_display_order_edittext);
816
817         // Extract the bookmark information.
818         String bookmarkNameString = editBookmarkNameEditText.getText().toString();
819         String bookmarkUrlString = editBookmarkUrlEditText.getText().toString();
820         int folderDatabaseId = (int) folderSpinner.getSelectedItemId();
821         int displayOrderInt = Integer.parseInt(displayOrderEditText.getText().toString());
822
823         // Instantiate the parent folder name `String`.
824         String parentFolderNameString;
825
826         // Set the parent folder name.
827         if (folderDatabaseId == HOME_FOLDER_DATABASE_ID) {  // The home folder is selected.  Use `""`.
828             parentFolderNameString = "";
829         } else {  // Get the parent folder name from the database.
830             parentFolderNameString = bookmarksDatabaseHelper.getFolderName(folderDatabaseId);
831         }
832
833         // Update the bookmark.
834         if (currentBookmarkIconRadioButton.isChecked()) {  // Update the bookmark without changing the favorite icon.
835             bookmarksDatabaseHelper.updateBookmark(selectedBookmarkDatabaseId, bookmarkNameString, bookmarkUrlString, parentFolderNameString, displayOrderInt);
836         } else {  // Update the bookmark using the `WebView` favorite icon.
837             // Create a favorite icon byte array output stream.
838             ByteArrayOutputStream newFavoriteIconByteArrayOutputStream = new ByteArrayOutputStream();
839
840             // Convert the favorite icon bitmap to a byte array.  `0` is for lossless compression (the only option for a PNG).
841             favoriteIconBitmap.compress(Bitmap.CompressFormat.PNG, 0, newFavoriteIconByteArrayOutputStream);
842
843             // Convert the favorite icon byte array stream to a byte array.
844             byte[] newFavoriteIconByteArray = newFavoriteIconByteArrayOutputStream.toByteArray();
845
846             //  Update the bookmark and the favorite icon.
847             bookmarksDatabaseHelper.updateBookmark(selectedBookmarkDatabaseId, bookmarkNameString, bookmarkUrlString, parentFolderNameString, displayOrderInt, newFavoriteIconByteArray);
848         }
849
850         // Update the list view.
851         updateBookmarksListView();
852     }
853
854     @Override
855     public void onSaveBookmarkFolder(DialogFragment dialogFragment, int selectedBookmarkDatabaseId, Bitmap favoriteIconBitmap) {
856         // Get the dialog from the dialog fragment.
857         Dialog dialog = dialogFragment.getDialog();
858
859         // Remove the incorrect lint warning below that the dialog might be null.
860         assert dialog != null;
861
862         // Get handles for the views from dialog fragment.
863         RadioButton currentBookmarkIconRadioButton = dialog.findViewById(R.id.edit_folder_current_icon_radiobutton);
864         RadioButton defaultFolderIconRadioButton = dialog.findViewById(R.id.edit_folder_default_icon_radiobutton);
865         ImageView defaultFolderIconImageView = dialog.findViewById(R.id.edit_folder_default_icon_imageview);
866         EditText editBookmarkNameEditText = dialog.findViewById(R.id.edit_folder_name_edittext);
867         Spinner parentFolderSpinner = dialog.findViewById(R.id.edit_folder_parent_folder_spinner);
868         EditText displayOrderEditText = dialog.findViewById(R.id.edit_folder_display_order_edittext);
869
870         // Extract the folder information.
871         String newFolderNameString = editBookmarkNameEditText.getText().toString();
872         int parentFolderDatabaseId = (int) parentFolderSpinner.getSelectedItemId();
873         int displayOrderInt = Integer.parseInt(displayOrderEditText.getText().toString());
874
875         // Instantiate the parent folder name `String`.
876         String parentFolderNameString;
877
878         // Set the parent folder name.
879         if (parentFolderDatabaseId == HOME_FOLDER_DATABASE_ID) {  // The home folder is selected.  Use `""`.
880             parentFolderNameString = "";
881         } else {  // Get the parent folder name from the database.
882             parentFolderNameString = bookmarksDatabaseHelper.getFolderName(parentFolderDatabaseId);
883         }
884
885         // Update the folder.
886         if (currentBookmarkIconRadioButton.isChecked()) {  // Update the folder without changing the favorite icon.
887             bookmarksDatabaseHelper.updateFolder(selectedBookmarkDatabaseId, oldFolderNameString, newFolderNameString, parentFolderNameString, displayOrderInt);
888         } else {  // Update the folder and the icon.
889             // Create the new folder icon Bitmap.
890             Bitmap folderIconBitmap;
891
892             // Populate the new folder icon bitmap.
893             if (defaultFolderIconRadioButton.isChecked()) {
894                 // Get the default folder icon drawable.
895                 Drawable folderIconDrawable = defaultFolderIconImageView.getDrawable();
896
897                 // Convert the folder icon drawable to a bitmap drawable.
898                 BitmapDrawable folderIconBitmapDrawable = (BitmapDrawable) folderIconDrawable;
899
900                 // Convert the folder icon bitmap drawable to a bitmap.
901                 folderIconBitmap = folderIconBitmapDrawable.getBitmap();
902             } else {  // Use the `WebView` favorite icon.
903                 // Get a copy of the favorite icon bitmap.
904                 folderIconBitmap = favoriteIconBitmap;
905             }
906
907             // Create a folder icon byte array output stream.
908             ByteArrayOutputStream newFolderIconByteArrayOutputStream = new ByteArrayOutputStream();
909
910             // Convert the folder icon bitmap to a byte array.  `0` is for lossless compression (the only option for a PNG).
911             folderIconBitmap.compress(Bitmap.CompressFormat.PNG, 0, newFolderIconByteArrayOutputStream);
912
913             // Convert the folder icon byte array stream to a byte array.
914             byte[] newFolderIconByteArray = newFolderIconByteArrayOutputStream.toByteArray();
915
916             //  Update the folder and the icon.
917             bookmarksDatabaseHelper.updateFolder(selectedBookmarkDatabaseId, oldFolderNameString, newFolderNameString, parentFolderNameString, displayOrderInt, newFolderIconByteArray);
918         }
919
920         // Update the list view.
921         updateBookmarksListView();
922     }
923
924     @Override
925     public void onDestroy() {
926         // Close the bookmarks cursor and database.
927         bookmarksCursor.close();
928         bookmarksDatabaseHelper.close();
929
930         // Run the default commands.
931         super.onDestroy();
932     }
933 }