Interface File
- All Superinterfaces:
Browsable, DirectoryEntry, Extensible, Identifiable, OsidObject
File represents a file in a file system.
-
Method Summary
Modifier and TypeMethodDescriptiongetFileRecord(Type fileRecordType) Gets the file record corresponding to the givenFilerecordType.This method is used to retrieve an object implementing the requested record.longgetSize()Gets the size of this file in bytes ifhasSize()istrue.booleanhasSize()Tests if this file has a known size.Methods inherited from interface Browsable
getProperties, getPropertiesByRecordTypeModifier and TypeMethodDescriptionGets a list of properties.getPropertiesByRecordType(Type recordType) Gets a list of properties corresponding to the specified record type.Methods inherited from interface DirectoryEntry
getCreatedTime, getLastAccessTime, getLastModifiedTime, getName, getOwner, getOwnerId, getPath, getRealPath, isAliasModifier and TypeMethodDescriptionGets the created time of this entry.Gets the last access time of this entry.Gets the last modified time of this entry.getName()Gets the name of this entry.getOwner()Gets theAgentthat owns this entry.Gets theIdof theAgentthat owns this entry.getPath()Gets the full path of this entry.Gets the real path of this entry.booleanisAlias()Tests if this entry is an alias.Methods inherited from interface Extensible
getRecordTypes, hasRecordTypeModifier and TypeMethodDescriptionGets the record types available in this object.booleanhasRecordType(Type recordType) Tests if this object supports the given recordType.Methods inherited from interface Identifiable
getId, isCurrentMethods inherited from interface OsidObject
getDescription, getDisplayName, getGenusType, isOfGenusTypeModifier and TypeMethodDescriptionGets the description associated with this instance of this OSID object.Gets the preferred display name associated with this instance of this OSID object appropriate for display to the user.Gets the genus type of this object.booleanisOfGenusType(Type genusType) Tests if this object is of the given genusType.
-
Method Details
-
hasSize
boolean hasSize()Tests if this file has a known size.- Returns:
trueif this file has a size,falseotherwise- Compliance:
mandatory- This method must be implemented.
-
getSize
long getSize()Gets the size of this file in bytes ifhasSize()istrue.- Returns:
- the size of this file
- Throws:
IllegalStateException-hasSize()isfalse- Compliance:
mandatory- This method must be implemented.
-
getFileRecord
Gets the file record corresponding to the givenFilerecordType.This method is used to retrieve an object implementing the requested record. ThefileRecordTypemay be theTypereturned ingetRecordTypes()or any of its parents in aTypehierarchy wherehasRecordType(fileRecordType)istrue.- Parameters:
fileRecordType- the file record type- Returns:
- the file record
- Throws:
NullArgumentException-fileRecordTypeisnullOperationFailedException- unable to complete requestUnsupportedException-hasRecordType(fileRecordType)isfalse- Compliance:
mandatory- This method must be implemented.
-