X-Git-Url: https://git.mxchange.org/?p=mailer.git;a=blobdiff_plain;f=inc%2Fclasses%2Fmiddleware%2Fio%2Fclass_FileIOHandler.php;fp=inc%2Fclasses%2Fmiddleware%2Fio%2Fclass_FileIOHandler.php;h=18147427c1876ae9c699e33282d60543ddc9dde6;hp=0000000000000000000000000000000000000000;hb=666210d9addd5d19b9dba98b05e8b824b4116c9a;hpb=ab9c0550b44bdb6bbb930b4553f687702963801e

diff --git a/inc/classes/middleware/io/class_FileIOHandler.php b/inc/classes/middleware/io/class_FileIOHandler.php
new file mode 100644
index 0000000000..18147427c1
--- /dev/null
+++ b/inc/classes/middleware/io/class_FileIOHandler.php
@@ -0,0 +1,162 @@
+<?php
+/**
+ * This is a file IO handler. It handles reading from and writing to files.
+ * Missing paths in writing process will be automatically created.
+ */
+class FileIOHandler extends BaseMiddleware {
+	/**
+	 * The *real* file input class we shall use for reading data
+	 */
+	private $inputStream = null;
+
+	/**
+	 * The *real* file output class we shall use for reading data
+	 */
+	private $outputStream = null;
+
+	/**
+	 * An instance of this class
+	 */
+	private static $thisInstance = null;
+
+	/**
+	 * Private constructor
+	 *
+	 * @return	void
+	 */
+	private function __construct () {
+		// Call parent constructor
+		parent::constructor(__CLASS__);
+
+		// Set description
+		$this->setPartDescr("Datei-Ein-/Ausgabe-Handler");
+
+		// Create an unique ID
+		$this->createUniqueID();
+
+		// Clean up a little
+		$this->removeNumberFormaters();
+		$this->removeSystemArray();
+
+		// Set own instance
+		self::$thisInstance = $this;
+	}
+
+	/**
+	 * Creates an instance of this class and prepares the IO system. This is
+	 * being done by setting the default file IO class
+	 *
+	 * @return	$ioInstance	A prepared instance of FilIOHandler
+	 */
+	public final static function createFileIOHandler () {
+		// Get instance
+		$ioHandler = new FileIOHandler();
+
+		// Set the *real* file IO instances (both the same)
+		$ioHandler->setInputStream(FileIOStream::createFileIOStream());
+		$ioHandler->setOutputStream(FileIOStream::createFileIOStream());
+
+		// Return instance
+		return $ioHandler;
+	}
+
+	/**
+	 * Getter for an instance of this class
+	 *
+	 * @return	$thisInstance	An instance of this class
+	 */
+	public final static function getInstance () {
+		return self::$thisInstance;
+	}
+	
+	/**
+	 * Setter for the *real* file input instance
+	 *
+	 * @param		$inputStream	The *real* file-input class
+	 */
+	public final function setInputStream (FileInputStreamer $inputStream) {
+		$this->inputStream = $inputStream;
+	}
+
+	/**
+	 * Getter for the *real* file input instance
+	 *
+	 * @return	$inputStream	The *real* file-input class
+	 */
+	public final function getInputStream () {
+		return $this->inputStream;
+	}
+
+	/**
+	 * Setter for the *real* file output instance
+	 *
+	 * @param		$outputStream	The *real* file-output class
+	 */
+	public final function setOutputStream (FileOutputStreamer $outputStream) {
+		$this->outputStream = $outputStream;
+	}
+
+	/**
+	 * Getter for the *real* file output instance
+	 *
+	 * @return	$outputStream	The *real* file-output class
+	 */
+	public final function getOutputStream () {
+		return $this->outputStream;
+	}
+
+	/**
+	 * Saves a file with data by using the current output stream
+	 *
+	 * @see	FileOutputStreamer
+	 */
+	public function saveFile ($fileName, $dataArray) {
+		// Get output stream
+		$outInstance = $this->getOutputStream();
+
+		// Is it a valid stream?
+		if (is_null($outInstance)) {
+			// No class returned
+			throw new NullPointerException($this, self::EXCEPTION_IS_NULL_POINTER);
+		} elseif (!is_object($outInstance)) {
+			// Not an object! ;-(
+			throw new NoObjectException($outInstance, self::EXCEPTION_IS_NO_OBJECT);
+		} elseif (!method_exists($outInstance, 'saveFile')) {
+			// Nope, so throw exception
+			throw new MissingMethodException(array($outInstance, 'saveFile'), self::EXCEPTION_MISSING_METHOD);
+		}
+
+		// Send the fileName and dataArray to the output handler
+		$outInstance->saveFile($fileName, $dataArray);
+	}
+
+	/** Loads data from a file over the input handler
+	 *
+	 * @see	FileInputStreamer
+	 */
+	public function loadFileContents ($fqfn) {
+		// Initialize the array
+		$array = array();
+
+		// Get output stream
+		$inInstance = $this->getInputStream();
+
+		// Is it a valid stream?
+		if (is_null($inInstance)) {
+			// No class returned
+			throw new NullPointerException($this, self::EXCEPTION_IS_NULL_POINTER);
+		} elseif (!is_object($inInstance)) {
+			// Not an object! ;-(
+			throw new NoObjectException($inInstance, self::EXCEPTION_IS_NO_OBJECT);
+		} elseif (!method_exists($inInstance, 'loadFileContents')) {
+			// Nope, so throw exception
+			throw new MissingMethodException(array($inInstance, 'loadFileContents'), self::EXCEPTION_MISSING_METHOD);
+		}
+
+		// Read from the input handler
+		return $inInstance->loadFileContents($fqfn);
+	}
+}
+
+// [EOF]
+?>