Create Java subpackage folders.
[PrivacyBrowser.git] / app / src / main / java / com / stoutner / privacybrowser / dialogs / DownloadFile.java
1 /**
2  * Copyright 2016 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.dialogs;
21
22 import android.annotation.SuppressLint;
23 import android.app.Dialog;
24 import android.content.Context;
25 import android.content.DialogInterface;
26 import android.net.Uri;
27 import android.os.Bundle;
28 import android.support.annotation.NonNull;
29 // `android.support.v7.app.AlertDialog` uses more of the horizontal screen real estate versus `android.app.AlertDialog's` smaller width.
30 import android.support.v7.app.AlertDialog;
31 // We have to use `AppCompatDialogFragment` instead of `DialogFragment` or an error is produced on API <=22.
32 import android.support.v7.app.AppCompatDialogFragment;
33 import android.view.KeyEvent;
34 import android.view.LayoutInflater;
35 import android.view.View;
36 import android.view.WindowManager;
37 import android.widget.EditText;
38 import android.widget.TextView;
39
40 import com.stoutner.privacybrowser.R;
41
42 import java.util.Locale;
43
44 public class DownloadFile extends AppCompatDialogFragment {
45
46     private String downloadUrl;
47     private String downloadFileName;
48     private String fileSize;
49
50     public static DownloadFile fromUrl(String urlString, String contentDisposition, long contentLength) {
51         // Create `argumentsBundle`.
52         Bundle argumentsBundle = new Bundle();
53
54         String fileNameString;
55
56         // Parse `filename` from `contentDisposition`.
57         if (contentDisposition.contains("filename=\"")) {  // The file name is contained in a string surrounded by `""`.
58             fileNameString = contentDisposition.substring(contentDisposition.indexOf("filename=\"") + 10, contentDisposition.indexOf("\"", contentDisposition.indexOf("filename=\"") + 10));
59         } else if (contentDisposition.contains("filename=") && ((contentDisposition.indexOf(";", contentDisposition.indexOf("filename=") + 9)) > 0 )) {  // The file name is contained in a string beginning with `filename=` and ending with `;`.
60             fileNameString = contentDisposition.substring(contentDisposition.indexOf("filename=") + 9, contentDisposition.indexOf(";", contentDisposition.indexOf("filename=") + 9));
61         } else if (contentDisposition.contains("filename=")) {  // The file name is contained in a string beginning with `filename=` and proceeding to the end of `contentDisposition`.
62             fileNameString = contentDisposition.substring(contentDisposition.indexOf("filename=") + 9, contentDisposition.length());
63         } else {  // `contentDisposition` does not contain the filename, so use the last path segment of the URL.
64             Uri downloadUri = Uri.parse(urlString);
65             fileNameString = downloadUri.getLastPathSegment();
66         }
67
68         // Store the variables in the `Bundle`.
69         argumentsBundle.putString("URL", urlString);
70         argumentsBundle.putString("File_Name", fileNameString);
71         argumentsBundle.putLong("File_Size", contentLength);
72
73         // Add `argumentsBundle` to this instance of `DownloadFile`.
74         DownloadFile thisDownloadFileDialog = new DownloadFile();
75         thisDownloadFileDialog.setArguments(argumentsBundle);
76         return thisDownloadFileDialog;
77     }
78
79     @Override
80     public void onCreate(Bundle savedInstanceState) {
81         super.onCreate(savedInstanceState);
82
83         // Store the strings in the local class variables.
84         downloadUrl = getArguments().getString("URL");
85         downloadFileName = getArguments().getString("File_Name");
86
87         // Get the `File_Size`.
88         long fileSizeLong = getArguments().getLong("File_Size");
89
90         // Convert `fileSizeLong` to a String.
91         if (fileSizeLong == -1) {  // We don't know the file size.
92             fileSize = getString(R.string.unknown_size);
93         } else {  // Convert `fileSize` to MB and store it in `fileSizeString`.  `%.3g` displays the three most significant digits.
94             fileSize = String.format(Locale.getDefault(), "%.3g", (float) fileSizeLong / 1048576) + " MB";
95         }
96     }
97
98     // The public interface is used to send information back to the parent activity.
99     public interface DownloadFileListener {
100         void onDownloadFile(AppCompatDialogFragment dialogFragment, String downloadUrl);
101     }
102
103     // `downloadFileListener` is used in `onAttach()` and `onCreateDialog()`.
104     private DownloadFileListener downloadFileListener;
105
106     @Override
107     public void onAttach(Context context) {
108         super.onAttach(context);
109
110         // Check to make sure the parent activity implements the listener.
111         try {
112             downloadFileListener = (DownloadFileListener) context;
113         } catch (ClassCastException exception) {
114             throw new ClassCastException(context.toString() + " must implement DownloadFileListener.");
115         }
116     }
117
118     @Override
119     @NonNull
120     // `@SuppressLing("InflateParams")` removes the warning about using `null` as the parent view group when inflating the `AlertDialog`.
121     @SuppressLint("InflateParams")
122     public Dialog onCreateDialog(Bundle savedInstanceState) {
123         // Get the activity's layout inflater.
124         LayoutInflater layoutInflater = getActivity().getLayoutInflater();
125
126         // Use `AlertDialog.Builder` to create the `AlertDialog`.  `R.style.lightAlertDialog` formats the color of the button text.
127         AlertDialog.Builder dialogBuilder = new AlertDialog.Builder(getActivity(), R.style.LightAlertDialog);
128
129         // Set the title.
130         dialogBuilder.setTitle(R.string.save_as);
131
132         // Set the view.  The parent view is `null` because it will be assigned by `AlertDialog`.
133         dialogBuilder.setView(layoutInflater.inflate(R.layout.download_file_dialog, null));
134
135         // Set an `onClick()` listener on the negative button.
136         dialogBuilder.setNegativeButton(R.string.cancel, new DialogInterface.OnClickListener() {
137             @Override
138             public void onClick(DialogInterface dialog, int which) {
139                 // Do nothing if `Cancel` is clicked.  The `Dialog` will automatically close.
140             }
141         });
142
143         // Set an `onClick()` listener on the positive button
144         dialogBuilder.setPositiveButton(R.string.download, new DialogInterface.OnClickListener() {
145             @Override
146             public void onClick(DialogInterface dialog, int which) {
147                 // trigger `onDownloadFile()` and return the `DialogFragment` and the download URL to the parent activity.
148                 downloadFileListener.onDownloadFile(DownloadFile.this, downloadUrl);
149             }
150         });
151
152         // Create an `AlertDialog` from the `AlertDialog.Builder`.
153         final AlertDialog alertDialog = dialogBuilder.create();
154
155         // Remove the warning below that `setSoftInputMode` might produce `java.lang.NullPointerException`.
156         assert alertDialog.getWindow() != null;
157
158         // Show the keyboard when `alertDialog` is displayed on the screen.
159         alertDialog.getWindow().setSoftInputMode(WindowManager.LayoutParams.SOFT_INPUT_STATE_ALWAYS_VISIBLE);
160
161         // We need to show `alertDialog` before we can modify the contents.
162         alertDialog.show();
163
164         // Set the text for `downloadFileSizeTextView`.
165         TextView downloadFileSizeTextView = (TextView) alertDialog.findViewById(R.id.download_file_size);
166         assert downloadFileSizeTextView != null;  // Remove the warning on the following line that `downloadFileSizeTextView` might be `null`.
167         downloadFileSizeTextView.setText(fileSize);
168
169         // Set the text for `downloadFileNameTextView`.
170         EditText downloadFileNameTextView = (EditText) alertDialog.findViewById(R.id.download_file_name);
171         assert downloadFileNameTextView != null;  // Remove the warning on the following line that `downloadFileNameTextView` might be `null`.
172         downloadFileNameTextView.setText(downloadFileName);
173
174         // Allow the `enter` key on the keyboard to save the file from `downloadFileNameTextView`.
175         downloadFileNameTextView.setOnKeyListener(new View.OnKeyListener() {
176             @Override
177             public boolean onKey (View v, int keyCode, KeyEvent event) {
178                 // If the event is an `ACTION_DOWN` on the `enter` key, initiate the download.
179                 if ((event.getAction() == KeyEvent.ACTION_DOWN) && (keyCode == KeyEvent.KEYCODE_ENTER)) {
180                     // trigger `onDownloadFile()` and return the `DialogFragment` and the URL to the parent activity.
181                     downloadFileListener.onDownloadFile(DownloadFile.this, downloadUrl);
182                     // Manually dismiss `alertDialog`.
183                     alertDialog.dismiss();
184                     // Consume the event.
185                     return true;
186                 } else {  // If any other key was pressed, do not consume the event.
187                     return false;
188                 }
189             }
190         });
191
192         // `onCreateDialog` requires the return of an `AlertDialog`.
193         return alertDialog;
194     }
195 }