adding media interfaces and a download controller draft

Controller/DownloadController.php

@@ -0,0 +1,29 @@
+<?php
+
+namespace Symfony\Cmf\Bundle\MediaBundle\Controller;
+
+use Symfony\Bundle\FrameworkBundle\Controller\Controller;
+use Symfony\Component\HttpKernel\Exception\NotFoundHttpException;
+use Symfony\Cmf\Bundle\MediaBundle\FileInterface;
+
+/**
+ * Controller to handle file downloads for things that have a route
+ */
+class DownloadController
+{
+    /**
+     * Action to download a document that has a route
+     *
+     * @param FileInterface $contentDocument
+     */
+    public function downloadAction($contentDocument)
+    {
+        if (! $contentDocument instanceof FileInterface) {
+            throw new NotFoundHttpException('Content is no file');
+        }
+
+        // TODO: can we use the BinaryFileResponse here? or adapt it to use it?
+        header('Content-Type: ' . $contentDocument->getContentType());
+        fpassthru($contentDocument->getBinaryContent());
+    }
+}

FileInterface.php

@@ -0,0 +1,40 @@
+<?php
+
+namespace Symfony\Cmf\Bundle\MediaBundle;
+
+/**
+ * Interface for objects containing a file.
+ *
+ * This is to be kept compatible with the SonataMediaBundle MediaInterface to
+ * allow integration with sonata.
+ */
+interface FileInterface extends MediaInterface
+{
+    /**
+     * Get a php stream with the data of this file.
+     *
+     * @return stream
+     */
+    public function getBinaryContent();
+
+    /**
+     * Get the file size in bytes
+     *
+     * @return integer
+     */
+    public function getSize();
+
+    /**
+     * TODO: The mime type of this media element ?
+     *
+     * @return string
+     */
+    public function getContentType();
+
+    /**
+     * Get the default file name extension for files of this format
+     *
+     * @return string
+     */
+    public function getExtension();
+}

ImageInterface.php

@@ -0,0 +1,28 @@
+<?php
+
+namespace Symfony\Cmf\Bundle\MediaBundle;
+
+/**
+ * Interface for image container objects. This just adds methods to get the
+ * native image dimensions, but implicitly also tells applications that this
+ * object is suitable to view with an <img> HTML tag.
+ *
+ * This is to be kept compatible with the SonataMediaBundle MediaInterface to
+ * allow integration with sonata.
+ */
+interface ImageInterface extends FileInterface
+{
+    /**
+     * Get image width in pixels
+     *
+     * @return integer
+     */
+    public function getWidth();
+
+    /**
+     * Get image height in pixels
+     *
+     * @return integer
+     */
+    public function getHeight();
+}

MediaInterface.php

@@ -0,0 +1,69 @@
+<?php
+
+namespace Symfony\Cmf\Bundle\MediaBundle;
+
+/**
+ * A basic interface for media objects. Be they cloud hosted or local files.
+ *
+ * This is to be kept compatible with the SonataMediaBundle MediaInterface to
+ * allow integration with sonata.
+ */
+interface MediaInterface
+{
+    /**
+     * Get the unique identifier of this media element
+     *
+     * @return string
+     */
+    public function getId();
+
+    /**
+     * The name of this media, e.g. for managing media documents
+     *
+     * For example an image file name.
+     *
+     * @return string
+     */
+    public function getName();
+
+    /**
+     * The caption to show to users
+     *
+     * @return string
+     */
+    public function getCaption();
+
+    /**
+     * The copyright text, e.g. a license name
+     *
+     * @return string
+     */
+    public function getCopyright();
+
+    /**
+     * The name of the author of the media represented by this object
+     *
+     * @return string
+     */
+    public function getAuthorName();
+
+    /**
+     * @param string $name
+     * @param null   $default to be used if $name is not set in the metadata
+     */
+    public function getMetadataValue($name, $default = null);
+
+    /**
+     * Get creation date
+     *
+     * @return \Datetime $createdAt
+     */
+    public function getCreatedAt();
+
+    /**
+     * Get last update date
+     *
+     * @return \Datetime $updatedAt
+     */
+    public function getUpdatedAt();
+}