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
|
<?php
/*
* (c) Markus Lanthaler <mail@markus-lanthaler.com>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace ML\JsonLD;
use ML\IRI\IRI;
/**
* JSON-LD document interface
*
* @author Markus Lanthaler <mail@markus-lanthaler.com>
*/
interface DocumentInterface
{
/**
* Set the document's IRI
*
* @param string|IRI The IRI.
*
* @return self
*/
public function setIri($iri);
/**
* Get the document's IRI
*
* @param boolean $asObject If set to true, the return value will be an
* {@link IRI} object; otherwise a string.
*
* @return string|IRI The document's IRI (might be empty).
*/
public function getIri($asObject = false);
/**
* Creates a new graph which is linked to this document
*
* If there exists already a graph with the passed name in the document,
* that graph will be returned instead of creating a new one.
*
* @param string|IRI $name The graph's name.
*
* @return GraphInterface The newly created graph.
*/
public function createGraph($name);
/**
* Get a graph by name
*
* @param null|string $name The name of the graph to retrieve. If null
* is passed, the default will be returned.
*
* @return GraphInterface|null Returns the graph if found; null otherwise.
*/
public function getGraph($name = null);
/**
* Get graph names
*
* @return string[] Returns the names of all graphs in the document.
*/
public function getGraphNames();
/**
* Check whether the document contains a graph with the specified name
*
* @param string $name The graph name.
*
* @return bool Returns true if the document contains a graph with the
* specified name; false otherwise.
*/
public function containsGraph($name);
/**
* Removes a graph from the document
*
* @param null|string|GraphInterface $graph The graph (or its name) to
* remove. If null is passed,
* the default will be reset.
*
* @return self
*/
public function removeGraph($graph = null);
}
|
