AssetFileDescriptor

UNKNOWN_LENGTH

long UNKNOWN_LENGTH

Length used with AssetFileDescriptor(ParcelFileDescriptor, long, long) and getDeclaredLength() when a length has not been declared. This means the data extends to the end of the file.

Constant Value: -1 (0xffffffffffffffff)

CREATOR

Creator<AssetFileDescriptor> CREATOR

AssetFileDescriptor

AssetFileDescriptor (ParcelFileDescriptor fd, 
                long startOffset, 
                long length)

Create a new AssetFileDescriptor from the given values.

AssetFileDescriptor

AssetFileDescriptor (ParcelFileDescriptor fd, 
                long startOffset, 
                long length, 
                Bundle extras)

Create a new AssetFileDescriptor from the given values.

close

void close ()

Convenience for calling getParcelFileDescriptor().close().

createInputStream

FileInputStream createInputStream ()

Create and return a new auto-close input stream for this asset. This will either return a full asset AssetFileDescriptor.AutoCloseInputStream, or an underlying ParcelFileDescriptor.AutoCloseInputStream depending on whether the the object represents a complete file or sub-section of a file. You should only call this once for a particular asset.

createOutputStream

FileOutputStream createOutputStream ()

Create and return a new auto-close output stream for this asset. This will either return a full asset AssetFileDescriptor.AutoCloseOutputStream, or an underlying ParcelFileDescriptor.AutoCloseOutputStream depending on whether the the object represents a complete file or sub-section of a file. You should only call this once for a particular asset.

describeContents

int describeContents ()

Describe the kinds of special objects contained in this Parcelable instance's marshaled representation. For example, if the object will include a file descriptor in the output of writeToParcel(Parcel, int), the return value of this method must include the CONTENTS_FILE_DESCRIPTOR bit.

getDeclaredLength

long getDeclaredLength ()

Return the actual number of bytes that were declared when the AssetFileDescriptor was constructed. Will be UNKNOWN_LENGTH if the length was not declared, meaning data should be read to the end of the file.

getExtras

Bundle getExtras ()

Returns any additional details that can be used to interpret the underlying file descriptor. May be null.

getFileDescriptor

FileDescriptor getFileDescriptor ()

Returns the FileDescriptor that can be used to read the data in the file.

getLength

long getLength ()

Returns the total number of bytes of this asset entry's data. May be UNKNOWN_LENGTH if the asset extends to the end of the file. If the AssetFileDescriptor was constructed with UNKNOWN_LENGTH, this will use ParcelFileDescriptor.getStatSize() to find the total size of the file, returning that number if found or UNKNOWN_LENGTH if it could not be determined.

getParcelFileDescriptor

ParcelFileDescriptor getParcelFileDescriptor ()

The AssetFileDescriptor contains its own ParcelFileDescriptor, which in addition to the normal FileDescriptor object also allows you to close the descriptor when you are done with it.

getStartOffset

long getStartOffset ()

Returns the byte offset where this asset entry's data starts.

toString

String toString ()

Returns a string representation of the object. In general, the toString method returns a string that "textually represents" this object. The result should be a concise but informative representation that is easy for a person to read. It is recommended that all subclasses override this method.

The toString method for class Object returns a string consisting of the name of the class of which the object is an instance, the at-sign character `@', and the unsigned hexadecimal representation of the hash code of the object. In other words, this method returns a string equal to the value of:

 getClass().getName() + '@' + Integer.toHexString(hashCode())
 

writeToParcel

void writeToParcel (Parcel out, 
                int flags)

Flatten this object in to a Parcel.