NotAListOfFactories

Description

NotAListOfFactories is an exception. It is thrown when we have been given something that isn't a list of factories.

Public Interface

NotAListOfFactories has the following public interface:

// NotAListOfFactories lives in this namespace
namespace GanbaroDigital\DIContainers\V1\Exceptions;

// our base classes and interfaces
use GanbaroDigital\ExceptionHelpers\V1\BaseExceptions\UnsupportedType;
use GanbaroDigital\DIContainers\V1\Exceptions\DIContainersException;
use GanbaroDigital\HttpStatus\Interfaces\HttpRuntimeErrorException;

// return type(s) for our methods
use GanbaroDigital\HttpStatus\StatusValues\RuntimeError\UnexpectedErrorStatus;

class NotAListOfFactories
  extends UnsupportedType
  implements DIContainersException, HttpRuntimeErrorException
{
    // adds 'getHttpStatus()' that returns a HTTP 500 status value object
    use UnexpectedErrorStatusProvider;

    /**
     * create a new exception
     *
     * @param  mixed $var
     *         the variable that has the unsupported type
     * @param  string $fieldOrVarName
     *         the name of the input field, PHP variable or function/method
     *         parameter that contains $data
     * @param  int|null $typeFlags
     *         do we want any extra type information in the final exception message?
     * @param  array $callerFilter
     *         are there any namespaces we want to filter out of the call stack?
     * @return UnsupportedType
     *         an fully-built exception for you to throw
     */
    public static function newFromVar(
        $var,
        $fieldOrVarName,
        $typeFlags = null,
        array $callerFilter = []
    );

    /**
     * what was the data that we used to create the printable message?
     *
     * @return array
     */
    public function getMessageData();

    /**
     * what was the format string we used to create the printable message?
     *
     * @return string
     */
    public function getMessageFormat();

    /**
     * which HTTP status code do we map onto?
     *
     * @return UnexpectedErrorStatus
     */
    public function getHttpStatus();
}

How To Use

Creating Exceptions To Throw

Call NotAListOfFactories::newFromVar() to create a new exception that you can throw:

use GanbaroDigital\DIContainers\V1\Exceptions\NotAListOfFactories;

throw NotAListOfFactories::newFromVar($badData, "\$badData");

Catching The Exception

NotAListOfFactories implements a rich set of classes and interfaces. You can use any of these to catch this exception.

// example 1: we catch only NotAListOfFactories exceptions
use GanbaroDigital\DIContainers\V1\Exceptions\NotAListOfFactories;

try {
    throw NotAListOfFactories::newFromVar($badData, "\$badData");
}
catch(NotAListOfFactories $e) {
    // ...
}

// example 2: catch all exceptions thrown by the Exception Helpers Library
use GanbaroDigital\DIContainers\V1\Exceptions\NotAListOfFactories;
use GanbaroDigital\DIContainers\V1\Exceptions\DIContainersException;

try {
    throw NotAListOfFactories::newFromVar($badData, "\$badData");
}
catch(DIContainersException $e) {
    // ...
}

// example 3: catch all exceptions where something went wrong that
// should never happen
use GanbaroDigital\DIContainers\V1\Exceptions\NotAListOfFactories;
use GanbaroDigital\HttpStatus\Interfaces\HttpRuntimeErrorException;

try {
    throw NotAListOfFactories::newFromVar($badData, "\$badData");
}
catch(HttpRuntimeErrorException $e) {
    $httpStatus = $e->getHttpStatus();
    // ...
}

// example 4: catch all exceptions that map onto a HTTP status
use GanbaroDigital\DIContainers\V1\Exceptions\NotAListOfFactories;
use GanbaroDigital\HttpStatus\Interfaces\HttpException;

try {
    throw NotAListOfFactories::newFromVar($badData, "\$badData");
}
catch(HttpException $e) {
    $httpStatus = $e->getHttpStatus();
    // ...
}

// example 5: catch all runtime exceptions
use GanbaroDigital\DIContainers\V1\Exceptions\NotAListOfFactories;
use RuntimeException;

try {
    throw NotAListOfFactories::newFromVar($badData, "\$badData");
}
catch(RuntimeException $e) {
    // ...
}

Class Contract

Here is the contract for this class:

GanbaroDigital\DIContainers\V1\Exceptions\NotAListOfFactories
 [x] Can instantiate
 [x] Is d i containers exception
 [x] Is parameterised exception
 [x] Is runtime exception
 [x] Is http runtime error exception
 [x] Maps to unexpected error status
 [x] Can build from bad list
 [x] Exception message contains caller
 [x] Exception message contains type of non list

Class contracts are built from this class's unit tests.

Notes

None at this time.

Changelog

v1.2016060601

• $callerFilter signature changed

  The $callerFilter parameter is now type-hinted as an array, and can no longer be NULL.

  If no $callerFilter parameter is provided, it now defaults to an empty list. It no longer defaults to FilterCodeCaller::$DEFAULT_PARTIALS; that list no longer exists.

  These changes were made to make this class compatible with the latest Exception Helpers Library.

See Also

• FactoryList - interface for a dependency-injection container for factories
• FactoryListContainer - dependency-injection container for factories