Minor dependency updates
[yaffs-website] / vendor / easyrdf / easyrdf / lib / EasyRdf / TypeMapper.php
1 <?php
2
3 /**
4  * EasyRdf
5  *
6  * LICENSE
7  *
8  * Copyright (c) 2009-2013 Nicholas J Humfrey.  All rights reserved.
9  *
10  * Redistribution and use in source and binary forms, with or without
11  * modification, are permitted provided that the following conditions are met:
12  * 1. Redistributions of source code must retain the above copyright
13  *    notice, this list of conditions and the following disclaimer.
14  * 2. Redistributions in binary form must reproduce the above copyright notice,
15  *    this list of conditions and the following disclaimer in the documentation
16  *    and/or other materials provided with the distribution.
17  * 3. The name of the author 'Nicholas J Humfrey" may be used to endorse or
18  *    promote products derived from this software without specific prior
19  *    written permission.
20  *
21  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
22  * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
23  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
24  * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE
25  * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
26  * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
27  * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
28  * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
29  * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
30  * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
31  * POSSIBILITY OF SUCH DAMAGE.
32  *
33  * @package    EasyRdf
34  * @copyright  Copyright (c) 2009-2013 Nicholas J Humfrey
35  * @license    http://www.opensource.org/licenses/bsd-license.php
36  */
37
38 /**
39  * Class to map between RDF Types and PHP Classes
40  *
41  * @package    EasyRdf
42  * @copyright  Copyright (c) 2009-2013 Nicholas J Humfrey
43  * @license    http://www.opensource.org/licenses/bsd-license.php
44  */
45 class EasyRdf_TypeMapper
46 {
47     /** The type map registry */
48     private static $map = array();
49
50     /** Get the registered class for an RDF type
51      *
52      * If a type is not registered, then this method will return null.
53      *
54      * @param  string  $type   The RDF type (e.g. foaf:Person)
55      * @return string          The class name (e.g. Model_Foaf_Name)
56      */
57     public static function get($type)
58     {
59         if (!is_string($type) or $type == null or $type == '') {
60             throw new InvalidArgumentException(
61                 "\$type should be a string and cannot be null or empty"
62             );
63         }
64
65         $type = EasyRdf_Namespace::expand($type);
66         if (array_key_exists($type, self::$map)) {
67             return self::$map[$type];
68         } else {
69             return null;
70         }
71     }
72
73     /** Register an RDF type with a PHP Class name
74      *
75      * @param  string  $type   The RDF type (e.g. foaf:Person)
76      * @param  string  $class  The PHP class name (e.g. Model_Foaf_Name)
77      * @return string          The PHP class name
78      */
79     public static function set($type, $class)
80     {
81         if (!is_string($type) or $type == null or $type == '') {
82             throw new InvalidArgumentException(
83                 "\$type should be a string and cannot be null or empty"
84             );
85         }
86
87         if (!is_string($class) or $class == null or $class == '') {
88             throw new InvalidArgumentException(
89                 "\$class should be a string and cannot be null or empty"
90             );
91         }
92
93         $type = EasyRdf_Namespace::expand($type);
94         return self::$map[$type] = $class;
95     }
96
97     /**
98       * Delete an existing RDF type mapping.
99       *
100       * @param  string  $type   The RDF type (e.g. foaf:Person)
101       */
102     public static function delete($type)
103     {
104         if (!is_string($type) or $type == null or $type == '') {
105             throw new InvalidArgumentException(
106                 "\$type should be a string and cannot be null or empty"
107             );
108         }
109
110         $type = EasyRdf_Namespace::expand($type);
111         if (isset(self::$map[$type])) {
112             unset(self::$map[$type]);
113         }
114     }
115 }
116
117
118 /*
119    Register default set of mapped types
120 */
121
122 EasyRdf_TypeMapper::set('rdf:Alt', 'EasyRdf_Container');
123 EasyRdf_TypeMapper::set('rdf:Bag', 'EasyRdf_Container');
124 EasyRdf_TypeMapper::set('rdf:List', 'EasyRdf_Collection');
125 EasyRdf_TypeMapper::set('rdf:Seq', 'EasyRdf_Container');