[CLEANUP] General code cleanup
authorAlexander Schnitzler <alex.schnitzler@typovision.de>
Sun, 26 Aug 2012 11:10:21 +0000 (13:10 +0200)
committerChristian Kuhn <lolli@schwarzbu.ch>
Sun, 26 Aug 2012 13:56:59 +0000 (15:56 +0200)
* Cleaned up wrong PHPDoc
* Removed unused variables
* Added missing fields
* Fixed type incompatibility

Change-Id: I3ecc49ceb25458dda285cc4e005c5c2d44112100
Fixes: #40224
Releases: 6.0
Reviewed-on: http://review.typo3.org/14106
Reviewed-by: Christian Kuhn
Tested-by: Christian Kuhn
85 files changed:
typo3/sysext/extbase/Classes/Configuration/ConfigurationManager.php
typo3/sysext/extbase/Classes/Configuration/FrontendConfigurationManager.php
typo3/sysext/extbase/Classes/Core/Bootstrap.php
typo3/sysext/extbase/Classes/Domain/Model/BackendUser.php
typo3/sysext/extbase/Classes/Domain/Model/Category.php
typo3/sysext/extbase/Classes/Domain/Model/FrontendUser.php
typo3/sysext/extbase/Classes/DomainObject/AbstractDomainObject.php
typo3/sysext/extbase/Classes/Mvc/Cli/Command.php
typo3/sysext/extbase/Classes/Mvc/Cli/Request.php
typo3/sysext/extbase/Classes/Mvc/Cli/RequestBuilder.php
typo3/sysext/extbase/Classes/Mvc/Cli/Response.php
typo3/sysext/extbase/Classes/Mvc/Controller/AbstractController.php
typo3/sysext/extbase/Classes/Mvc/Controller/ActionController.php
typo3/sysext/extbase/Classes/Mvc/Controller/Argument.php
typo3/sysext/extbase/Classes/Mvc/Controller/Arguments.php
typo3/sysext/extbase/Classes/Mvc/Controller/ArgumentsValidator.php
typo3/sysext/extbase/Classes/Mvc/Controller/CommandController.php
typo3/sysext/extbase/Classes/Mvc/Controller/FlashMessages.php
typo3/sysext/extbase/Classes/Mvc/Dispatcher.php
typo3/sysext/extbase/Classes/Mvc/Exception/AmbiguousCommandIdentifierException.php
typo3/sysext/extbase/Classes/Mvc/Request.php
typo3/sysext/extbase/Classes/Mvc/RequestHandlerResolver.php
typo3/sysext/extbase/Classes/Mvc/Web/BackendRequestHandler.php
typo3/sysext/extbase/Classes/Mvc/Web/FrontendRequestHandler.php
typo3/sysext/extbase/Classes/Mvc/Web/RequestBuilder.php
typo3/sysext/extbase/Classes/Mvc/Web/Response.php
typo3/sysext/extbase/Classes/Mvc/Web/Routing/UriBuilder.php
typo3/sysext/extbase/Classes/Object/Container/ClassInfoFactory.php
typo3/sysext/extbase/Classes/Object/Container/Container.php
typo3/sysext/extbase/Classes/Object/ObjectManagerException.php
typo3/sysext/extbase/Classes/Persistence/Generic/Backend.php
typo3/sysext/extbase/Classes/Persistence/Generic/IdentityMap.php
typo3/sysext/extbase/Classes/Persistence/Generic/LazyLoadingProxy.php
typo3/sysext/extbase/Classes/Persistence/Generic/LazyObjectStorage.php
typo3/sysext/extbase/Classes/Persistence/Generic/ManagerInterface.php
typo3/sysext/extbase/Classes/Persistence/Generic/Mapper/ColumnMap.php
typo3/sysext/extbase/Classes/Persistence/Generic/Mapper/DataMap.php
typo3/sysext/extbase/Classes/Persistence/Generic/Mapper/DataMapFactory.php
typo3/sysext/extbase/Classes/Persistence/Generic/Mapper/DataMapper.php
typo3/sysext/extbase/Classes/Persistence/Generic/ObjectStorage.php
typo3/sysext/extbase/Classes/Persistence/Generic/PropertyType.php
typo3/sysext/extbase/Classes/Persistence/Generic/Qom/Join.php
typo3/sysext/extbase/Classes/Persistence/Generic/Qom/JoinInterface.php
typo3/sysext/extbase/Classes/Persistence/Generic/Qom/LowerCase.php
typo3/sysext/extbase/Classes/Persistence/Generic/Qom/Ordering.php
typo3/sysext/extbase/Classes/Persistence/Generic/Qom/QueryObjectModelFactory.php
typo3/sysext/extbase/Classes/Persistence/Generic/Qom/Selector.php
typo3/sysext/extbase/Classes/Persistence/Generic/Qom/SelectorInterface.php
typo3/sysext/extbase/Classes/Persistence/Generic/Qom/Statement.php
typo3/sysext/extbase/Classes/Persistence/Generic/Qom/UpperCase.php
typo3/sysext/extbase/Classes/Persistence/Generic/Query.php
typo3/sysext/extbase/Classes/Persistence/Generic/QueryResult.php
typo3/sysext/extbase/Classes/Persistence/Generic/QuerySettingsInterface.php
typo3/sysext/extbase/Classes/Persistence/Generic/Session.php
typo3/sysext/extbase/Classes/Persistence/Generic/Storage/BackendInterface.php
typo3/sysext/extbase/Classes/Persistence/Generic/Storage/Typo3DbBackend.php
typo3/sysext/extbase/Classes/Persistence/Generic/Typo3QuerySettings.php
typo3/sysext/extbase/Classes/Persistence/Repository.php
typo3/sysext/extbase/Classes/Property/Mapper.php
typo3/sysext/extbase/Classes/Property/PropertyMapper.php
typo3/sysext/extbase/Classes/Property/PropertyMappingConfiguration.php
typo3/sysext/extbase/Classes/Property/PropertyMappingConfigurationInterface.php
typo3/sysext/extbase/Classes/Property/TypeConverter/AbstractFileCollectionConverter.php
typo3/sysext/extbase/Classes/Property/TypeConverter/AbstractFileFolderConverter.php
typo3/sysext/extbase/Classes/Property/TypeConverter/DateTimeConverter.php
typo3/sysext/extbase/Classes/Property/TypeConverter/PersistentObjectConverter.php
typo3/sysext/extbase/Classes/Reflection/ClassReflection.php
typo3/sysext/extbase/Classes/Reflection/ClassSchema.php
typo3/sysext/extbase/Classes/Reflection/DocCommentParser.php
typo3/sysext/extbase/Classes/Reflection/ObjectAccess.php
typo3/sysext/extbase/Classes/Reflection/PropertyReflection.php
typo3/sysext/extbase/Classes/Reflection/Service.php
typo3/sysext/extbase/Classes/Scheduler/FieldProvider.php
typo3/sysext/extbase/Classes/Security/Channel/RequestHashService.php
typo3/sysext/extbase/Classes/Service/ExtensionService.php
typo3/sysext/extbase/Classes/Service/TypeHandlingService.php
typo3/sysext/extbase/Classes/SignalSlot/Dispatcher.php
typo3/sysext/extbase/Classes/Utility/ArrayUtility.php
typo3/sysext/extbase/Classes/Utility/DebuggerUtility.php
typo3/sysext/extbase/Classes/Utility/ExtensionUtility.php
typo3/sysext/extbase/Classes/Utility/FrontendSimulatorUtility.php
typo3/sysext/extbase/Classes/Validation/Validator/AbstractCompositeValidator.php
typo3/sysext/extbase/Classes/Validation/Validator/GenericObjectValidator.php
typo3/sysext/extbase/Classes/Validation/Validator/StringLengthValidator.php
typo3/sysext/extbase/Classes/Validation/ValidatorResolver.php

index 2caa076..ba7630f 100644 (file)
@@ -100,6 +100,7 @@ class ConfigurationManager implements \TYPO3\CMS\Extbase\Configuration\Configura
         * @param string $configurationType The kind of configuration to fetch - must be one of the CONFIGURATION_TYPE_* constants
         * @param string $extensionName if specified, the configuration for the given extension will be returned.
         * @param string $pluginName if specified, the configuration for the given plugin will be returned.
