2 * ownCloud Android client application
4 * @author Bartek Przybylski
5 * @author David A. Velasco
6 * Copyright (C) 2011 Bartek Przybylski
7 * Copyright (C) 2015 ownCloud Inc.
9 * This program is free software: you can redistribute it and/or modify
10 * it under the terms of the GNU General Public License version 2,
11 * as published by the Free Software Foundation.
13 * This program is distributed in the hope that it will be useful,
14 * but WITHOUT ANY WARRANTY; without even the implied warranty of
15 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
16 * GNU General Public License for more details.
18 * You should have received a copy of the GNU General Public License
19 * along with this program. If not, see <http://www.gnu.org/licenses/>.
22 package com
.owncloud
.android
.ui
.fragment
;
24 import android
.accounts
.Account
;
25 import android
.os
.Bundle
;
26 import android
.view
.LayoutInflater
;
27 import android
.view
.Menu
;
28 import android
.view
.MenuInflater
;
29 import android
.view
.MenuItem
;
30 import android
.view
.View
;
31 import android
.view
.View
.OnClickListener
;
32 import android
.view
.ViewGroup
;
33 import android
.widget
.CheckBox
;
34 import android
.widget
.ImageView
;
35 import android
.widget
.ProgressBar
;
36 import android
.widget
.TextView
;
38 import com
.owncloud
.android
.R
;
39 import com
.owncloud
.android
.datamodel
.FileDataStorageManager
;
40 import com
.owncloud
.android
.datamodel
.OCFile
;
41 import com
.owncloud
.android
.files
.FileMenuFilter
;
42 import com
.owncloud
.android
.files
.services
.FileDownloader
.FileDownloaderBinder
;
43 import com
.owncloud
.android
.files
.services
.FileUploader
.FileUploaderBinder
;
44 import com
.owncloud
.android
.lib
.common
.network
.OnDatatransferProgressListener
;
45 import com
.owncloud
.android
.lib
.common
.utils
.Log_OC
;
46 import com
.owncloud
.android
.ui
.activity
.FileActivity
;
47 import com
.owncloud
.android
.ui
.activity
.FileDisplayActivity
;
48 import com
.owncloud
.android
.ui
.dialog
.RemoveFileDialogFragment
;
49 import com
.owncloud
.android
.ui
.dialog
.RenameFileDialogFragment
;
50 import com
.owncloud
.android
.utils
.DisplayUtils
;
52 import java
.lang
.ref
.WeakReference
;
56 * This Fragment is used to display the details about a file.
58 public class FileDetailFragment
extends FileFragment
implements OnClickListener
{
62 private Account mAccount
;
64 public ProgressListener mProgressListener
;
66 private static final String TAG
= FileDetailFragment
.class.getSimpleName();
67 public static final String FTAG_CONFIRMATION
= "REMOVE_CONFIRMATION_FRAGMENT";
68 public static final String FTAG_RENAME_FILE
= "RENAME_FILE_FRAGMENT";
70 private static final String ARG_FILE
= "FILE";
71 private static final String ARG_ACCOUNT
= "ACCOUNT";
75 * Public factory method to create new FileDetailFragment instances.
77 * When 'fileToDetail' or 'ocAccount' are null, creates a dummy layout (to use when a file wasn't tapped before).
79 * @param fileToDetail An {@link OCFile} to show in the fragment
80 * @param account An ownCloud account; needed to start downloads
81 * @return New fragment with arguments set
83 public static FileDetailFragment
newInstance(OCFile fileToDetail
, Account account
) {
84 FileDetailFragment frag
= new FileDetailFragment();
85 Bundle args
= new Bundle();
86 args
.putParcelable(ARG_FILE
, fileToDetail
);
87 args
.putParcelable(ARG_ACCOUNT
, account
);
88 frag
.setArguments(args
);
93 * Creates an empty details fragment.
95 * It's necessary to keep a public constructor without parameters; the system uses it when tries
96 * to reinstantiate a fragment automatically.
98 public FileDetailFragment() {
101 mLayout
= R
.layout
.file_details_empty
;
102 mProgressListener
= null
;
107 public void onActivityCreated(Bundle savedInstanceState
) {
108 super.onCreate(savedInstanceState
);
109 setHasOptionsMenu(true
);
114 public View
onCreateView(LayoutInflater inflater
, ViewGroup container
,
115 Bundle savedInstanceState
) {
117 setFile((OCFile
) getArguments().getParcelable(ARG_FILE
));
118 mAccount
= getArguments().getParcelable(ARG_ACCOUNT
);
120 if (savedInstanceState
!= null
) {
121 setFile((OCFile
) savedInstanceState
.getParcelable(FileActivity
.EXTRA_FILE
));
122 mAccount
= savedInstanceState
.getParcelable(FileActivity
.EXTRA_ACCOUNT
);
125 if (getFile() != null
&& mAccount
!= null
) {
126 mLayout
= R
.layout
.file_details_fragment
;
129 mView
= inflater
.inflate(mLayout
, null
);
131 if (mLayout
== R
.layout
.file_details_fragment
) {
132 mView
.findViewById(R
.id
.fdFavorite
).setOnClickListener(this);
133 ProgressBar progressBar
= (ProgressBar
)mView
.findViewById(R
.id
.fdProgressBar
);
134 DisplayUtils
.colorPreLollipopHorizontalProgressBar(progressBar
);
135 mProgressListener
= new ProgressListener(progressBar
);
136 mView
.findViewById(R
.id
.fdCancelBtn
).setOnClickListener(this);
139 updateFileDetails(false
, false
);
144 public void onSaveInstanceState(Bundle outState
) {
145 super.onSaveInstanceState(outState
);
146 outState
.putParcelable(FileActivity
.EXTRA_FILE
, getFile());
147 outState
.putParcelable(FileActivity
.EXTRA_ACCOUNT
, mAccount
);
151 public void onStart() {
153 listenForTransferProgress();
157 public void onStop() {
158 leaveTransferProgress();
164 public View
getView() {
165 return super.getView() == null ? mView
: super.getView();
173 public void onCreateOptionsMenu(Menu menu
, MenuInflater inflater
) {
174 super.onCreateOptionsMenu(menu
, inflater
);
175 inflater
.inflate(R
.menu
.file_actions_menu
, menu
);
183 public void onPrepareOptionsMenu(Menu menu
) {
184 super.onPrepareOptionsMenu(menu
);
186 if (mContainerActivity
.getStorageManager() != null
) {
187 FileMenuFilter mf
= new FileMenuFilter(
189 mContainerActivity
.getStorageManager().getAccount(),
196 // additional restriction for this fragment
197 MenuItem item
= menu
.findItem(R
.id
.action_see_details
);
199 item
.setVisible(false
);
200 item
.setEnabled(false
);
203 // additional restriction for this fragment
204 item
= menu
.findItem(R
.id
.action_move
);
206 item
.setVisible(false
);
207 item
.setEnabled(false
);
210 // additional restriction for this fragment
211 item
= menu
.findItem(R
.id
.action_copy
);
213 item
.setVisible(false
);
214 item
.setEnabled(false
);
223 public boolean onOptionsItemSelected(MenuItem item
) {
224 switch (item
.getItemId()) {
225 case R
.id
.action_share_file
: {
226 mContainerActivity
.getFileOperationsHelper().shareFileWithLink(getFile());
229 case R
.id
.action_unshare_file
: {
230 mContainerActivity
.getFileOperationsHelper().unshareFileWithLink(getFile());
233 case R
.id
.action_open_file_with
: {
234 mContainerActivity
.getFileOperationsHelper().openFile(getFile());
237 case R
.id
.action_remove_file
: {
238 RemoveFileDialogFragment dialog
= RemoveFileDialogFragment
.newInstance(getFile());
239 dialog
.show(getFragmentManager(), FTAG_CONFIRMATION
);
242 case R
.id
.action_rename_file
: {
243 RenameFileDialogFragment dialog
= RenameFileDialogFragment
.newInstance(getFile());
244 dialog
.show(getFragmentManager(), FTAG_RENAME_FILE
);
247 case R
.id
.action_cancel_download
:
248 case R
.id
.action_cancel_upload
: {
249 ((FileDisplayActivity
) mContainerActivity
).cancelTransference(getFile());
252 case R
.id
.action_download_file
:
253 case R
.id
.action_sync_file
: {
254 mContainerActivity
.getFileOperationsHelper().syncFile(getFile());
257 case R
.id
.action_send_file
: {
259 if (!getFile().isDown()) { // Download the file
260 Log_OC
.d(TAG
, getFile().getRemotePath() + " : File must be downloaded");
261 ((FileDisplayActivity
) mContainerActivity
).startDownloadForSending(getFile());
265 mContainerActivity
.getFileOperationsHelper().sendDownloadedFile(getFile());
269 case R
.id
.action_favorite_file
:{
270 mContainerActivity
.getFileOperationsHelper().toggleFavorite(getFile(), true
);
273 case R
.id
.action_unfavorite_file
:{
274 mContainerActivity
.getFileOperationsHelper().toggleFavorite(getFile(), false
);
283 public void onClick(View v
) {
285 case R
.id
.fdFavorite
: {
286 CheckBox cb
= (CheckBox
) getView().findViewById(R
.id
.fdFavorite
);
287 mContainerActivity
.getFileOperationsHelper().toggleFavorite(getFile(),cb
.isChecked());
290 case R
.id
.fdCancelBtn
: {
291 ((FileDisplayActivity
) mContainerActivity
).cancelTransference(getFile());
295 Log_OC
.e(TAG
, "Incorrect view clicked!");
301 * Check if the fragment was created with an empty layout. An empty fragment can't show file details, must be replaced.
303 * @return True when the fragment was created with the empty layout.
305 public boolean isEmpty() {
306 return (mLayout
== R
.layout
.file_details_empty
|| getFile() == null
|| mAccount
== null
);
311 * Use this method to signal this Activity that it shall update its view.
313 * @param file : An {@link OCFile}
315 public void updateFileDetails(OCFile file
, Account ocAccount
) {
317 mAccount
= ocAccount
;
318 updateFileDetails(false
, false
);
322 * Updates the view with all relevant details about that file.
324 * TODO Remove parameter when the transferring state of files is kept in database.
326 * @param transferring Flag signaling if the file should be considered as downloading or uploading,
327 * although {@link FileDownloaderBinder#isDownloading(Account, OCFile)} and
328 * {@link FileUploaderBinder#isUploading(Account, OCFile)} return false.
329 * @param refresh If 'true', try to refresh the whole file from the database
331 public void updateFileDetails(boolean transferring
, boolean refresh
) {
333 FileDataStorageManager storageManager
= mContainerActivity
.getStorageManager();
334 if (refresh
&& storageManager
!= null
) {
335 setFile(storageManager
.getFileByPath(getFile().getRemotePath()));
337 OCFile file
= getFile();
340 setFilename(file
.getFileName());
341 setFiletype(file
.getMimetype(), file
.getFileName());
342 setFilesize(file
.getFileLength());
344 setTimeModified(file
.getModificationTimestamp());
346 CheckBox cb
= (CheckBox
)getView().findViewById(R
.id
.fdFavorite
);
347 cb
.setChecked(file
.isFavorite());
349 // configure UI for depending upon local state of the file
350 FileDownloaderBinder downloaderBinder
= mContainerActivity
.getFileDownloaderBinder();
351 FileUploaderBinder uploaderBinder
= mContainerActivity
.getFileUploaderBinder();
353 (downloaderBinder
!= null
&& downloaderBinder
.isDownloading(mAccount
, file
)) ||
354 (uploaderBinder
!= null
&& uploaderBinder
.isUploading(mAccount
, file
))
356 setButtonsForTransferring();
358 } else if (file
.isDown()) {
363 // TODO load default preview image; when the local file is removed, the preview
365 setButtonsForRemote();
368 getView().invalidate();
372 * Checks if the fragment is ready to show details of a OCFile
374 * @return 'True' when the fragment is ready to show details of a file
376 private boolean readyToShow() {
377 return (getFile() != null
&& mAccount
!= null
&& mLayout
== R
.layout
.file_details_fragment
);
382 * Updates the filename in view
384 * @param filename to set
386 private void setFilename(String filename
) {
387 TextView tv
= (TextView
) getView().findViewById(R
.id
.fdFilename
);
389 tv
.setText(filename
);
394 * Updates the MIME type in view
395 * @param mimetype MIME type to set
396 * @param filename Name of the file, to deduce the icon to use in case the MIME type is not precise enough
398 private void setFiletype(String mimetype
, String filename
) {
399 TextView tv
= (TextView
) getView().findViewById(R
.id
.fdType
);
401 String printableMimetype
= DisplayUtils
.convertMIMEtoPrettyPrint(mimetype
);
402 tv
.setText(printableMimetype
);
404 ImageView iv
= (ImageView
) getView().findViewById(R
.id
.fdIcon
);
406 iv
.setImageResource(DisplayUtils
.getFileTypeIconId(mimetype
, filename
));
411 * Updates the file size in view
413 * @param filesize in bytes to set
415 private void setFilesize(long filesize
) {
416 TextView tv
= (TextView
) getView().findViewById(R
.id
.fdSize
);
418 tv
.setText(DisplayUtils
.bytesToHumanReadable(filesize
));
423 * Updates the time that the file was last modified
425 * @param milliseconds Unix time to set
427 private void setTimeModified(long milliseconds
) {
428 TextView tv
= (TextView
) getView().findViewById(R
.id
.fdModified
);
430 tv
.setText(DisplayUtils
.unixTimeToHumanReadable(milliseconds
));
435 * Enables or disables buttons for a file being downloaded
437 private void setButtonsForTransferring() {
439 // let's protect the user from himself ;)
440 getView().findViewById(R
.id
.fdFavorite
).setEnabled(false
);
442 // show the progress bar for the transfer
443 getView().findViewById(R
.id
.fdProgressBlock
).setVisibility(View
.VISIBLE
);
444 TextView progressText
= (TextView
) getView().findViewById(R
.id
.fdProgressText
);
445 progressText
.setVisibility(View
.VISIBLE
);
446 FileDownloaderBinder downloaderBinder
= mContainerActivity
.getFileDownloaderBinder();
447 FileUploaderBinder uploaderBinder
= mContainerActivity
.getFileUploaderBinder();
448 //if (getFile().isDownloading()) {
449 if (downloaderBinder
!= null
&& downloaderBinder
.isDownloading(mAccount
, getFile())) {
450 progressText
.setText(R
.string
.downloader_download_in_progress_ticker
);
453 if (uploaderBinder
!= null
&& uploaderBinder
.isUploading(mAccount
, getFile())) {
454 progressText
.setText(R
.string
.uploader_upload_in_progress_ticker
);
461 * Enables or disables buttons for a file locally available
463 private void setButtonsForDown() {
465 getView().findViewById(R
.id
.fdFavorite
).setEnabled(true
);
467 // hides the progress bar
468 getView().findViewById(R
.id
.fdProgressBlock
).setVisibility(View
.GONE
);
469 TextView progressText
= (TextView
) getView().findViewById(R
.id
.fdProgressText
);
470 progressText
.setVisibility(View
.GONE
);
475 * Enables or disables buttons for a file not locally available
477 private void setButtonsForRemote() {
479 getView().findViewById(R
.id
.fdFavorite
).setEnabled(true
);
481 // hides the progress bar
482 getView().findViewById(R
.id
.fdProgressBlock
).setVisibility(View
.GONE
);
483 TextView progressText
= (TextView
) getView().findViewById(R
.id
.fdProgressText
);
484 progressText
.setVisibility(View
.GONE
);
489 public void listenForTransferProgress() {
490 if (mProgressListener
!= null
) {
491 if (mContainerActivity
.getFileDownloaderBinder() != null
) {
492 mContainerActivity
.getFileDownloaderBinder().
493 addDatatransferProgressListener(mProgressListener
, mAccount
, getFile());
495 if (mContainerActivity
.getFileUploaderBinder() != null
) {
496 mContainerActivity
.getFileUploaderBinder().
497 addDatatransferProgressListener(mProgressListener
, mAccount
, getFile());
503 public void leaveTransferProgress() {
504 if (mProgressListener
!= null
) {
505 if (mContainerActivity
.getFileDownloaderBinder() != null
) {
506 mContainerActivity
.getFileDownloaderBinder().
507 removeDatatransferProgressListener(mProgressListener
, mAccount
, getFile());
509 if (mContainerActivity
.getFileUploaderBinder() != null
) {
510 mContainerActivity
.getFileUploaderBinder().
511 removeDatatransferProgressListener(mProgressListener
, mAccount
, getFile());
518 * Helper class responsible for updating the progress bar shown for file uploading or
521 private class ProgressListener
implements OnDatatransferProgressListener
{
522 int mLastPercent
= 0;
523 WeakReference
<ProgressBar
> mProgressBar
= null
;
525 ProgressListener(ProgressBar progressBar
) {
526 mProgressBar
= new WeakReference
<ProgressBar
>(progressBar
);
530 public void onTransferProgress(long progressRate
, long totalTransferredSoFar
,
531 long totalToTransfer
, String filename
) {
532 int percent
= (int)(100.0*((double)totalTransferredSoFar
)/((double)totalToTransfer
));
533 if (percent
!= mLastPercent
) {
534 ProgressBar pb
= mProgressBar
.get();
536 pb
.setProgress(percent
);
540 mLastPercent
= percent
;