com.mongodb.gridfs

Class GridFSFile

java.lang.Object

com.mongodb.gridfs.GridFSFile

All Implemented Interfaces:

DBObject, BSONObject

Direct Known Subclasses:

GridFSDBFile, GridFSInputFile

public abstract class GridFSFile
extends Object
implements DBObject

The abstract class representing a GridFS file.

Constructor Summary

Constructors

Constructor and Description
GridFSFile()

Method Summary

Methods

Modifier and Type	Method and Description
boolean	containsField(String s) Checks if this object contains a field with the given name.
boolean	containsKey(String key) Deprecated.
Object	get(String key) Gets a field from this object by a given name.
List<String>	getAliases() Gets the aliases from the metadata.
long	getChunkSize() Gets the size of a chunk.
String	getContentType() Gets the content type.
String	getFilename() Gets the filename.
protected GridFS	getGridFS() Gets the GridFS associated with this file
Object	getId() Gets the id.
long	getLength() Gets the file's length.
String	getMD5() Gets the observed MD5 during transfer
DBObject	getMetaData() Gets the file metadata.
Date	getUploadDate() Gets the upload date.
boolean	isPartialObject() Whether DBObject.markAsPartialObject() was ever called only matters if you are going to upsert and do not want to risk losing fields.
Set<String>	keySet() Returns this object's fields' names
void	markAsPartialObject() If this object was retrieved with only some fields (using a field filter) this method will be called to mark it as such.
int	numChunks() Returns the number of chunks that store the file data.
Object	put(String key, Object v) Sets a name/value pair in this object.
void	putAll(BSONObject o) Sets all key/value pairs from an object into this object
void	putAll(Map m) Sets all key/value pairs from a map into this object
Object	removeField(String key) Removes a field with a given name from this object.
void	save() Saves the file entry to the files collection
protected void	setGridFS(GridFS fs) Sets the GridFS associated with this file.
void	setMetaData(DBObject metadata) Gets the file metadata.
Map<?,?>	toMap() Returns a map representing this BSONObject.
String	toString()
void	validate() Verifies that the MD5 matches between the database and the local file.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

GridFSFile

public GridFSFile()

Method Detail

save

public void save()

Saves the file entry to the files collection

Throws:

com.mongodb.MongoException - if there's a failure

validate

public void validate()

Verifies that the MD5 matches between the database and the local file. This should be called after transferring a file.

Throws:

com.mongodb.MongoException - if there's a failure

numChunks

public int numChunks()

Returns the number of chunks that store the file data.

Returns:

number of chunks

getId

public Object getId()

Gets the id.

Returns:

the id of the file.

getFilename

public String getFilename()

Gets the filename.

Returns:

the name of the file

getContentType

public String getContentType()

Gets the content type.

Returns:

the content type

getLength

public long getLength()

Gets the file's length.

Returns:

the length of the file

getChunkSize

public long getChunkSize()

Gets the size of a chunk.

Returns:

the chunkSize

getUploadDate

public Date getUploadDate()

Gets the upload date.

Returns:

the date

getAliases

public List<String> getAliases()

Gets the aliases from the metadata. note: to set aliases, call put(String, Object) with "aliases" , List<String>.

Returns:

list of aliases

getMetaData

public DBObject getMetaData()

Gets the file metadata.

Returns:

the metadata

setMetaData

public void setMetaData(DBObject metadata)

Gets the file metadata.

Parameters:

metadata - metadata to be set

getMD5

public String getMD5()

Gets the observed MD5 during transfer

Returns:

md5

put

public Object put(String key,
         Object v)

Description copied from interface: BSONObject

Sets a name/value pair in this object.

Specified by:

put in interface BSONObject

Parameters:

key - Name to set

v - Corresponding value

Returns:

the previous value associated with key, or null if there was no mapping for key. (A null return can also indicate that the map previously associated null with key.)

get

public Object get(String key)

Description copied from interface: BSONObject

Gets a field from this object by a given name.

Specified by:

get in interface BSONObject

Parameters:

key - The name of the field fetch

Returns:

The field, if found

containsKey

@Deprecated
public boolean containsKey(String key)

Deprecated.

Description copied from interface: BSONObject

Deprecated

Specified by:

containsKey in interface BSONObject

Parameters:

key - the key to check

Returns:

True if the key is present

containsField

public boolean containsField(String s)

Description copied from interface: BSONObject

Checks if this object contains a field with the given name.

Specified by:

containsField in interface BSONObject

Parameters:

s - Field name for which to check

Returns:

True if the field is present

keySet

public Set<String> keySet()

Description copied from interface: BSONObject

Returns this object's fields' names

Specified by:

keySet in interface BSONObject

Returns:

The names of the fields in this object

isPartialObject

public boolean isPartialObject()

Description copied from interface: DBObject

Whether DBObject.markAsPartialObject() was ever called only matters if you are going to upsert and do not want to risk losing fields.

Specified by:

isPartialObject in interface DBObject

Returns:

true if this has been marked as a partial object

markAsPartialObject

public void markAsPartialObject()

Description copied from interface: DBObject

If this object was retrieved with only some fields (using a field filter) this method will be called to mark it as such.

Specified by:

markAsPartialObject in interface DBObject

toString

public String toString()

Overrides:

toString in class Object

setGridFS

protected void setGridFS(GridFS fs)

Sets the GridFS associated with this file.

Parameters:

fs - gridFS instance

getGridFS

protected GridFS getGridFS()

Gets the GridFS associated with this file

Returns:

gridFS instance

putAll

public void putAll(BSONObject o)

Description copied from interface: BSONObject

Sets all key/value pairs from an object into this object

Specified by:

putAll in interface BSONObject

Parameters:

o - the object

putAll

public void putAll(Map m)

Description copied from interface: BSONObject

Sets all key/value pairs from a map into this object

Specified by:

putAll in interface BSONObject

Parameters:

m - the map

toMap

public Map<?,?> toMap()

Description copied from interface: BSONObject

Returns a map representing this BSONObject.

Specified by:

toMap in interface BSONObject

Returns:

the map

removeField

public Object removeField(String key)

Description copied from interface: BSONObject

Removes a field with a given name from this object.

Specified by:

removeField in interface BSONObject

Parameters:

key - The name of the field to remove

Returns:

The value removed from this object