src/com/owncloud/android/datamodel/OCFile.java

   1 /* ownCloud Android client application
   2  *   Copyright (C) 2012  Bartek Przybylski
   3  *   Copyright (C) 2012-2013 ownCloud Inc.
   4  *
   5  *   This program is free software: you can redistribute it and/or modify
   6  *   it under the terms of the GNU General Public License version 2,
   7  *   as published by the Free Software Foundation.
   8  *
   9  *   This program is distributed in the hope that it will be useful,
  10  *   but WITHOUT ANY WARRANTY; without even the implied warranty of
  11  *   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  12  *   GNU General Public License for more details.
  13  *
  14  *   You should have received a copy of the GNU General Public License
  15  *   along with this program.  If not, see <http://www.gnu.org/licenses/>.
  16  *
  17  */
  18
  19 package com.owncloud.android.datamodel;
  20
  21 import android.os.Parcel;
  22 import android.os.Parcelable;
  23 import android.webkit.MimeTypeMap;
  24
  25 import com.owncloud.android.lib.common.utils.Log_OC;
  26
  27 import java.io.File;
  28
  29 import third_parties.daveKoeller.AlphanumComparator;
  30 public class OCFile implements Parcelable, Comparable<OCFile> {
  31
  32     public static final Parcelable.Creator<OCFile> CREATOR = new Parcelable.Creator<OCFile>() {
  33         @Override
  34         public OCFile createFromParcel(Parcel source) {
  35             return new OCFile(source);
  36         }
  37
  38         @Override
  39         public OCFile[] newArray(int size) {
  40             return new OCFile[size];
  41         }
  42     };
  43
  44     public static final String PATH_SEPARATOR = "/";
  45     public static final String ROOT_PATH = PATH_SEPARATOR;
  46
  47     private static final String TAG = OCFile.class.getSimpleName();
  48
  49     private long mId;
  50     private long mParentId;
  51     private long mLength;
  52     private long mCreationTimestamp;
  53     private long mModifiedTimestamp;
  54     private long mModifiedTimestampAtLastSyncForData;
  55     private String mRemotePath;
  56     private String mLocalPath;
  57     private String mMimeType;
  58     private boolean mNeedsUpdating;
  59     private long mLastSyncDateForProperties;
  60     private long mLastSyncDateForData;
  61     private boolean mKeepInSync;
  62
  63     private String mEtag;
  64
  65     private boolean mShareByLink;
  66     private String mPublicLink;
  67
  68     private String mPermissions;
  69     private String mRemoteId;
  70
  71     private boolean mNeedsUpdateThumbnail;
  72
  73
  74     /**
  75      * Create new {@link OCFile} with given path.
  76      * <p/>
  77      * The path received must be URL-decoded. Path separator must be OCFile.PATH_SEPARATOR, and it must be the first character in 'path'.
  78      *
  79      * @param path The remote path of the file.
  80      */
  81     public OCFile(String path) {
  82         resetData();
  83         mNeedsUpdating = false;
  84         if (path == null || path.length() <= 0 || !path.startsWith(PATH_SEPARATOR)) {
  85             throw new IllegalArgumentException("Trying to create a OCFile with a non valid remote path: " + path);
  86         }
  87         mRemotePath = path;
  88     }
  89
  90     /**
  91      * Reconstruct from parcel
  92      *
  93      * @param source The source parcel
  94      */
  95     private OCFile(Parcel source) {
  96         mId = source.readLong();
  97         mParentId = source.readLong();
  98         mLength = source.readLong();
  99         mCreationTimestamp = source.readLong();
 100         mModifiedTimestamp = source.readLong();
 101         mModifiedTimestampAtLastSyncForData = source.readLong();
 102         mRemotePath = source.readString();
 103         mLocalPath = source.readString();
 104         mMimeType = source.readString();
 105         mNeedsUpdating = source.readInt() == 0;
 106         mKeepInSync = source.readInt() == 1;
 107         mLastSyncDateForProperties = source.readLong();
 108         mLastSyncDateForData = source.readLong();
 109         mEtag = source.readString();
 110         mShareByLink = source.readInt() == 1;
 111         mPublicLink = source.readString();
 112         mPermissions = source.readString();
 113         mRemoteId = source.readString();
 114         mNeedsUpdateThumbnail = source.readInt() == 0;
 115
 116     }
 117
 118     @Override
 119     public void writeToParcel(Parcel dest, int flags) {
 120         dest.writeLong(mId);
 121         dest.writeLong(mParentId);
 122         dest.writeLong(mLength);
 123         dest.writeLong(mCreationTimestamp);
 124         dest.writeLong(mModifiedTimestamp);
 125         dest.writeLong(mModifiedTimestampAtLastSyncForData);
 126         dest.writeString(mRemotePath);
 127         dest.writeString(mLocalPath);
 128         dest.writeString(mMimeType);
 129         dest.writeInt(mNeedsUpdating ? 1 : 0);
 130         dest.writeInt(mKeepInSync ? 1 : 0);
 131         dest.writeLong(mLastSyncDateForProperties);
 132         dest.writeLong(mLastSyncDateForData);
 133         dest.writeString(mEtag);
 134         dest.writeInt(mShareByLink ? 1 : 0);
 135         dest.writeString(mPublicLink);
 136         dest.writeString(mPermissions);
 137         dest.writeString(mRemoteId);
 138         dest.writeInt(mNeedsUpdateThumbnail ? 1 : 0);
 139     }
 140
 141     /**
 142      * Gets the ID of the file
 143      *
 144      * @return the file ID
 145      */
 146     public long getFileId() {
 147         return mId;
 148     }
 149
 150     /**
 151      * Returns the remote path of the file on ownCloud
 152      *
 153      * @return The remote path to the file
 154      */
 155     public String getRemotePath() {
 156         return mRemotePath;
 157     }
 158
 159     /**
 160      * Can be used to check, whether or not this file exists in the database
 161      * already
 162      *
 163      * @return true, if the file exists in the database
 164      */
 165     public boolean fileExists() {
 166         return mId != -1;
 167     }
 168
 169     /**
 170      * Use this to find out if this file is a folder.
 171      *
 172      * @return true if it is a folder
 173      */
 174     public boolean isFolder() {
 175         return mMimeType != null && mMimeType.equals("DIR");
 176     }
 177
 178     /**
 179      * Use this to check if this file is available locally
 180      *
 181      * @return true if it is
 182      */
 183     public boolean isDown() {
 184         if (mLocalPath != null && mLocalPath.length() > 0) {
 185             File file = new File(mLocalPath);
 186             return (file.exists());
 187         }
 188         return false;
 189     }
 190
 191     /**
 192      * The path, where the file is stored locally
 193      *
 194      * @return The local path to the file
 195      */
 196     public String getStoragePath() {
 197         return mLocalPath;
 198     }
 199
 200     /**
 201      * Can be used to set the path where the file is stored
 202      *
 203      * @param storage_path to set
 204      */
 205     public void setStoragePath(String storage_path) {
 206         mLocalPath = storage_path;
 207     }
 208
 209     /**
 210      * Get a UNIX timestamp of the file creation time
 211      *
 212      * @return A UNIX timestamp of the time that file was created
 213      */
 214     public long getCreationTimestamp() {
 215         return mCreationTimestamp;
 216     }
 217
 218     /**
 219      * Set a UNIX timestamp of the time the file was created
 220      *
 221      * @param creation_timestamp to set
 222      */
 223     public void setCreationTimestamp(long creation_timestamp) {
 224         mCreationTimestamp = creation_timestamp;
 225     }
 226
 227     /**
 228      * Get a UNIX timestamp of the file modification time.
 229      *
 230      * @return A UNIX timestamp of the modification time, corresponding to the value returned by the server
 231      * in the last synchronization of the properties of this file.
 232      */
 233     public long getModificationTimestamp() {
 234         return mModifiedTimestamp;
 235     }
 236
 237     /**
 238      * Set a UNIX timestamp of the time the time the file was modified.
 239      * <p/>
 240      * To update with the value returned by the server in every synchronization of the properties
 241      * of this file.
 242      *
 243      * @param modification_timestamp to set
 244      */
 245     public void setModificationTimestamp(long modification_timestamp) {
 246         mModifiedTimestamp = modification_timestamp;
 247     }
 248
 249
 250     /**
 251      * Get a UNIX timestamp of the file modification time.
 252      *
 253      * @return A UNIX timestamp of the modification time, corresponding to the value returned by the server
 254      * in the last synchronization of THE CONTENTS of this file.
 255      */
 256     public long getModificationTimestampAtLastSyncForData() {
 257         return mModifiedTimestampAtLastSyncForData;
 258     }
 259
 260     /**
 261      * Set a UNIX timestamp of the time the time the file was modified.
 262      * <p/>
 263      * To update with the value returned by the server in every synchronization of THE CONTENTS
 264      * of this file.
 265      *
 266      * @param modificationTimestamp to set
 267      */
 268     public void setModificationTimestampAtLastSyncForData(long modificationTimestamp) {
 269         mModifiedTimestampAtLastSyncForData = modificationTimestamp;
 270     }
 271
 272
 273     /**
 274      * Returns the filename and "/" for the root directory
 275      *
 276      * @return The name of the file
 277      */
 278     public String getFileName() {
 279         File f = new File(getRemotePath());
 280         return f.getName().length() == 0 ? ROOT_PATH : f.getName();
 281     }
 282
 283     /**
 284      * Sets the name of the file
 285      * <p/>
 286      * Does nothing if the new name is null, empty or includes "/" ; or if the file is the root directory
 287      */
 288     public void setFileName(String name) {
 289         Log_OC.d(TAG, "OCFile name changin from " + mRemotePath);
 290         if (name != null && name.length() > 0 && !name.contains(PATH_SEPARATOR) && !mRemotePath.equals(ROOT_PATH)) {
 291             String parent = (new File(getRemotePath())).getParent();
 292             parent = (parent.endsWith(PATH_SEPARATOR)) ? parent : parent + PATH_SEPARATOR;
 293             mRemotePath = parent + name;
 294             if (isFolder()) {
 295                 mRemotePath += PATH_SEPARATOR;
 296             }
 297             Log_OC.d(TAG, "OCFile name changed to " + mRemotePath);
 298         }
 299     }
 300
 301     /**
 302      * Can be used to get the Mimetype
 303      *
 304      * @return the Mimetype as a String
 305      */
 306     public String getMimetype() {
 307         return mMimeType;
 308     }
 309
 310     /**
 311      * Adds a file to this directory. If this file is not a directory, an
 312      * exception gets thrown.
 313      *
 314      * @param file to add
 315      * @throws IllegalStateException if you try to add a something and this is
 316      *                               not a directory
 317      */
 318     public void addFile(OCFile file) throws IllegalStateException {
 319         if (isFolder()) {
 320             file.mParentId = mId;
 321             mNeedsUpdating = true;
 322             return;
 323         }
 324         throw new IllegalStateException(
 325                 "This is not a directory where you can add stuff to!");
 326     }
 327
 328     /**
 329      * Used internally. Reset all file properties
 330      */
 331     private void resetData() {
 332         mId = -1;
 333         mRemotePath = null;
 334         mParentId = 0;
 335         mLocalPath = null;
 336         mMimeType = null;
 337         mLength = 0;
 338         mCreationTimestamp = 0;
 339         mModifiedTimestamp = 0;
 340         mModifiedTimestampAtLastSyncForData = 0;
 341         mLastSyncDateForProperties = 0;
 342         mLastSyncDateForData = 0;
 343         mKeepInSync = false;
 344         mNeedsUpdating = false;
 345         mEtag = null;
 346         mShareByLink = false;
 347         mPublicLink = null;
 348         mPermissions = null;
 349         mRemoteId = null;
 350         mNeedsUpdateThumbnail = false;
 351     }
 352
 353     /**
 354      * Sets the ID of the file
 355      *
 356      * @param file_id to set
 357      */
 358     public void setFileId(long file_id) {
 359         mId = file_id;
 360     }
 361
 362     /**
 363      * Sets the Mime-Type of the
 364      *
 365      * @param mimetype to set
 366      */
 367     public void setMimetype(String mimetype) {
 368         mMimeType = mimetype;
 369     }
 370
 371     /**
 372      * Sets the ID of the parent folder
 373      *
 374      * @param parent_id to set
 375      */
 376     public void setParentId(long parent_id) {
 377         mParentId = parent_id;
 378     }
 379
 380     /**
 381      * Sets the file size in bytes
 382      *
 383      * @param file_len to set
 384      */
 385     public void setFileLength(long file_len) {
 386         mLength = file_len;
 387     }
 388
 389     /**
 390      * Returns the size of the file in bytes
 391      *
 392      * @return The filesize in bytes
 393      */
 394     public long getFileLength() {
 395         return mLength;
 396     }
 397
 398     /**
 399      * Returns the ID of the parent Folder
 400      *
 401      * @return The ID
 402      */
 403     public long getParentId() {
 404         return mParentId;
 405     }
 406
 407     /**
 408      * Check, if this file needs updating
 409      *
 410      * @return
 411      */
 412     public boolean needsUpdatingWhileSaving() {
 413         return mNeedsUpdating;
 414     }
 415
 416     public boolean needsUpdateThumbnail() {
 417         return mNeedsUpdateThumbnail;
 418     }
 419
 420     public void setNeedsUpdateThumbnail(boolean needsUpdateThumbnail) {
 421         this.mNeedsUpdateThumbnail = needsUpdateThumbnail;
 422     }
 423
 424     public long getLastSyncDateForProperties() {
 425         return mLastSyncDateForProperties;
 426     }
 427
 428     public void setLastSyncDateForProperties(long lastSyncDate) {
 429         mLastSyncDateForProperties = lastSyncDate;
 430     }
 431
 432     public long getLastSyncDateForData() {
 433         return mLastSyncDateForData;
 434     }
 435
 436     public void setLastSyncDateForData(long lastSyncDate) {
 437         mLastSyncDateForData = lastSyncDate;
 438     }
 439
 440     public void setKeepInSync(boolean keepInSync) {
 441         mKeepInSync = keepInSync;
 442     }
 443
 444     public boolean keepInSync() {
 445         return mKeepInSync;
 446     }
 447
 448     @Override
 449     public int describeContents() {
 450         return super.hashCode();
 451     }
 452
 453     @Override
 454     public int compareTo(OCFile another) {
 455         if (isFolder() && another.isFolder()) {
 456             return getRemotePath().toLowerCase().compareTo(another.getRemotePath().toLowerCase());
 457         } else if (isFolder()) {
 458             return -1;
 459         } else if (another.isFolder()) {
 460             return 1;
 461         }
 462         return new AlphanumComparator().compare(this, another);
 463     }
 464
 465     @Override
 466     public boolean equals(Object o) {
 467         if (o instanceof OCFile) {
 468             OCFile that = (OCFile) o;
 469             if (that != null) {
 470                 return this.mId == that.mId;
 471             }
 472         }
 473
 474         return false;
 475     }
 476
 477     @Override
 478     public String toString() {
 479         String asString = "[id=%s, name=%s, mime=%s, downloaded=%s, local=%s, remote=%s, parentId=%s, keepInSync=%s etag=%s]";
 480         asString = String.format(asString, Long.valueOf(mId), getFileName(), mMimeType, isDown(), mLocalPath, mRemotePath, Long.valueOf(mParentId), Boolean.valueOf(mKeepInSync), mEtag);
 481         return asString;
 482     }
 483
 484     public String getEtag() {
 485         return mEtag;
 486     }
 487
 488     public void setEtag(String etag) {
 489         this.mEtag = etag;
 490     }
 491
 492
 493     public boolean isShareByLink() {
 494         return mShareByLink;
 495     }
 496
 497     public void setShareByLink(boolean shareByLink) {
 498         this.mShareByLink = shareByLink;
 499     }
 500
 501     public String getPublicLink() {
 502         return mPublicLink;
 503     }
 504
 505     public void setPublicLink(String publicLink) {
 506         this.mPublicLink = publicLink;
 507     }
 508
 509     public long getLocalModificationTimestamp() {
 510         if (mLocalPath != null && mLocalPath.length() > 0) {
 511             File f = new File(mLocalPath);
 512             return f.lastModified();
 513         }
 514         return 0;
 515     }
 516
 517     /**
 518      * @return 'True' if the file contains audio
 519      */
 520     public boolean isAudio() {
 521         return (mMimeType != null && mMimeType.startsWith("audio/"));
 522     }
 523
 524     /**
 525      * @return 'True' if the file contains video
 526      */
 527     public boolean isVideo() {
 528         return (mMimeType != null && mMimeType.startsWith("video/"));
 529     }
 530
 531     /**
 532      * @return 'True' if the file contains an image
 533      */
 534     public boolean isImage() {
 535         return ((mMimeType != null && mMimeType.startsWith("image/")) ||
 536                 getMimeTypeFromName().startsWith("image/"));
 537     }
 538
 539     /**
 540      * @return 'True' if the file is simple text (e.g. not application-dependent, like .doc or .docx)
 541      */
 542     public boolean isText() {
 543         return ((mMimeType != null && mMimeType.startsWith("text/")) || getMimeTypeFromName().startsWith("text/"));
 544     }
 545
 546     public String getMimeTypeFromName() {
 547         String extension = "";
 548         int pos = mRemotePath.lastIndexOf('.');
 549         if (pos >= 0) {
 550             extension = mRemotePath.substring(pos + 1);
 551         }
 552         String result = MimeTypeMap.getSingleton().getMimeTypeFromExtension(extension.toLowerCase());
 553         return (result != null) ? result : "";
 554     }
 555
 556     public String getPermissions() {
 557         return mPermissions;
 558     }
 559
 560     public void setPermissions(String permissions) {
 561         this.mPermissions = permissions;
 562     }
 563
 564     public String getRemoteId() {
 565         return mRemoteId;
 566     }
 567
 568     public void setRemoteId(String remoteId) {
 569         this.mRemoteId = remoteId;
 570     }
 571 }