1	<?php
2
3	/**
4	* This program is free software; you can redistribute it and/or
5	* modify it under the terms of the GNU General Public License
6	* as published by the Free Software Foundation; under version 2
7	* of the License (non-upgradable).
8	*
9	* This program is distributed in the hope that it will be useful,
10	* but WITHOUT ANY WARRANTY; without even the implied warranty of
11	* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
12	* GNU General Public License for more details.
13	*
14	* You should have received a copy of the GNU General Public License
15	* along with this program; if not, write to the Free Software
16	* Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
17	*
18	* Copyright (c) 2015 (original work) Open Assessment Technologies SA (under the project TAO-PRODUCT);
19	*
20	*/
21
22	namespace oat\taoQtiItem\model\qti\metadata;
23
24	/**
25	* MetadataGuardion interface.
26	*
27	* All classes claiming to be able to identify an item being imported (using its associated metadata)
28	* as an item already stored in the item bank must implement this interface.
29	*
30	* @author Jérôme Bogaerts <jerome@taotesting.com>
31	*
32	*/
33	interface MetadataGuardian
34	{
35	/**
36	* Check whether or not an item is already stored in the item bank.
37	*
38	* This method takes in input an array of $metadataValues that will be inspected by the implementation
39	* to check whether or not, an item being imported is currently stored in the item bank.
40	*
41	* @param array $metadataValues An array of MetadataValue objects that were previously identified to belong to
42	*                              a given item.
43	* @return false|\core_kernel_classes_Resource An ontology resource describing an item already in the database or
44	*                                             false if not already in the database.
45	*/
46	public function guard(array $metadataValues);
47	}