CMISRepositoryService.inc.php
7.04 KB
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
<?php
/**
* CMIS Repository Service API class for KnowledgeTree.
*
* KnowledgeTree Community Edition
* Document Management Made Simple
* Copyright (C) 2008, 2009, 2010 KnowledgeTree Inc.
*
*
* This program is free software; you can redistribute it and/or modify it under
* the terms of the GNU General Public License version 3 as published by the
* Free Software Foundation.
*
* This program is distributed in the hope that it will be useful, but WITHOUT
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
* FOR A PARTICULAR PURPOSE. See the GNU General Public License for more
* details.
*
* You should have received a copy of the GNU General Public License
* along with this program. If not, see <http://www.gnu.org/licenses/>.
*
* You can contact KnowledgeTree Inc., PO Box 7775 #87847, San Francisco,
* California 94120-7775, or email info@knowledgetree.com.
*
* The interactive user interfaces in modified source and object code versions
* of this program must display Appropriate Legal Notices, as required under
* Section 5 of the GNU General Public License version 3.
*
* In accordance with Section 7(b) of the GNU General Public License version 3,
* these Appropriate Legal Notices must retain the display of the "Powered by
* KnowledgeTree" logo and retain the original copyright notice. If the display of the
* logo is not reasonably feasible for technical reasons, the Appropriate Legal Notices
* must display the words "Powered by KnowledgeTree" and retain the original
* copyright notice.
* Contributor( s): ______________________________________
*/
/**
*
* @copyright 2008-2010, KnowledgeTree Inc.
* @license GNU General Public License version 3
* @author KnowledgeTree Team
* @package KTCMIS
* @version Version 0.1
*/
require_once(CMIS_DIR . '/classes/CMISRepository.inc.php');
require_once(CMIS_DIR . '/classes/CMISObjectTypes.inc.php');
/**
* CMIS Repository Service.
*/
class CMISRepositoryService {
/**
* Gets a list of available repositories.
*
* @return a collection of repository entries
*/
function getRepositories()
{
$repositories = array();
// read the repositories config file to get the list of available repositories
// TODO what if file does not exist?
$xml = simplexml_load_file(CMIS_DIR . '/config/repositories.xml');
foreach($xml->repository as $repositoryXML) {
$repositoryId = (string)$repositoryXML->repositoryInfo[0]->repositoryId;
$Repository = new CMISRepository($repositoryId, $repositoryXML);
$repositories[] = $Repository;
}
return $repositories;
}
/**
* Fetches the RepositoryInfo object for a specified repository
*
* @param string $repositoryId
* @return object $repositoryInfo
*/
function getRepositoryInfo($repositoryId)
{
$Repository = new CMISRepository($repositoryId);
$repositoryInfo = $Repository->getRepositoryInfo();
return $repositoryInfo;
}
/**
* Gets a list of object types supported by the repository
*
* @param string $repositoryId The ID of the repository for which object types must be returned
* @param string $typeId The type to return, ALL if not set
* @param boolean $returnPropertyDefinitions Return property definitions as well if TRUE
* @param int $maxItems The maximum number of items to return
* @param int $skipCount The number of items to skip before starting to return results
* @param boolean $hasMoreItems TRUE if there are more items to return than were requested
* @return array $objectTypes
*/
// TODO return for specific type when $typeId is specified
// TODO other optional parameters
// This code is superseded by getTypeChildren and getTypeDescendants - when implementing those, check
// whether it is possible to entirely remove this function or if it is to remain and be shared by the
// other two functions (when no type is specified they will return base types [children] amd all types
// [descendants] respectively
public function getTypes($repositoryId, $typeId = '', $returnPropertyDefinitions = false,
$maxItems = 0, $skipCount = 0, &$hasMoreItems = false)
{
/*
if ($typeId != '')
{
try {
$typeDefinition = $this->getTypeDefinition($repositoryId, $typeId);
}
catch (Exception $e)
{
throw new InvalidArgumentException('Type ' . $typeId . ' is not supported');
}
}
*/
$repository = new CMISRepository($repositoryId);
$supportedTypes = $repository->getTypes();
$types = array();
// determine which types are actually supported based on available class definitions
// compared with the repository's declaration of the types it supports
$objectTypes = new CMISObjectTypes();
$types = $objectTypes->getObjectTypes();
foreach ($types as $key => $objectType)
{
// filter this list according to what is defined for the selected repository
// additionally filter based on typeId if set
if (!in_array($objectType, $supportedTypes) || (($typeId != '') && ($typeId != $objectType)))
{
unset($types[$key]);
continue;
}
$types[$key] = $this->getTypeDefinition($repositoryId, $objectType);
// only return properties if explicitly requested
if (!$returnPropertyDefinitions)
{
unset($types[$key]['properties']);
}
}
return $types;
}
/**
* Fetches the object type definition for the requested type
*
* @param string $repositoryId The ID of the repository
* @param string $typeId The ID of the object type requested
* @return $array $typeDefinition
*/
// NOTE this code may fit better in the Repository Class
function getTypeDefinition($repositoryId, $typeId)
{
$typeId = ucwords(str_replace('cmis:', '', $typeId));
$object = 'CMIS' . $typeId . 'Object';
// check whether the object type exists, return error if not
// consider throwing an exception instead (see General Exceptions)
if (!file_exists(CMIS_DIR . '/objecttypes/' . $object . '.inc.php')) {
throw new InvalidArgumentException('Type ' . $typeId . ' is not supported');
}
$typeDefinition = array();
require_once(CMIS_DIR . '/objecttypes/' . $object . '.inc.php');
$cmisObject = new $object;
// NOTE The specification is ambigous here: it states that this function must return the type properties, but
// the atompub example shows the type attributes, not properties; since most properties are only populated
// on creation of an instance of an object-type, we choose to go with the attributes and not the properties
$typeDefinition['attributes'] = $cmisObject->getAttributes();
return $typeDefinition;
}
}
?>