src/com/owncloud/android/ui/fragment/FileDetailFragment.java

   1 /**
   2  *   ownCloud Android client application
   3  *
   4  *   @author Bartek Przybylski
   5  *   @author David A. Velasco
   6  *   Copyright (C) 2011  Bartek Przybylski
   7  *   Copyright (C) 2015 ownCloud Inc.
   8  *
   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.
  12  *
  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.
  17  *
  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/>.
  20  *
  21  */
  22 package com.owncloud.android.ui.fragment;
  23
  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;
  38
  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;
  55
  56 import java.lang.ref.WeakReference;
  57
  58
  59 /**
  60  * This Fragment is used to display the details about a file.
  61  */
  62 public class FileDetailFragment extends FileFragment implements OnClickListener {
  63
  64     private int mLayout;
  65     private View mView;
  66     private Account mAccount;
  67
  68     public ProgressListener mProgressListener;
  69
  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";
  73
  74     private static final String ARG_FILE = "FILE";
  75     private static final String ARG_ACCOUNT = "ACCOUNT";
  76
  77
  78     /**
  79      * Public factory method to create new FileDetailFragment instances.
  80      *
  81      * When 'fileToDetail' or 'ocAccount' are null, creates a dummy layout (to use when a file wasn't tapped before).
  82      *
  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
  86      */
  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);
  93         return frag;
  94     }
  95
  96     /**
  97      * Creates an empty details fragment.
  98      *
  99      * It's necessary to keep a public constructor without parameters; the system uses it when tries
 100      * to reinstantiate a fragment automatically.
 101      */
 102     public FileDetailFragment() {
 103         super();
 104         mAccount = null;
 105         mLayout = R.layout.file_details_empty;
 106         mProgressListener = null;
 107     }
 108
 109
 110     @Override
 111     public void onActivityCreated(Bundle savedInstanceState) {
 112         super.onCreate(savedInstanceState);
 113         setHasOptionsMenu(true);
 114     }
 115
 116
 117     @Override
 118     public View onCreateView(LayoutInflater inflater, ViewGroup container,
 119             Bundle savedInstanceState) {
 120
 121         setFile((OCFile) getArguments().getParcelable(ARG_FILE));
 122         mAccount = getArguments().getParcelable(ARG_ACCOUNT);
 123
 124         if (savedInstanceState != null) {
 125             setFile((OCFile) savedInstanceState.getParcelable(FileActivity.EXTRA_FILE));
 126             mAccount = savedInstanceState.getParcelable(FileActivity.EXTRA_ACCOUNT);
 127         }
 128
 129         if (getFile() != null && mAccount != null) {
 130             mLayout = R.layout.file_details_fragment;
 131         }
 132
 133         mView = inflater.inflate(mLayout, null);
 134
 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);
 141         }
 142
 143         updateFileDetails(false, false);
 144         return mView;
 145     }
 146
 147     @Override
 148     public void onSaveInstanceState(Bundle outState) {
 149         super.onSaveInstanceState(outState);
 150         outState.putParcelable(FileActivity.EXTRA_FILE, getFile());
 151         outState.putParcelable(FileActivity.EXTRA_ACCOUNT, mAccount);
 152     }
 153
 154     @Override
 155     public void onStart() {
 156         super.onStart();
 157         listenForTransferProgress();
 158     }
 159
 160     @Override
 161     public void onStop() {
 162         leaveTransferProgress();
 163         super.onStop();
 164     }
 165
 166
 167     @Override
 168     public View getView() {
 169         return super.getView() == null ? mView : super.getView();
 170     }
 171
 172
 173     /**
 174      * {@inheritDoc}
 175      */
 176     @Override
 177     public void onCreateOptionsMenu(Menu menu, MenuInflater inflater) {
 178         super.onCreateOptionsMenu(menu, inflater);
 179         inflater.inflate(R.menu.file_actions_menu, menu);
 180     }
 181
 182
 183     /**
 184      * {@inheritDoc}
 185      */
 186     @Override
 187     public void onPrepareOptionsMenu(Menu menu) {
 188         super.onPrepareOptionsMenu(menu);
 189
 190         if (mContainerActivity.getStorageManager() != null) {
 191             FileMenuFilter mf = new FileMenuFilter(
 192                 getFile(),
 193                 mContainerActivity.getStorageManager().getAccount(),
 194                 mContainerActivity,
 195                 getActivity()
 196             );
 197             mf.filter(menu);
 198         }
 199
 200         // additional restriction for this fragment
 201         MenuItem item = menu.findItem(R.id.action_see_details);
 202         if (item != null) {
 203             item.setVisible(false);
 204             item.setEnabled(false);
 205         }
 206
 207         // additional restriction for this fragment
 208         item = menu.findItem(R.id.action_move);
 209         if (item != null) {
 210             item.setVisible(false);
 211             item.setEnabled(false);
 212         }
 213
 214         // additional restriction for this fragment
 215         item = menu.findItem(R.id.action_copy);
 216         if (item != null) {
 217             item.setVisible(false);
 218             item.setEnabled(false);
 219         }
 220
 221         item = menu.findItem(R.id.action_switch_view);
 222         if (item != null){
 223             item.setVisible(false);
 224             item.setEnabled(false);
 225         }
 226
 227         item = menu.findItem(R.id.action_sync_account);
 228         if (item != null) {
 229             item.setVisible(false);
 230             item.setEnabled(false);
 231         }
 232
 233         item = menu.findItem(R.id.action_sort);
 234         if (item != null) {
 235             item.setVisible(false);
 236             item.setEnabled(false);
 237         }
 238     }
 239
 240
 241     /**
 242      * {@inheritDoc}
 243      */
 244     @Override
 245     public boolean onOptionsItemSelected(MenuItem item) {
 246         switch (item.getItemId()) {
 247             case R.id.action_share_file: {
 248                 mContainerActivity.getFileOperationsHelper().shareFileWithLink(getFile());
 249                 return true;
 250             }
 251             case R.id.action_unshare_file: {
 252                 mContainerActivity.getFileOperationsHelper().unshareFileWithLink(getFile());
 253                 return true;
 254             }
 255             case R.id.action_open_file_with: {
 256                 mContainerActivity.getFileOperationsHelper().openFile(getFile());
 257                 return true;
 258             }
 259             case R.id.action_remove_file: {
 260                 RemoveFileDialogFragment dialog = RemoveFileDialogFragment.newInstance(getFile());
 261                 dialog.show(getFragmentManager(), FTAG_CONFIRMATION);
 262                 return true;
 263             }
 264             case R.id.action_rename_file: {
 265                 RenameFileDialogFragment dialog = RenameFileDialogFragment.newInstance(getFile());
 266                 dialog.show(getFragmentManager(), FTAG_RENAME_FILE);
 267                 return true;
 268             }
 269             case R.id.action_cancel_download:
 270             case R.id.action_cancel_upload: {
 271                 ((FileDisplayActivity) mContainerActivity).cancelTransference(getFile());
 272                 return true;
 273             }
 274             case R.id.action_download_file:
 275             case R.id.action_sync_file: {
 276                 mContainerActivity.getFileOperationsHelper().syncFile(getFile());
 277                 return true;
 278             }
 279             case R.id.action_send_file: {
 280                 // Obtain the file
 281                 if (!getFile().isDown()) {  // Download the file
 282                     Log_OC.d(TAG, getFile().getRemotePath() + " : File must be downloaded");
 283                     ((FileDisplayActivity) mContainerActivity).startDownloadForSending(getFile());
 284
 285                 }
 286                 else {
 287                     mContainerActivity.getFileOperationsHelper().sendDownloadedFile(getFile());
 288                 }
 289                 return true;
 290             }
 291             case R.id.action_favorite_file:{
 292                 mContainerActivity.getFileOperationsHelper().toggleFavorite(getFile(), true);
 293                 return true;
 294             }
 295             case R.id.action_unfavorite_file:{
 296                 mContainerActivity.getFileOperationsHelper().toggleFavorite(getFile(), false);
 297                 return true;
 298             }
 299             default:
 300                 return false;
 301         }
 302     }
 303
 304     @Override
 305     public void onClick(View v) {
 306         switch (v.getId()) {
 307             case R.id.fdFavorite: {
 308                 CheckBox cb = (CheckBox) getView().findViewById(R.id.fdFavorite);
 309                 mContainerActivity.getFileOperationsHelper().toggleFavorite(getFile(),cb.isChecked());
 310                 break;
 311             }
 312             case R.id.fdCancelBtn: {
 313                 ((FileDisplayActivity) mContainerActivity).cancelTransference(getFile());
 314                 break;
 315             }
 316             default:
 317                 Log_OC.e(TAG, "Incorrect view clicked!");
 318         }
 319     }
 320
 321
 322     /**
 323      * Check if the fragment was created with an empty layout. An empty fragment can't show file details, must be replaced.
 324      *
 325      * @return True when the fragment was created with the empty layout.
 326      */
 327     public boolean isEmpty() {
 328         return (mLayout == R.layout.file_details_empty || getFile() == null || mAccount == null);
 329     }
 330
 331
 332     /**
 333      * Use this method to signal this Activity that it shall update its view.
 334      *
 335      * @param file : An {@link OCFile}
 336      */
 337     public void updateFileDetails(OCFile file, Account ocAccount) {
 338         setFile(file);
 339         mAccount = ocAccount;
 340         updateFileDetails(false, false);
 341     }
 342
 343     /**
 344      * Updates the view with all relevant details about that file.
 345      * <p/>
 346      * TODO Remove parameter when the transferring state of files is kept in database.
 347      *
 348      * @param transferring Flag signaling if the file should be considered as downloading or uploading,
 349      *                     although {@link FileDownloaderBinder#isDownloading(Account, OCFile)}  and
 350      *                     {@link FileUploaderBinder#isUploading(Account, OCFile)} return false.
 351      * @param refresh      If 'true', try to refresh the whole file from the database
 352      */
 353     public void updateFileDetails(boolean transferring, boolean refresh) {
 354         if (readyToShow()) {
 355             FileDataStorageManager storageManager = mContainerActivity.getStorageManager();
 356             if (refresh && storageManager != null) {
 357                 setFile(storageManager.getFileByPath(getFile().getRemotePath()));
 358             }
 359             OCFile file = getFile();
 360
 361             // set file details
 362             setFilename(file.getFileName());
 363             setFiletype(file);
 364             setFilesize(file.getFileLength());
 365
 366             setTimeModified(file.getModificationTimestamp());
 367
 368             CheckBox cb = (CheckBox)getView().findViewById(R.id.fdFavorite);
 369             cb.setChecked(file.isFavorite());
 370
 371             // configure UI for depending upon local state of the file
 372             FileDownloaderBinder downloaderBinder = mContainerActivity.getFileDownloaderBinder();
 373             FileUploaderBinder uploaderBinder = mContainerActivity.getFileUploaderBinder();
 374             if (transferring ||
 375                     (downloaderBinder != null && downloaderBinder.isDownloading(mAccount, file)) ||
 376                     (uploaderBinder != null && uploaderBinder.isUploading(mAccount, file))
 377                     ) {
 378                 setButtonsForTransferring();
 379
 380             } else if (file.isDown()) {
 381
 382                 setButtonsForDown();
 383
 384             } else {
 385                 // TODO load default preview image; when the local file is removed, the preview
 386                 // remains there
 387                 setButtonsForRemote();
 388             }
 389         }
 390         getView().invalidate();
 391     }
 392
 393     /**
 394      * Checks if the fragment is ready to show details of a OCFile
 395      *
 396      * @return 'True' when the fragment is ready to show details of a file
 397      */
 398     private boolean readyToShow() {
 399         return (getFile() != null && mAccount != null && mLayout == R.layout.file_details_fragment);
 400     }
 401
 402
 403     /**
 404      * Updates the filename in view
 405      *
 406      * @param filename to set
 407      */
 408     private void setFilename(String filename) {
 409         TextView tv = (TextView) getView().findViewById(R.id.fdFilename);
 410         if (tv != null) {
 411             tv.setText(filename);
 412         }
 413     }
 414
 415     /**
 416      * Updates the MIME type in view
 417      * @param file : An {@link OCFile}
 418      */
 419     private void setFiletype(OCFile file) {
 420         String mimetype = file.getMimetype();
 421         TextView tv = (TextView) getView().findViewById(R.id.fdType);
 422         if (tv != null) {
 423                         // mimetype      MIME type to set
 424             String printableMimetype = DisplayUtils.convertMIMEtoPrettyPrint(mimetype);
 425             tv.setText(printableMimetype);
 426         }
 427
 428         ImageView iv = (ImageView) getView().findViewById(R.id.fdIcon);
 429
 430         if (iv != null) {
 431             Bitmap thumbnail;
 432             iv.setTag(file.getFileId());
 433
 434             if (file.isImage()) {
 435                 String tagId = String.valueOf(file.getRemoteId());
 436                 thumbnail = ThumbnailsCacheManager.getBitmapFromDiskCache(tagId);
 437
 438                 if (thumbnail != null && !file.needsUpdateThumbnail()) {
 439                     iv.setImageBitmap(thumbnail);
 440                 } else {
 441                     // generate new Thumbnail
 442                     if (ThumbnailsCacheManager.cancelPotentialWork(file, iv)) {
 443                         final ThumbnailsCacheManager.ThumbnailGenerationTask task =
 444                                 new ThumbnailsCacheManager.ThumbnailGenerationTask(
 445                                         iv, mContainerActivity.getStorageManager(), mAccount
 446                                 );
 447                         if (thumbnail == null) {
 448                             thumbnail = ThumbnailsCacheManager.mDefaultImg;
 449                         }
 450                         final ThumbnailsCacheManager.AsyncDrawable asyncDrawable =
 451                                 new ThumbnailsCacheManager.AsyncDrawable(
 452                                         MainApp.getAppContext().getResources(),
 453                                         thumbnail,
 454                                         task
 455                                 );
 456                         iv.setImageDrawable(asyncDrawable);
 457                         task.execute(file);
 458                     }
 459                 }
 460             } else {
 461                                 // Name of the file, to deduce the icon to use in case the MIME type is not precise enough
 462                                 String filename = file.getFileName();
 463                 iv.setImageResource(MimetypeIconUtil.getFileTypeIconId(mimetype, filename));
 464                         }
 465         }
 466     }
 467
 468     /**
 469      * Updates the file size in view
 470      *
 471      * @param filesize in bytes to set
 472      */
 473     private void setFilesize(long filesize) {
 474         TextView tv = (TextView) getView().findViewById(R.id.fdSize);
 475         if (tv != null) {
 476             tv.setText(DisplayUtils.bytesToHumanReadable(filesize));
 477         }
 478     }
 479
 480     /**
 481      * Updates the time that the file was last modified
 482      *
 483      * @param milliseconds Unix time to set
 484      */
 485     private void setTimeModified(long milliseconds) {
 486         TextView tv = (TextView) getView().findViewById(R.id.fdModified);
 487         if (tv != null) {
 488             tv.setText(DisplayUtils.unixTimeToHumanReadable(milliseconds));
 489         }
 490     }
 491
 492     /**
 493      * Enables or disables buttons for a file being downloaded
 494      */
 495     private void setButtonsForTransferring() {
 496         if (!isEmpty()) {
 497             // let's protect the user from himself ;)
 498             getView().findViewById(R.id.fdFavorite).setEnabled(false);
 499
 500             // show the progress bar for the transfer
 501             getView().findViewById(R.id.fdProgressBlock).setVisibility(View.VISIBLE);
 502             TextView progressText = (TextView) getView().findViewById(R.id.fdProgressText);
 503             progressText.setVisibility(View.VISIBLE);
 504             FileDownloaderBinder downloaderBinder = mContainerActivity.getFileDownloaderBinder();
 505             FileUploaderBinder uploaderBinder = mContainerActivity.getFileUploaderBinder();
 506             //if (getFile().isDownloading()) {
 507             if (downloaderBinder != null && downloaderBinder.isDownloading(mAccount, getFile())) {
 508                 progressText.setText(R.string.downloader_download_in_progress_ticker);
 509             }
 510             else {
 511                 if (uploaderBinder != null && uploaderBinder.isUploading(mAccount, getFile())) {
 512                     progressText.setText(R.string.uploader_upload_in_progress_ticker);
 513                 }
 514             }
 515         }
 516     }
 517
 518     /**
 519      * Enables or disables buttons for a file locally available
 520      */
 521     private void setButtonsForDown() {
 522         if (!isEmpty()) {
 523             getView().findViewById(R.id.fdFavorite).setEnabled(true);
 524
 525             // hides the progress bar
 526             getView().findViewById(R.id.fdProgressBlock).setVisibility(View.GONE);
 527             TextView progressText = (TextView) getView().findViewById(R.id.fdProgressText);
 528             progressText.setVisibility(View.GONE);
 529         }
 530     }
 531
 532     /**
 533      * Enables or disables buttons for a file not locally available
 534      */
 535     private void setButtonsForRemote() {
 536         if (!isEmpty()) {
 537             getView().findViewById(R.id.fdFavorite).setEnabled(true);
 538
 539             // hides the progress bar
 540             getView().findViewById(R.id.fdProgressBlock).setVisibility(View.GONE);
 541             TextView progressText = (TextView) getView().findViewById(R.id.fdProgressText);
 542             progressText.setVisibility(View.GONE);
 543         }
 544     }
 545
 546
 547     public void listenForTransferProgress() {
 548         if (mProgressListener != null) {
 549             if (mContainerActivity.getFileDownloaderBinder() != null) {
 550                 mContainerActivity.getFileDownloaderBinder().
 551                         addDatatransferProgressListener(mProgressListener, mAccount, getFile());
 552             }
 553             if (mContainerActivity.getFileUploaderBinder() != null) {
 554                 mContainerActivity.getFileUploaderBinder().
 555                         addDatatransferProgressListener(mProgressListener, mAccount, getFile());
 556             }
 557         }
 558     }
 559
 560
 561     public void leaveTransferProgress() {
 562         if (mProgressListener != null) {
 563             if (mContainerActivity.getFileDownloaderBinder() != null) {
 564                 mContainerActivity.getFileDownloaderBinder().
 565                         removeDatatransferProgressListener(mProgressListener, mAccount, getFile());
 566             }
 567             if (mContainerActivity.getFileUploaderBinder() != null) {
 568                 mContainerActivity.getFileUploaderBinder().
 569                         removeDatatransferProgressListener(mProgressListener, mAccount, getFile());
 570             }
 571         }
 572     }
 573
 574
 575     /**
 576      * Helper class responsible for updating the progress bar shown for file uploading or
 577      * downloading
 578      */
 579     private class ProgressListener implements OnDatatransferProgressListener {
 580         int mLastPercent = 0;
 581         WeakReference<ProgressBar> mProgressBar = null;
 582
 583         ProgressListener(ProgressBar progressBar) {
 584             mProgressBar = new WeakReference<ProgressBar>(progressBar);
 585         }
 586
 587         @Override
 588         public void onTransferProgress(long progressRate, long totalTransferredSoFar,
 589                                        long totalToTransfer, String filename) {
 590             int percent = (int)(100.0*((double)totalTransferredSoFar)/((double)totalToTransfer));
 591             if (percent != mLastPercent) {
 592                 ProgressBar pb = mProgressBar.get();
 593                 if (pb != null) {
 594                     pb.setProgress(percent);
 595                     pb.postInvalidate();
 596                 }
 597             }
 598             mLastPercent = percent;
 599         }
 600
 601     }
 602
 603 }