/* ownCloud Android client application * Copyright (C) 2012 Bartek Przybylski * Copyright (C) 2012-2013 ownCloud Inc. * * This program is free software: you can redistribute it and/or modify * it under the terms of the GNU General Public License version 2, * as published by the Free Software Foundation. * * This program is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the * GNU General Public License for more details. * * You should have received a copy of the GNU General Public License * along with this program. If not, see . * */ package com.owncloud.android.datamodel; import java.io.File; import com.owncloud.android.Log_OC; import android.os.Parcel; import android.os.Parcelable; import android.webkit.MimeTypeMap; public class OCFile implements Parcelable, Comparable { public static final Parcelable.Creator CREATOR = new Parcelable.Creator() { @Override public OCFile createFromParcel(Parcel source) { return new OCFile(source); } @Override public OCFile[] newArray(int size) { return new OCFile[size]; } }; public static final String PATH_SEPARATOR = "/"; public static final String ROOT_PATH = PATH_SEPARATOR; private static final String TAG = OCFile.class.getSimpleName(); private long mId; private long mParentId; private long mLength; private long mCreationTimestamp; private long mModifiedTimestamp; private long mModifiedTimestampAtLastSyncForData; private String mRemotePath; private String mLocalPath; private String mMimeType; private boolean mNeedsUpdating; private long mLastSyncDateForProperties; private long mLastSyncDateForData; private boolean mKeepInSync; private String mEtag; /** * Create new {@link OCFile} with given path. * * The path received must be URL-decoded. Path separator must be OCFile.PATH_SEPARATOR, and it must be the first character in 'path'. * * @param path The remote path of the file. */ public OCFile(String path) { resetData(); mNeedsUpdating = false; if (path == null || path.length() <= 0 || !path.startsWith(PATH_SEPARATOR)) { throw new IllegalArgumentException("Trying to create a OCFile with a non valid remote path: " + path); } mRemotePath = path; } /** * Reconstruct from parcel * * @param source The source parcel */ private OCFile(Parcel source) { mId = source.readLong(); mParentId = source.readLong(); mLength = source.readLong(); mCreationTimestamp = source.readLong(); mModifiedTimestamp = source.readLong(); mModifiedTimestampAtLastSyncForData = source.readLong(); mRemotePath = source.readString(); mLocalPath = source.readString(); mMimeType = source.readString(); mNeedsUpdating = source.readInt() == 0; mKeepInSync = source.readInt() == 1; mLastSyncDateForProperties = source.readLong(); mLastSyncDateForData = source.readLong(); mEtag = source.readString(); } @Override public void writeToParcel(Parcel dest, int flags) { dest.writeLong(mId); dest.writeLong(mParentId); dest.writeLong(mLength); dest.writeLong(mCreationTimestamp); dest.writeLong(mModifiedTimestamp); dest.writeLong(mModifiedTimestampAtLastSyncForData); dest.writeString(mRemotePath); dest.writeString(mLocalPath); dest.writeString(mMimeType); dest.writeInt(mNeedsUpdating ? 1 : 0); dest.writeInt(mKeepInSync ? 1 : 0); dest.writeLong(mLastSyncDateForProperties); dest.writeLong(mLastSyncDateForData); dest.writeString(mEtag); } /** * Gets the ID of the file * * @return the file ID */ public long getFileId() { return mId; } /** * Returns the remote path of the file on ownCloud * * @return The remote path to the file */ public String getRemotePath() { return mRemotePath; } /** * Can be used to check, whether or not this file exists in the database * already * * @return true, if the file exists in the database */ public boolean fileExists() { return mId != -1; } /** * Use this to find out if this file is a folder. * * @return true if it is a folder */ public boolean isFolder() { return mMimeType != null && mMimeType.equals("DIR"); } /** * Use this to check if this file is available locally * * @return true if it is */ public boolean isDown() { if (mLocalPath != null && mLocalPath.length() > 0) { File file = new File(mLocalPath); return (file.exists()); } return false; } /** * The path, where the file is stored locally * * @return The local path to the file */ public String getStoragePath() { return mLocalPath; } /** * Can be used to set the path where the file is stored * * @param storage_path to set */ public void setStoragePath(String storage_path) { mLocalPath = storage_path; } /** * Get a UNIX timestamp of the file creation time * * @return A UNIX timestamp of the time that file was created */ public long getCreationTimestamp() { return mCreationTimestamp; } /** * Set a UNIX timestamp of the time the file was created * * @param creation_timestamp to set */ public void setCreationTimestamp(long creation_timestamp) { mCreationTimestamp = creation_timestamp; } /** * Get a UNIX timestamp of the file modification time. * * @return A UNIX timestamp of the modification time, corresponding to the value returned by the server * in the last synchronization of the properties of this file. */ public long getModificationTimestamp() { return mModifiedTimestamp; } /** * Set a UNIX timestamp of the time the time the file was modified. * * To update with the value returned by the server in every synchronization of the properties * of this file. * * @param modification_timestamp to set */ public void setModificationTimestamp(long modification_timestamp) { mModifiedTimestamp = modification_timestamp; } /** * Get a UNIX timestamp of the file modification time. * * @return A UNIX timestamp of the modification time, corresponding to the value returned by the server * in the last synchronization of THE CONTENTS of this file. */ public long getModificationTimestampAtLastSyncForData() { return mModifiedTimestampAtLastSyncForData; } /** * Set a UNIX timestamp of the time the time the file was modified. * * To update with the value returned by the server in every synchronization of THE CONTENTS * of this file. * * @param modification_timestamp to set */ public void setModificationTimestampAtLastSyncForData(long modificationTimestamp) { mModifiedTimestampAtLastSyncForData = modificationTimestamp; } /** * Returns the filename and "/" for the root directory * * @return The name of the file */ public String getFileName() { File f = new File(getRemotePath()); return f.getName().length() == 0 ? ROOT_PATH : f.getName(); } /** * Sets the name of the file * * Does nothing if the new name is null, empty or includes "/" ; or if the file is the root directory */ public void setFileName(String name) { Log_OC.d(TAG, "OCFile name changin from " + mRemotePath); if (name != null && name.length() > 0 && !name.contains(PATH_SEPARATOR) && !mRemotePath.equals(ROOT_PATH)) { String parent = (new File(getRemotePath())).getParent(); parent = (parent.endsWith(PATH_SEPARATOR)) ? parent : parent + PATH_SEPARATOR; mRemotePath = parent + name; if (isFolder()) { mRemotePath += PATH_SEPARATOR; } Log_OC.d(TAG, "OCFile name changed to " + mRemotePath); } } /** * Can be used to get the Mimetype * * @return the Mimetype as a String */ public String getMimetype() { return mMimeType; } /** * Adds a file to this directory. If this file is not a directory, an * exception gets thrown. * * @param file to add * @throws IllegalStateException if you try to add a something and this is * not a directory */ public void addFile(OCFile file) throws IllegalStateException { if (isFolder()) { file.mParentId = mId; mNeedsUpdating = true; return; } throw new IllegalStateException( "This is not a directory where you can add stuff to!"); } /** * Used internally. Reset all file properties */ private void resetData() { mId = -1; mRemotePath = null; mParentId = 0; mLocalPath = null; mMimeType = null; mLength = 0; mCreationTimestamp = 0; mModifiedTimestamp = 0; mModifiedTimestampAtLastSyncForData = 0; mLastSyncDateForProperties = 0; mLastSyncDateForData = 0; mKeepInSync = false; mNeedsUpdating = false; mEtag = null; } /** * Sets the ID of the file * * @param file_id to set */ public void setFileId(long file_id) { mId = file_id; } /** * Sets the Mime-Type of the * * @param mimetype to set */ public void setMimetype(String mimetype) { mMimeType = mimetype; } /** * Sets the ID of the parent folder * * @param parent_id to set */ public void setParentId(long parent_id) { mParentId = parent_id; } /** * Sets the file size in bytes * * @param file_len to set */ public void setFileLength(long file_len) { mLength = file_len; } /** * Returns the size of the file in bytes * * @return The filesize in bytes */ public long getFileLength() { return mLength; } /** * Returns the ID of the parent Folder * * @return The ID */ public long getParentId() { return mParentId; } /** * Check, if this file needs updating * * @return */ public boolean needsUpdatingWhileSaving() { return mNeedsUpdating; } public long getLastSyncDateForProperties() { return mLastSyncDateForProperties; } public void setLastSyncDateForProperties(long lastSyncDate) { mLastSyncDateForProperties = lastSyncDate; } public long getLastSyncDateForData() { return mLastSyncDateForData; } public void setLastSyncDateForData(long lastSyncDate) { mLastSyncDateForData = lastSyncDate; } public void setKeepInSync(boolean keepInSync) { mKeepInSync = keepInSync; } public boolean keepInSync() { return mKeepInSync; } @Override public int describeContents() { return this.hashCode(); } @Override public int compareTo(OCFile another) { if (isFolder() && another.isFolder()) { return getRemotePath().toLowerCase().compareTo(another.getRemotePath().toLowerCase()); } else if (isFolder()) { return -1; } else if (another.isFolder()) { return 1; } return getRemotePath().toLowerCase().compareTo(another.getRemotePath().toLowerCase()); } @Override public boolean equals(Object o) { if(o instanceof OCFile){ OCFile that = (OCFile) o; if(that != null){ return this.mId == that.mId; } } return false; } @Override public String toString() { String asString = "[id=%s, name=%s, mime=%s, downloaded=%s, local=%s, remote=%s, parentId=%s, keepInSinc=%s etag=%s]"; asString = String.format(asString, Long.valueOf(mId), getFileName(), mMimeType, isDown(), mLocalPath, mRemotePath, Long.valueOf(mParentId), Boolean.valueOf(mKeepInSync), mEtag); return asString; } public String getEtag() { return mEtag; } public void setEtag(String etag) { this.mEtag = etag; } public long getLocalModificationTimestamp() { if (mLocalPath != null && mLocalPath.length() > 0) { File f = new File(mLocalPath); return f.lastModified(); } return 0; } /** @return 'True' if the file contains audio */ public boolean isAudio() { return (mMimeType != null && mMimeType.startsWith("audio/")); } /** @return 'True' if the file contains video */ public boolean isVideo() { return (mMimeType != null && mMimeType.startsWith("video/")); } /** @return 'True' if the file contains an image */ public boolean isImage() { return ((mMimeType != null && mMimeType.startsWith("image/")) || getMimeTypeFromName().startsWith("image/")); } public String getMimeTypeFromName() { String extension = ""; int pos = mRemotePath.lastIndexOf('.'); if (pos >= 0) { extension = mRemotePath.substring(pos + 1); } String result = MimeTypeMap.getSingleton().getMimeTypeFromExtension(extension.toLowerCase()); return (result != null) ? result : ""; } }