aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authoricewing <icewing@36083f99-b078-4883-b0ff-0f9b5a30f544>2008-04-21 12:10:32 +0000
committericewing <icewing@36083f99-b078-4883-b0ff-0f9b5a30f544>2008-04-21 12:10:32 +0000
commit52225c52c4f72fcf2ccfdbcb984b2ed9124f5016 (patch)
treefe300f1adb869c46752df2f63285e71cebb47dc8
parent0034c42ddaf5952c4545d8ee875b218eddd65cc9 (diff)
downloadelgg-52225c52c4f72fcf2ccfdbcb984b2ed9124f5016.tar.gz
elgg-52225c52c4f72fcf2ccfdbcb984b2ed9124f5016.tar.bz2
Marcus Povey <marcus@dushka.co.uk>
* Coded, but untested, file and filestore classes... committed to let others start using them straight away. DISCUSSION: Should we use metadata to store datastore parameters in the context of ODD? - Or should ODD say that other non-defined metadata is ok? git-svn-id: https://code.elgg.org/elgg/trunk@495 36083f99-b078-4883-b0ff-0f9b5a30f544
-rw-r--r--engine/lib/filestore.php203
1 files changed, 183 insertions, 20 deletions
diff --git a/engine/lib/filestore.php b/engine/lib/filestore.php
index 3b5dd7543..7ad82b31a 100644
--- a/engine/lib/filestore.php
+++ b/engine/lib/filestore.php
@@ -43,11 +43,11 @@
* Read data from a filestore.
*
* @param mixed $f The file handle
- * @param int $length Length in bytes to read, or 0 for the entire file.
+ * @param int $length Length in bytes to read.
* @param int $offset The optional offset.
* @return mixed String of data or false on error.
*/
- abstract public function read($f, $length = 0, $offset = 0);
+ abstract public function read($f, $length, $offset = 0);
/**
* Seek a given position within a file handle.
@@ -137,7 +137,7 @@
return fwrite($f, $data);
}
- public function read($f, $length = 0, $offset = 0)
+ public function read($f, $length, $offset = 0)
{
if ($offset)
$this->seek($f, $offset);
@@ -223,6 +223,12 @@
*/
class ElggFile extends ElggObject
{
+ /** Filestore */
+ private $filestore;
+
+ /** File handle used to identify this file in a filestore. Created by open. */
+ private $handle;
+
protected function initialise_attributes()
{
parent::initialise_attributes();
@@ -230,38 +236,195 @@
$this->attributes['subtype'] = "file";
}
- function __construct($guid = null)
+ public function __construct($guid = null)
{
parent::__construct($guid);
}
- // TODO: Save filestore & filestore parameters - getparameters, save them as name/value with type "$datastoreclassname"
-
- // TODO: Set name and optional description
+ /**
+ * Set the filename of this file.
+ *
+ * @param string $name The filename.
+ */
+ public function setFilename($name) { $this->name = $name; }
+ /**
+ * Return the filename.
+ */
+ public function getFilename() { return $this->name; }
- //get datastore (save with object as meta/ load from create)
+ /**
+ * Set the optional file description.
+ *
+ * @param string $description The description.
+ */
+ public function setDescription($description) { $this->description = $description; }
- // constrcut
-
- // initialise (set subtype to elggfile)
-
- // set name
-
+ /**
+ * Open the file with the given mode
+ *
+ * @param string $mode Either read/write/append
+ */
+ public function open($mode)
+ {
+ if (!$this->name)
+ throw new IOException("You must specify a name before opening a file.");
+
+ // Sanity check
+ if (
+ ($mode!="read") &&
+ ($mode!="write") &&
+ ($mode!="append")
+ )
+ throw new InvalidParameterException("Unrecognised file mode '$mode'");
+
+ // Get the filestore
+ $fs = $this->getFilestore();
+
+ // Ensure that we save the file details to object store
+ $this->save();
+
+ // Open the file handle
+ $this->handle = $fs->open($this, $mode);
+
+ return $this->handle;
+ }
+
+ /**
+ * Write some data.
+ *
+ * @param string $data The data
+ */
+ public function write($data)
+ {
+ $fs = $this->getFilestore();
+
+ return $fs->write($this->handle, $data);
+ }
+
+ /**
+ * Read some data.
+ *
+ * @param int $length Amount to read.
+ * @param int $offset The offset to start from.
+ */
+ public function read($length, $offset = 0)
+ {
+ $fs = $this->getFilestore();
+
+ return $fs->read($this->handle, $length, $offset);
+ }
+
+ /**
+ * Close the file and commit changes
+ */
+ public function close()
+ {
+ $fs = $this->getFilestore();
+
+ if ($fs->close($this->handle))
+ {
+ $this->handle = NULL;
+
+ return true;
+ }
+
+ return false;
+ }
+ /**
+ * Delete this file.
+ */
+ public function delete()
+ {
+ $fs = $this->getFilestore();
+
+ return $fs->delete($this);
+ }
- // read / write / open / close / delete
+ /**
+ * Seek a position in the file.
+ *
+ * @param int $position
+ */
+ public function seek($position)
+ {
+ $fs = $this->getFilestore();
+
+ return $fs->seek($this->handle, $position);
+ }
+
+ /**
+ * Set a filestore.
+ *
+ * @param ElggFilestore $filestore The file store.
+ */
+ public function setFilestore(ElggFilestore $filestore)
+ {
+ $this->filestore = $filestore;
+ }
+
+ /**
+ * Return a filestore suitable for saving this file.
+ * This filestore is either a pre-registered filestore, a filestore loaded from metatags saved
+ * along side this file, or the system default.
+ */
+ protected function getFilestore()
+ {
+ // Short circuit if already set.
+ if ($this->filestore)
+ return $this->filestore;
+
+
+ // If filestore meta set then retrieve filestore TODO: Better way of doing this?
+ $metas = get_metadata_for_entity($this->guid);
+ $parameters = array();
+ foreach ($metas as $meta)
+ {
+ if (strpos($meta->name, "filestore::")!==false)
+ {
+ // Filestore parameter tag
+ $comp = explode("::", $meta->name);
+ $name = $comp[1];
+
+ $parameters[$name] = $meta->value;
+ }
+ }
+
+ // If parameters loaded then create new filestore
+ if (count($parameters)!=0)
+ {
+ // Create new filestore object
+ if ((!isset($parameters['filestore'])) || (!class_exists($parameters['filestore'])))
+ throw new ClassNotFoundException("Filestore not found or class not saved with file!");
+
+ $this->filestore = new $parameters['filestore']();
- // Get name
+ // Set parameters
+ $this->filestore->setParameters($parameters);
+ }
+
+ // if still nothing then set filestore to default
+ if (!$this->filestore)
+ $this->filestore = get_default_filestore();
+ return $this->filestore;
+ }
- // getFilestore
-
+ public function save()
+ {
+ if (!parent::save())
+ return false;
+
+ // Save datastore metadata
+ $params = $this->filestore->getParameters();
+ foreach ($params as $k => $v)
+ $this->setMetaData("filestore::$k", $v);
- // if $filestore is blank, try and get from meta
- // if meta not found or guid is null then get from default
+ return true;
+ }
}