1 | <?php
|
---|
2 | // ----------------------------------------------------------------------------------
|
---|
3 | // Class: ResModel
|
---|
4 | // ----------------------------------------------------------------------------------
|
---|
5 |
|
---|
6 | /**
|
---|
7 | * A ResModel provides an resource centric view on an underlying RDF model.
|
---|
8 | * ResModels show information not as statements but as resources with
|
---|
9 | * properties, similar to Jena models. ResModels may create Resources [URI
|
---|
10 | * nodes and bnodes]. Creating a Resource does not make the Resource visible to
|
---|
11 | * the model; Resources are only "in" Models if Statements about them are added
|
---|
12 | * to the Model. Similarly the only way to "remove" a Resource from a Model is
|
---|
13 | * to remove all the Statements that mention it.
|
---|
14 | *
|
---|
15 | * When a Resource or Literal is created by a Model, the Model is free to re-use an existing
|
---|
16 | * Resource or Literal object with the correct values, or it may create a fresh one.
|
---|
17 | *
|
---|
18 | * @version $Id: ResModel.php 562 2008-02-29 15:30:18Z cax $
|
---|
19 | * @author Daniel Westphal <mail at d-westphal dot de>
|
---|
20 | *
|
---|
21 | *
|
---|
22 | * @package resModel
|
---|
23 | * @access public
|
---|
24 | **/
|
---|
25 |
|
---|
26 | class ResModel
|
---|
27 | {
|
---|
28 |
|
---|
29 | /**
|
---|
30 | * Holds a reference to the assoiated memmodel/dbmodel/infmodel
|
---|
31 | * @var ResResource
|
---|
32 | * @access private
|
---|
33 | */
|
---|
34 | var $model;
|
---|
35 |
|
---|
36 |
|
---|
37 | /**
|
---|
38 | * Constructor
|
---|
39 | * You have to supply a memmodel/dbmodel/infmodel to save the statements.
|
---|
40 | *
|
---|
41 | * @param object model $model
|
---|
42 | * @access public
|
---|
43 | */
|
---|
44 | function ResModel(& $model)
|
---|
45 | {
|
---|
46 | if (!is_a($model,'Model'))
|
---|
47 | trigger_error(RDFAPI_ERROR . '(class: ResourceLayer; method: ResourceLayer):
|
---|
48 | $model has to be object of class Model', E_USER_ERROR);
|
---|
49 |
|
---|
50 | $this->model =& $model;
|
---|
51 | }
|
---|
52 |
|
---|
53 | /**
|
---|
54 | * Create a new resource associated with this model.
|
---|
55 | * If the uri string isn't set, this creates a bnode.
|
---|
56 | * Otherwise it creates a URI node.
|
---|
57 | * A URI resource is .equals() to any other URI Resource with the same URI
|
---|
58 | * (even in a different model - be warned).
|
---|
59 | *
|
---|
60 | * This method may return an existing Resource with the correct URI and model,
|
---|
61 | * or it may construct a fresh one, as it sees fit.
|
---|
62 | *
|
---|
63 | * Operations on the result Resource may change this model.
|
---|
64 | *
|
---|
65 | * @param string $uri
|
---|
66 | * @return object ResResource
|
---|
67 | * @access public
|
---|
68 | */
|
---|
69 | function createResource($uri = null)
|
---|
70 | {
|
---|
71 | $resResource = new ResResource($uri);
|
---|
72 | //associate the resource with this model, and get a unique identifier
|
---|
73 | //if it is bnode.
|
---|
74 | $resResource->setAssociatedModel($this);
|
---|
75 |
|
---|
76 | return $resResource;
|
---|
77 | }
|
---|
78 |
|
---|
79 | /**
|
---|
80 | * Create a new Property associated with this model.
|
---|
81 | * This method may return an existing property with the correct URI and model,
|
---|
82 | * or it may construct a fresh one, as it sees fit.
|
---|
83 | *
|
---|
84 | * Subsequent operations on the returned property may modify this model.
|
---|
85 | *
|
---|
86 | *
|
---|
87 | * @param string $uri
|
---|
88 | * @return object ResProperty
|
---|
89 | * @access public
|
---|
90 | */
|
---|
91 | function createProperty($uri = null)
|
---|
92 | {
|
---|
93 | $resProperty = new ResProperty($uri);
|
---|
94 | $resProperty->setAssociatedModel($this);
|
---|
95 |
|
---|
96 | return $resProperty;
|
---|
97 | }
|
---|
98 |
|
---|
99 | /**
|
---|
100 | * Create an untyped literal from a String value with a specified language.
|
---|
101 | *
|
---|
102 | * If you want to type this literal, you have to set a datatype before
|
---|
103 | * adding it to the model.
|
---|
104 | *
|
---|
105 | *
|
---|
106 | * @param string $label
|
---|
107 | * @param string $languageTag
|
---|
108 | * @return object ResLiteral
|
---|
109 | * @access public
|
---|
110 | */
|
---|
111 | function createLiteral($label,$languageTag = null)
|
---|
112 | {
|
---|
113 | $resLiteral = new ResLiteral($label,$languageTag);
|
---|
114 | $resLiteral->setAssociatedModel($this);
|
---|
115 |
|
---|
116 | return $resLiteral;
|
---|
117 | }
|
---|
118 |
|
---|
119 | /**
|
---|
120 | * General method to search for triples.
|
---|
121 | * NULL input for any parameter will match anything.
|
---|
122 | * Example: $result = $m->find( NULL, NULL, $node );
|
---|
123 | * Finds all Statements with $node as object.
|
---|
124 | * Returns an array of statements with ResResources.
|
---|
125 | *
|
---|
126 | * @param object ResResource $subject
|
---|
127 | * @param object ResResource $predicate
|
---|
128 | * @param object ResResource $object
|
---|
129 | * @return array
|
---|
130 | * @access public
|
---|
131 | * @throws PhpError
|
---|
132 | */
|
---|
133 | function find($subject,$predicate, $object)
|
---|
134 | {
|
---|
135 | $result=array();
|
---|
136 | //convert ResResources to Resources and Blanknodes
|
---|
137 | $resmodel=$this->model->find( $this->_resNode2Node($subject),
|
---|
138 | $this->_resNode2Node($predicate),
|
---|
139 | $this->_resNode2Node($object)
|
---|
140 | );
|
---|
141 | //convert Resources, Blanknodes to ResResources
|
---|
142 | foreach ($resmodel->triples as $statement)
|
---|
143 | {
|
---|
144 | $result[]=new Statement($this->_node2ResNode($statement->getSubject()),
|
---|
145 | $this->_node2ResNode($statement->getPredicate(),true),
|
---|
146 | $this->_node2ResNode($statement->getObject())
|
---|
147 | );
|
---|
148 | };
|
---|
149 | return $result;
|
---|
150 |
|
---|
151 | }
|
---|
152 |
|
---|
153 | /**
|
---|
154 | * Searches for triples and returns the first matching statement.
|
---|
155 | * NULL input for any parameter will match anything.
|
---|
156 | * Example: $result = $m->findFirstMatchingStatement( NULL, NULL, $node );
|
---|
157 | * Returns the first statement with ResResources of the Model where the object equals $node.
|
---|
158 | * Returns an NULL if nothing is found.
|
---|
159 | * You can define an offset to search.
|
---|
160 | *
|
---|
161 | * @param object Node $subject
|
---|
162 | * @param object Node $predicate
|
---|
163 | * @param object Node $object
|
---|
164 | * @param integer $offset
|
---|
165 | * @return object Statement
|
---|
166 | * @access public
|
---|
167 | */
|
---|
168 | function findFirstMatchingStatement($subject,$predicate,$object,$offset = 0)
|
---|
169 | {
|
---|
170 |
|
---|
171 | $statement = $this->model->findFirstMatchingStatement( $this->_resNode2Node($subject),
|
---|
172 | $this->_resNode2Node($predicate),
|
---|
173 | $this->_resNode2Node($object),
|
---|
174 | $offset
|
---|
175 | );
|
---|
176 | if ($statement!==null)
|
---|
177 | {
|
---|
178 | return new Statement( $this->_node2ResNode($statement->getSubject()),
|
---|
179 | $this->_node2ResNode($statement->getPredicate(),true),
|
---|
180 | $this->_node2ResNode($statement->getObject())
|
---|
181 | );
|
---|
182 | } else
|
---|
183 | {
|
---|
184 | return null;
|
---|
185 | }
|
---|
186 | }
|
---|
187 |
|
---|
188 | /**
|
---|
189 | * Adds a new triple to the Model without checking if the statement is already in the Model.
|
---|
190 | * So if you want a duplicate free Model use the addWithoutDuplicates() function (which is slower then add())
|
---|
191 | * Expects a statements with ResResources(ResLiterals)
|
---|
192 | *
|
---|
193 | * @param object Statement $statement
|
---|
194 | * @access public
|
---|
195 | * @throws PhpError
|
---|
196 | */
|
---|
197 | function add($statement)
|
---|
198 | {
|
---|
199 | return $this->model->add(new Statement( $this->_resNode2Node($statement->getSubject()),
|
---|
200 | $this->_resNode2Node($statement->getPredicate()),
|
---|
201 | $this->_resNode2Node($statement->getObject()))
|
---|
202 | );
|
---|
203 | }
|
---|
204 | /**
|
---|
205 | * Checks if a new statement is already in the Model and adds the statement, if it is not in the Model.
|
---|
206 | * addWithoutDuplicates() is significantly slower then add().
|
---|
207 | * Retruns TRUE if the statement is added.
|
---|
208 | * FALSE otherwise.
|
---|
209 | * Expects a statements with ResResources(ResLiterals)
|
---|
210 | *
|
---|
211 | * @param object Statement $statement
|
---|
212 | * @return boolean
|
---|
213 | * @access public
|
---|
214 | * @throws PhpError
|
---|
215 | */
|
---|
216 | function addWithoutDuplicates($statement)
|
---|
217 | {
|
---|
218 | return $this->model->addWithoutDuplicates(new Statement($this->_resNode2Node($statement->getSubject()),
|
---|
219 | $this->_resNode2Node($statement->getPredicate()),
|
---|
220 | $this->_resNode2Node($statement->getObject()))
|
---|
221 | );
|
---|
222 | }
|
---|
223 |
|
---|
224 | /**
|
---|
225 | * Tests if the Model contains the given statement.
|
---|
226 | * TRUE if the statement belongs to the model;
|
---|
227 | * FALSE otherwise.
|
---|
228 | * Expects a statement of ResResources(ResLiterals)
|
---|
229 | *
|
---|
230 | * @param object Statement $statement
|
---|
231 | * @return boolean
|
---|
232 | * @access public
|
---|
233 | */
|
---|
234 | function contains(& $statement)
|
---|
235 | {
|
---|
236 |
|
---|
237 | return $this->model->contains(new Statement($this->_resNode2Node($statement->getSubject()),
|
---|
238 | $this->_resNode2Node($statement->getPredicate()),
|
---|
239 | $this->_resNode2Node($statement->getObject()))
|
---|
240 | );
|
---|
241 | }
|
---|
242 |
|
---|
243 | /**
|
---|
244 | * Determine if all of the statements in a model are also contained in this model.
|
---|
245 | * True if all of the statements in $model are also contained in this model and false otherwise.
|
---|
246 | *
|
---|
247 | * @param object Model &$model
|
---|
248 | * @return boolean
|
---|
249 | * @access public
|
---|
250 | */
|
---|
251 | function containsAll(& $model)
|
---|
252 | {
|
---|
253 | if (is_a($model,'ResModel'))
|
---|
254 | return $this->model->containsAll($model->getModel());
|
---|
255 |
|
---|
256 | return $this->model->containsAll($model);
|
---|
257 | }
|
---|
258 |
|
---|
259 | /**
|
---|
260 | * Determine if any of the statements in a model are also contained in this model.
|
---|
261 | * True if any of the statements in $model are also contained in this model and false otherwise.
|
---|
262 | *
|
---|
263 | * @param object Model &$model
|
---|
264 | * @return boolean
|
---|
265 | * @access public
|
---|
266 | */
|
---|
267 | function containsAny(& $model)
|
---|
268 | {
|
---|
269 | if (is_a($model,'ResModel'))
|
---|
270 | return $this->model->containsAny($model->getModel());
|
---|
271 | return $this->model->containsAny($model);
|
---|
272 | }
|
---|
273 |
|
---|
274 | /**
|
---|
275 | * Determine if the node (ResResource / ResLiteral) $node appears in any statement of this model.
|
---|
276 | *
|
---|
277 | * @param object Node &$node
|
---|
278 | * @return boolean
|
---|
279 | * @access public
|
---|
280 | */
|
---|
281 | function containsResource(& $node)
|
---|
282 | {
|
---|
283 | if ($this->findFirstMatchingStatement($node,null,null) === null)
|
---|
284 | if ($this->findFirstMatchingStatement(null,$node,null) === null)
|
---|
285 | if ($this->findFirstMatchingStatement(null,null,$node) === null)
|
---|
286 | return false;
|
---|
287 |
|
---|
288 | return true;
|
---|
289 | }
|
---|
290 |
|
---|
291 | /**
|
---|
292 | * Create a literal from a String value with the $dtype Datatype
|
---|
293 | * An existing literal of the right value may be returned, or a fresh one created.
|
---|
294 | *
|
---|
295 | * @param string $value
|
---|
296 | * @param string $dtype
|
---|
297 | * @return object ResLiteral
|
---|
298 | * @access public
|
---|
299 | */
|
---|
300 | function createTypedLiteral($value,$dtype)
|
---|
301 | {
|
---|
302 | $resLiteral = new ResLiteral($value);
|
---|
303 | $resLiteral->setDatatype($dtype);
|
---|
304 | $resLiteral->setAssociatedModel($this);
|
---|
305 |
|
---|
306 | return $resLiteral;
|
---|
307 | }
|
---|
308 |
|
---|
309 | /**
|
---|
310 | * Checks if two models are equal.
|
---|
311 | * Two models are equal if and only if the two RDF graphs they represent are isomorphic.
|
---|
312 | *
|
---|
313 | * Warning: This method doesn't work correct with models where the same blank node has different
|
---|
314 | * identifiers in the two models. We will correct this in a future version.
|
---|
315 | *
|
---|
316 | * @access public
|
---|
317 | * @param object model &$that
|
---|
318 | * @throws phpErrpr
|
---|
319 | * @return boolean
|
---|
320 | */
|
---|
321 | function equals(& $that)
|
---|
322 | {
|
---|
323 | if (is_a($that,'ResModel'))
|
---|
324 | return $this->model->equals($that->getModel());
|
---|
325 | return $this->model->equals($that);
|
---|
326 | }
|
---|
327 |
|
---|
328 | /**
|
---|
329 | * Returns a new model that is the subtraction of another model from this model.
|
---|
330 | *
|
---|
331 | * @param object Model $model
|
---|
332 | * @return object MemModel
|
---|
333 | * @access public
|
---|
334 | * @throws phpErrpr
|
---|
335 | */
|
---|
336 | function subtract($model)
|
---|
337 | {
|
---|
338 | if (is_a($model,'ResModel'))
|
---|
339 | return $this->model->subtract($model->getModel());
|
---|
340 | return $this->model->subtract($model);
|
---|
341 | }
|
---|
342 |
|
---|
343 | /**
|
---|
344 | * Answer a statement find(s, p, null) with ResResources(ResLiterals) from this model.
|
---|
345 | * If none exist, return null; if several exist, pick one arbitrarily.
|
---|
346 | *
|
---|
347 | * @param object ResResource $subject
|
---|
348 | * @param object ResResource $property
|
---|
349 | * @return object Statement
|
---|
350 | * @access public
|
---|
351 | * @throws phpErrpr
|
---|
352 | */
|
---|
353 | function getProperty($subject,$property)
|
---|
354 | {
|
---|
355 |
|
---|
356 | $statement= $this->model->findFirstMatchingStatement( $this->_resNode2Node($subject),
|
---|
357 | $this->_resNode2Node($property),
|
---|
358 | null
|
---|
359 | );
|
---|
360 | if ($statement === null)
|
---|
361 | return null;
|
---|
362 |
|
---|
363 | return new Statement($this->_node2ResNode($statement->getSubject()),
|
---|
364 | $this->_node2ResNode($statement->getPredicate(),true),
|
---|
365 | $this->_node2ResNode($statement->getObject())
|
---|
366 | );
|
---|
367 |
|
---|
368 | }
|
---|
369 |
|
---|
370 | /**
|
---|
371 | * Checks if MemModel is empty
|
---|
372 | *
|
---|
373 | * @return boolean
|
---|
374 | * @access public
|
---|
375 | */
|
---|
376 | function isEmpty()
|
---|
377 | {
|
---|
378 | return $this->model->isEmpty();
|
---|
379 | }
|
---|
380 |
|
---|
381 | /**
|
---|
382 | * Returns a ResIterator with all objects in a model.
|
---|
383 | *
|
---|
384 | * @return object ResIterator
|
---|
385 | * @access public
|
---|
386 | * @throws phpErrpr
|
---|
387 | */
|
---|
388 | function listObjects()
|
---|
389 | {
|
---|
390 | return $this->listObjectsOfProperty(null);
|
---|
391 | }
|
---|
392 |
|
---|
393 | /**
|
---|
394 | * Returns a ResIterator with all objects with a given property and property value.
|
---|
395 | *
|
---|
396 | * @param object ResResource $property
|
---|
397 | * @param object ResResource $value
|
---|
398 | * @return object ResIterator
|
---|
399 | * @access public
|
---|
400 | */
|
---|
401 | function listObjectsOfProperty($property, $value = null)
|
---|
402 | {
|
---|
403 | return new ResIterator(null,$property,$value,'o',$this);
|
---|
404 | }
|
---|
405 |
|
---|
406 |
|
---|
407 | /**
|
---|
408 | * Returns a ResIterator with all subjects in a model.
|
---|
409 | *
|
---|
410 | * @return object ResIterator
|
---|
411 | * @access public
|
---|
412 | * @throws phpErrpr
|
---|
413 | */
|
---|
414 | function listSubjects()
|
---|
415 | {
|
---|
416 | return $this->listSubjectsWithProperty(null);
|
---|
417 | }
|
---|
418 |
|
---|
419 | /**
|
---|
420 | * Returns a ResIterator with all subjects with a given property and property value.
|
---|
421 | *
|
---|
422 | * @param object ResResource $property
|
---|
423 | * @param object ResResource $value
|
---|
424 | * @return object ResIterator
|
---|
425 | * @access public
|
---|
426 | * @throws phpErrpr
|
---|
427 | */
|
---|
428 | function listSubjectsWithProperty($property,$value = null)
|
---|
429 | {
|
---|
430 | return new ResIterator(null,$property,$value,'s',$this);
|
---|
431 | }
|
---|
432 |
|
---|
433 | /**
|
---|
434 | * Removes the statement of ResResources(ResTriples) from the MemModel.
|
---|
435 | * TRUE if the statement is removed.
|
---|
436 | * FALSE otherwise.
|
---|
437 | *
|
---|
438 | * @param object Statement $statement
|
---|
439 | * @return boolean
|
---|
440 | * @access public
|
---|
441 | * @throws PhpError
|
---|
442 | */
|
---|
443 | function remove($statement)
|
---|
444 | {
|
---|
445 | return $this->model->remove(new Statement( $this->_resNode2Node($statement->getSubject()),
|
---|
446 | $this->_resNode2Node($statement->getPredicate()),
|
---|
447 | $this->_resNode2Node($statement->getObject())
|
---|
448 | ));
|
---|
449 | }
|
---|
450 |
|
---|
451 | /**
|
---|
452 | * Number of statements in the MemModel
|
---|
453 | *
|
---|
454 | * @return integer
|
---|
455 | * @access public
|
---|
456 | */
|
---|
457 | function size()
|
---|
458 | {
|
---|
459 | return $this->model->size();
|
---|
460 | }
|
---|
461 |
|
---|
462 | /**
|
---|
463 | * Returns a new Model that is the set-union of the model with another model.
|
---|
464 | * Duplicate statements are removed. If you want to allow duplicates, use addModel() which is much faster.
|
---|
465 | *
|
---|
466 | * The result of taking the set-union of two or more RDF graphs (i.e. sets of triples)
|
---|
467 | * is another graph, which we will call the merge of the graphs.
|
---|
468 | * Each of the original graphs is a subgraph of the merged graph. Notice that when forming
|
---|
469 | * a merged graph, two occurrences of a given uriref or literal as nodes in two different
|
---|
470 | * graphs become a single node in the union graph (since by definition they are the same
|
---|
471 | * uriref or literal) but blank nodes are not 'merged' in this way; and arcs are of course
|
---|
472 | * never merged. In particular, this means that every blank node in a merged graph can be
|
---|
473 | * identified as coming from one particular graph in the original set of graphs.
|
---|
474 | *
|
---|
475 | * Notice that one does not, in general, obtain the merge of a set of graphs by concatenating
|
---|
476 | * their corresponding N-triples documents and constructing the graph described by the merged
|
---|
477 | * document, since if some of the documents use the same node identifiers, the merged document
|
---|
478 | * will describe a graph in which some of the blank nodes have been 'accidentally' merged.
|
---|
479 | * To merge Ntriples documents it is necessary to check if the same nodeID is used in two or
|
---|
480 | * more documents, and to replace it with a distinct nodeID in each of them, before merging the
|
---|
481 | * documents. (Not implemented yet !!!!!!!!!!!)
|
---|
482 | *
|
---|
483 | * @param object Model $model
|
---|
484 | * @return object MemModel
|
---|
485 | * @access public
|
---|
486 | * @throws phpErrpr
|
---|
487 | *
|
---|
488 | */
|
---|
489 | function & unite(& $model)
|
---|
490 | {
|
---|
491 | if (is_a($model,'ResModel'))
|
---|
492 | return $this->model->unite($model->getModel());
|
---|
493 | return $this->model->unite($model);
|
---|
494 | }
|
---|
495 |
|
---|
496 | /**
|
---|
497 | * Adds another model to this MemModel.
|
---|
498 | * Duplicate statements are not removed.
|
---|
499 | * If you don't want duplicates, use unite().
|
---|
500 | * If any statement of the model to be added to this model contains a blankNode
|
---|
501 | * with an identifier already existing in this model, a new blankNode is generated.
|
---|
502 | *
|
---|
503 | * @param object Model $model
|
---|
504 | * @access public
|
---|
505 | * @throws phpErrpr
|
---|
506 | *
|
---|
507 | */
|
---|
508 | function addModel(&$model)
|
---|
509 | {
|
---|
510 | if (is_a($model,'ResModel'))
|
---|
511 | return $this->model->addModel($model->getModel());
|
---|
512 | return $this->model->addModel($model);
|
---|
513 | }
|
---|
514 |
|
---|
515 | /**
|
---|
516 | * Create a new RDF Container from type rdf:Alt
|
---|
517 | * This method may return an existing container with the correct URI and model,
|
---|
518 | * or it may construct a fresh one, as it sees fit.
|
---|
519 | *
|
---|
520 | * Subsequent operations on the returned Container may modify this model.
|
---|
521 | *
|
---|
522 | *
|
---|
523 | * @param string $uri
|
---|
524 | * @return object ResProperty
|
---|
525 | * @access public
|
---|
526 | */
|
---|
527 | function createAlt($uri = null)
|
---|
528 | {
|
---|
529 | $resAlt = new ResAlt($uri);
|
---|
530 | $resAlt->setAssociatedModel($this);
|
---|
531 |
|
---|
532 | return $resAlt;
|
---|
533 | }
|
---|
534 |
|
---|
535 | /**
|
---|
536 | * Create a new RDF Container from type rdf:Bag
|
---|
537 | * This method may return an existing container with the correct URI and model,
|
---|
538 | * or it may construct a fresh one, as it sees fit.
|
---|
539 | *
|
---|
540 | * Subsequent operations on the returned Container may modify this model.
|
---|
541 | *
|
---|
542 | *
|
---|
543 | * @param string $uri
|
---|
544 | * @return object ResProperty
|
---|
545 | * @access public
|
---|
546 | */
|
---|
547 | function createBag($uri = null)
|
---|
548 | {
|
---|
549 | $resBag = new ResBag($uri);
|
---|
550 | $resBag->setAssociatedModel($this);
|
---|
551 |
|
---|
552 | return $resBag;
|
---|
553 | }
|
---|
554 |
|
---|
555 | /**
|
---|
556 | * Create a new RDF Container from type rdf:Seq
|
---|
557 | * This method may return an existing container with the correct URI and model,
|
---|
558 | * or it may construct a fresh one, as it sees fit.
|
---|
559 | *
|
---|
560 | * Subsequent operations on the returned Container may modify this model.
|
---|
561 | *
|
---|
562 | *
|
---|
563 | * @param string $uri
|
---|
564 | * @return object ResProperty
|
---|
565 | * @access public
|
---|
566 | */
|
---|
567 | function createSeq($uri = null)
|
---|
568 | {
|
---|
569 | $resSeq = new ResSeq($uri);
|
---|
570 | $resSeq->setAssociatedModel($this);
|
---|
571 |
|
---|
572 | return $resSeq;
|
---|
573 | }
|
---|
574 |
|
---|
575 | /**
|
---|
576 | * Create a new RDF Collection from type rdf:List
|
---|
577 | * This method may return an existing container with the correct URI and model,
|
---|
578 | * or it may construct a fresh one, as it sees fit.
|
---|
579 | *
|
---|
580 | * Subsequent operations on the returned Container may modify this model.
|
---|
581 | *
|
---|
582 | *
|
---|
583 | * @param string $uri
|
---|
584 | * @return object ResProperty
|
---|
585 | * @access public
|
---|
586 | */
|
---|
587 | function createList($uri = null)
|
---|
588 | {
|
---|
589 | $resList = new ResList($uri);
|
---|
590 | $resList->setAssociatedModel($this);
|
---|
591 |
|
---|
592 | return $resList;
|
---|
593 | }
|
---|
594 |
|
---|
595 | /**
|
---|
596 | * Returns a reference to the underlying model (Mem/DB/InfModel) that contains the statements
|
---|
597 | *
|
---|
598 | *
|
---|
599 | * @return object Model
|
---|
600 | * @access public
|
---|
601 | */
|
---|
602 | function & getModel()
|
---|
603 | {
|
---|
604 | return $this->model;
|
---|
605 | }
|
---|
606 |
|
---|
607 |
|
---|
608 | /**
|
---|
609 | * Internal method, that returns a resource URI that is unique for the Model.
|
---|
610 | * URIs are generated using the base_uri of the Model, the prefix and a unique number.
|
---|
611 | * If no prefix is defined, the bNode prefix, defined in constants.php, is used.
|
---|
612 | *
|
---|
613 | * @param string $prefix
|
---|
614 | * @return string
|
---|
615 | * @access private
|
---|
616 | */
|
---|
617 | function getUniqueResourceURI($bnodePrefix)
|
---|
618 | {
|
---|
619 | return $this->model->getUniqueResourceURI($bnodePrefix);
|
---|
620 | }
|
---|
621 |
|
---|
622 | /**
|
---|
623 | * Load a model from a file containing RDF, N3 or N-Triples.
|
---|
624 | * This function recognizes the suffix of the filename (.n3 or .rdf) and
|
---|
625 | * calls a suitable parser, if no $type is given as string ("rdf" "n3" "nt");
|
---|
626 | * If the model is not empty, the contents of the file is added to this DbModel.
|
---|
627 | *
|
---|
628 | * @param string $filename
|
---|
629 | * @param string $type
|
---|
630 | * @param boolean $stream
|
---|
631 | * @access public
|
---|
632 | */
|
---|
633 | function load($filename, $type = NULL, $stream=false)
|
---|
634 | {
|
---|
635 | $this->model->load($filename, $type, $stream);
|
---|
636 | }
|
---|
637 |
|
---|
638 | /**
|
---|
639 | * Return current baseURI.
|
---|
640 | *
|
---|
641 | * @return string
|
---|
642 | * @access public
|
---|
643 | */
|
---|
644 | function getBaseURI()
|
---|
645 | {
|
---|
646 | return $this->model->getBaseURI();
|
---|
647 | }
|
---|
648 |
|
---|
649 | /**
|
---|
650 | * Saves the RDF,N3 or N-Triple serialization of the MemModel to a file.
|
---|
651 | * You can decide to which format the model should be serialized by using a
|
---|
652 | * corresponding suffix-string as $type parameter. If no $type parameter
|
---|
653 | * is placed this method will serialize the model to XML/RDF format.
|
---|
654 | * Returns FALSE if the MemModel couldn't be saved to the file.
|
---|
655 | *
|
---|
656 | * @access public
|
---|
657 | * @param string $filename
|
---|
658 | * @param string $type
|
---|
659 | * @throws PhpError
|
---|
660 | * @return boolean
|
---|
661 | */
|
---|
662 | function saveAs($filename, $type ='rdf')
|
---|
663 | {
|
---|
664 | return $this->model->saveAs($filename, $type ='rdf');
|
---|
665 | }
|
---|
666 |
|
---|
667 | /**
|
---|
668 | * Writes the RDF serialization of the MemModel as HTML table.
|
---|
669 | *
|
---|
670 | * @access public
|
---|
671 | */
|
---|
672 | function writeAsHTMLTable()
|
---|
673 | {
|
---|
674 | $this->model->writeAsHtmlTable();
|
---|
675 | }
|
---|
676 |
|
---|
677 | /**
|
---|
678 | * Returns a new model containing all the statements which are in both this model and another.
|
---|
679 | *
|
---|
680 | * @param object Model $model
|
---|
681 | * @return object MemModel
|
---|
682 | * @access public
|
---|
683 | * @throws phpErrpr
|
---|
684 | */
|
---|
685 | function & intersect(& $model)
|
---|
686 | {
|
---|
687 | if (is_a($model,'ResModel'))
|
---|
688 | return $this->model->intersect($model->getModel());
|
---|
689 | return $this->model->intersect($model);
|
---|
690 | }
|
---|
691 |
|
---|
692 | /**
|
---|
693 | * converts a Resource,Blanknode,Literal into a ResResource, ResProperty, or ResLiteral
|
---|
694 | *
|
---|
695 | * @param object Node $node
|
---|
696 | * @param boolean $isProperty
|
---|
697 | * @return object ResResource / ResProperty / ResLiteral
|
---|
698 | * @access private
|
---|
699 | * @throws phpErrpr
|
---|
700 | */
|
---|
701 | function _node2ResNode($node, $isProperty = false)
|
---|
702 | {
|
---|
703 | if (is_a($node,'Literal'))
|
---|
704 | {
|
---|
705 | $return= new ResLiteral($node->getLabel(),$node->getLanguage());
|
---|
706 | $return->setDatatype($node->getDatatype());
|
---|
707 | $return->setAssociatedModel($this);
|
---|
708 |
|
---|
709 | return $return;
|
---|
710 | }
|
---|
711 | if (is_a($node,'Resource'))
|
---|
712 | {
|
---|
713 | if ($isProperty)
|
---|
714 | {
|
---|
715 | $res= new ResProperty($node->getLabel());
|
---|
716 | } else
|
---|
717 | {
|
---|
718 | $res= new ResResource($node->getLabel());
|
---|
719 | }
|
---|
720 | $res->setAssociatedModel($this);
|
---|
721 | if (is_a($node,'Blanknode'))
|
---|
722 | $res->setIsAnon(true);
|
---|
723 |
|
---|
724 | return $res;
|
---|
725 | }
|
---|
726 | }
|
---|
727 |
|
---|
728 | /**
|
---|
729 | * converts a ResResource, ResProperty, or ResLiteral into a Resource, Blanknode, or Literal
|
---|
730 | *
|
---|
731 | * @param object ResNode $resNode
|
---|
732 | * @return object Node
|
---|
733 | * @access private
|
---|
734 | * @throws phpErrpr
|
---|
735 | */
|
---|
736 | function _resNode2Node($resNode)
|
---|
737 | {
|
---|
738 | if (is_a($resNode,'ResResource'))
|
---|
739 | {
|
---|
740 | if ($resNode->getIsAnon())
|
---|
741 | {
|
---|
742 | $return=new BlankNode($resNode->getURI());
|
---|
743 | } else
|
---|
744 | {
|
---|
745 | $return=new Resource($resNode->getURI());
|
---|
746 | }
|
---|
747 | return $return;
|
---|
748 | }
|
---|
749 |
|
---|
750 | if (is_a($resNode,'ResLiteral'))
|
---|
751 | {
|
---|
752 | $literal=new Literal($resNode->getLabel(),$resNode->getLanguage());
|
---|
753 | if ($resNode->getDatatype() != null)
|
---|
754 | $literal->setDatatype($resNode->getDatatype());
|
---|
755 | return $literal;
|
---|
756 | }
|
---|
757 | }
|
---|
758 |
|
---|
759 | /**
|
---|
760 | * Set a base URI for the MemModel.
|
---|
761 | * Affects creating of new resources and serialization syntax.
|
---|
762 | * If the URI doesn't end with # : or /, then a # is added to the URI.
|
---|
763 | * @param string $uri
|
---|
764 | * @access public
|
---|
765 | */
|
---|
766 | function setBaseURI($uri)
|
---|
767 | {
|
---|
768 | $this->model->setBaseURI($uri);
|
---|
769 | }
|
---|
770 |
|
---|
771 | /**
|
---|
772 | * Writes the RDF serialization of the MemModel as HTML table.
|
---|
773 | *
|
---|
774 | * @access public
|
---|
775 | * @return string
|
---|
776 | */
|
---|
777 | function writeRdfToString()
|
---|
778 | {
|
---|
779 | return $this->model->writeRdfToString();
|
---|
780 | }
|
---|
781 |
|
---|
782 | /**
|
---|
783 | * Perform an RDQL query on this MemModel.
|
---|
784 | * This method returns an associative array of variable bindings.
|
---|
785 | * The values of the query variables can either be RAP's objects (instances of Node)
|
---|
786 | * if $returnNodes set to TRUE, or their string serialization.
|
---|
787 | *
|
---|
788 | * @access public
|
---|
789 | * @param string $queryString
|
---|
790 | * @param boolean $returnNodes
|
---|
791 | * @return array [][?VARNAME] = object Node (if $returnNodes = TRUE)
|
---|
792 | * OR array [][?VARNAME] = string
|
---|
793 | *
|
---|
794 | */
|
---|
795 | function & rdqlQuery($queryString, $returnNodes = TRUE)
|
---|
796 | {
|
---|
797 | $ret = $this->model->rdqlQuery($queryString, $returnNodes);
|
---|
798 | return $ret;
|
---|
799 | }
|
---|
800 |
|
---|
801 | /**
|
---|
802 | * Perform an RDQL query on this MemModel.
|
---|
803 | * This method returns an RdqlResultIterator of variable bindings.
|
---|
804 | * The values of the query variables can either be RAP's objects (instances of Node)
|
---|
805 | * if $returnNodes set to TRUE, or their string serialization.
|
---|
806 | *
|
---|
807 | * @access public
|
---|
808 | * @param string $queryString
|
---|
809 | * @param boolean $returnNodes
|
---|
810 | * @return object RdqlResultIterator = with values as object Node (if $returnNodes = TRUE)
|
---|
811 | * OR object RdqlResultIterator = with values as strings if (if $returnNodes = FALSE)
|
---|
812 | *
|
---|
813 | */
|
---|
814 | function rdqlQueryAsIterator($queryString, $returnNodes = TRUE)
|
---|
815 | {
|
---|
816 | return $this->model->rdqlQueryAsIterator($queryString, $returnNodes);
|
---|
817 | }
|
---|
818 |
|
---|
819 |
|
---|
820 | /**
|
---|
821 | * Returns the models namespaces.
|
---|
822 | *
|
---|
823 | * @author Tobias Gauß <tobias.gauss@web.de>
|
---|
824 | * @access public
|
---|
825 | * @return Array
|
---|
826 | */
|
---|
827 | function getParsedNamespaces(){
|
---|
828 | return $this->model->getParsedNamespaces();
|
---|
829 | }
|
---|
830 |
|
---|
831 |
|
---|
832 |
|
---|
833 | /**
|
---|
834 | * Adds the namespaces to the model. This method is called by
|
---|
835 | * the parser. !!!! addParsedNamespaces() not overwrites manual
|
---|
836 | * added namespaces in the model !!!!
|
---|
837 | *
|
---|
838 | * @author Tobias Gauß <tobias.gauss@web.de>
|
---|
839 | * @access public
|
---|
840 | * @param Array $newNs
|
---|
841 | */
|
---|
842 | function addParsedNamespaces($newNs){
|
---|
843 | $this->model->addParsedNamespaces($newNs);
|
---|
844 | }
|
---|
845 |
|
---|
846 |
|
---|
847 | /**
|
---|
848 | * Adds a namespace and prefix to the model.
|
---|
849 | *
|
---|
850 | * @author Tobias Gauß <tobias.gauss@web.de>
|
---|
851 | * @access public
|
---|
852 | * @param String $prefix, String $nmsp
|
---|
853 | */
|
---|
854 | function addNamespace($prefix, $namespace){
|
---|
855 | $this->model->addNamespace($prefix, $namespace);
|
---|
856 | }
|
---|
857 |
|
---|
858 | /**
|
---|
859 | * removes a single namespace from the model
|
---|
860 | *
|
---|
861 | * @author Tobias Gauß <tobias.gauss@web.de>
|
---|
862 | * @access public
|
---|
863 | * @param String $nmsp
|
---|
864 | */
|
---|
865 | function removeNamespace($nmsp){
|
---|
866 | return $this->model->removeNamespace($nmsp);
|
---|
867 | }
|
---|
868 |
|
---|
869 |
|
---|
870 |
|
---|
871 |
|
---|
872 |
|
---|
873 |
|
---|
874 | }
|
---|
875 |
|
---|
876 | ?> |
---|