+        * @throws Exception\InvalidConfigurationType
         * @return array The configuration
         */
        public function getConfiguration($configurationType, $extensionName = NULL, $pluginName = NULL) {
index bd643d5..a4c6365 100644 (file)
@@ -145,7 +145,7 @@ class FrontendConfigurationManager extends \TYPO3\CMS\Extbase\Configuration\Abst
        /**
         * Overrides configuration settings from the plugin typoscript (plugin.tx_myext_pi1.)
         *
-        * @param array the framework configuration
+        * @param array $frameworkConfiguration the framework configuration
         * @return array the framework configuration with overridden data from typoscript
         */
        protected function overrideConfigurationFromPlugin(array $frameworkConfiguration) {
@@ -165,7 +165,7 @@ class FrontendConfigurationManager extends \TYPO3\CMS\Extbase\Configuration\Abst
         * Overrides configuration settings from flexForms.
         * This merges the whole flexForm data, and overrides switchable controller actions.
         *
-        * @param array the framework configuration
+        * @param array $frameworkConfiguration the framework configuration
         * @return array the framework configuration with overridden data from flexForm
         */
        protected function overrideConfigurationFromFlexForm(array $frameworkConfiguration) {
@@ -228,6 +228,7 @@ class FrontendConfigurationManager extends \TYPO3\CMS\Extbase\Configuration\Abst
         *
         * @param array $frameworkConfiguration The original framework configuration
         * @param array $flexFormConfiguration The full flexForm configuration
+        * @throws Exception\ParseError
         * @return array the modified framework configuration, if needed
         */
        protected function overrideSwitchableControllerActionsFromFlexForm(array $frameworkConfiguration, array $flexFormConfiguration) {
index 87fc615..8d931be 100644 (file)
@@ -81,6 +81,7 @@ class Bootstrap implements \TYPO3\CMS\Extbase\Core\BootstrapInterface {
         * the initialization and request handling process. Most other applications just call the run() method.
         *
         * @param array $configuration The TS configuration array
+        * @throws \RuntimeException
         * @return void
         * @see run()
         * @api
@@ -254,6 +255,7 @@ class Bootstrap implements \TYPO3\CMS\Extbase\Core\BootstrapInterface {
         * function of TYPO3.
         *
         * @param string $moduleSignature
+        * @throws \RuntimeException
         * @return boolean TRUE, if the request request could be dispatched
         * @see run()
         */
index 6a89a91..ca38fc3 100644 (file)
@@ -55,12 +55,12 @@ class BackendUser extends \TYPO3\CMS\Extbase\DomainObject\AbstractEntity {
        protected $isDisabled = FALSE;
 
        /**
-        * @var DateTime|NULL
+        * @var \DateTime|NULL
         */
        protected $startDateAndTime = NULL;
 
        /**
-        * @var DateTime|NULL
+        * @var \DateTime|NULL
         */
        protected $endDateAndTime = NULL;
 
@@ -75,7 +75,7 @@ class BackendUser extends \TYPO3\CMS\Extbase\DomainObject\AbstractEntity {
        protected $realName = '';
 
        /**
-        * @var DateTime|NULL
+        * @var \DateTime|NULL
         */
        protected $lastLoginDateAndTime;
 
index bd0c286..c0bb9c5 100755 (executable)
@@ -144,7 +144,7 @@ class Category extends \TYPO3\CMS\Extbase\DomainObject\AbstractEntity {
        /**
         * Returns the items within this category.
         *
-        * @return Tx_Extbase_Persistence_ObjectStorage<Tx_Extbase_DomainObject_AbstractEntity> the items, might be empty
+        * @return \TYPO3\CMS\Extbase\Persistence\Generic\ObjectStorage the items, might be empty
         * @api
         */
        public function getItems() {
@@ -154,7 +154,7 @@ class Category extends \TYPO3\CMS\Extbase\DomainObject\AbstractEntity {
        /**
         * Sets the items within this category.
         *
-        * @param Tx_Extbase_Persistence_ObjectStorage<Tx_Extbase_DomainObject_AbstractEntity> $items the items, may be empty
+        * @param \TYPO3\CMS\Extbase\Persistence\Generic\ObjectStorage $items
         * @return void
         * @api
         */
index e8af8a3..4779d4b 100644 (file)
@@ -131,12 +131,12 @@ class FrontendUser extends \TYPO3\CMS\Extbase\DomainObject\AbstractEntity {
        protected $image = '';
 
        /**
-        * @var DateTime|NULL
+        * @var \DateTime|NULL
         */
        protected $lastlogin = NULL;
 
        /**
-        * @var DateTime|NULL
+        * @var \DateTime|NULL
         */
        protected $isOnline = NULL;
 
@@ -579,7 +579,7 @@ class FrontendUser extends \TYPO3\CMS\Extbase\DomainObject\AbstractEntity {
        /**
         * Sets the lastlogin value
         *
-        * @param DateTime $lastlogin
+        * @param \DateTime $lastlogin
         * @return void
         * @api
         */
@@ -590,7 +590,7 @@ class FrontendUser extends \TYPO3\CMS\Extbase\DomainObject\AbstractEntity {
        /**
         * Returns the lastlogin value
         *
-        * @return DateTime
+        * @return \DateTime
         * @api
         */
        public function getLastlogin() {
@@ -600,7 +600,7 @@ class FrontendUser extends \TYPO3\CMS\Extbase\DomainObject\AbstractEntity {
        /**
         * Sets the isOnline value
         *
-        * @param DateTime $isOnline
+        * @param \DateTime $isOnline
         * @return void
         * @api
         */
@@ -611,7 +611,7 @@ class FrontendUser extends \TYPO3\CMS\Extbase\DomainObject\AbstractEntity {
        /**
         * Returns the isOnline value
         *
-        * @return DateTime
+        * @return \DateTime
         * @api
         */
        public function getIsOnline() {
index 2ee7508..550adba 100644 (file)
@@ -62,7 +62,7 @@ abstract class AbstractDomainObject implements \TYPO3\CMS\Extbase\DomainObject\D
        private $_isClone = FALSE;
 
        /**
-        * @var An array holding the clean property values. Set right after reconstitution of the object
+        * @var array An array holding the clean property values. Set right after reconstitution of the object
         */
        private $_cleanProperties;
 
@@ -259,6 +259,7 @@ abstract class AbstractDomainObject implements \TYPO3\CMS\Extbase\DomainObject\D
         * Returns TRUE if the properties were modified after reconstitution
         *
         * @param string $propertyName An optional name of a property to be checked if its value is dirty
+        * @throws \TYPO3\CMS\Extbase\Persistence\Generic\Exception\TooDirtyException
         * @return boolean
         */
        public function _isDirty($propertyName = NULL) {
@@ -284,10 +285,9 @@ abstract class AbstractDomainObject implements \TYPO3\CMS\Extbase\DomainObject\D
         *
         * @param mixed $previousValue
         * @param mixed $currentValue
-        * @return boolan
+        * @return boolean
         */
        protected function isPropertyDirty($previousValue, $currentValue) {
-               $result = FALSE;
                // In case it is an object and it implements the ObjectMonitoringInterface, we call _isDirty() instead of a simple comparison of objects.
                // We do this, because if the object itself contains a lazy loaded property, the comparison of the objects might fail even if the object didn't change
                if (is_object($currentValue)) {
index 3194c04..97c7e1f 100644 (file)
@@ -68,6 +68,7 @@ class Command {
         *
         * @param string $controllerClassName Class name of the controller providing the command
         * @param string $controllerCommandName Command name, i.e. the method name of the command, without the "Command" suffix
+        * @throws \InvalidArgumentException
         * @author Robert Lemke <robert@typo3.org>
         */
        public function __construct($controllerClassName, $controllerCommandName) {
index 8aa945c..015b072 100644 (file)
@@ -194,6 +194,7 @@ class Request implements \TYPO3\CMS\Extbase\Mvc\RequestInterface {
         *
         * @param string $argumentName Name of the argument to set
         * @param mixed $value The new value
+        * @throws \TYPO3\CMS\Extbase\Mvc\Exception\InvalidArgumentNameException
         * @return void
         */
        public function setArgument($argumentName, $value) {
index 67ed255..34448a3 100644 (file)
@@ -114,6 +114,7 @@ class RequestBuilder {
         * @param array $rawCommandLineArguments The unparsed command parts (such as "--foo") as an array
         * @param string $controllerObjectName Object name of the designated command controller
         * @param string $controllerCommandName Command name of the recognized command (ie. method name without "Command" suffix)
+        * @throws \TYPO3\CMS\Extbase\Mvc\Exception\InvalidArgumentMixingException
         * @return array All and exceeding command line arguments
         * @author Robert Lemke <robert@typo3.org>
         */
index a1cc332..ecd8a0b 100644 (file)
@@ -41,6 +41,7 @@ class Response extends \TYPO3\CMS\Extbase\Mvc\Response {
         * Sets the numerical exit code which should be returned when exiting this application.
         *
         * @param integer $exitCode
+        * @throws \InvalidArgumentException
         * @return void
         * @api
         */
index 34e088a..935dfa3 100644 (file)
@@ -397,6 +397,7 @@ abstract class AbstractController implements \TYPO3\CMS\Extbase\Mvc\Controller\C
        /**
         * Maps arguments delivered by the request object to the local controller arguments.
         *
+        * @throws Exception\RequiredArgumentMissingException
         * @return void
         */
        protected function mapRequestArgumentsToControllerArguments() {
@@ -418,6 +419,7 @@ abstract class AbstractController implements \TYPO3\CMS\Extbase\Mvc\Controller\C
                                        $optionalPropertyNames[] = $propertyName;
                                }
                        }
+                       /** @var $validator ArgumentsValidator */
                        $validator = $this->objectManager->create('TYPO3\\CMS\\Extbase\\Mvc\\Controller\\ArgumentsValidator');
                        $this->deprecatedPropertyMapper->mapAndValidate($allPropertyNames, $this->request->getArguments(), $this->arguments, $optionalPropertyNames, $validator);
                        $this->argumentsMappingResults = $this->deprecatedPropertyMapper->getMappingResults();
index 3549969..5b073a5 100644 (file)
@@ -134,6 +134,7 @@ class ActionController extends \TYPO3\CMS\Extbase\Mvc\Controller\AbstractControl
         *
         * @param \TYPO3\CMS\Extbase\Mvc\RequestInterface $request The request object
         * @param \TYPO3\CMS\Extbase\Mvc\ResponseInterface $response The response, modified by this handler
+        * @throws \TYPO3\CMS\Extbase\Mvc\Exception\UnsupportedRequestTypeException
         * @return void
         */
        public function processRequest(\TYPO3\CMS\Extbase\Mvc\RequestInterface $request, \TYPO3\CMS\Extbase\Mvc\ResponseInterface $response) {
@@ -172,6 +173,7 @@ class ActionController extends \TYPO3\CMS\Extbase\Mvc\Controller\AbstractControl
         *
         * Don't override this method - use initializeAction() instead.
         *
+        * @throws \TYPO3\CMS\Extbase\Mvc\Exception\InvalidArgumentTypeException
         * @return void
         * @see initializeArguments()
         */
@@ -287,7 +289,6 @@ class ActionController extends \TYPO3\CMS\Extbase\Mvc\Controller\AbstractControl
                        }
                } else {
                        // @deprecated since Extbase 1.4.0, will be removed with Extbase 6.0
-                       $argumentsAreValid = TRUE;
                        $preparedArguments = array();
                        foreach ($this->arguments as $argument) {
                                $preparedArguments[] = $argument->getValue();
@@ -318,6 +319,7 @@ class ActionController extends \TYPO3\CMS\Extbase\Mvc\Controller\AbstractControl
        protected function resolveView() {
                $viewObjectName = $this->resolveViewObjectName();
                if ($viewObjectName !== FALSE) {
+                       /** @var $view \TYPO3\CMS\Extbase\Mvc\View\ViewInterface */
                        $view = $this->objectManager->create($viewObjectName);
                        $this->setViewConfiguration($view);
                        if ($view->canRender($this->controllerContext) === FALSE) {
@@ -325,6 +327,7 @@ class ActionController extends \TYPO3\CMS\Extbase\Mvc\Controller\AbstractControl
                        }
                }
                if (!isset($view) && $this->defaultViewObjectName != '') {
+                       /** @var $view \TYPO3\CMS\Extbase\Mvc\View\ViewInterface */
                        $view = $this->objectManager->create($this->defaultViewObjectName);
                        $this->setViewConfiguration($view);
                        if ($view->canRender($this->controllerContext) === FALSE) {
index ad048ec..7070bcf 100644 (file)
@@ -179,7 +179,7 @@ class Argument {
         *
         * @param string $name Name of this argument
         * @param string $dataType The data type of this argument
-        * @throws InvalidArgumentException if $name is not a string or empty
+        * @throws \InvalidArgumentException if $name is not a string or empty
         * @api
         */
        public function __construct($name, $dataType) {
@@ -296,8 +296,8 @@ class Argument {
         * Sets the short name of this argument.
         *
         * @param string $shortName A "short name" - a single character
+        * @throws \InvalidArgumentException if $shortName is not a character
         * @return \TYPO3\CMS\Extbase\Mvc\Controller\Argument $this
-        * @throws InvalidArgumentException if $shortName is not a character
         * @api
         */
        public function setShortName($shortName) {
@@ -482,6 +482,7 @@ class Argument {
         * Additionally, it maps arrays to objects in case it is a normal object.
         *
         * @param mixed $value The value of an argument
+        * @throws \TYPO3\CMS\Extbase\Mvc\Exception\InvalidArgumentValueException
         * @return mixed
         * @deprecated since Extbase 1.4, will be removed in Extbase 6.0
         */
index c559270..1d45b59 100644 (file)
@@ -74,8 +74,8 @@ class Arguments extends \ArrayObject {
         *
         * @param mixed $offset Offset - not used here
         * @param mixed $value The argument
+        * @throws \InvalidArgumentException if the argument is not a valid Controller Argument object
         * @return void
-        * @throws InvalidArgumentException if the argument is not a valid Controller Argument object
         */
        public function offsetSet($offset, $value) {
                if (!$value instanceof \TYPO3\CMS\Extbase\Mvc\Controller\Argument) {
@@ -90,8 +90,8 @@ class Arguments extends \ArrayObject {
         * Sets an argument, aliased to offsetSet()
         *
         * @param mixed $value The value
+        * @throws \InvalidArgumentException if the argument is not a valid Controller Argument object
         * @return void
-        * @throws InvalidArgumentException if the argument is not a valid Controller Argument object
         */
        public function append($value) {
                if (!$value instanceof \TYPO3\CMS\Extbase\Mvc\Controller\Argument) {
@@ -228,6 +228,7 @@ class Arguments extends \ArrayObject {
         *
         * @param string $methodName Name of the method
         * @param array $arguments Method arguments
+        * @throws \LogicException
         * @return void
         */
        public function __call($methodName, array $arguments) {
index 615a15e..7280b2b 100644 (file)
@@ -44,6 +44,7 @@ class ArgumentsValidator extends \TYPO3\CMS\Extbase\Validation\Validator\Abstrac
         * be retrieved through the getErrors() method.
         *
         * @param object $arguments The arguments object that should be validated
+        * @throws \InvalidArgumentException
         * @return boolean TRUE if all arguments are valid, FALSE if an error occured
         */
        public function isValid($arguments) {
@@ -79,6 +80,7 @@ class ArgumentsValidator extends \TYPO3\CMS\Extbase\Validation\Validator\Abstrac
         *
         * @param object $arguments The arguments object containing the property (argument) to validate
         * @param string $argumentName Name of the property (ie. name of the argument) to validate
+        * @throws \InvalidArgumentException
         * @return boolean TRUE if the argument is valid, FALSE if an error occured
         */
        public function isPropertyValid($arguments, $argumentName) {
index 88b6513..c793ed0 100644 (file)
@@ -97,8 +97,8 @@ class CommandController implements \TYPO3\CMS\Extbase\Mvc\Controller\CommandCont
         *
         * @param \TYPO3\CMS\Extbase\Mvc\RequestInterface $request The request object
         * @param \TYPO3\CMS\Extbase\Mvc\ResponseInterface $response The response, modified by this controller
+        * @throws \TYPO3\CMS\Extbase\Mvc\Exception\UnsupportedRequestTypeException
         * @return void
-        * @throws Tx_Extbase_MVC_Exception_UnsupportedRequestTypeException if the controller doesn't support the current request type
         * @author Robert Lemke <robert@typo3.org>
         * @api
         */
@@ -121,6 +121,7 @@ class CommandController implements \TYPO3\CMS\Extbase\Mvc\Controller\CommandCont
         * Note: The resulting command method name might not have the correct case, which isn't a problem because PHP is
         * case insensitive regarding method names.
         *
+        * @throws \TYPO3\CMS\Extbase\Mvc\Exception\NoSuchCommandException
         * @return string Method name of the current command
         * @author Robert Lemke <robert@typo3.org>
         */
@@ -136,6 +137,7 @@ class CommandController implements \TYPO3\CMS\Extbase\Mvc\Controller\CommandCont
         * Initializes the arguments array of this controller by creating an empty argument object for each of the
         * method arguments found in the designated command method.
         *
+        * @throws \TYPO3\CMS\Extbase\Mvc\Exception\InvalidArgumentTypeException
         * @return void
         * @author Robert Lemke <robert@typo3.org>
         */
@@ -184,6 +186,7 @@ class CommandController implements \TYPO3\CMS\Extbase\Mvc\Controller\CommandCont
         * @param string $commandName
         * @param string $controllerObjectName
         * @param array $arguments
+        * @throws \TYPO3\CMS\Extbase\Mvc\Exception\StopActionException
         * @return void
         */
        protected function forward($commandName, $controllerObjectName = NULL, array $arguments = array()) {
@@ -227,7 +230,7 @@ class CommandController implements \TYPO3\CMS\Extbase\Mvc\Controller\CommandCont
         * @see http://www.php.net/sprintf
         * @param string $text Text to output
         * @param array $arguments Optional arguments to use for sprintf
-        * @return void
+        * @return string
         */
        protected function output($text, array $arguments = array()) {
                if ($arguments !== array()) {
@@ -253,6 +256,7 @@ class CommandController implements \TYPO3\CMS\Extbase\Mvc\Controller\CommandCont
         * An exit status code can be specified @see http://www.php.net/exit
         *
         * @param integer $exitCode Exit code to return on exit
+        * @throws \TYPO3\CMS\Extbase\Mvc\Exception\StopActionException
         * @return void
         */
        protected function quit($exitCode = 0) {
index 9f0fcbf..b11127a 100644 (file)
@@ -49,6 +49,7 @@ class FlashMessages implements \TYPO3\CMS\Core\SingletonInterface {
         * @param string $message
         * @param string $title optional message title
         * @param integer $severity optional severity code. One of the t3lib_FlashMessage constants
+        * @throws \InvalidArgumentException
         * @return void
         * @api
         */
index b9b3640..c595fb0 100644 (file)
@@ -85,6 +85,7 @@ class Dispatcher implements \TYPO3\CMS\Core\SingletonInterface {
         *
         * @param \TYPO3\CMS\Extbase\Mvc\RequestInterface $request The request to dispatch
         * @param \TYPO3\CMS\Extbase\Mvc\ResponseInterface $response The response, to be modified by the controller
+        * @throws Exception\InfiniteLoopException
         * @return void
         */
        public function dispatch(\TYPO3\CMS\Extbase\Mvc\RequestInterface $request, \TYPO3\CMS\Extbase\Mvc\ResponseInterface $response) {
@@ -108,6 +109,7 @@ class Dispatcher implements \TYPO3\CMS\Core\SingletonInterface {
         * If no controller can be found, an instance of NotFoundControllerInterface is returned.
         *
         * @param \TYPO3\CMS\Extbase\Mvc\RequestInterface $request The request to dispatch
+        * @throws Exception\InvalidControllerException
         * @return \TYPO3\CMS\Extbase\Mvc\Controller\ControllerInterface
         * @author Bastian Waidelich <bastian@typo3.org>
         * @author Robert Lemke <robert@typo3.org>
index f7ad96c..69bad32 100644 (file)
@@ -43,8 +43,8 @@ class AmbiguousCommandIdentifierException extends \TYPO3\CMS\Extbase\Mvc\Excepti
         *
         * @param string $message
         * @param integer $code
-        * @param Exception $previousException
-        * @param array<Tx_Extbase_MVC_CLI_Command> $matchingCommands Commands that matched the command identifier
+        * @param \Exception|NULL $previousException
+        * @param array $matchingCommands <Tx_Extbase_MVC_CLI_Command> $matchingCommands Commands that matched the command identifier
         * @see Exception
         * @author Bastian Waidelich <bastian@typo3.org>
         */
index 4ef6710..3da8791 100644 (file)
@@ -270,6 +270,7 @@ class Request implements \TYPO3\CMS\Extbase\Mvc\RequestInterface {
         * Note: This is not the object name of the controller!
         *
         * @param string $controllerName Name of the controller
+        * @throws Exception\InvalidControllerNameException
         * @return void
         */
        public function setControllerName($controllerName) {
@@ -341,6 +342,7 @@ class Request implements \TYPO3\CMS\Extbase\Mvc\RequestInterface {
         *
         * @param string $argumentName Name of the argument to set
         * @param mixed $value The new value
+        * @throws Exception\InvalidArgumentNameException
         * @return void
         */
        public function setArgument($argumentName, $value) {
index 13090dd..ba67d56 100644 (file)
@@ -37,7 +37,7 @@ class RequestHandlerResolver {
        protected $objectManager;
 
        /**
-        * @var Tx_Extbase_Reflection_ReflectionService
+        * @var \TYPO3\CMS\Extbase\Reflection\Service
         */
        protected $reflectionService;
 
@@ -80,7 +80,7 @@ class RequestHandlerResolver {
         * Analyzes the raw request and tries to find a request handler which can handle
         * it. If none is found, an exception is thrown.
         *
-        * @return Tx_Extbase_MVC_RequestHandler A request handler
+        * @return \TYPO3\CMS\Extbase\Mvc\RequestHandlerInterface A request handler
         * @throws \TYPO3\CMS\Extbase\Mvc\Exception
         */
        public function resolveRequestHandler() {
index c71a135..b9c5852 100644 (file)
@@ -41,6 +41,7 @@ class BackendRequestHandler extends \TYPO3\CMS\Extbase\Mvc\Web\AbstractRequestHa
                /** @var $requestHashService \TYPO3\CMS\Extbase\Security\Channel\RequestHashService */
                $requestHashService = $this->objectManager->get('TYPO3\\CMS\\Extbase\\Security\\Channel\\RequestHashService');
                $requestHashService->verifyRequest($request);
+               /** @var $response \TYPO3\CMS\Extbase\Mvc\ResponseInterface */
                $response = $this->objectManager->create('TYPO3\\CMS\\Extbase\\Mvc\\Web\\Response');
                $this->dispatcher->dispatch($request, $response);
                return $response;
index 93f449e..3196ca6 100644 (file)
@@ -60,7 +60,7 @@ class FrontendRequestHandler extends \TYPO3\CMS\Extbase\Mvc\Web\AbstractRequestH
        /**
         * Handles the web request. The response will automatically be sent to the client.
         *
-        * @return Tx_Extbase_MVC_Web_Response|NULL
+        * @return \TYPO3\CMS\Extbase\Mvc\ResponseInterface|NULL
         */
        public function handleRequest() {
                $request = $this->requestBuilder->build();
@@ -78,6 +78,7 @@ class FrontendRequestHandler extends \TYPO3\CMS\Extbase\Mvc\Web\AbstractRequestH
                        }
                        $request->setIsCached(FALSE);
                }
+               /** @var $response \TYPO3\CMS\Extbase\Mvc\ResponseInterface */
                $response = $this->objectManager->create('TYPO3\\CMS\\Extbase\\Mvc\\Web\\Response');
                $this->dispatcher->dispatch($request, $response);
                return $response;
index 09f9b47..a6946ce 100644 (file)
@@ -111,6 +111,7 @@ class RequestBuilder implements \TYPO3\CMS\Core\SingletonInterface {
        }
 
        /**
+        * @throws \TYPO3\CMS\Extbase\Mvc\Exception
         * @return void
         */
        protected function loadDefaultValues() {
@@ -173,8 +174,10 @@ class RequestBuilder implements \TYPO3\CMS\Core\SingletonInterface {
         * If that's not available, an exception is thrown.
         *
         * @param array $parameters
-        * @return string
+        * @throws \TYPO3\CMS\Extbase\Mvc\Exception\InvalidControllerNameException
         * @throws \TYPO3\CMS\Extbase\Mvc\Exception if the controller could not be resolved
+        * @throws \TYPO3\CMS\Core\Error\Http\PageNotFoundException
+        * @return string
         */
        protected function resolveControllerName(array $parameters) {
                if (!isset($parameters['controller']) || strlen($parameters['controller']) === 0) {
@@ -203,8 +206,10 @@ class RequestBuilder implements \TYPO3\CMS\Core\SingletonInterface {
         *
         * @param $controllerName
         * @param array $parameters
+        * @throws \TYPO3\CMS\Extbase\Mvc\Exception\InvalidActionNameException
+        * @throws \TYPO3\CMS\Extbase\Mvc\Exception
+        * @throws \TYPO3\CMS\Core\Error\Http\PageNotFoundException
         * @return string
-        * @throws t3lib_error_http_PageNotFoundException|Tx_Extbase_MVC_Exception|Tx_Extbase_MVC_Exception_InvalidActionName if the action could not be resolved
         */
        protected function resolveActionName($controllerName, array $parameters) {
                $defaultActionName = is_array($this->allowedControllerActions[$controllerName]) ? current($this->allowedControllerActions[$controllerName]) : '';
index 7f8a890..e8e070a 100644 (file)
@@ -115,8 +115,8 @@ class Response extends \TYPO3\CMS\Extbase\Mvc\Response {
         *
         * @param integer $code The status code
         * @param string $message If specified, this message is sent instead of the standard message
+        * @throws \InvalidArgumentException if the specified status code is not valid
         * @return void
-        * @throws InvalidArgumentException if the specified status code is not valid
         * @api
         */
        public function setStatus($code, $message = NULL) {
@@ -146,6 +146,7 @@ class Response extends \TYPO3\CMS\Extbase\Mvc\Response {
         * @param string $name Name of the header, for example "Location", "Content-Description" etc.
         * @param mixed $value The value of the given header
         * @param boolean $replaceExistingHeader If a header with the same name should be replaced. Default is TRUE.
+        * @throws \InvalidArgumentException
         * @return void
         * @api
         */
@@ -218,6 +219,7 @@ class Response extends \TYPO3\CMS\Extbase\Mvc\Response {
         *
         * @TODO The workround and the $request member should be removed again, once the PageRender does support non-cached USER_INTs
         * @param string $additionalHeaderData The value additonal header
+        * @throws \InvalidArgumentException
         * @return void
         * @api
         */
index badfc06..ed4c6ce 100644 (file)
@@ -646,6 +646,7 @@ class UriBuilder {
         * into an arrays containing the uid of the domain object.
         *
         * @param array $arguments The arguments to be iterated
+        * @throws \TYPO3\CMS\Extbase\Mvc\Exception\InvalidArgumentValueException
         * @return array The modified arguments array
         */
        protected function convertDomainObjectsToIdentityArrays(array $arguments) {
index 53c39a2..2b6abfc 100644 (file)
@@ -37,6 +37,7 @@ class ClassInfoFactory {
         * Factory metod that builds a ClassInfo Object for the given classname - using reflection
         *
         * @param string $className The class name to build the class info for
+        * @throws Exception\UnknownObjectException
         * @return \TYPO3\CMS\Extbase\Object\Container\ClassInfo the class info
         */
        public function buildClassInfoFromClassName($className) {
@@ -56,7 +57,7 @@ class ClassInfoFactory {
        /**
         * Build a list of constructor arguments
         *
-        * @param ReflectionClass $reflectedClass
+        * @param \ReflectionClass $reflectedClass
         * @return array of parameter infos for constructor
         */
        private function getConstructorArguments(\ReflectionClass $reflectedClass) {
@@ -84,6 +85,7 @@ class ClassInfoFactory {
         * Build a list of inject methods for the given class.
         *
         * @param \ReflectionClass $reflectedClass
+        * @throws \Exception
         * @return array (nameOfInjectMethod => nameOfClassToBeInjected)
         */
        private function getInjectMethods(\ReflectionClass $reflectedClass) {
@@ -108,7 +110,7 @@ class ClassInfoFactory {
        /**
         * Build a list of properties to be injected for the given class.
         *
-        * @param ReflectionClass $reflectedClass
+        * @param \ReflectionClass $reflectedClass
         * @return array (nameOfInjectProperty => nameOfClassToBeInjected)
         */
        private function getInjectProperties(\ReflectionClass $reflectedClass) {
index a7d32c8..532b6be 100644 (file)
@@ -138,6 +138,8 @@ class Container implements \TYPO3\CMS\Core\SingletonInterface {
         *
         * @param string $className
         * @param array $givenConstructorArguments the list of constructor arguments as array
+        * @throws \TYPO3\CMS\Extbase\Object\Exception
+        * @throws \TYPO3\CMS\Extbase\Object\Exception\CannotBuildObjectException
         * @return object the built object
         */
        protected function getInstanceInternal($className, $givenConstructorArguments = array()) {
@@ -181,6 +183,7 @@ class Container implements \TYPO3\CMS\Core\SingletonInterface {
         *
         * @param \TYPO3\CMS\Extbase\Object\Container\ClassInfo $classInfo
         * @param array $givenConstructorArguments
+        * @throws \TYPO3\CMS\Extbase\Object\Exception
         * @return object the new instance
         */
        protected function instanciateObject(\TYPO3\CMS\Extbase\Object\Container\ClassInfo $classInfo, array $givenConstructorArguments) {
@@ -232,9 +235,9 @@ class Container implements \TYPO3\CMS\Core\SingletonInterface {
        /**
         * Wrapper for dev log, in order to ease testing
         *
-        * @param       string          Message (in english).
-        * @param       integer         Severity: 0 is info, 1 is notice, 2 is warning, 3 is fatal error, -1 is "OK" message
-        * @return      void
+        * @param string $message Message (in english).
+        * @param integer $severity Severity: 0 is info, 1 is notice, 2 is warning, 3 is fatal error, -1 is "OK" message
+        * @return void
         */
        protected function log($message, $severity) {
                \TYPO3\CMS\Core\Utility\GeneralUtility::devLog($message, 'extbase', $severity);
@@ -257,13 +260,13 @@ class Container implements \TYPO3\CMS\Core\SingletonInterface {
         * @param string $className
         * @param \TYPO3\CMS\Extbase\Object\Container\ClassInfo $classInfo
         * @param array $givenConstructorArguments
+        * @throws \InvalidArgumentException
         * @return array
         */
        private function getConstructorArguments($className, \TYPO3\CMS\Extbase\Object\Container\ClassInfo $classInfo, array $givenConstructorArguments) {
                $parameters = array();
                $constructorArgumentInformation = $classInfo->getConstructorArguments();
                foreach ($constructorArgumentInformation as $argumentInformation) {
-                       $argumentName = $argumentInformation['name'];
                        // We have a dependency we can automatically wire,
                        // AND the class has NOT been explicitely passed in
                        if (isset($argumentInformation['dependency']) && !(count($givenConstructorArguments) && is_a($givenConstructorArguments[0], $argumentInformation['dependency']))) {
@@ -296,8 +299,8 @@ class Container implements \TYPO3\CMS\Core\SingletonInterface {
         * Returns the class name for a new instance, taking into account the
         * class-extension API.
         *
-        * @param       string          Base class name to evaluate
-        * @return      string          Final class name to instantiate with "new [classname]
+        * @param string $className Base class name to evaluate
+        * @return string Final class name to instantiate with "new [classname]
         */
        protected function getImplementationClassName($className) {
                if (isset($this->alternativeImplementation[$className])) {
index d0b93ed..9ad73d9 100644 (file)
@@ -118,8 +118,8 @@ class ObjectManagerException implements \TYPO3\CMS\Extbase\Object\ObjectManagerI
         * Object Manager
         *
         * @param string $objectName The name of the object to create
+        * @throws Exception\WrongScopeException
         * @return object The new object instance
-        * @throws Tx_Extbase_Object_Exception_WrongScropeException if the created object is not of scope prototype
         * @api
         */
        public function create($objectName) {
index 9137862..f9727dc 100644 (file)
@@ -99,8 +99,14 @@ class Backend implements \TYPO3\CMS\Extbase\Persistence\Generic\BackendInterface
        protected $signalSlotDispatcher;
 
        /**
+        * @var \TYPO3\CMS\Extbase\Persistence\Generic\ObjectStorage
+        */
+       protected $deletedObjects;
+
+       /**
         * Constructs the backend
         *
+        * @param \TYPO3\CMS\Extbase\Configuration\ConfigurationManagerInterface $configurationManager
         * @return void
         */
        public function __construct(\TYPO3\CMS\Extbase\Configuration\ConfigurationManagerInterface $configurationManager) {
@@ -109,6 +115,7 @@ class Backend implements \TYPO3\CMS\Extbase\Persistence\Generic\BackendInterface
                if ($frameworkConfiguration['persistence']['updateReferenceIndex'] === '1') {
                        $this->referenceIndex = \TYPO3\CMS\Core\Utility\GeneralUtility::makeInstance('TYPO3\\CMS\\Core\\Database\\ReferenceIndex');
                }
+               $this->deletedObjects = new \TYPO3\CMS\Extbase\Persistence\Generic\ObjectStorage();
        }
 
        /**
@@ -313,6 +320,7 @@ class Backend implements \TYPO3\CMS\Extbase\Persistence\Generic\BackendInterface
         *
         * @param object $existingObject The existing object
         * @param object $newObject The new object
+        * @throws \TYPO3\CMS\Extbase\Persistence\Exception\UnknownObjectException
         * @return void
         */
        public function replaceObject($existingObject, $newObject) {
@@ -453,7 +461,6 @@ class Backend implements \TYPO3\CMS\Extbase\Persistence\Generic\BackendInterface
        protected function persistObjectStorage(\TYPO3\CMS\Extbase\Persistence\Generic\ObjectStorage $objectStorage, \TYPO3\CMS\Extbase\DomainObject\DomainObjectInterface $parentObject, $propertyName, array &$row) {
                $className = get_class($parentObject);
                $columnMap = $this->dataMapper->getDataMap($className)->getColumnMap($propertyName);
-               $columnName = $columnMap->getColumnName();
                $propertyMetaData = $this->reflectionService->getClassSchema($className)->getProperty($propertyName);
                foreach ($this->getRemovedChildObjects($parentObject, $propertyName) as $removedObject) {
                        if ($columnMap->getTypeOfRelation() === \TYPO3\CMS\Extbase\Persistence\Generic\Mapper\ColumnMap::RELATION_HAS_MANY && $propertyMetaData['cascade'] === 'remove') {
@@ -486,11 +493,11 @@ class Backend implements \TYPO3\CMS\Extbase\Persistence\Generic\BackendInterface
         * Returns the removed objects determined by a comparison of the clean property value
         * with the actual property value.
         *
-        * @param \TYPO3\CMS\Extbase\DomainObject\AbstractEntity $object The object
-        * @param string $parentPropertyName The name of the property
+        * @param \TYPO3\CMS\Extbase\DomainObject\DomainObjectInterface $object The object
+        * @param string $propertyName
         * @return array An array of removed objects
         */
-       protected function getRemovedChildObjects(\TYPO3\CMS\Extbase\DomainObject\AbstractEntity $object, $propertyName) {
+       protected function getRemovedChildObjects(\TYPO3\CMS\Extbase\DomainObject\DomainObjectInterface $object, $propertyName) {
                $removedObjects = array();
                $cleanPropertyValue = $object->_getCleanProperty($propertyName);
                if (is_array($cleanPropertyValue) || $cleanPropertyValue instanceof \Iterator) {
@@ -508,11 +515,12 @@ class Backend implements \TYPO3\CMS\Extbase\Persistence\Generic\BackendInterface
         * Updates the fields defining the relation between the object and the parent object.
         *
         * @param \TYPO3\CMS\Extbase\DomainObject\DomainObjectInterface $object
-        * @param \TYPO3\CMS\Extbase\DomainObject\AbstractEntity $parentObject
+        * @param \TYPO3\CMS\Extbase\DomainObject\DomainObjectInterface $parentObject
         * @param string $parentPropertyName
+        * @param int $sortingPosition
         * @return void
         */
-       protected function attachObjectToParentObject(\TYPO3\CMS\Extbase\DomainObject\DomainObjectInterface $object, \TYPO3\CMS\Extbase\DomainObject\AbstractEntity $parentObject, $parentPropertyName, $sortingPosition = 0) {
+       protected function attachObjectToParentObject(\TYPO3\CMS\Extbase\DomainObject\DomainObjectInterface $object, \TYPO3\CMS\Extbase\DomainObject\DomainObjectInterface $parentObject, $parentPropertyName, $sortingPosition = 0) {
                $parentDataMap = $this->dataMapper->getDataMap(get_class($parentObject));
                $parentColumnMap = $parentDataMap->getColumnMap($parentPropertyName);
                if ($parentColumnMap->getTypeOfRelation() === \TYPO3\CMS\Extbase\Persistence\Generic\Mapper\ColumnMap::RELATION_HAS_MANY) {
@@ -541,11 +549,11 @@ class Backend implements \TYPO3\CMS\Extbase\Persistence\Generic\BackendInterface
         * Updates the fields defining the relation between the object and the parent object.
         *
         * @param \TYPO3\CMS\Extbase\DomainObject\DomainObjectInterface $object
-        * @param \TYPO3\CMS\Extbase\DomainObject\AbstractEntity $parentObject
+        * @param \TYPO3\CMS\Extbase\DomainObject\DomainObjectInterface $parentObject
         * @param string $parentPropertyName
         * @return void
         */
-       protected function detachObjectFromParentObject(\TYPO3\CMS\Extbase\DomainObject\DomainObjectInterface $object, \TYPO3\CMS\Extbase\DomainObject\AbstractEntity $parentObject, $parentPropertyName) {
+       protected function detachObjectFromParentObject(\TYPO3\CMS\Extbase\DomainObject\DomainObjectInterface $object, \TYPO3\CMS\Extbase\DomainObject\DomainObjectInterface $parentObject, $parentPropertyName) {
                $parentDataMap = $this->dataMapper->getDataMap(get_class($parentObject));
                $parentColumnMap = $parentDataMap->getColumnMap($parentPropertyName);
                if ($parentColumnMap->getTypeOfRelation() === \TYPO3\CMS\Extbase\Persistence\Generic\Mapper\ColumnMap::RELATION_HAS_MANY) {
index 14bbe89..fa7fdce 100644 (file)
@@ -95,6 +95,8 @@ class IdentityMap implements \TYPO3\CMS\Core\SingletonInterface {
         * Returns the node identifier for the given object
         *
         * @param object $object
+        * @throws \InvalidArgumentException
+        * @throws \TYPO3\CMS\Extbase\Persistence\Exception\UnknownObjectException
         * @return string
         * @author Karsten Dambekalns <karsten@typo3.org>
         */
@@ -123,7 +125,7 @@ class IdentityMap implements \TYPO3\CMS\Core\SingletonInterface {
        /**
         * Unregister an object
         *
-        * @param string $object
+        * @param object $object
         * @return void
         * @author Karsten Dambekalns <karsten@typo3.org>
         */
index dc18f37..6db9ad8 100644 (file)
@@ -44,7 +44,7 @@ class LazyLoadingProxy implements \Iterator, \TYPO3\CMS\Extbase\Persistence\Gene
        /**
         * The object this property is contained in.
         *
-        * @var object
+        * @var \TYPO3\CMS\Extbase\DomainObject\DomainObjectInterface
         */
        private $parentObject;
 
@@ -168,7 +168,7 @@ class LazyLoadingProxy implements \Iterator, \TYPO3\CMS\Extbase\Persistence\Gene
        /**
         * Magic toString call implementation.
         *
-        * @return void
+        * @return string
         */
        public function __toString() {
                $realInstance = $this->_loadRealInstance();
@@ -178,7 +178,7 @@ class LazyLoadingProxy implements \Iterator, \TYPO3\CMS\Extbase\Persistence\Gene
        /**
         * Returns the current value of the storage array
         *
-        * @return void
+        * @return mixed
         */
        public function current() {
                $realInstance = $this->_loadRealInstance();
@@ -188,7 +188,7 @@ class LazyLoadingProxy implements \Iterator, \TYPO3\CMS\Extbase\Persistence\Gene
        /**
         * Returns the current key storage array
         *
-        * @return void
+        * @return integer
         */
        public function key() {
                $realInstance = $this->_loadRealInstance();
@@ -198,7 +198,7 @@ class LazyLoadingProxy implements \Iterator, \TYPO3\CMS\Extbase\Persistence\Gene
        /**
         * Returns the next position of the storage array
         *
-        * @return void
+        * @return mixed
         */
        public function next() {
                $realInstance = $this->_loadRealInstance();
@@ -218,7 +218,7 @@ class LazyLoadingProxy implements \Iterator, \TYPO3\CMS\Extbase\Persistence\Gene
        /**
         * Checks if the array pointer of the storage points to a valid position
         *
-        * @return void
+        * @return boolean
         */
        public function valid() {
                return $this->current() !== FALSE;
index 1cbfd73..b5e55e4 100644 (file)
@@ -54,7 +54,7 @@ class LazyObjectStorage extends \TYPO3\CMS\Extbase\Persistence\Generic\ObjectSto
        /**
         * The object this property is contained in.
         *
-        * @var object
+        * @var \TYPO3\CMS\Extbase\DomainObject\DomainObjectInterface
         */
        protected $parentObject;
 
@@ -80,7 +80,7 @@ class LazyObjectStorage extends \TYPO3\CMS\Extbase\Persistence\Generic\ObjectSto
        /**
         * Returns the state of the initialization
         *
-        * @return void
+        * @return boolean
         */
        public function isInitialized() {
                return $this->isInitialized;
@@ -155,6 +155,7 @@ class LazyObjectStorage extends \TYPO3\CMS\Extbase\Persistence\Generic\ObjectSto
        /**
         * Counts the elements in the storage array
         *
+        * @throws Exception
         * @return int The number of elements in the ObjectStorage
         */
        public function count() {
index f149847..f354143 100644 (file)
@@ -25,7 +25,7 @@ interface ManagerInterface extends \TYPO3\CMS\Extbase\Persistence\PersistenceMan
        /**
         * Returns the current persistence session
         *
-        * @return \TYPO3\CMS\Extbase\Persistence\Session
+        * @return \TYPO3\CMS\Extbase\Persistence\Generic\Session
         * @deprecated since Extbase 1.4.0, will be removed in Extbase 7.0
         */
        public function getSession();
@@ -33,7 +33,7 @@ interface ManagerInterface extends \TYPO3\CMS\Extbase\Persistence\PersistenceMan
        /**
         * Returns the persistence backend
         *
-        * @return \TYPO3\CMS\Extbase\Persistence\BackendInterface
+        * @return \TYPO3\CMS\Extbase\Persistence\Generic\BackendInterface
         * @deprecated since Extbase 1.4.0, will be removed in Extbase 7.0
         */
        public function getBackend();
index 19af7ef..131aa5f 100644 (file)
@@ -164,7 +164,7 @@ class ColumnMap {
         *
         * @param string $columnName The column name
         * @param string $propertyName The property name
-        * @return void
+        * @return \TYPO3\CMS\Extbase\Persistence\Generic\Mapper\ColumnMap
         */
        public function __construct($columnName, $propertyName) {
                // TODO Enable aliases (tx_anotherextension_addedcolumn -> theAddedColumn)
@@ -172,114 +172,198 @@ class ColumnMap {
                $this->setPropertyName($propertyName);
        }
 
+       /**
+        * @param $typeOfRelation
+        */
        public function setTypeOfRelation($typeOfRelation) {
                $this->typeOfRelation = $typeOfRelation;
        }
 
+       /**
+        * @return int
+        */
        public function getTypeOfRelation() {
                return $this->typeOfRelation;
        }
 
+       /**
+        * @param $propertyName
+        */
        public function setPropertyName($propertyName) {
                $this->propertyName = $propertyName;
        }
 
+       /**
+        * @return string
+        */
        public function getPropertyName() {
                return $this->propertyName;
        }
 
+       /**
+        * @param $columnName
+        */
        public function setColumnName($columnName) {
                $this->columnName = $columnName;
        }
 
+       /**
+        * @return string
+        */
        public function getColumnName() {
                return $this->columnName;
        }
 
+       /**
+        * @param $childTableName
+        */
        public function setChildTableName($childTableName) {
                $this->childTableName = $childTableName;
        }
 
+       /**
+        * @return string
+        */
        public function getChildTableName() {
                return $this->childTableName;
        }
 
+       /**
+        * @param $childTableWhereStatement
+        */
        public function setChildTableWhereStatement($childTableWhereStatement) {
                $this->childTableWhereStatement = $childTableWhereStatement;
        }
 
+       /**
+        * @return string
+        */
        public function getChildTableWhereStatement() {
                return $this->childTableWhereStatement;
        }
 
+       /**
+        * @param $childSortByFieldName
+        */
        public function setChildSortByFieldName($childSortByFieldName) {
                $this->childSortByFieldName = $childSortByFieldName;
        }
 
+       /**
+        * @return string
+        */
        public function getChildSortByFieldName() {
                return $this->childSortByFieldName;
        }
 
+       /**
+        * @param $relationTableName
+        */
        public function setRelationTableName($relationTableName) {
                $this->relationTableName = $relationTableName;
        }
 
+       /**
+        * @return string
+        */
        public function getRelationTableName() {
                return $this->relationTableName;
        }
 
+       /**
+        * @param $relationTablePageIdColumnName
+        */
        public function setRelationTablePageIdColumnName($relationTablePageIdColumnName) {
                $this->relationTablePageIdColumnName = $relationTablePageIdColumnName;
        }
 
+       /**
+        * @return string
+        */
        public function getRelationTablePageIdColumnName() {
                return $this->relationTablePageIdColumnName;
        }
 
+       /**
+        * @param array $relationTableMatchFields
+        */
        public function setRelationTableMatchFields(array $relationTableMatchFields) {
                $this->relationTableMatchFields = $relationTableMatchFields;
        }
 
+       /**
+        * @return array
+        */
        public function getRelationTableMatchFields() {
                return $this->relationTableMatchFields;
        }
 
+       /**
+        * @param array $relationTableInsertFields
+        */
        public function setRelationTableInsertFields(array $relationTableInsertFields) {
                $this->relationTableInsertFields = $relationTableInsertFields;
        }
 
+       /**
+        * @return array
+        */
        public function getRelationTableInsertFields() {
                return $this->relationTableInsertFields;
        }
 
+       /**
+        * @param $relationTableWhereStatement
+        */
        public function setRelationTableWhereStatement($relationTableWhereStatement) {
                $this->relationTableWhereStatement = $relationTableWhereStatement;
        }
 
+       /**
+        * @return string
+        */
        public function getRelationTableWhereStatement() {
                return $this->relationTableWhereStatement;
        }
 
+       /**
+        * @param $parentKeyFieldName
+        */
        public function setParentKeyFieldName($parentKeyFieldName) {
                $this->parentKeyFieldName = $parentKeyFieldName;
        }
 
+       /**
+        * @return string
+        */
        public function getParentKeyFieldName() {
                return $this->parentKeyFieldName;
        }
 
+       /**
+        * @param $parentTableFieldName
+        */
        public function setParentTableFieldName($parentTableFieldName) {
                $this->parentTableFieldName = $parentTableFieldName;
        }
 
+       /**
+        * @return string
+        */
        public function getParentTableFieldName() {
                return $this->parentTableFieldName;
        }
 
+       /**
+        * @param $childKeyFieldName
+        */
        public function setChildKeyFieldName($childKeyFieldName) {
                $this->childKeyFieldName = $childKeyFieldName;
        }
 
+       /**
+        * @return string
+        */
        public function getChildKeyFieldName() {
                return $this->childKeyFieldName;
        }
index 7ed1603..eace5f5 100644 (file)
@@ -145,6 +145,7 @@ class DataMap {
        /**
         * Sets the name of the class the colum map represents
         *
+        * @param $className
         * @return void
         */
        public function setClassName($className) {
@@ -163,6 +164,7 @@ class DataMap {
        /**
         * Sets the name of the table the colum map represents
         *
+        * @param $tableName
         * @return void
         */
        public function setTableName($tableName) {
@@ -249,7 +251,7 @@ class DataMap {
        /**
         * Sets the name of a column holding the page id
         *
-        * @param string The field name
+        * @param string $pageIdColumnName The field name
         * @return void
         */
        public function setPageIdColumnName($pageIdColumnName) {
@@ -306,7 +308,7 @@ class DataMap {
        /**
         * Sets the name of a column holding the timestamp the record was modified
         *
-        * @param string The field name
+        * @param string $modificationDateColumnName The field name
         * @return void
         */
        public function setModificationDateColumnName($modificationDateColumnName) {
@@ -325,7 +327,7 @@ class DataMap {
        /**
         * Sets the name of a column holding the creation date timestamp
         *
-        * @param string The field name
+        * @param string $creationDateColumnName The field name
         * @return void
         */
        public function setCreationDateColumnName($creationDateColumnName) {
@@ -344,7 +346,7 @@ class DataMap {
        /**
         * Sets the name of a column holding the uid of the back-end user who created this record
         *
-        * @param string The field name
+        * @param string $creatorColumnName The field name
         * @return void
         */
        public function setCreatorColumnName($creatorColumnName) {
@@ -363,7 +365,7 @@ class DataMap {
        /**
         * Sets the name of a column indicating the 'deleted' state of the row
         *
-        * @param string The field name
+        * @param string $deletedFlagColumnName The field name
         * @return void
         */
        public function setDeletedFlagColumnName($deletedFlagColumnName) {
@@ -382,7 +384,7 @@ class DataMap {
        /**
         * Sets the name of a column indicating the 'hidden' state of the row
         *
-        * @param string The field name
+        * @param string $disabledFlagColumnName The field name
         * @return void
         */
        public function setDisabledFlagColumnName($disabledFlagColumnName) {
@@ -401,7 +403,7 @@ class DataMap {
        /**
         * Sets the name of a column holding the timestamp the record should not displayed before
         *
-        * @param string The field name
+        * @param string $startTimeColumnName The field name
         * @return void
         */
        public function setStartTimeColumnName($startTimeColumnName) {
@@ -420,7 +422,7 @@ class DataMap {
        /**
         * Sets the name of a column holding the timestamp the record should not displayed afterwards
         *
-        * @param string The field name
+        * @param string $endTimeColumnName The field name
         * @return void
         */
        public function setEndTimeColumnName($endTimeColumnName) {
@@ -439,7 +441,7 @@ class DataMap {
        /**
         * Sets the name of a column holding the uid of the front-end user group which is allowed to edit this record
         *
-        * @param string The field name
+        * @param string $frontendUserGroupColumnName The field name
         * @return void
         */
        public function setFrontEndUserGroupColumnName($frontendUserGroupColumnName) {
index da7a0c1..b09619a 100644 (file)
@@ -171,6 +171,7 @@ class DataMapFactory implements \TYPO3\CMS\Core\SingletonInterface {
                                }
                        }
                }
+               /** @var $dataMap \TYPO3\CMS\Extbase\Persistence\Generic\Mapper\DataMap */
                $dataMap = $this->objectManager->create('TYPO3\\CMS\\Extbase\\Persistence\\Generic\\Mapper\\DataMap', $className, $tableName, $recordType, $subclasses);
                $dataMap = $this->addMetaDataColumnNames($dataMap, $tableName);
                // $classPropertyNames = $this->reflectionService->getClassPropertyNames($className);
@@ -197,7 +198,7 @@ class DataMapFactory implements \TYPO3\CMS\Core\SingletonInterface {
         * Resolves all subclasses for the given set of (sub-)classes.
         * The whole classes configuration is used to determine all subclasses recursively.
         *
-        * @param array $classes The framework configuration part [persistence][classes].
+        * @param array $classesConfiguration The framework configuration part [persistence][classes].
         * @param array $subclasses An array of subclasses defined via TypoScript
         * @return array An numeric array that contains all available subclasses-strings as values.
         */
@@ -248,6 +249,11 @@ class DataMapFactory implements \TYPO3\CMS\Core\SingletonInterface {
                \TYPO3\CMS\Core\Utility\GeneralUtility::loadTCA($tableName);
        }
 
+       /**
+        * @param DataMap $dataMap
+        * @param $tableName
+        * @return DataMap
+        */
        protected function addMetaDataColumnNames(\TYPO3\CMS\Extbase\Persistence\Generic\Mapper\DataMap $dataMap, $tableName) {
                $controlSection = $GLOBALS['TCA'][$tableName]['ctrl'];
                $dataMap->setPageIdColumnName('pid');
@@ -294,7 +300,7 @@ class DataMapFactory implements \TYPO3\CMS\Core\SingletonInterface {
         * @param \TYPO3\CMS\Extbase\Persistence\Generic\Mapper\ColumnMap $columnMap The column map
         * @param string $columnConfiguration The column configuration from $TCA
         * @param array $propertyMetaData The property metadata as delivered by the reflection service
-        * @return void
+        * @return \TYPO3\CMS\Extbase\Persistence\Generic\Mapper\ColumnMap
         */
        protected function setRelations(\TYPO3\CMS\Extbase\Persistence\Generic\Mapper\ColumnMap $columnMap, $columnConfiguration, $propertyMetaData) {
                if (isset($columnConfiguration)) {
@@ -317,9 +323,9 @@ class DataMapFactory implements \TYPO3\CMS\Core\SingletonInterface {
         * This method sets the configuration for a 1:1 relation based on
         * the $TCA column configuration
         *
-        * @param string $columnMap The column map
+        * @param string|\TYPO3\CMS\Extbase\Persistence\Generic\Mapper\ColumnMap $columnMap The column map
         * @param string $columnConfiguration The column configuration from $TCA
-        * @return void
+        * @return \TYPO3\CMS\Extbase\Persistence\Generic\Mapper\ColumnMap
         */
        protected function setOneToOneRelation(\TYPO3\CMS\Extbase\Persistence\Generic\Mapper\ColumnMap $columnMap, $columnConfiguration) {
                $columnMap->setTypeOfRelation(\TYPO3\CMS\Extbase\Persistence\Generic\Mapper\ColumnMap::RELATION_HAS_ONE);
@@ -335,9 +341,9 @@ class DataMapFactory implements \TYPO3\CMS\Core\SingletonInterface {
         * This method sets the configuration for a 1:n relation based on
         * the $TCA column configuration
         *
-        * @param string $columnMap The column map
+        * @param string|\TYPO3\CMS\Extbase\Persistence\Generic\Mapper\ColumnMap $columnMap The column map
         * @param string $columnConfiguration The column configuration from $TCA
-        * @return void
+        * @return \TYPO3\CMS\Extbase\Persistence\Generic\Mapper\ColumnMap
         */
        protected function setOneToManyRelation(\TYPO3\CMS\Extbase\Persistence\Generic\Mapper\ColumnMap $columnMap, $columnConfiguration) {
                $columnMap->setTypeOfRelation(\TYPO3\CMS\Extbase\Persistence\Generic\Mapper\ColumnMap::RELATION_HAS_MANY);
@@ -353,9 +359,10 @@ class DataMapFactory implements \TYPO3\CMS\Core\SingletonInterface {
         * This method sets the configuration for a m:n relation based on
         * the $TCA column configuration
         *
-        * @param string $columnMap The column map
+        * @param string|\TYPO3\CMS\Extbase\Persistence\Generic\Mapper\ColumnMap $columnMap The column map
         * @param string $columnConfiguration The column configuration from $TCA
-        * @return void
+        * @throws \TYPO3\CMS\Extbase\Persistence\Generic\Exception\UnsupportedRelationException
+        * @return \TYPO3\CMS\Extbase\Persistence\Generic\Mapper\ColumnMap
         */
        protected function setManyToManyRelation(\TYPO3\CMS\Extbase\Persistence\Generic\Mapper\ColumnMap $columnMap, $columnConfiguration) {
                $columnMap->setTypeOfRelation(\TYPO3\CMS\Extbase\Persistence\Generic\Mapper\ColumnMap::RELATION_HAS_AND_BELONGS_TO_MANY);
index b941507..87f1fbc 100644 (file)
@@ -216,6 +216,7 @@ class DataMapper implements \TYPO3\CMS\Core\SingletonInterface {
         * Creates a skeleton of the specified object
         *
         * @param string $className Name of the class to create a skeleton for
+        * @throws \TYPO3\CMS\Extbase\Object\Exception\CannotReconstituteObjectException
         * @return object The object skeleton
         */
        protected function createEmptyObject($className) {
@@ -298,7 +299,7 @@ class DataMapper implements \TYPO3\CMS\Core\SingletonInterface {
         * NULL is returned.
         *
         * @param integer $timestamp
-        * @return DateTime
+        * @return \DateTime
         */
        protected function mapDateTime($timestamp) {
                if (empty($timestamp)) {
@@ -316,7 +317,6 @@ class DataMapper implements \TYPO3\CMS\Core\SingletonInterface {
         * @param string $propertyName The name of the proxied property in it's parent
         * @param mixed $fieldValue The raw field value.
         * @param bool $enableLazyLoading A flag indication if the related objects should be lazy loaded
-        * @param bool $performLanguageOverlay A flag indication if the related objects should be localized
         * @return Tx_Extbase_Persistence_LazyObjectStorage|Tx_Extbase_Persistence_QueryResultInterface The result
         */
        public function fetchRelated(\TYPO3\CMS\Extbase\DomainObject\DomainObjectInterface $parentObject, $propertyName, $fieldValue = '', $enableLazyLoading = TRUE) {
@@ -343,7 +343,6 @@ class DataMapper implements \TYPO3\CMS\Core\SingletonInterface {
         * @param \TYPO3\CMS\Extbase\DomainObject\DomainObjectInterface $parentObject The object instance this proxy is part of
         * @param string $propertyName The name of the proxied property in it's parent
         * @param mixed $fieldValue The raw field value.
-        * @param bool $performLanguageOverlay A flag indication if the related objects should be localized
         * @return mixed
         */
        protected function fetchRelatedEager(\TYPO3\CMS\Extbase\DomainObject\DomainObjectInterface $parentObject, $propertyName, $fieldValue = '') {
@@ -378,7 +377,7 @@ class DataMapper implements \TYPO3\CMS\Core\SingletonInterface {
         * @param \TYPO3\CMS\Extbase\DomainObject\DomainObjectInterface $parentObject
         * @param string $propertyName
         * @param string $fieldValue
-        * @return void
+        * @return \TYPO3\CMS\Extbase\Persistence\QueryInterface
         */
        protected function getPreparedQuery(\TYPO3\CMS\Extbase\DomainObject\DomainObjectInterface $parentObject, $propertyName, $fieldValue = '') {
                $columnMap = $this->getDataMap(get_class($parentObject))->getColumnMap($propertyName);
@@ -448,19 +447,18 @@ class DataMapper implements \TYPO3\CMS\Core\SingletonInterface {
        /**
         * Returns the given result as property value of the specified property type.
         *
-        * @param mixed $result The result could be an object or an ObjectStorage
-        * @param array $propertyMetaData The property meta data
-        * @param Tx_Extbase_Persistence_QueryResultInterface|Tx_Extbase_Persistence_LoadingStrategyInterface $result The result
-        * @return void
+        * @param \TYPO3\CMS\Extbase\DomainObject\DomainObjectInterface $parentObject
+        * @param $propertyName
+        * @param $result
+        * @param mixed $result The result
+        * @return mixed
         */
        public function mapResultToPropertyValue(\TYPO3\CMS\Extbase\DomainObject\DomainObjectInterface $parentObject, $propertyName, $result) {
                if ($result instanceof \TYPO3\CMS\Extbase\Persistence\Generic\LoadingStrategyInterface) {
                        $propertyValue = $result;
                } else {
                        $propertyMetaData = $this->reflectionService->getClassSchema(get_class($parentObject))->getProperty($propertyName);
-                       $columnMap = $this->getDataMap(get_class($parentObject))->getColumnMap($propertyName);
                        if (in_array($propertyMetaData['type'], array('array', 'ArrayObject', 'SplObjectStorage', 'TYPO3\\CMS\\Extbase\\Persistence\\Generic\\ObjectStorage'))) {
-                               $elementType = $this->getType(get_class($parentObject), $propertyName);
                                $objects = array();
                                foreach ($result as $value) {
                                        $objects[] = $value;
@@ -516,6 +514,7 @@ class DataMapper implements \TYPO3\CMS\Core\SingletonInterface {
         * Returns a data map for a given class name
         *
         * @param string $className The class name you want to fetch the Data Map for
+        * @throws \TYPO3\CMS\Extbase\Persistence\Generic\Exception
         * @return \TYPO3\CMS\Extbase\Persistence\Generic\Mapper\DataMap The data map
         */
        public function getDataMap($className) {
@@ -568,6 +567,7 @@ class DataMapper implements \TYPO3\CMS\Core\SingletonInterface {
         *
         * @param string $parentClassName The class name of the object this proxy is part of
         * @param string $propertyName The name of the proxied property in it's parent
+        * @throws \TYPO3\CMS\Extbase\Persistence\Generic\Exception\UnexpectedTypeException
         * @return string The class name of the child object
         */
        public function getType($parentClassName, $propertyName) {
index 38f0b29..49310ad 100644 (file)
@@ -211,7 +211,8 @@ class ObjectStorage implements \Countable, \Iterator, \ArrayAccess, \TYPO3\CMS\E
        /**
         * Associates data, or info, with the object currently pointed to by the iterator.
         *
-        * @param mixed $information The data associated with the current iterator entry.
+        * @param mixed $data
+        * @return void
         */
        public function setInfo($data) {
                $this->isModified = TRUE;
@@ -260,8 +261,8 @@ class ObjectStorage implements \Countable, \Iterator, \ArrayAccess, \TYPO3\CMS\E
        /**
         * Dummy method to avoid serialization.
         *
+        * @throws \RuntimeException
         * @return void
-        * @throws RuntimeException
         */
        public function serialize() {
                throw new \RuntimeException('An ObjectStorage instance cannot be serialized.', 1267700868);
@@ -270,8 +271,9 @@ class ObjectStorage implements \Countable, \Iterator, \ArrayAccess, \TYPO3\CMS\E
        /**
         * Dummy method to avoid unserialization.
         *
+        * @param $serialized
+        * @throws \RuntimeException
         * @return void
-        * @throws RuntimeException
         */
        public function unserialize($serialized) {
                throw new \RuntimeException('A ObjectStorage instance cannot be unserialized.', 1267700870);
index 0173f5c..03d74e5 100644 (file)
@@ -188,6 +188,7 @@ final class PropertyType {
         * String constant for type name as used in serialization.
         */
        const TYPENAME_INTEGER = 'Integer';
+
        /**
         * Make instantiation impossible...
         *
@@ -205,6 +206,7 @@ final class PropertyType {
         */
        static public function nameFromValue($type) {
                switch (intval($type)) {
+               default:
                case self::UNDEFINED:
                        return self::TYPENAME_UNDEFINED;
                        break;
@@ -258,6 +260,7 @@ final class PropertyType {
         */
        static public function valueFromName($name) {
                switch ($name) {
+               default:
                case self::TYPENAME_UNDEFINED:
                        return self::UNDEFINED;
                        break;
index 9b6a1fc..0aea2b7 100644 (file)
@@ -62,7 +62,7 @@ class Join implements \TYPO3\CMS\Extbase\Persistence\Generic\Qom\JoinInterface {
         * @param \TYPO3\CMS\Extbase\Persistence\Generic\Qom\SourceInterface $left the left node-tuple source; non-null
         * @param \TYPO3\CMS\Extbase\Persistence\Generic\Qom\SourceInterface $right the right node-tuple source; non-null
         * @param string $joinType one of QueryObjectModelConstants.JCR_JOIN_TYPE_*
-        * @param \TYPO3\CMS\Extbase\Persistence\Generic\Qom\JoinConditionInterface $join Condition the join condition; non-null
+        * @param JoinConditionInterface $joinCondition
         */
        public function __construct(\TYPO3\CMS\Extbase\Persistence\Generic\Qom\SourceInterface $left, \TYPO3\CMS\Extbase\Persistence\Generic\Qom\SourceInterface $right, $joinType, \TYPO3\CMS\Extbase\Persistence\Generic\Qom\JoinConditionInterface $joinCondition) {
                $this->left = $left;
@@ -101,7 +101,7 @@ class Join implements \TYPO3\CMS\Extbase\Persistence\Generic\Qom\JoinInterface {
        /**
         * Gets the join condition.
         *
-        * @return JoinCondition the join condition; non-null
+        * @return JoinConditionInterface the join condition; non-null
         */
        public function getJoinCondition() {
                return $this->joinCondition;
index 3d1a95f..854251c 100644 (file)
@@ -59,7 +59,7 @@ interface JoinInterface extends \TYPO3\CMS\Extbase\Persistence\Generic\Qom\Sourc
        /**
         * Gets the join condition.
         *
-        * @return JoinCondition the join condition; non-null
+        * @return JoinConditionInterface the join condition; non-null
         */
        public function getJoinCondition();
 
index 0b657af..95189aa 100644 (file)
@@ -50,7 +50,7 @@ class LowerCase implements \TYPO3\CMS\Extbase\Persistence\Generic\Qom\LowerCaseI
        /**
         * Constructs this LowerCase instance
         *
-        * @param \TYPO3\CMS\Extbase\Persistence\Generic\Qom\DynamicOperandInterface $constraint
+        * @param DynamicOperandInterface $operand
         */
        public function __construct(\TYPO3\CMS\Extbase\Persistence\Generic\Qom\DynamicOperandInterface $operand) {
                $this->operand = $operand;
index 5317f2d..5e8179d 100644 (file)
@@ -50,7 +50,7 @@ class Ordering implements \TYPO3\CMS\Extbase\Persistence\Generic\Qom\OrderingInt
         * Constructs the Ordering instance
         *
         * @param \TYPO3\CMS\Extbase\Persistence\Generic\Qom\DynamicOperandInterface $operand The operand; non-null
-        * @param string either Tx_Extbase_Persistence_QOM_QueryObjectModelConstantsInterface::JCR_ORDER_ASCENDING or Tx_Extbase_Persistence_QOM_QueryObjectModelConstantsInterface::JCR_ORDER_DESCENDING
+        * @param string $order either Tx_Extbase_Persistence_QOM_QueryObjectModelConstantsInterface::JCR_ORDER_ASCENDING or Tx_Extbase_Persistence_QOM_QueryObjectModelConstantsInterface::JCR_ORDER_DESCENDING
         */
        public function __construct(\TYPO3\CMS\Extbase\Persistence\Generic\Qom\DynamicOperandInterface $operand, $order = \TYPO3\CMS\Extbase\Persistence\Generic\Qom\QueryObjectModelConstantsInterface::JCR_ORDER_ASCENDING) {
                $this->operand = $operand;
index 2628eb1..98286b8 100644 (file)
@@ -69,7 +69,7 @@ class QueryObjectModelFactory implements \TYPO3\CMS\Core\SingletonInterface {
         *
         * @param string $statement The statement
         * @param array $boundVariables An array of variables to bind to the statement
-        * @param object $language The language of the statement. Must be a supported languanguage defined as Tx_Extbase_Persistence_QOM_QueryObjectModelFactory::TYPO3_*
+        * @param object|string $language The language of the statement. Must be a supported languanguage defined as Tx_Extbase_Persistence_QOM_QueryObjectModelFactory::TYPO3_*
         * @return Tx_Extbase_Persistence_QOM_StatementInterface
         */
        public function statement($statement, array $boundVariables = array(), $language = \TYPO3\CMS\Extbase\Persistence\Generic\Qom\Statement::TYPO3_SQL_MYSQL) {
@@ -82,9 +82,8 @@ class QueryObjectModelFactory implements \TYPO3\CMS\Core\SingletonInterface {
         * @param \TYPO3\CMS\Extbase\Persistence\Generic\Qom\SourceInterface $left the left node-tuple source; non-null
         * @param \TYPO3\CMS\Extbase\Persistence\Generic\Qom\SourceInterface $right the right node-tuple source; non-null
         * @param string $joinType one of QueryObjectModelConstants.JCR_JOIN_TYPE_*
-        * @param \TYPO3\CMS\Extbase\Persistence\Generic\Qom\JoinConditionInterface $join Condition the join condition; non-null
+        * @param JoinConditionInterface $joinCondition
         * @return \TYPO3\CMS\Extbase\Persistence\Generic\Qom\JoinInterface the join; non-null
-        * @throws \TYPO3\CMS\Extbase\Persistence\Generic\Exception\RepositoryException if the operation otherwise fails
         */
        public function join(\TYPO3\CMS\Extbase\Persistence\Generic\Qom\SourceInterface $left, \TYPO3\CMS\Extbase\Persistence\Generic\Qom\SourceInterface $right, $joinType, \TYPO3\CMS\Extbase\Persistence\Generic\Qom\JoinConditionInterface $joinCondition) {
                return $this->objectManager->create('TYPO3\\CMS\\Extbase\\Persistence\\Generic\\Qom\\Join', $left, $right, $joinType, $joinCondition);
index 7a2bbff..e0719b4 100644 (file)
@@ -78,7 +78,7 @@ class Selector implements \TYPO3\CMS\Extbase\Persistence\Generic\Qom\SelectorInt
         * Gets the selector name.
         * A selector's name can be used elsewhere in the query to identify the selector.
         *
-        * @return the selector name; non-null
+        * @return string the selector name; non-null
         */
        public function getSelectorName() {
                return $this->selectorName;
index 7a47df1..ceb5c75 100644 (file)
@@ -54,7 +54,7 @@ interface SelectorInterface extends \TYPO3\CMS\Extbase\Persistence\Generic\Qom\S
         * Gets the selector name.
         * A selector's name can be used elsewhere in the query to identify the selector.
         *
-        * @return the selector name; non-null
+        * @return string the selector name; non-null
         */
        public function getSelectorName();
 
index 6f67f22..fbc853d 100644 (file)
@@ -71,7 +71,7 @@ class Statement {
        /**
         * Gets the statement.
         *
-        * @return the statement; non-null
+        * @return string the statement; non-null
         */
        public function getStatement() {
                return $this->statement;
index cfea003..4a51476 100644 (file)
@@ -51,7 +51,7 @@ class UpperCase implements \TYPO3\CMS\Extbase\Persistence\Generic\Qom\UpperCaseI
        /**
         * Constructs this UpperCase instance
         *
-        * @param \TYPO3\CMS\Extbase\Persistence\Generic\Qom\DynamicOperandInterface $constraint
+        * @param DynamicOperandInterface $operand
         */
        public function __construct(\TYPO3\CMS\Extbase\Persistence\Generic\Qom\DynamicOperandInterface $operand) {
                $this->operand = $operand;
index 83b48b6..9f8d95e 100644 (file)
@@ -161,6 +161,7 @@ class Query implements \TYPO3\CMS\Extbase\Persistence\QueryInterface {
        /**
         * Returns the Query Settings.
         *
+        * @throws Exception
         * @return \TYPO3\CMS\Extbase\Persistence\Generic\QuerySettingsInterface $querySettings The Query Settings
         * @api This method is not part of FLOW3 API
         */
@@ -266,6 +267,7 @@ class Query implements \TYPO3\CMS\Extbase\Persistence\QueryInterface {
         * for chaining (fluid interface)
         *
         * @param integer $limit
+        * @throws \InvalidArgumentException
         * @return \TYPO3\CMS\Extbase\Persistence\QueryInterface
         * @api
         */
@@ -292,7 +294,7 @@ class Query implements \TYPO3\CMS\Extbase\Persistence\QueryInterface {
        /**
         * Returns the maximum size of the result set to limit.
         *
-        * @param integer
+        * @return integer
         * @api
         */
        public function getLimit() {
@@ -304,6 +306,7 @@ class Query implements \TYPO3\CMS\Extbase\Persistence\QueryInterface {
         * allow for chaining (fluid interface)
         *
         * @param integer $offset
+        * @throws \InvalidArgumentException
         * @return \TYPO3\CMS\Extbase\Persistence\QueryInterface
         * @api
         */
@@ -343,7 +346,7 @@ class Query implements \TYPO3\CMS\Extbase\Persistence\QueryInterface {
         * backend (database).
         *
         * @param string $statement The statement
-        * @param array $paramerters An array of parameters. These will be bound to placeholders '?' in the $statement.
+        * @param array $parameters An array of parameters. These will be bound to placeholders '?' in the $statement.
         * @return \TYPO3\CMS\Extbase\Persistence\QueryInterface
         */
        public function statement($statement, array $parameters = array()) {
@@ -375,6 +378,7 @@ class Query implements \TYPO3\CMS\Extbase\Persistence\QueryInterface {
         * It also scepts a single array of constraints to be concatenated.
         *
         * @param mixed $constraint1 The first of multiple constraints or an array of constraints.
+        * @throws Exception\InvalidNumberOfConstraintsException
         * @return \TYPO3\CMS\Extbase\Persistence\Generic\Qom\AndInterface
         * @api
         */
@@ -399,6 +403,7 @@ class Query implements \TYPO3\CMS\Extbase\Persistence\QueryInterface {
         * Performs a logical disjunction of the two given constraints
         *
         * @param mixed $constraint1 The first of multiple constraints or an array of constraints.
+        * @throws Exception\InvalidNumberOfConstraintsException
         * @return \TYPO3\CMS\Extbase\Persistence\Generic\Qom\OrInterface
         * @api
         */
@@ -479,6 +484,7 @@ class Query implements \TYPO3\CMS\Extbase\Persistence\QueryInterface {
         *
         * @param string $propertyName The name of the property to compare against
         * @param mixed $operand The value to compare with, multivalued
+        * @throws Exception\UnexpectedTypeException
         * @return \TYPO3\CMS\Extbase\Persistence\Generic\Qom\ComparisonInterface
         * @api
         */
index ee33ce1..ff2a22a 100644 (file)
@@ -250,7 +250,7 @@ class QueryResult implements \TYPO3\CMS\Extbase\Persistence\QueryResultInterface
        }
 
        /**
-        * @return void
+        * @return boolean
         * @see Iterator::valid()
         */
        public function valid() {
index f5e91c7..b040e82 100644 (file)
@@ -54,7 +54,7 @@ interface QuerySettingsInterface
        /**
         * Sets the pid(s) of the storage page(s) that should be respected for the query.
         *
-        * @param array $respectStoragePage If TRUE the storage page ID will be determined and the statement will be extended accordingly.
+        * @param array $storagePageIds If TRUE the storage page ID will be determined and the statement will be extended accordingly.
         * @return \TYPO3\CMS\Extbase\Persistence\Generic\QuerySettingsInterface instance of $this to allow method chaining
         * @api
         */
@@ -70,7 +70,7 @@ interface QuerySettingsInterface
        /**
         * Sets the flag if a  and language overlay should be performed.
         *
-        * @param boolean $respectEnableFields TRUE if a  and language overlay should be performed.
+        * @param boolean $respectSysLanguage TRUE if a  and language overlay should be performed.
         * @return \TYPO3\CMS\Extbase\Persistence\Generic\QuerySettingsInterface instance of $this to allow method chaining
         * @api
         */
index def96d1..bae81f7 100644 (file)
@@ -50,7 +50,7 @@ class Session implements \TYPO3\CMS\Core\SingletonInterface {
        /**
         * Registers a reconstituted object
         *
-        * @param object $object
+        * @param object|\TYPO3\CMS\Extbase\DomainObject\DomainObjectInterface $object $object
         * @return void
         */
        public function registerReconstitutedObject(\TYPO3\CMS\Extbase\DomainObject\DomainObjectInterface $object) {
@@ -70,7 +70,6 @@ class Session implements \TYPO3\CMS\Core\SingletonInterface {
        /**
         * Returns all objects which have been registered as reconstituted objects
         *
-        * @param string $objectClassName The class name of objects to be returned
         * @return array All reconstituted objects
         */
        public function getReconstitutedObjects() {
index adbcd09..a927c92 100644 (file)
@@ -41,7 +41,7 @@ interface BackendInterface
         * @param string $tableName The database table name
         * @param array $row The row to insert
         * @param boolean $isRelation TRUE if we are currently inserting into a relation table, FALSE by default
-        * @return void
+        * @return mixed|void
         */
        public function addRow($tableName, array $row, $isRelation = FALSE);
 
@@ -51,7 +51,7 @@ interface BackendInterface
         * @param string $tableName The database table name
         * @param array $row The row to update
         * @param boolean $isRelation TRUE if we are currently inserting into a relation table, FALSE by default
-        * @return void
+        * @return mixed|void
         */
        public function updateRow($tableName, array $row, $isRelation = FALSE);
 
@@ -61,7 +61,7 @@ interface BackendInterface
         * @param string $tableName The database table name
         * @param array $identifier An array of identifier array('fieldname' => value). This array will be transformed to a WHERE clause
         * @param boolean $isRelation TRUE if we are currently inserting into a relation table, FALSE by default
-        * @return void
+        * @return mixed|void
         */
        public function removeRow($tableName, array $identifier, $isRelation = FALSE);
 
index 09b039d..d042830 100644 (file)
@@ -170,6 +170,7 @@ class Typo3DbBackend implements \TYPO3\CMS\Extbase\Persistence\Generic\Storage\B
         * @param string $tableName The database table name
         * @param array $row The row to be updated
         * @param boolean $isRelation TRUE if we are currently inserting into a relation table, FALSE by default
+        * @throws \InvalidArgumentException
         * @return bool
         */
        public function updateRow($tableName, array $row, $isRelation = FALSE) {
@@ -219,9 +220,9 @@ class Typo3DbBackend implements \TYPO3\CMS\Extbase\Persistence\Generic\Storage\B
        /**
         * Fetches row data from the database
         *
-        * @param string $identifier The Identifier of the row to fetch
-        * @param \TYPO3\CMS\Extbase\Persistence\Generic\Mapper\DataMap $dataMap The Data Map
-        * @return array|FALSE
+        * @param string $tableName
+        * @param array $identifier The Identifier of the row to fetch
+        * @return array|boolean
         */
        public function getRowByIdentifier($tableName, array $identifier) {
                $statement = (('SELECT * FROM ' . $tableName) . ' WHERE ') . $this->parseIdentifier($identifier);
@@ -237,6 +238,10 @@ class Typo3DbBackend implements \TYPO3\CMS\Extbase\Persistence\Generic\Storage\B
                }
        }
 
+       /**
+        * @param array $identifier
+        * @return string
+        */
        protected function parseIdentifier(array $identifier) {
                $fieldNames = array_keys($identifier);
                $suffixedFieldNames = array();
@@ -254,7 +259,6 @@ class Typo3DbBackend implements \TYPO3\CMS\Extbase\Persistence\Generic\Storage\B
         * @author Karsten Dambekalns <karsten@typo3.org>
         */
        public function getObjectDataByQuery(\TYPO3\CMS\Extbase\Persistence\QueryInterface $query) {
-               $parameters = array();
                $statement = $query->getStatement();
                if ($statement instanceof \TYPO3\CMS\Extbase\Persistence\Generic\Qom\Statement) {
                        $sql = $statement->getStatement();
@@ -278,7 +282,8 @@ class Typo3DbBackend implements \TYPO3\CMS\Extbase\Persistence\Generic\Storage\B
        /**
         * Returns the number of tuples matching the query.
         *
-        * @param Tx_Extbase_Persistence_QOM_QueryObjectModelInterface $query
+        * @param \TYPO3\CMS\Extbase\Persistence\QueryInterface $query
+        * @throws Exception\BadConstraintException
         * @return integer The number of matching tuples
         */
        public function getObjectCountByQuery(\TYPO3\CMS\Extbase\Persistence\QueryInterface $query) {
@@ -316,6 +321,7 @@ class Typo3DbBackend implements \TYPO3\CMS\Extbase\Persistence\Generic\Storage\B
         * Parses the query and returns the SQL statement parts.
         *
         * @param \TYPO3\CMS\Extbase\Persistence\QueryInterface $query The query
+        * @param array $parameters
         * @return array The SQL statement parts
         */
        public function parseQuery(\TYPO3\CMS\Extbase\Persistence\QueryInterface $query, array &$parameters) {
@@ -504,7 +510,6 @@ class Typo3DbBackend implements \TYPO3\CMS\Extbase\Persistence\Generic\Storage\B
         * @param \TYPO3\CMS\Extbase\Persistence\Generic\Qom\SourceInterface $source The source
         * @param array &$sql The query parts
         * @param array &$parameters The parameters that will replace the markers
-        * @param array $boundVariableValues The bound variables in the query (key) and their values (value)
         * @return void
         */
        protected function parseConstraint(\TYPO3\CMS\Extbase\Persistence\Generic\Qom\ConstraintInterface $constraint = NULL, \TYPO3\CMS\Extbase\Persistence\Generic\Qom\SourceInterface $source, array &$sql, array &$parameters) {
@@ -536,7 +541,7 @@ class Typo3DbBackend implements \TYPO3\CMS\Extbase\Persistence\Generic\Storage\B
         * @param \TYPO3\CMS\Extbase\Persistence\Generic\Qom\SourceInterface $source The source
         * @param array &$sql SQL query parts to add to
         * @param array &$parameters Parameters to bind to the SQL
-        * @param array $boundVariableValues The bound variables in the query and their values
+        * @throws \TYPO3\CMS\Extbase\Persistence\Generic\Exception\RepositoryException
         * @return void
         */
        protected function parseComparison(\TYPO3\CMS\Extbase\Persistence\Generic\Qom\ComparisonInterface $comparison, \TYPO3\CMS\Extbase\Persistence\Generic\Qom\SourceInterface $source, array &$sql, array &$parameters) {
@@ -606,6 +611,7 @@ class Typo3DbBackend implements \TYPO3\CMS\Extbase\Persistence\Generic\Storage\B
         * Returns a plain value, i.e. objects are flattened out if possible.
         *
         * @param mixed $input
+        * @throws \TYPO3\CMS\Extbase\Persistence\Generic\Exception\UnexpectedTypeException
         * @return mixed
         */
        protected function getPlainValue($input) {
@@ -636,6 +642,7 @@ class Typo3DbBackend implements \TYPO3\CMS\Extbase\Persistence\Generic\Storage\B
         * @param array &$sql The query parts
         * @param array &$parameters The parameters that will replace the markers
         * @param string $valueFunction an optional SQL function to apply to the operand value
+        * @param null $operand2
         * @return void
         */
        protected function parseDynamicOperand(\TYPO3\CMS\Extbase\Persistence\Generic\Qom\DynamicOperandInterface $operand, $operator, \TYPO3\CMS\Extbase\Persistence\Generic\Qom\SourceInterface $source, array &$sql, array &$parameters, $valueFunction = NULL, $operand2 = NULL) {
@@ -667,6 +674,13 @@ class Typo3DbBackend implements \TYPO3\CMS\Extbase\Persistence\Generic\Storage\B
                }
        }
 
+       /**
+        * @param $className
+        * @param $tableName
+        * @param $propertyPath
+        * @param array $sql
+        * @throws \TYPO3\CMS\Extbase\Persistence\Generic\Exception
+        */
        protected function addUnionStatement(&$className, &$tableName, &$propertyPath, array &$sql) {
                $explodedPropertyPath = explode('.', $propertyPath, 2);
                $propertyName = $explodedPropertyPath[0];
@@ -708,6 +722,7 @@ class Typo3DbBackend implements \TYPO3\CMS\Extbase\Persistence\Generic\Storage\B
         * Returns the SQL operator for the given JCR operator type.
         *
         * @param string $operator One of the JCR_OPERATOR_* constants
+        * @throws \TYPO3\CMS\Extbase\Persistence\Generic\Exception
         * @return string an SQL operator
         */
        protected function resolveOperator($operator) {
@@ -754,6 +769,7 @@ class Typo3DbBackend implements \TYPO3\CMS\Extbase\Persistence\Generic\Storage\B
         *
         * @param string $sqlString The query part with placeholders
         * @param array $parameters The parameters
+        * @throws \TYPO3\CMS\Extbase\Persistence\Generic\Exception
         * @return string The query part with replaced placeholders
         */
        protected function replacePlaceholders(&$sqlString, array $parameters) {
@@ -950,6 +966,7 @@ class Typo3DbBackend implements \TYPO3\CMS\Extbase\Persistence\Generic\Storage\B
         * @param array $orderings An array of orderings (Tx_Extbase_Persistence_QOM_Ordering)
         * @param \TYPO3\CMS\Extbase\Persistence\Generic\Qom\SourceInterface $source The source
         * @param array &$sql The query parts
+        * @throws \TYPO3\CMS\Extbase\Persistence\Generic\Exception\UnsupportedOrderException
         * @return void
         */
        protected function parseOrderings(array $orderings, \TYPO3\CMS\Extbase\Persistence\Generic\Qom\SourceInterface $source, array &$sql) {
@@ -1029,10 +1046,10 @@ class Typo3DbBackend implements \TYPO3\CMS\Extbase\Persistence\Generic\Storage\B
         * detected (depending on FE or BE context). You can also explicitly set the language/workspace id.
         *
         * @param \TYPO3\CMS\Extbase\Persistence\Generic\Qom\SourceInterface $source The source (selector od join)
-        * @param array $row The row array (as reference)
-        * @param string $languageUid The language id
-        * @param string $workspaceUidUid The workspace id
-        * @return void
+        * @param array $rows
+        * @param null|integer $languageUid
+        * @param null|integer $workspaceUid
+        * @return array
         */
        protected function doLanguageAndWorkspaceOverlay(\TYPO3\CMS\Extbase\Persistence\Generic\Qom\SourceInterface $source, array $rows, $languageUid = NULL, $workspaceUid = NULL) {
                $overlayedRows = array();
@@ -1118,8 +1135,8 @@ class Typo3DbBackend implements \TYPO3\CMS\Extbase\Persistence\Generic\Storage\B
         *
         * Much of this functionality is taken from t3lib_tcemain::clear_cache() which unfortunately only works with logged-in BE user.
         *
-        * @param $tableName Table name of the record
-        * @param $uid UID of the record
+        * @param string $tableName Table name of the record
+        * @param integer $uid UID of the record
         * @return void
         */
        protected function clearPageCache($tableName, $uid) {
index 8ef3f55..8c3b3ad 100644 (file)
@@ -127,7 +127,7 @@ class Typo3QuerySettings implements \TYPO3\CMS\Extbase\Persistence\Generic\Query
        /**
         * Sets the pid(s) of the storage page(s) that should be respected for the query.
         *
-        * @param array $respectStoragePage If TRUE the storage page ID will be determined and the statement will be extended accordingly.
+        * @param array $storagePageIds If TRUE the storage page ID will be determined and the statement will be extended accordingly.
         * @return \TYPO3\CMS\Extbase\Persistence\Generic\QuerySettingsInterface instance of $this to allow method chaining
         * @api
         */
@@ -147,7 +147,7 @@ class Typo3QuerySettings implements \TYPO3\CMS\Extbase\Persistence\Generic\Query
        /**
         * Sets the flag if a  and language overlay should be performed.
         *
-        * @param boolean $respectEnableFields TRUE if a  and language overlay should be performed.
+        * @param boolean $respectSysLanguage TRUE if a  and language overlay should be performed.
         * @return \TYPO3\CMS\Extbase\Persistence\Generic\QuerySettingsInterface (fluent interface)
         * @api
         */
index ab08876..342e093 100644 (file)
@@ -122,6 +122,7 @@ class Repository implements \TYPO3\CMS\Extbase\Persistence\RepositoryInterface,
         * Adds an object to this repository
         *
         * @param object $object The object to add
+        * @throws Exception\IllegalObjectTypeException
         * @return void
         * @api
         */
@@ -139,6 +140,7 @@ class Repository implements \TYPO3\CMS\Extbase\Persistence\RepositoryInterface,
         * Removes an object from this repository.
         *
         * @param object $object The object to remove
+        * @throws Exception\IllegalObjectTypeException
         * @return void
         * @api
         */
@@ -159,6 +161,8 @@ class Repository implements \TYPO3\CMS\Extbase\Persistence\RepositoryInterface,
         *
         * @param object $existingObject The existing object
         * @param object $newObject The new object
+        * @throws Exception\UnknownObjectException
+        * @throws Exception\IllegalObjectTypeException
         * @return void
         * @api
         */
@@ -195,6 +199,9 @@ class Repository implements \TYPO3\CMS\Extbase\Persistence\RepositoryInterface,
         * Replaces an existing object with the same identifier by the given object
         *
         * @param object $modifiedObject The modified object
+        * @throws Exception\UnknownObjectException
+        * @throws Exception\IllegalObjectTypeException
+        * @return void
         * @api
         */
        public function update($modifiedObject) {
index d320fe6..7736ef0 100644 (file)
@@ -187,8 +187,10 @@ class Mapper implements \TYPO3\CMS\Core\SingletonInterface {
         *
         * @param array $propertyNames Names of the properties to map.
         * @param mixed $source Source containing the properties to map to the target object. Must either be an array, ArrayObject or any other object.
-        * @param object $target The target object
+        * @param object|array $target The target object
         * @param array $optionalPropertyNames Names of optional properties. If a property is specified here and it doesn't exist in the source, no error is issued.
+        * @throws Exception\InvalidSource
+        * @throws Exception\InvalidTarget
         * @return boolean TRUE if the properties could be mapped, otherwise FALSE
         * @see mapAndValidate()
         * @api
@@ -270,6 +272,8 @@ class Mapper implements \TYPO3\CMS\Core\SingletonInterface {
         * @param mixed $propertyValue The value to transform, string or array
         * @param string $targetType The type to transform to
         * @param string $propertyName In case of an error we add this to the error message
+        * @throws Exception\InvalidTarget
+        * @throws \InvalidArgumentException
         * @return object The object, when no transformation was possible this may return NULL as well
         */
        protected function transformToObject($propertyValue, $targetType, $propertyName) {
index 7308d2f..5591bda 100644 (file)
@@ -91,6 +91,7 @@ class PropertyMapper implements \TYPO3\CMS\Core\SingletonInterface {
         * Lifecycle method, called after all dependencies have been injected.
         * Here, the typeConverter array gets initialized.
         *
+        * @throws Exception\DuplicateTypeConverterException
         * @return void
         * @author Sebastian Kurfürst <sebastian@typo3.org>
         */
@@ -112,6 +113,7 @@ class PropertyMapper implements \TYPO3\CMS\Core\SingletonInterface {
         * @param mixed $source the source data to map. MUST be a simple type, NO object allowed!
         * @param string $targetType The type of the target; can be either a class name or a simple type.
         * @param \TYPO3\CMS\Extbase\Property\PropertyMappingConfigurationInterface $configuration Configuration for the property mapping. If NULL, the PropertyMappingConfigurationBuilder will create a default configuration.
+        * @throws Exception
         * @return mixed an instance of $targetType
         * @author Sebastian Kurfürst <sebastian@typo3.org>
         * @api
@@ -147,6 +149,7 @@ class PropertyMapper implements \TYPO3\CMS\Core\SingletonInterface {
         * @param string $targetType The type of the target; can be either a class name or a simple type.
         * @param \TYPO3\CMS\Extbase\Property\PropertyMappingConfigurationInterface $configuration Configuration for the property mapping.
         * @param array $currentPropertyPath The property path currently being mapped; used for knowing the context in case an exception is thrown.
+        * @throws Exception\TypeConverterException
         * @return mixed an instance of $targetType
         * @author Sebastian Kurfürst <sebastian@typo3.org>
         */
@@ -187,6 +190,8 @@ class PropertyMapper implements \TYPO3\CMS\Core\SingletonInterface {
         * @param mixed $source
         * @param string $targetType
         * @param \TYPO3\CMS\Extbase\Property\PropertyMappingConfigurationInterface $configuration
+        * @throws Exception\TypeConverterException
+        * @throws Exception\InvalidTargetException
         * @return \TYPO3\CMS\Extbase\Property\TypeConverterInterface Type Converter which should be used to convert between $source and $targetType.
         * @author Sebastian Kurfürst <sebastian@typo3.org>
         */
@@ -304,6 +309,7 @@ class PropertyMapper implements \TYPO3\CMS\Core\SingletonInterface {
         * Determine the type of the source data, or throw an exception if source was an unsupported format.
         *
         * @param mixed $source
+        * @throws Exception\InvalidSourceException
         * @return string the type of $source
         * @author Sebastian Kurfürst <sebastian@typo3.org>
         */
index 6a8dfbc..e1b7135 100644 (file)
@@ -76,8 +76,10 @@ class PropertyMappingConfiguration implements \TYPO3\CMS\Extbase\Property\Proper
        }
 
        /**
+        * returns TRUE if the given propertyName should be mapped, FALSE otherwise.
+        *
         * @param string $propertyName
-        * @return TRUE if the given propertyName should be mapped, FALSE otherwise.
+        * @return boolean
         * @todo : extend to enable whitelisting / blacklisting of properties.
         * @author Sebastian Kurfürst <sebastian@typo3.org>
         * @api
index 9a0009e..e381054 100644 (file)
@@ -29,8 +29,10 @@ namespace TYPO3\CMS\Extbase\Property;
 interface PropertyMappingConfigurationInterface
 {
        /**
+        * returns TRUE if the given propertyName should be mapped, FALSE otherwise.
+        *
         * @param string $propertyName
-        * @return TRUE if the given propertyName should be mapped, FALSE otherwise.
+        * @return boolean
         * @api
         */
        public function shouldMap($propertyName);
index 6b18565..3ac0145 100644 (file)
@@ -60,6 +60,7 @@ abstract class AbstractFileCollectionConverter extends \TYPO3\CMS\Extbase\Proper
         * @param string $targetType
         * @param array $convertedChildProperties
         * @param \TYPO3\CMS\Extbase\Property\PropertyMappingConfigurationInterface $configuration
+        * @throws \TYPO3\CMS\Extbase\Property\Exception
         * @return \TYPO3\CMS\Extbase\Domain\Model\AbstractFileCollection
         * @api
         */
index b36dc1f..bfb13f4 100644 (file)
@@ -60,6 +60,7 @@ abstract class AbstractFileFolderConverter extends \TYPO3\CMS\Extbase\Property\T
         * @param string $targetType
         * @param array $convertedChildProperties
         * @param \TYPO3\CMS\Extbase\Property\PropertyMappingConfigurationInterface $configuration
+        * @throws \TYPO3\CMS\Extbase\Property\Exception
         * @return \TYPO3\CMS\Extbase\Domain\Model\AbstractFileFolder
         * @api
         */
index 25d60d3..49ec3a7 100644 (file)
@@ -102,7 +102,8 @@ class DateTimeConverter extends \TYPO3\CMS\Extbase\Property\TypeConverter\Abstra
         * @param string $targetType must be "DateTime
         * @param array $convertedChildProperties not used currently
         * @param \TYPO3\CMS\Extbase\Property\PropertyMappingConfigurationInterface $configuration
-        * @return DateTime
+        * @throws \TYPO3\CMS\Extbase\Property\Exception\TypeConverterException
+        * @return \DateTime
         * @author Bastian Waidelich <bastian@typo3.org>
         */
        public function convertFrom($source, $targetType, array $convertedChildProperties = array(), \TYPO3\CMS\Extbase\Property\PropertyMappingConfigurationInterface $configuration = NULL) {
@@ -137,6 +138,7 @@ class DateTimeConverter extends \TYPO3\CMS\Extbase\Property\TypeConverter\Abstra
         * If no format is specified in the mapping configuration DEFAULT_DATE_FORMAT is used.
         *
         * @param \TYPO3\CMS\Extbase\Property\PropertyMappingConfigurationInterface $configuration
+        * @throws \TYPO3\CMS\Extbase\Property\Exception\InvalidPropertyMappingConfigurationException
         * @return string
         * @author Bastian Waidelich <bastian@typo3.org>
         */
@@ -156,7 +158,7 @@ class DateTimeConverter extends \TYPO3\CMS\Extbase\Property\TypeConverter\Abstra
        /**
         * Overrides hour, minute & second of the given date with the values in the $source array
         *
-        * @param DateTime $date
+        * @param \DateTime $date
         * @param array $source
         * @return void
         */
@@ -173,8 +175,9 @@ class DateTimeConverter extends \TYPO3\CMS\Extbase\Property\TypeConverter\Abstra
        /**
         * Overrides timezone of the given date with $source['timezone']
         *
-        * @param DateTime $date
+        * @param \DateTime $date
         * @param array $source
+        * @throws \TYPO3\CMS\Extbase\Property\Exception\TypeConverterException
         * @return void
         */
        protected function overrideTimezoneIfSpecified(\DateTime $date, array $source) {
index fbc591a..ded9a50 100644 (file)
@@ -46,7 +46,7 @@ class PersistentObjectConverter extends \TYPO3\CMS\Extbase\Property\TypeConverte
        protected $sourceTypes = array('string', 'array');
 
        /**
-        * @var strng
+        * @var string
         */
        protected $targetType = 'object';
 
@@ -131,6 +131,7 @@ class PersistentObjectConverter extends \TYPO3\CMS\Extbase\Property\TypeConverte
         * @param string $targetType
         * @param string $propertyName
         * @param \TYPO3\CMS\Extbase\Property\PropertyMappingConfigurationInterface $configuration
+        * @throws \TYPO3\CMS\Extbase\Property\Exception\InvalidTargetException
         * @return string
         * @author Sebastian Kurfürst <sebastian@typo3.org>
         */
@@ -154,6 +155,8 @@ class PersistentObjectConverter extends \TYPO3\CMS\Extbase\Property\TypeConverte
         * @param string $targetType
         * @param array $convertedChildProperties
         * @param \TYPO3\CMS\Extbase\Property\PropertyMappingConfigurationInterface $configuration
+        * @throws \InvalidArgumentException
+        * @throws \TYPO3\CMS\Extbase\Property\Exception\InvalidTargetException
         * @return object the target type
         * @author Sebastian Kurfürst <sebastian@typo3.org>
         */
@@ -181,6 +184,7 @@ class PersistentObjectConverter extends \TYPO3\CMS\Extbase\Property\TypeConverte
         * @param string $targetType
         * @param array $convertedChildProperties
         * @param \TYPO3\CMS\Extbase\Property\PropertyMappingConfigurationInterface $configuration
+        * @throws \TYPO3\CMS\Extbase\Property\Exception\InvalidPropertyMappingConfigurationException
         * @return object
         * @author Sebastian Kurfürst <sebastian@typo3.org>
         */
@@ -207,6 +211,8 @@ class PersistentObjectConverter extends \TYPO3\CMS\Extbase\Property\TypeConverte
         *
         * @param mixed $identity
         * @param string $targetType
+        * @throws \TYPO3\CMS\Extbase\Property\Exception\TargetNotFoundException
+        * @throws \TYPO3\CMS\Extbase\Property\Exception\InvalidSourceException
         * @return object
         * @author Sebastian Kurfürst <sebastian@typo3.org>
         * @author Bastian Waidelich <bastian@typo3.org>
index 299c687..01fb300 100644 (file)
@@ -51,7 +51,7 @@ class ClassReflection extends \ReflectionClass {
         * that Tx_Extbase_Reflection_MethodReflection objects are returned instead of the
         * orginal ReflectionMethod instances.
         *
-        * @param long $filter: A filter mask
+        * @param integer|NULL $filter A filter mask
         * @return \TYPO3\CMS\Extbase\Reflection\MethodReflection Method reflection objects of the methods in this class
         */
        public function getMethods($filter = NULL) {
@@ -99,7 +99,7 @@ class ClassReflection extends \ReflectionClass {
         * that Tx_Extbase_Reflection_PropertyReflection objects are returned instead of the
         * orginal ReflectionProperty instances.
         *
-        * @param long $filter: A filter mask
+        * @param integer|NULL $filter A filter mask
         * @return array of Tx_Extbase_Reflection_PropertyReflection Property reflection objects of the properties in this class
         */
        public function getProperties($filter = NULL) {
index 02eb414..4335b6b 100644 (file)
@@ -158,7 +158,8 @@ class ClassSchema {
        /**
         * Sets the model type of the class this schema is referring to.
         *
-        * @param integer The model type, one of the MODELTYPE_* constants.
+        * @param integer $modelType The model type, one of the MODELTYPE_* constants.
+        * @throws \InvalidArgumentException
         * @return void
         * @author Robert Lemke <robert@typo3.org>
         */
@@ -217,6 +218,7 @@ class ClassSchema {
         * Sets the property marked as uuid of an object with @uuid
         *
         * @param string $propertyName
+        * @throws \InvalidArgumentException
         * @return void
         * @author Karsten Dambekalns <karsten@typo3.org>
         */
@@ -243,6 +245,7 @@ class ClassSchema {
         * schema.
         *
         * @param string $propertyName
+        * @throws \InvalidArgumentException
         * @return void
         * @author Karsten Dambekalns <karsten@typo3.org>
         */
index 34da9db..591ff0d 100644 (file)
@@ -79,6 +79,7 @@ class DocCommentParser {
         * available.
         *
         * @param string $tagName The tag name to retrieve the values for
+        * @throws \RuntimeException
         * @return array The tag's values
         */
        public function getTagValues($tagName) {
index 6946914..3f8a62f 100644 (file)
@@ -40,6 +40,7 @@ class ObjectAccess {
        const ACCESS_GET = 0;
        const ACCESS_SET = 1;
        const ACCESS_PUBLIC = 2;
+
        /**
         * Get a property of a given object.
         * Tries to get the property the following ways:
@@ -54,9 +55,9 @@ class ObjectAccess {
         * @param mixed $subject Object or array to get the property from
         * @param string $propertyName name of the property to retrieve
         * @param boolean $forceDirectAccess directly access property using reflection(!)
+        * @throws Exception\PropertyNotAccessibleException
+        * @throws \InvalidArgumentException in case $subject was not an object or $propertyName was not a string
         * @return mixed Value of the property
-        * @throws InvalidArgumentException in case $subject was not an object or $propertyName was not a string
-        * @throws RuntimeException if the property was not accessible
         */
        static public function getProperty($subject, $propertyName, $forceDirectAccess = FALSE) {
                if (!is_object($subject) && !is_array($subject)) {
@@ -83,6 +84,7 @@ class ObjectAccess {
         * @param string $propertyName name of the property to retrieve
         * @param boolean $forceDirectAccess directly access property using reflection(!)
         * @param boolean $propertyExists (by reference) will be set to TRUE if the specified property exists and is gettable
+        * @throws Exception\PropertyNotAccessibleException
         * @return mixed Value of the property
         * @internal
         */
@@ -167,8 +169,8 @@ class ObjectAccess {
         * @param string $propertyName Name of the property to set
         * @param mixed $propertyValue Value of the property
         * @param boolean $forceDirectAccess directly access property using reflection(!)
+        * @throws \InvalidArgumentException in case $object was not an object or $propertyName was not a string
         * @return boolean TRUE if the property could be set, FALSE otherwise
-        * @throws InvalidArgumentException in case $object was not an object or $propertyName was not a string
         */
        static public function setProperty(&$subject, $propertyName, $propertyValue, $forceDirectAccess = FALSE) {
                if (is_array($subject)) {
@@ -209,6 +211,7 @@ class ObjectAccess {
         * - public properties which can be directly get.
         *
         * @param object $object Object to receive property names for
+        * @throws \InvalidArgumentException
         * @return array Array of all gettable property names
         * @author Sebastian Kurfürst <sebastian@typo3.org>
         * @author Karsten Dambekalns <karsten@typo3.org>
@@ -245,6 +248,7 @@ class ObjectAccess {
         * - public properties which can be directly set.
         *
         * @param object $object Object to receive property names for
+        * @throws \InvalidArgumentException
         * @return array Array of all settable property names
         * @author Karsten Dambekalns <karsten@typo3.org>
         */
@@ -272,6 +276,7 @@ class ObjectAccess {
         *
         * @param object $object Object containting the property
         * @param string $propertyName Name of the property to check
+        * @throws \InvalidArgumentException
         * @return boolean
         * @author Robert Lemke <robert@typo3.org>
         */
@@ -292,6 +297,7 @@ class ObjectAccess {
         *
         * @param object $object Object containting the property
         * @param string $propertyName Name of the property to check
+        * @throws \InvalidArgumentException
         * @return boolean
         */
        static public function isPropertyGettable($object, $propertyName) {
@@ -319,6 +325,7 @@ class ObjectAccess {
         * $object that are accessible through this class.
         *
         * @param object $object Object to get all properties from.
+        * @throws \InvalidArgumentException
         * @return array Associative array of all properties.
         * @todo What to do with ArrayAccess
         */
index e0e300f..d9ccfe4 100644 (file)
@@ -33,7 +33,7 @@ namespace TYPO3\CMS\Extbase\Reflection;
 class PropertyReflection extends \ReflectionProperty {
 
        /**
-        * @var Tx_Extbase_Reflection_DocCommentParser: An instance of the doc comment parser
+        * @var \TYPO3\CMS\Extbase\Reflection\DocCommentParser An instance of the doc comment parser
         */
        protected $docCommentParser;
 
index a349c4a..39edf27 100644 (file)
@@ -181,6 +181,7 @@ class Service implements \TYPO3\CMS\Core\SingletonInterface {
        /**
         * Initializes this service
         *
+        * @throws Exception
         * @return void
         */
        public function initialize() {
@@ -420,6 +421,7 @@ class Service implements \TYPO3\CMS\Core\SingletonInterface {
         * Builds class schemata from classes annotated as entities or value objects
         *
         * @param string $className
+        * @throws Exception\UnknownClassException
         * @return \TYPO3\CMS\Extbase\Reflection\ClassSchema The class schema
         */
        protected function buildClassSchema($className) {
@@ -458,9 +460,9 @@ class Service implements \TYPO3\CMS\Core\SingletonInterface {
        /**
         * Converts the given parameter reflection into an information array
         *
-        * @param ReflectionParameter $parameter The parameter to reflect
+        * @param \ReflectionParameter $parameter The parameter to reflect
         * @param integer $parameterPosition
-        * @param ReflectionMethod|NULL $method
+        * @param \ReflectionMethod|NULL $method
         * @return array Parameter information array
         */
        protected function convertParameterReflectionToArray(\ReflectionParameter $parameter, $parameterPosition, \ReflectionMethod $method = NULL) {
@@ -525,6 +527,7 @@ class Service implements \TYPO3\CMS\Core\SingletonInterface {
        /**
         * Exports the internal reflection data into the ReflectionData cache.
         *
+        * @throws Exception
         * @return void
         */
        protected function saveToCache() {
index 3e59c0f..6980ff6 100644 (file)
@@ -161,7 +161,7 @@ class FieldProvider implements \TYPO3\CMS\Scheduler\AdditionalFieldProviderInter
        protected function getCommandControllerActionArgumentFields(array $argumentDefinitions) {
                $fields = array();
                $argumentValues = $this->task->getArguments();
-               foreach ($argumentDefinitions as $index => $argument) {
+               foreach ($argumentDefinitions as $argument) {
                        $name = $argument->getName();
                        $defaultValue = $this->getDefaultArgumentValue($argument);
                        $this->task->addDefaultValue($name, $defaultValue);
index d6a6572..afbdfe0 100644 (file)
@@ -65,6 +65,7 @@ class RequestHashService implements \TYPO3\CMS\Core\SingletonInterface {
         *
         * @param array $formFieldNames Array of form fields
         * @param string $fieldNamePrefix
+        * @throws \TYPO3\CMS\Extbase\Security\Exception\InvalidArgumentForRequestHashGenerationException
         * @return string request hash
         * @author Sebastian Kurfürst <sebastian@typo3.org>
         * @todo might need to become public API lateron, as we need to call it from Fluid
@@ -128,6 +129,7 @@ class RequestHashService implements \TYPO3\CMS\Core\SingletonInterface {
         * In the end, $request->setHmacVerified is set depending on the value.
         *
         * @param \TYPO3\CMS\Extbase\Mvc\Web\Request $request The request to verify
+        * @throws \TYPO3\CMS\Extbase\Security\Exception\SyntacticallyWrongRequestHashException
         * @return void
         * @author Sebastian Kurfürst <sebastian@typo3.org>
         */
index 89315d9..aa0c08f 100644 (file)
@@ -88,6 +88,7 @@ class ExtensionService implements \TYPO3\CMS\Core\SingletonInterface {
         * @param string $extensionName name of the target extension (UpperCamelCase)
         * @param string $controllerName name of the target controller (UpperCamelCase)
         * @param string $actionName name of the target action (lowerCamelCase)
+        * @throws \TYPO3\CMS\Extbase\Exception
         * @return string name of the target plugin (UpperCamelCase) or NULL if no matching plugin configuration was found
         */
        public function getPluginNameByAction($extensionName, $controllerName, $actionName) {
@@ -147,6 +148,7 @@ class ExtensionService implements \TYPO3\CMS\Core\SingletonInterface {
         *
         * @param string $extensionName name of the extension to retrieve the target PID for
         * @param string $pluginName name of the plugin to retrieve the target PID for
+        * @throws \TYPO3\CMS\Extbase\Exception
         * @return integer uid of the target page or NULL if target page could not be determined
         */
        public function getTargetPidByPlugin($extensionName, $pluginName) {
index 922bd9f..4e5942b 100644 (file)
@@ -40,10 +40,12 @@ class TypeHandlingService implements \TYPO3\CMS\Core\SingletonInterface {
         * A type pattern to detect literal types.
         */
        const LITERAL_TYPE_PATTERN = '/^(?:integer|int|float|double|boolean|bool|string)$/';
+
        /**
         * Adds (defines) a specific property and its type.
         *
         * @param string $type Type of the property (see PARSE_TYPE_PATTERN)
+        * @throws \InvalidArgumentException
         * @return array An array with information about the type
         */
        public function parseType($type) {
index f002da2..96fa220 100644 (file)
@@ -79,6 +79,7 @@ class Dispatcher implements \TYPO3\CMS\Core\SingletonInterface {
         * @param mixed $slotClassNameOrObject Name of the class containing the slot or the instantiated class or a Closure object
         * @param string $slotMethodName Name of the method to be used as a slot. If $slotClassNameOrObject is a Closure object, this parameter is ignored
         * @param boolean $passSignalInformation If set to TRUE, the last argument passed to the slot will be information about the signal (EmitterClassName::signalName)
+        * @throws \InvalidArgumentException
         * @return void
         * @api
         */
index 8365e09..320d50b 100644 (file)
@@ -138,7 +138,7 @@ class ArrayUtility {
         */
        static public function containsMultipleTypes(array $array) {
                if (count($array) > 0) {
-                       foreach ($array as $key => $value) {
+                       foreach ($array as $value) {
                                if (!isset($previousType)) {
                                        $previousType = gettype($value);
                                } elseif ($previousType !== gettype($value)) {
@@ -172,6 +172,7 @@ class ArrayUtility {
         *
         * @param array &$array The array to traverse as a reference
         * @param array|string $path The path to follow. Either a simple array of keys or a string in the format 'foo.bar.baz'
+        * @throws \InvalidArgumentException
         * @return mixed The value found, NULL if the path didn't exist
         * @api
         */
@@ -199,6 +200,7 @@ class ArrayUtility {
         * @param array|\ArrayAccess $subject The array or ArrayAccess instance to work on
         * @param array|string $path The path to follow. Either a simple array of keys or a string in the format 'foo.bar.baz'
         * @param mixed $value The value to set
+        * @throws \InvalidArgumentException
         * @return array The modified array or object
         */
        static public function setValueByPath($subject, $path, $value) {
@@ -227,6 +229,7 @@ class ArrayUtility {
         *
         * @param array $array The array
         * @param array|string $path The path to follow. Either a simple array of keys or a string in the format 'foo.bar.baz'
+        * @throws \InvalidArgumentException
         * @return array The modified array
         */
        static public function unsetValueByPath(array $array, $path) {
@@ -271,6 +274,7 @@ class ArrayUtility {
         * Recursively convert an object hierarchy into an associative array.
         *
         * @param mixed $subject An object or array of objects
+        * @throws \InvalidArgumentException
         * @return array The subject represented as an array
         */
        static public function convertObjectToArray($subject) {
index ea07546..1c514d2 100644 (file)
@@ -120,7 +120,7 @@ class DebuggerUtility {
        /**
         * Renders a dump of the given array
         *
-        * @param array $array
+        * @param array|\Traversable $array
         * @param integer $level
         * @param boolean $plainText
         * @param boolean $ansiColors
@@ -387,9 +387,9 @@ class DebuggerUtility {
                        echo '
                                <style type=\'text/css\'>
                                        .debug-tree{position:relative;}
-                                       .debug-tree input{position:absolute;top:0px;left:0px;cursor:pointer;opacity:0;z-index:2;}
+                                       .debug-tree input{position:absolute;top:0;left:0;cursor:pointer;opacity:0;z-index:2;}
                                        .debug-tree input ~ .debug-content{display:none;}
-                                       .debug-tree .debug-header:before{content:"+";padding:0px 2px 0px 2px;margin:0 3px 0 3px;font-size:1em;font-weight:bold;color:#004fb0;border:1px #004fb0 solid;}
+                                       .debug-tree .debug-header:before{content:"+";padding:0 2px 0 2px;margin:0 3px 0 3px;font-size:1em;font-weight:bold;color:#004fb0;border:1px #004fb0 solid;}
                                        .debug-tree input:checked ~ .debug-content{display:inline;}
                                        .debug-tree input:checked ~ .debug-header:before{content:"-";}
                                        .Extbase-Utility-Debugger-VarDump{display:block;text-align:left;background:#b9b9b9;border:10px solid #b9b9b9;-moz-border-radius:10px;-webkit-border-radius:10px;border-radius:10px;-moz-box-shadow:0 0 20px #333;-webkit-box-shadow:0 0 20px #333;box-shadow:0 0 20px #333;z-index:999;color:#000;margin:20px 0 0;}
index 5748842..d2944ea 100644 (file)
@@ -68,6 +68,7 @@ class ExtensionUtility {
         * @param array $controllerActions is an array of allowed combinations of controller and action stored in an array (controller name as key and a comma separated list of action names as value, the first controller and its first action is chosen as default)
         * @param array $nonCacheableControllerActions is an optional array of controller name and  action names which should not be cached (array as defined in $controllerActions)
         * @param string $pluginType either Tx_Extbase_Utility_Extension::TYPE_PLUGIN (default) or Tx_Extbase_Utility_Extension::TYPE_CONTENT_ELEMENT
+        * @throws \InvalidArgumentException
         * @return void
         */
        static public function configurePlugin($extensionName, $pluginName, array $controllerActions, array $nonCacheableControllerActions = array(), $pluginType = self::PLUGIN_TYPE_PLUGIN) {
@@ -147,6 +148,7 @@ tt_content.') . $pluginSignature) . ' {
         * @param string $pluginName must be a unique id for your plugin in UpperCamelCase (the string length of the extension key added to the length of the plugin name should be less than 32!)
         * @param string $pluginTitle is a speaking title of the plugin that will be displayed in the drop down menu in the backend
         * @param string $pluginIconPathAndFilename is a path to an icon file (relative to TYPO3_mainDir), that will be displayed in the drop down menu in the backend (optional)
+        * @throws \InvalidArgumentException
         * @return void
         */
        static public function registerPlugin($extensionName, $pluginName, $pluginTitle, $pluginIconPathAndFilename = NULL) {
@@ -202,6 +204,7 @@ tt_content.') . $pluginSignature) . ' {
         * @param string $position This can be used to set the position of the $sub module within the list of existing submodules for the main module. $position has this syntax: [cmd]:[submodule-key]. cmd can be "after", "before" or "top" (or blank which is default). If "after"/"before" then submodule will be inserted after/before the existing submodule with [submodule-key] if found. If not found, the bottom of list. If "top" the module is inserted in the top of the submodule list.
         * @param array $controllerActions is an array of allowed combinations of controller and action stored in an array (controller name as key and a comma separated list of action names as value, the first controller and its first action is chosen as default)
         * @param array $moduleConfiguration The configuration options of the module (icon, locallang.xml file)
+        * @throws \InvalidArgumentException
         * @return void
         */
        static public function registerModule($extensionName, $mainModuleName = '', $subModuleName = '', $position = '', array $controllerActions, array $moduleConfiguration = array()) {
index e5303af..9a052ed 100644 (file)
@@ -43,7 +43,7 @@ class FrontendSimulatorUtility {
         * Sets the $TSFE->cObjectDepthCounter in Backend mode
         * This somewhat hacky work around is currently needed because the cObjGetSingle() function of tslib_cObj relies on this setting
         *
-        * @param tslib_cObj|NULL $cObj
+        * @param \TYPO3\CMS\Frontend\ContentObject\ContentObjectRenderer|NULL $cObj
         * @return void
         * @author Bastian Waidelich <bastian@typo3.org>
         */
index e1aad12..5f777a9 100644 (file)
@@ -94,6 +94,8 @@ abstract class AbstractCompositeValidator implements \TYPO3\CMS\Extbase\Validati
         * Removes the specified validator.
         *
         * @param \TYPO3\CMS\Extbase\Validation\Validator\ValidatorInterface $validator The validator to remove
+        * @throws \TYPO3\CMS\Extbase\Validation\Exception\NoSuchValidatorException
+        * @return void
         */
        public function removeValidator(\TYPO3\CMS\Extbase\Validation\Validator\ValidatorInterface $validator) {
                if (!$this->validators->contains($validator)) {
index 47734ba..093ae7c 100644 (file)
@@ -156,6 +156,7 @@ class GenericObjectValidator extends \TYPO3\CMS\Extbase\Validation\Validator\Abs
         *
         * @param object $object The object containing the property to validate
         * @param string $propertyName Name of the property to validate
+        * @throws \InvalidArgumentException
         * @return boolean TRUE if the property value is valid, FALSE if an error occured
         * @api
         * @deprecated since Extbase 1.4.0, will be removed in Extbase 6.0
index 0b0f0fb..e5f346e 100644 (file)
@@ -44,6 +44,8 @@ class StringLengthValidator extends \TYPO3\CMS\Extbase\Validation\Validator\Abst
         * If at least one error occurred, the result is FALSE.
         *
         * @param mixed $value The value that should be validated
+        * @throws \TYPO3\CMS\Extbase\Validation\Exception\InvalidSubjectException
+        * @throws \TYPO3\CMS\Extbase\Validation\Exception\InvalidValidationOptionsException
         * @return boolean TRUE if the value is valid, FALSE if an error occured
         */
        public function isValid($value) {
index d98ce16..5a24312 100644 (file)
@@ -149,6 +149,8 @@ class ValidatorResolver implements \TYPO3\CMS\Core\SingletonInterface {
         *
         * @param string $className
         * @param string $methodName
+        * @throws Exception\NoSuchValidatorException
+        * @throws Exception\InvalidValidationConfigurationException
         * @return array An Array of ValidatorConjunctions for each method parameters.
         */
        public function buildMethodArgumentsValidatorConjunctions($className, $methodName) {
@@ -200,6 +202,7 @@ class ValidatorResolver implements \TYPO3\CMS\Core\SingletonInterface {
         * name F3\Foo\Domain\Validator\QuuxValidator
         *
         * @param string $dataType The data type to build the validation conjunction for. Needs to be the fully qualified object name.
+        * @throws Exception\NoSuchValidatorException
         * @return \TYPO3\CMS\Extbase\Validation\Validator\ConjunctionValidator The validator conjunction or NULL
         */
        protected function buildBaseValidatorConjunction($dataType) {