Refactor writers for better DI (#427)

This commit is a big refactor that improves the code organization.
It focuses on how dependencies are injected into the different classes. This is now done via some factories.

Also, the code is now built around entities (data model that only exposes getters and setters), managers (used to manage an entity) and helpers (used by the managers to perform some specific tasks).

The refactoring is not fully complete, as some dependencies are still hidden...

src/Spout/Writer/ODS/Factory/InternalFactory.php

@@ -0,0 +1,101 @@
+<?php
+
+namespace Box\Spout\Writer\ODS\Factory;
+
+use Box\Spout\Common\Helper\StringHelper;
+use Box\Spout\Writer\Common\Manager\OptionsManagerInterface;
+use Box\Spout\Writer\Common\Options;
+use Box\Spout\Writer\Factory\EntityFactory;
+use Box\Spout\Writer\Factory\InternalFactoryInterface;
+use Box\Spout\Writer\ODS\Helper\FileSystemHelper;
+use Box\Spout\Writer\ODS\Helper\StyleHelper;
+use Box\Spout\Writer\ODS\Manager\WorkbookManager;
+use Box\Spout\Writer\ODS\Manager\WorksheetManager;
+use \Box\Spout\Common\Escaper;
+
+/**
+ * Class InternalFactory
+ * Factory for all useful types of objects needed by the ODS Writer
+ *
+ * @package Box\Spout\Writer\ODS\Factory
+ */
+class InternalFactory implements InternalFactoryInterface
+{
+    /** @var EntityFactory */
+    private $entityFactory;
+
+    /**
+     * InternalFactory constructor.
+     *
+     * @param EntityFactory $entityFactory
+     */
+    public function __construct(EntityFactory $entityFactory)
+    {
+        $this->entityFactory = $entityFactory;
+    }
+
+    /**
+     * @param OptionsManagerInterface $optionsManager
+     * @return WorkbookManager
+     */
+    public function createWorkbookManager(OptionsManagerInterface $optionsManager)
+    {
+        $workbook = $this->entityFactory->createWorkbook();
+
+        $fileSystemHelper = $this->createFileSystemHelper($optionsManager);
+        $fileSystemHelper->createBaseFilesAndFolders();
+
+        $styleHelper = $this->createStyleHelper($optionsManager);
+        $worksheetManager = $this->createWorksheetManager($styleHelper);
+
+        return new WorkbookManager($workbook, $optionsManager, $worksheetManager, $styleHelper, $fileSystemHelper, $this->entityFactory);
+    }
+
+    /**
+     * @param StyleHelper $styleHelper
+     * @return WorksheetManager
+     */
+    private function createWorksheetManager(StyleHelper $styleHelper)
+    {
+        $stringsEscaper = $this->createStringsEscaper();
+        $stringsHelper = $this->createStringHelper();
+
+        return new WorksheetManager($styleHelper, $stringsEscaper, $stringsHelper);
+    }
+
+    /**
+     * @param OptionsManagerInterface $optionsManager
+     * @return FileSystemHelper
+     */
+    public function createFileSystemHelper(OptionsManagerInterface $optionsManager)
+    {
+        $tempFolder = $optionsManager->getOption(Options::TEMP_FOLDER);
+        return new FileSystemHelper($tempFolder);
+    }
+
+    /**
+     * @param OptionsManagerInterface $optionsManager
+     * @return StyleHelper
+     */
+    private function createStyleHelper(OptionsManagerInterface $optionsManager)
+    {
+        $defaultRowStyle = $optionsManager->getOption(Options::DEFAULT_ROW_STYLE);
+        return new StyleHelper($defaultRowStyle);
+    }
+
+    /**
+     * @return Escaper\ODS
+     */
+    private function createStringsEscaper()
+    {
+        return Escaper\ODS::getInstance();
+    }
+
+    /**
+     * @return StringHelper
+     */
+    private function createStringHelper()
+    {
+        return new StringHelper();
+    }
+}