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
.graphics
.Bitmap
;
26 import android
.os
.Bundle
;
27 import android
.view
.LayoutInflater
;
28 import android
.view
.Menu
;
29 import android
.view
.MenuInflater
;
30 import android
.view
.MenuItem
;
31 import android
.view
.View
;
32 import android
.view
.View
.OnClickListener
;
33 import android
.view
.ViewGroup
;
34 import android
.widget
.CheckBox
;
35 import android
.widget
.ImageView
;
36 import android
.widget
.ProgressBar
;
37 import android
.widget
.TextView
;
39 import com
.owncloud
.android
.MainApp
;
40 import com
.owncloud
.android
.R
;
41 import com
.owncloud
.android
.datamodel
.FileDataStorageManager
;
42 import com
.owncloud
.android
.datamodel
.OCFile
;
43 import com
.owncloud
.android
.datamodel
.ThumbnailsCacheManager
;
44 import com
.owncloud
.android
.files
.FileMenuFilter
;
45 import com
.owncloud
.android
.files
.services
.FileDownloader
.FileDownloaderBinder
;
46 import com
.owncloud
.android
.files
.services
.FileUploader
.FileUploaderBinder
;
47 import com
.owncloud
.android
.lib
.common
.network
.OnDatatransferProgressListener
;
48 import com
.owncloud
.android
.lib
.common
.utils
.Log_OC
;
49 import com
.owncloud
.android
.ui
.activity
.FileActivity
;
50 import com
.owncloud
.android
.ui
.activity
.FileDisplayActivity
;
51 import com
.owncloud
.android
.ui
.dialog
.RemoveFileDialogFragment
;
52 import com
.owncloud
.android
.ui
.dialog
.RenameFileDialogFragment
;
53 import com
.owncloud
.android
.utils
.DisplayUtils
;
54 import com
.owncloud
.android
.utils
.MimetypeIconUtil
;
56 import java
.lang
.ref
.WeakReference
;
60 * This Fragment is used to display the details about a file.
62 public class FileDetailFragment
extends FileFragment
implements OnClickListener
{
66 private Account mAccount
;
68 public ProgressListener mProgressListener
;
70 private static final String TAG
= FileDetailFragment
.class.getSimpleName();
71 public static final String FTAG_CONFIRMATION
= "REMOVE_CONFIRMATION_FRAGMENT";
72 public static final String FTAG_RENAME_FILE
= "RENAME_FILE_FRAGMENT";
74 private static final String ARG_FILE
= "FILE";
75 private static final String ARG_ACCOUNT
= "ACCOUNT";
79 * Public factory method to create new FileDetailFragment instances.
81 * When 'fileToDetail' or 'ocAccount' are null, creates a dummy layout (to use when a file wasn't tapped before).
83 * @param fileToDetail An {@link OCFile} to show in the fragment
84 * @param account An ownCloud account; needed to start downloads
85 * @return New fragment with arguments set
87 public static FileDetailFragment
newInstance(OCFile fileToDetail
, Account account
) {
88 FileDetailFragment frag
= new FileDetailFragment();
89 Bundle args
= new Bundle();
90 args
.putParcelable(ARG_FILE
, fileToDetail
);
91 args
.putParcelable(ARG_ACCOUNT
, account
);
92 frag
.setArguments(args
);
97 * Creates an empty details fragment.
99 * It's necessary to keep a public constructor without parameters; the system uses it when tries
100 * to reinstantiate a fragment automatically.
102 public FileDetailFragment() {
105 mLayout
= R
.layout
.file_details_empty
;
106 mProgressListener
= null
;
111 public void onActivityCreated(Bundle savedInstanceState
) {
112 super.onCreate(savedInstanceState
);
113 setHasOptionsMenu(true
);
118 public View
onCreateView(LayoutInflater inflater
, ViewGroup container
,
119 Bundle savedInstanceState
) {
121 setFile((OCFile
) getArguments().getParcelable(ARG_FILE
));
122 mAccount
= getArguments().getParcelable(ARG_ACCOUNT
);
124 if (savedInstanceState
!= null
) {
125 setFile((OCFile
) savedInstanceState
.getParcelable(FileActivity
.EXTRA_FILE
));
126 mAccount
= savedInstanceState
.getParcelable(FileActivity
.EXTRA_ACCOUNT
);
129 if (getFile() != null
&& mAccount
!= null
) {
130 mLayout
= R
.layout
.file_details_fragment
;
133 mView
= inflater
.inflate(mLayout
, null
);
135 if (mLayout
== R
.layout
.file_details_fragment
) {
136 mView
.findViewById(R
.id
.fdFavorite
).setOnClickListener(this);
137 ProgressBar progressBar
= (ProgressBar
)mView
.findViewById(R
.id
.fdProgressBar
);
138 DisplayUtils
.colorPreLollipopHorizontalProgressBar(progressBar
);
139 mProgressListener
= new ProgressListener(progressBar
);
140 mView
.findViewById(R
.id
.fdCancelBtn
).setOnClickListener(this);
143 updateFileDetails(false
, false
);
148 public void onSaveInstanceState(Bundle outState
) {
149 super.onSaveInstanceState(outState
);
150 outState
.putParcelable(FileActivity
.EXTRA_FILE
, getFile());
151 outState
.putParcelable(FileActivity
.EXTRA_ACCOUNT
, mAccount
);
155 public void onStart() {
157 listenForTransferProgress();
161 public void onStop() {
162 leaveTransferProgress();
168 public View
getView() {
169 return super.getView() == null ? mView
: super.getView();
177 public void onCreateOptionsMenu(Menu menu
, MenuInflater inflater
) {
178 super.onCreateOptionsMenu(menu
, inflater
);
179 inflater
.inflate(R
.menu
.file_actions_menu
, menu
);
187 public void onPrepareOptionsMenu(Menu menu
) {
188 super.onPrepareOptionsMenu(menu
);
190 if (mContainerActivity
.getStorageManager() != null
) {
191 FileMenuFilter mf
= new FileMenuFilter(
193 mContainerActivity
.getStorageManager().getAccount(),
200 // additional restriction for this fragment
201 MenuItem item
= menu
.findItem(R
.id
.action_see_details
);
203 item
.setVisible(false
);
204 item
.setEnabled(false
);
207 // additional restriction for this fragment
208 item
= menu
.findItem(R
.id
.action_move
);
210 item
.setVisible(false
);
211 item
.setEnabled(false
);
214 // additional restriction for this fragment
215 item
= menu
.findItem(R
.id
.action_copy
);
217 item
.setVisible(false
);
218 item
.setEnabled(false
);
221 item
= menu
.findItem(R
.id
.action_switch_view
);
223 item
.setVisible(false
);
224 item
.setEnabled(false
);
227 item
= menu
.findItem(R
.id
.action_sync_account
);
229 item
.setVisible(false
);
230 item
.setEnabled(false
);
233 item
= menu
.findItem(R
.id
.action_sort
);
235 item
.setVisible(false
);
236 item
.setEnabled(false
);
245 public boolean onOptionsItemSelected(MenuItem item
) {
246 switch (item
.getItemId()) {
247 case R
.id
.action_share_file
: {
248 mContainerActivity
.getFileOperationsHelper().showShareFile(getFile());
251 case R
.id
.action_open_file_with
: {
252 mContainerActivity
.getFileOperationsHelper().openFile(getFile());
255 case R
.id
.action_remove_file
: {
256 RemoveFileDialogFragment dialog
= RemoveFileDialogFragment
.newInstance(getFile());
257 dialog
.show(getFragmentManager(), FTAG_CONFIRMATION
);
260 case R
.id
.action_rename_file
: {
261 RenameFileDialogFragment dialog
= RenameFileDialogFragment
.newInstance(getFile());
262 dialog
.show(getFragmentManager(), FTAG_RENAME_FILE
);
265 case R
.id
.action_cancel_sync
: {
266 ((FileDisplayActivity
)mContainerActivity
).cancelTransference(getFile());
269 case R
.id
.action_download_file
:
270 case R
.id
.action_sync_file
: {
271 mContainerActivity
.getFileOperationsHelper().syncFile(getFile());
274 case R
.id
.action_send_file
: {
276 if (!getFile().isDown()) { // Download the file
277 Log_OC
.d(TAG
, getFile().getRemotePath() + " : File must be downloaded");
278 ((FileDisplayActivity
) mContainerActivity
).startDownloadForSending(getFile());
281 mContainerActivity
.getFileOperationsHelper().sendDownloadedFile(getFile());
285 case R
.id
.action_favorite_file
:{
286 mContainerActivity
.getFileOperationsHelper().toggleFavorite(getFile(), true
);
289 case R
.id
.action_unfavorite_file
:{
290 mContainerActivity
.getFileOperationsHelper().toggleFavorite(getFile(), false
);
299 public void onClick(View v
) {
301 case R
.id
.fdFavorite
: {
302 CheckBox cb
= (CheckBox
) getView().findViewById(R
.id
.fdFavorite
);
303 mContainerActivity
.getFileOperationsHelper().toggleFavorite(getFile(),cb
.isChecked());
306 case R
.id
.fdCancelBtn
: {
307 ((FileDisplayActivity
) mContainerActivity
).cancelTransference(getFile());
311 Log_OC
.e(TAG
, "Incorrect view clicked!");
316 * Check if the fragment was created with an empty layout. An empty fragment can't show file details, must be replaced.
318 * @return True when the fragment was created with the empty layout.
320 public boolean isEmpty() {
321 return (mLayout
== R
.layout
.file_details_empty
|| getFile() == null
|| mAccount
== null
);
326 * Use this method to signal this Activity that it shall update its view.
328 * @param file : An {@link OCFile}
330 public void updateFileDetails(OCFile file
, Account ocAccount
) {
332 mAccount
= ocAccount
;
333 updateFileDetails(false
, false
);
337 * Updates the view with all relevant details about that file.
339 * TODO Remove parameter when the transferring state of files is kept in database.
341 * @param transferring Flag signaling if the file should be considered as downloading or uploading,
342 * although {@link FileDownloaderBinder#isDownloading(Account, OCFile)} and
343 * {@link FileUploaderBinder#isUploading(Account, OCFile)} return false.
344 * @param refresh If 'true', try to refresh the whole file from the database
346 public void updateFileDetails(boolean transferring
, boolean refresh
) {
348 FileDataStorageManager storageManager
= mContainerActivity
.getStorageManager();
349 if (refresh
&& storageManager
!= null
) {
350 setFile(storageManager
.getFileByPath(getFile().getRemotePath()));
352 OCFile file
= getFile();
355 setFilename(file
.getFileName());
357 setFilesize(file
.getFileLength());
359 setTimeModified(file
.getModificationTimestamp());
361 CheckBox cb
= (CheckBox
)getView().findViewById(R
.id
.fdFavorite
);
362 cb
.setChecked(file
.isFavorite());
364 // configure UI for depending upon local state of the file
365 FileDownloaderBinder downloaderBinder
= mContainerActivity
.getFileDownloaderBinder();
366 FileUploaderBinder uploaderBinder
= mContainerActivity
.getFileUploaderBinder();
368 (downloaderBinder
!= null
&& downloaderBinder
.isDownloading(mAccount
, file
)) ||
369 (uploaderBinder
!= null
&& uploaderBinder
.isUploading(mAccount
, file
))
371 setButtonsForTransferring();
373 } else if (file
.isDown()) {
378 // TODO load default preview image; when the local file is removed, the preview
380 setButtonsForRemote();
383 getView().invalidate();
387 * Checks if the fragment is ready to show details of a OCFile
389 * @return 'True' when the fragment is ready to show details of a file
391 private boolean readyToShow() {
392 return (getFile() != null
&& mAccount
!= null
&& mLayout
== R
.layout
.file_details_fragment
);
397 * Updates the filename in view
399 * @param filename to set
401 private void setFilename(String filename
) {
402 TextView tv
= (TextView
) getView().findViewById(R
.id
.fdFilename
);
404 tv
.setText(filename
);
409 * Updates the MIME type in view
410 * @param file : An {@link OCFile}
412 private void setFiletype(OCFile file
) {
413 String mimetype
= file
.getMimetype();
414 TextView tv
= (TextView
) getView().findViewById(R
.id
.fdType
);
416 // mimetype MIME type to set
417 String printableMimetype
= DisplayUtils
.convertMIMEtoPrettyPrint(mimetype
);
418 tv
.setText(printableMimetype
);
421 ImageView iv
= (ImageView
) getView().findViewById(R
.id
.fdIcon
);
425 iv
.setTag(file
.getFileId());
427 if (file
.isImage()) {
428 String tagId
= String
.valueOf(file
.getRemoteId());
429 thumbnail
= ThumbnailsCacheManager
.getBitmapFromDiskCache(tagId
);
431 if (thumbnail
!= null
&& !file
.needsUpdateThumbnail()) {
432 iv
.setImageBitmap(thumbnail
);
434 // generate new Thumbnail
435 if (ThumbnailsCacheManager
.cancelPotentialWork(file
, iv
)) {
436 final ThumbnailsCacheManager
.ThumbnailGenerationTask task
=
437 new ThumbnailsCacheManager
.ThumbnailGenerationTask(
438 iv
, mContainerActivity
.getStorageManager(), mAccount
440 if (thumbnail
== null
) {
441 thumbnail
= ThumbnailsCacheManager
.mDefaultImg
;
443 final ThumbnailsCacheManager
.AsyncDrawable asyncDrawable
=
444 new ThumbnailsCacheManager
.AsyncDrawable(
445 MainApp
.getAppContext().getResources(),
449 iv
.setImageDrawable(asyncDrawable
);
454 // Name of the file, to deduce the icon to use in case the MIME type is not precise enough
455 String filename
= file
.getFileName();
456 iv
.setImageResource(MimetypeIconUtil
.getFileTypeIconId(mimetype
, filename
));
462 * Updates the file size in view
464 * @param filesize in bytes to set
466 private void setFilesize(long filesize
) {
467 TextView tv
= (TextView
) getView().findViewById(R
.id
.fdSize
);
469 tv
.setText(DisplayUtils
.bytesToHumanReadable(filesize
));
474 * Updates the time that the file was last modified
476 * @param milliseconds Unix time to set
478 private void setTimeModified(long milliseconds
) {
479 TextView tv
= (TextView
) getView().findViewById(R
.id
.fdModified
);
481 tv
.setText(DisplayUtils
.unixTimeToHumanReadable(milliseconds
));
486 * Enables or disables buttons for a file being downloaded
488 private void setButtonsForTransferring() {
490 // let's protect the user from himself ;)
491 getView().findViewById(R
.id
.fdFavorite
).setEnabled(false
);
493 // show the progress bar for the transfer
494 getView().findViewById(R
.id
.fdProgressBlock
).setVisibility(View
.VISIBLE
);
495 TextView progressText
= (TextView
) getView().findViewById(R
.id
.fdProgressText
);
496 progressText
.setVisibility(View
.VISIBLE
);
497 FileDownloaderBinder downloaderBinder
= mContainerActivity
.getFileDownloaderBinder();
498 FileUploaderBinder uploaderBinder
= mContainerActivity
.getFileUploaderBinder();
499 //if (getFile().isDownloading()) {
500 if (downloaderBinder
!= null
&& downloaderBinder
.isDownloading(mAccount
, getFile())) {
501 progressText
.setText(R
.string
.downloader_download_in_progress_ticker
);
504 if (uploaderBinder
!= null
&& uploaderBinder
.isUploading(mAccount
, getFile())) {
505 progressText
.setText(R
.string
.uploader_upload_in_progress_ticker
);
512 * Enables or disables buttons for a file locally available
514 private void setButtonsForDown() {
516 getView().findViewById(R
.id
.fdFavorite
).setEnabled(true
);
518 // hides the progress bar
519 getView().findViewById(R
.id
.fdProgressBlock
).setVisibility(View
.GONE
);
520 TextView progressText
= (TextView
) getView().findViewById(R
.id
.fdProgressText
);
521 progressText
.setVisibility(View
.GONE
);
526 * Enables or disables buttons for a file not locally available
528 private void setButtonsForRemote() {
530 getView().findViewById(R
.id
.fdFavorite
).setEnabled(true
);
532 // hides the progress bar
533 getView().findViewById(R
.id
.fdProgressBlock
).setVisibility(View
.GONE
);
534 TextView progressText
= (TextView
) getView().findViewById(R
.id
.fdProgressText
);
535 progressText
.setVisibility(View
.GONE
);
540 public void listenForTransferProgress() {
541 if (mProgressListener
!= null
) {
542 if (mContainerActivity
.getFileDownloaderBinder() != null
) {
543 mContainerActivity
.getFileDownloaderBinder().
544 addDatatransferProgressListener(mProgressListener
, mAccount
, getFile());
546 if (mContainerActivity
.getFileUploaderBinder() != null
) {
547 mContainerActivity
.getFileUploaderBinder().
548 addDatatransferProgressListener(mProgressListener
, mAccount
, getFile());
554 public void leaveTransferProgress() {
555 if (mProgressListener
!= null
) {
556 if (mContainerActivity
.getFileDownloaderBinder() != null
) {
557 mContainerActivity
.getFileDownloaderBinder().
558 removeDatatransferProgressListener(mProgressListener
, mAccount
, getFile());
560 if (mContainerActivity
.getFileUploaderBinder() != null
) {
561 mContainerActivity
.getFileUploaderBinder().
562 removeDatatransferProgressListener(mProgressListener
, mAccount
, getFile());
569 * Helper class responsible for updating the progress bar shown for file uploading or
572 private class ProgressListener
implements OnDatatransferProgressListener
{
573 int mLastPercent
= 0;
574 WeakReference
<ProgressBar
> mProgressBar
= null
;
576 ProgressListener(ProgressBar progressBar
) {
577 mProgressBar
= new WeakReference
<ProgressBar
>(progressBar
);
581 public void onTransferProgress(long progressRate
, long totalTransferredSoFar
,
582 long totalToTransfer
, String filename
) {
583 int percent
= (int)(100.0*((double)totalTransferredSoFar
)/((double)totalToTransfer
));
584 if (percent
!= mLastPercent
) {
585 ProgressBar pb
= mProgressBar
.get();
587 pb
.setProgress(percent
);
591 mLastPercent
= percent
;