Initial import

Author: rkrx

README.md

@@ -86,13 +86,13 @@ class ServiceDispatcher {
 
 ### ObjectFactory
 
-A `ObjectFactory` is mostly useful in common factories to create entities.
+A `ObjectFactory` is mostly useful in common factories to create entities. For implementation details, look at the phpdoc-blocks.
 
 ### InstanceContainer
 
-A `InstanceContainer` is mostly useful when in subjection to a di-container only a single instance of an object should be used. This is slightly different to the use of a singleton-pattern since you can have multiple di-containers with different configurations that may inject different implementations for 
+A `InstanceContainer` is mostly useful when in subjection to a di-container only a single instance of an object should be used. This is slightly different to the use of a singleton-pattern since you can have multiple di-containers with different configurations that may inject different implementations for the provided interfaces. For implementation details, look at the phpdoc-blocks.
 
 ### MethodInvoker
 
 Invokes a `callable` method, function or closure and resolve the required parameters automatically of not already
-provided. Here is a 
+provided. For implementation details, look at the phpdoc-blocks. 

src/Exceptions/DefinitionNotFoundException.php

@@ -0,0 +1,5 @@
+<?php
+namespace Ioc\Exceptions;
+
+class DefinitionNotFoundException extends \Exception {
+}

src/InstanceContainer.php

@@ -4,6 +4,7 @@
 interface InstanceContainer {
 	/**
 	 * Returns an instance of $className. Is no instance of $className exists, it will be created.
+	 * If no matching class could be found, it must throw an Ioc\Exceptions\DefinitionNotFoundException.
 	 *
 	 * @param string $className
 	 * @return object

src/MethodInvoker.php

@@ -4,7 +4,10 @@
 interface MethodInvoker {
 	/**
 	 * Invokes the callable $callable with the arguments $arguments. If arguments were missing in $arguments, the
-	 * method-invoker tries to fill the missing arguments by itself.
+	 * method-invoker tries to fill the missing arguments by itself. The provided callable could be a function, a static
+	 * method or a class not yet instantiated. The implementation determines how to handle the callable and find the
+	 * appropriate method for invocation. If no matching class could be found, it must throw an
+	 * Ioc\Exceptions\DefinitionNotFoundException.
 	 *
 	 * @param callable $callable
 	 * @param array $arguments

src/ObjectFactory.php

@@ -5,6 +5,7 @@ interface ObjectFactory {
 	/**
 	 * The object-factory creates a class with the name $className and the __construct-arguments $arguments. If
 	 * arguments were missing in $arguments, the method-invoker tries to fill the missing arguments by itself.
+	 * If no matching class could be found, it must throw an Ioc\Exceptions\DefinitionNotFoundException.
 	 *
 	 * @param string $className
 	 * @param array $arguments