Made configuration more like Jackson.

Added ability to change config on the mapper post instantiation
Added ability to always ignore unknowns.
Added option to throw an exception on unknowns.
Made BadConfig exception extend the base mapper exception.

Author: JonathanO

lib/Weasel/JsonMarshaller/Config/Deserialization/Feature.php

@@ -6,12 +6,26 @@
  */
 namespace Weasel\JsonMarshaller\Config\Deserialization;
 
-
+/**
+ * Features for config general mapper behaviour.
+ * These are the keys to be passed to the mapper configure() method.
+ */
 interface Feature {
+    /**
+     * bool. When true,  throw an exception (UnknownPropertyException) on encountering an unknown property in the JSON and
+     * there's no AnySetter configured (or ignoreUnknown isn't set.) Default: false.
+     */
     const FAIL_ON_UNKNOWN_PROPERTIES = "deserialization::fail_on_unknown";
+    /**
+     * bool. When true trigger an E_USER_WARNING on encountering an unknown property in the JSON and there's no AnySetter
+     * configured (or ignoreUnknown isn't set.) Default: true.
+     */
     const WARN_ON_UNKNOWN_PROPERTIES = "deserialization::warn_on_unknown";
 
+    /**
+     * bool. When true apply strict type checking. JSON types encountered are expected to match the PHP types we're
+     * going to deserialize to. If they don't, throw an exception. Default true.
+     */
     const STRICT_TYPES = "deserialization::strict_types";
 
-
 }

lib/Weasel/JsonMarshaller/JsonMapper.php

@@ -56,6 +56,10 @@ public function __construct(JsonConfigProvider $configProvider, $strict = true)
         }
     }
 
+    /**
+     * @param string $key One of the Config\*\Feature:: constants.
+     * @param mixed $value Appropriate value for the config option. See their documentation.
+     */
     public function configure($key, $value)
     {
         $this->mapperConfig[$key] = $value;