pho 0.7.3 → 0.7.4

Sign up to get free protection for your applications and to get access to all the features.
Files changed (87) hide show
  1. data/CHANGES +6 -0
  2. data/README +9 -1
  3. data/Rakefile +1 -1
  4. data/doc/index.html +3 -1
  5. data/doc/rdoc/classes/Pho/Analyzers.html +310 -0
  6. data/doc/rdoc/classes/Pho/CommandLine.html +770 -0
  7. data/doc/rdoc/classes/Pho/DatatypeProperty.html +241 -0
  8. data/doc/rdoc/classes/Pho/Enrichment/StoreEnricher.html +410 -0
  9. data/doc/rdoc/classes/Pho/Enrichment.html +119 -0
  10. data/doc/rdoc/classes/Pho/Etags.html +310 -0
  11. data/doc/rdoc/classes/Pho/Facet/Results.html +299 -0
  12. data/doc/rdoc/classes/Pho/Facet/Term.html +177 -0
  13. data/doc/rdoc/classes/Pho/Facet.html +119 -0
  14. data/doc/rdoc/classes/Pho/FieldPredicateMap.html +695 -0
  15. data/doc/rdoc/classes/Pho/FieldWeighting.html +230 -0
  16. data/doc/rdoc/classes/Pho/FileManagement/AbstractFileManager.html +478 -0
  17. data/doc/rdoc/classes/Pho/FileManagement/FileManager.html +264 -0
  18. data/doc/rdoc/classes/Pho/FileManagement/RDFManager.html +259 -0
  19. data/doc/rdoc/classes/Pho/FileManagement.html +121 -0
  20. data/doc/rdoc/classes/Pho/Job.html +627 -0
  21. data/doc/rdoc/classes/Pho/JobUpdate.html +141 -0
  22. data/doc/rdoc/classes/Pho/Jobs.html +538 -0
  23. data/doc/rdoc/classes/Pho/Namespaces.html +164 -0
  24. data/doc/rdoc/classes/Pho/OAI/Record.html +165 -0
  25. data/doc/rdoc/classes/Pho/OAI/Records.html +331 -0
  26. data/doc/rdoc/classes/Pho/OAI.html +118 -0
  27. data/doc/rdoc/classes/Pho/QueryProfile.html +524 -0
  28. data/doc/rdoc/classes/Pho/RDF/Parser.html +279 -0
  29. data/doc/rdoc/classes/Pho/RDF.html +120 -0
  30. data/doc/rdoc/classes/Pho/RDFCollection.html +119 -0
  31. data/doc/rdoc/classes/Pho/ResourceHash/Converter.html +325 -0
  32. data/doc/rdoc/classes/Pho/ResourceHash/SetAlgebra.html +241 -0
  33. data/doc/rdoc/classes/Pho/ResourceHash.html +123 -0
  34. data/doc/rdoc/classes/Pho/Snapshot.html +402 -0
  35. data/doc/rdoc/classes/Pho/Sparql/SparqlClient.html +594 -0
  36. data/doc/rdoc/classes/Pho/Sparql/SparqlHelper.html +696 -0
  37. data/doc/rdoc/classes/Pho/Sparql.html +187 -0
  38. data/doc/rdoc/classes/Pho/Status.html +296 -0
  39. data/doc/rdoc/classes/Pho/Store.html +1569 -0
  40. data/doc/rdoc/classes/Pho/StoreSparqlClient.html +183 -0
  41. data/doc/rdoc/classes/Pho/Update/Changeset.html +521 -0
  42. data/doc/rdoc/classes/Pho/Update/ChangesetBuilder.html +330 -0
  43. data/doc/rdoc/classes/Pho/Update/ChangesetHelper.html +159 -0
  44. data/doc/rdoc/classes/Pho/Update/Changesets.html +205 -0
  45. data/doc/rdoc/classes/Pho/Update/LiteralStatement.html +257 -0
  46. data/doc/rdoc/classes/Pho/Update/ResourceStatement.html +237 -0
  47. data/doc/rdoc/classes/Pho/Update/Statement.html +303 -0
  48. data/doc/rdoc/classes/Pho/Update.html +128 -0
  49. data/doc/rdoc/classes/Pho.html +283 -0
  50. data/doc/rdoc/classes/String.html +146 -0
  51. data/doc/rdoc/created.rid +1 -0
  52. data/doc/rdoc/files/CHANGES.html +373 -0
  53. data/doc/rdoc/files/README.html +204 -0
  54. data/doc/rdoc/files/lib/pho/changeset_builder_rb.html +108 -0
  55. data/doc/rdoc/files/lib/pho/changeset_rb.html +108 -0
  56. data/doc/rdoc/files/lib/pho/command_line_rb.html +101 -0
  57. data/doc/rdoc/files/lib/pho/converter_rb.html +108 -0
  58. data/doc/rdoc/files/lib/pho/enrichment_rb.html +101 -0
  59. data/doc/rdoc/files/lib/pho/etags_rb.html +108 -0
  60. data/doc/rdoc/files/lib/pho/facet_rb.html +101 -0
  61. data/doc/rdoc/files/lib/pho/field_predicate_map_rb.html +101 -0
  62. data/doc/rdoc/files/lib/pho/file_management_rb.html +101 -0
  63. data/doc/rdoc/files/lib/pho/file_manager_rb.html +108 -0
  64. data/doc/rdoc/files/lib/pho/job_rb.html +101 -0
  65. data/doc/rdoc/files/lib/pho/oai_rb.html +101 -0
  66. data/doc/rdoc/files/lib/pho/query_profile_rb.html +101 -0
  67. data/doc/rdoc/files/lib/pho/rdf_collection_rb.html +101 -0
  68. data/doc/rdoc/files/lib/pho/rdf_rb.html +108 -0
  69. data/doc/rdoc/files/lib/pho/resource_hash_rb.html +101 -0
  70. data/doc/rdoc/files/lib/pho/snapshot_rb.html +109 -0
  71. data/doc/rdoc/files/lib/pho/sparql_rb.html +101 -0
  72. data/doc/rdoc/files/lib/pho/status_rb.html +101 -0
  73. data/doc/rdoc/files/lib/pho/store_rb.html +108 -0
  74. data/doc/rdoc/files/lib/pho_rb.html +133 -0
  75. data/doc/rdoc/fr_class_index.html +72 -0
  76. data/doc/rdoc/fr_file_index.html +49 -0
  77. data/doc/rdoc/fr_method_index.html +239 -0
  78. data/doc/rdoc/index.html +24 -0
  79. data/doc/rdoc/rdoc-style.css +208 -0
  80. data/lib/pho/enrichment.rb +1 -0
  81. data/lib/pho/field_predicate_map.rb +5 -0
  82. data/lib/pho/query_profile.rb +5 -0
  83. data/lib/pho/store.rb +4 -1
  84. data/tests/tc_field_predicate_map.rb +7 -1
  85. data/tests/tc_query_profile.rb +6 -0
  86. data/tests/tc_store_util.rb +7 -0
  87. metadata +134 -21
data/doc/rdoc/classes/Pho/Sparql/SparqlClient.html ADDED
@@ -0,0 +1,594 @@
1
+ <?xml version="1.0" encoding="iso-8859-1"?>
2
+ <!DOCTYPE html
3
+ PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
4
+ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
5
+
6
+ <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
7
+ <head>
8
+ <title>Class: Pho::Sparql::SparqlClient</title>
9
+ <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
10
+ <meta http-equiv="Content-Script-Type" content="text/javascript" />
11
+ <link rel="stylesheet" href="../../.././rdoc-style.css" type="text/css" media="screen" />
12
+ <script type="text/javascript">
13
+ // <![CDATA[
14
+
15
+ function popupCode( url ) {
16
+ window.open(url, "Code", "resizable=yes,scrollbars=yes,toolbar=no,status=no,height=150,width=400")
17
+ }
18
+
19
+ function toggleCode( id ) {
20
+ if ( document.getElementById )
21
+ elem = document.getElementById( id );
22
+ else if ( document.all )
23
+ elem = eval( "document.all." + id );
24
+ else
25
+ return false;
26
+
27
+ elemStyle = elem.style;
28
+
29
+ if ( elemStyle.display != "block" ) {
30
+ elemStyle.display = "block"
31
+ } else {
32
+ elemStyle.display = "none"
33
+ }
34
+
35
+ return true;
36
+ }
37
+
38
+ // Make codeblocks hidden by default
39
+ document.writeln( "<style type=\"text/css\">div.method-source-code { display: none }</style>" )
40
+
41
+ // ]]>
42
+ </script>
43
+
44
+ </head>
45
+ <body>
46
+
47
+
48
+
49
+ <div id="classHeader">
50
+ <table class="header-table">
51
+ <tr class="top-aligned-row">
52
+ <td><strong>Class</strong></td>
53
+ <td class="class-name-in-header">Pho::Sparql::SparqlClient</td>
54
+ </tr>
55
+ <tr class="top-aligned-row">
56
+ <td><strong>In:</strong></td>
57
+ <td>
58
+ <a href="../../../files/lib/pho/sparql_rb.html">
59
+ lib/pho/sparql.rb
60
+ </a>
61
+ <br />
62
+ </td>
63
+ </tr>
64
+
65
+ <tr class="top-aligned-row">
66
+ <td><strong>Parent:</strong></td>
67
+ <td>
68
+ Object
69
+ </td>
70
+ </tr>
71
+ </table>
72
+ </div>
73
+ <!-- banner header -->
74
+
75
+ <div id="bodyContent">
76
+
77
+
78
+
79
+ <div id="contextContent">
80
+
81
+ <div id="description">
82
+ <p>
83
+ A simple SPARQL client that handles the basic HTTP traffic
84
+ </p>
85
+
86
+ </div>
87
+
88
+
89
+ </div>
90
+
91
+ <div id="method-list">
92
+ <h3 class="section-bar">Methods</h3>
93
+
94
+ <div class="name-list">
95
+ <a href="#M000048">add_default_graph</a>&nbsp;&nbsp;
96
+ <a href="#M000049">add_named_graph</a>&nbsp;&nbsp;
97
+ <a href="#M000055">ask</a>&nbsp;&nbsp;
98
+ <a href="#M000054">construct</a>&nbsp;&nbsp;
99
+ <a href="#M000052">describe</a>&nbsp;&nbsp;
100
+ <a href="#M000051">describe_uri</a>&nbsp;&nbsp;
101
+ <a href="#M000053">multi_describe</a>&nbsp;&nbsp;
102
+ <a href="#M000047">new</a>&nbsp;&nbsp;
103
+ <a href="#M000050">query</a>&nbsp;&nbsp;
104
+ <a href="#M000056">select</a>&nbsp;&nbsp;
105
+ </div>
106
+ </div>
107
+
108
+ </div>
109
+
110
+
111
+ <!-- if includes -->
112
+
113
+ <div id="section">
114
+
115
+
116
+
117
+
118
+
119
+ <div id="attribute-list">
120
+ <h3 class="section-bar">Attributes</h3>
121
+
122
+ <div class="name-list">
123
+ <table>
124
+ <tr class="top-aligned-row context-row">
125
+ <td class="context-item-name">client</td>
126
+ <td class="context-item-value">&nbsp;[R]&nbsp;</td>
127
+ <td class="context-item-desc">
128
+ HTTPClient object
129
+
130
+ </td>
131
+ </tr>
132
+ <tr class="top-aligned-row context-row">
133
+ <td class="context-item-name">endpoint</td>
134
+ <td class="context-item-value">&nbsp;[R]&nbsp;</td>
135
+ <td class="context-item-desc">
136
+ URI of the endpoint
137
+
138
+ </td>
139
+ </tr>
140
+ <tr class="top-aligned-row context-row">
141
+ <td class="context-item-name">graphs</td>
142
+ <td class="context-item-value">&nbsp;[R]&nbsp;</td>
143
+ <td class="context-item-desc"></td>
144
+ </tr>
145
+ <tr class="top-aligned-row context-row">
146
+ <td class="context-item-name">named_graphs</td>
147
+ <td class="context-item-value">&nbsp;[R]&nbsp;</td>
148
+ <td class="context-item-desc"></td>
149
+ </tr>
150
+ <tr class="top-aligned-row context-row">
151
+ <td class="context-item-name">output_parameter_name</td>
152
+ <td class="context-item-value">&nbsp;[RW]&nbsp;</td>
153
+ <td class="context-item-desc">
154
+ Name of output parameter to use to control response format. If set then
155
+ this parameter is added to the <a
156
+ href="SparqlClient.html#M000050">query</a> string, rather than using
157
+ Content Negotiation
158
+
159
+ </td>
160
+ </tr>
161
+ <tr class="top-aligned-row context-row">
162
+ <td class="context-item-name">supports_rdf_json</td>
163
+ <td class="context-item-value">&nbsp;[RW]&nbsp;</td>
164
+ <td class="context-item-desc">
165
+ Configures whether the remote endpoint supports the <a
166
+ href="../RDF.html">RDF</a>-in-JSON specification for serializing <a
167
+ href="../RDF.html">RDF</a> graphs as JSON. Will default to false.
168
+
169
+ </td>
170
+ </tr>
171
+ <tr class="top-aligned-row context-row">
172
+ <td class="context-item-name">supports_sparql_json</td>
173
+ <td class="context-item-value">&nbsp;[RW]&nbsp;</td>
174
+ <td class="context-item-desc">
175
+ Configures whether the remote endpoint supports SPARQL JSON Results format
176
+ Will default to true.
177
+
178
+ </td>
179
+ </tr>
180
+ </table>
181
+ </div>
182
+ </div>
183
+
184
+
185
+
186
+ <!-- if method_list -->
187
+ <div id="methods">
188
+ <h3 class="section-bar">Public Class methods</h3>
189
+
190
+ <div id="method-M000047" class="method-detail">
191
+ <a name="M000047"></a>
192
+
193
+ <div class="method-heading">
194
+ <a href="#M000047" class="method-signature">
195
+ <span class="method-name">new</span><span class="method-args">(endpoint, client=HTTPClient.new() )</span>
196
+ </a>
197
+ </div>
198
+
199
+ <div class="method-description">
200
+ <p>
201
+ Initialize a client for a specific endpoint
202
+ </p>
203
+ <table>
204
+ <tr><td valign="top">endpoint:</td><td>uri of the SPARQL endpoint
205
+
206
+ </td></tr>
207
+ <tr><td valign="top">client:</td><td>optionally, a reference to an existing HTTPClient object instance
208
+
209
+ </td></tr>
210
+ </table>
211
+ <p><a class="source-toggle" href="#"
212
+ onclick="toggleCode('M000047-source');return false;">[Source]</a></p>
213
+ <div class="method-source-code" id="M000047-source">
214
+ <pre>
215
+ <span class="ruby-comment cmt"># File lib/pho/sparql.rb, line 121</span>
216
+ <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">initialize</span>(<span class="ruby-identifier">endpoint</span>, <span class="ruby-identifier">client</span>=<span class="ruby-constant">HTTPClient</span>.<span class="ruby-identifier">new</span>() )
217
+ <span class="ruby-ivar">@endpoint</span> = <span class="ruby-identifier">endpoint</span>
218
+ <span class="ruby-ivar">@graphs</span> = <span class="ruby-keyword kw">nil</span>
219
+ <span class="ruby-ivar">@named_graphs</span> = <span class="ruby-keyword kw">nil</span>
220
+ <span class="ruby-ivar">@client</span> = <span class="ruby-identifier">client</span>
221
+ <span class="ruby-ivar">@output_parameter_name</span> = <span class="ruby-keyword kw">nil</span>
222
+ <span class="ruby-ivar">@supports_rdf_json</span> = <span class="ruby-keyword kw">false</span>
223
+ <span class="ruby-ivar">@supports_sparql_json</span> = <span class="ruby-keyword kw">true</span>
224
+ <span class="ruby-keyword kw">end</span>
225
+ </pre>
226
+ </div>
227
+ </div>
228
+ </div>
229
+
230
+ <h3 class="section-bar">Public Instance methods</h3>
231
+
232
+ <div id="method-M000048" class="method-detail">
233
+ <a name="M000048"></a>
234
+
235
+ <div class="method-heading">
236
+ <a href="#M000048" class="method-signature">
237
+ <span class="method-name">add_default_graph</span><span class="method-args">(graph_uri)</span>
238
+ </a>
239
+ </div>
240
+
241
+ <div class="method-description">
242
+ <p>
243
+ Add a default graph. This will be added as a default graph in the request
244
+ protocol
245
+ </p>
246
+ <p><a class="source-toggle" href="#"
247
+ onclick="toggleCode('M000048-source');return false;">[Source]</a></p>
248
+ <div class="method-source-code" id="M000048-source">
249
+ <pre>
250
+ <span class="ruby-comment cmt"># File lib/pho/sparql.rb, line 132</span>
251
+ <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">add_default_graph</span>(<span class="ruby-identifier">graph_uri</span>)
252
+ <span class="ruby-keyword kw">if</span> <span class="ruby-ivar">@graphs</span> <span class="ruby-operator">==</span> <span class="ruby-keyword kw">nil</span>
253
+ <span class="ruby-ivar">@graphs</span> = []
254
+ <span class="ruby-keyword kw">end</span>
255
+ <span class="ruby-ivar">@graphs</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-identifier">graph_uri</span>
256
+ <span class="ruby-keyword kw">end</span>
257
+ </pre>
258
+ </div>
259
+ </div>
260
+ </div>
261
+
262
+ <div id="method-M000049" class="method-detail">
263
+ <a name="M000049"></a>
264
+
265
+ <div class="method-heading">
266
+ <a href="#M000049" class="method-signature">
267
+ <span class="method-name">add_named_graph</span><span class="method-args">(graph_uri)</span>
268
+ </a>
269
+ </div>
270
+
271
+ <div class="method-description">
272
+ <p>
273
+ Add a named graph. This will be added as a named graph in the request
274
+ protocol
275
+ </p>
276
+ <p><a class="source-toggle" href="#"
277
+ onclick="toggleCode('M000049-source');return false;">[Source]</a></p>
278
+ <div class="method-source-code" id="M000049-source">
279
+ <pre>
280
+ <span class="ruby-comment cmt"># File lib/pho/sparql.rb, line 140</span>
281
+ <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">add_named_graph</span>(<span class="ruby-identifier">graph_uri</span>)
282
+ <span class="ruby-keyword kw">if</span> <span class="ruby-ivar">@named_graphs</span> <span class="ruby-operator">==</span> <span class="ruby-keyword kw">nil</span>
283
+ <span class="ruby-ivar">@named_graphs</span> = []
284
+ <span class="ruby-keyword kw">end</span>
285
+ <span class="ruby-ivar">@named_graphs</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-identifier">graph_uri</span>
286
+ <span class="ruby-keyword kw">end</span>
287
+ </pre>
288
+ </div>
289
+ </div>
290
+ </div>
291
+
292
+ <div id="method-M000055" class="method-detail">
293
+ <a name="M000055"></a>
294
+
295
+ <div class="method-heading">
296
+ <a href="#M000055" class="method-signature">
297
+ <span class="method-name">ask</span><span class="method-args">(query, format=Pho::Sparql::SPARQL_RESULTS_XML)</span>
298
+ </a>
299
+ </div>
300
+
301
+ <div class="method-description">
302
+ <p>
303
+ Perform a SPARQL ASK <a href="SparqlClient.html#M000050">query</a>.
304
+ </p>
305
+ <table>
306
+ <tr><td valign="top"><a href="SparqlClient.html#M000050">query</a>:</td><td>the SPARQL <a href="SparqlClient.html#M000050">query</a>
307
+
308
+ </td></tr>
309
+ <tr><td valign="top">format:</td><td>the preferred response format
310
+
311
+ </td></tr>
312
+ </table>
313
+ <p><a class="source-toggle" href="#"
314
+ onclick="toggleCode('M000055-source');return false;">[Source]</a></p>
315
+ <div class="method-source-code" id="M000055-source">
316
+ <pre>
317
+ <span class="ruby-comment cmt"># File lib/pho/sparql.rb, line 231</span>
318
+ <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">ask</span>(<span class="ruby-identifier">query</span>, <span class="ruby-identifier">format</span>=<span class="ruby-constant">Pho</span><span class="ruby-operator">::</span><span class="ruby-constant">Sparql</span><span class="ruby-operator">::</span><span class="ruby-constant">SPARQL_RESULTS_XML</span>)
319
+ <span class="ruby-keyword kw">return</span> <span class="ruby-identifier">query</span>(<span class="ruby-identifier">query</span>, <span class="ruby-identifier">format</span>)
320
+ <span class="ruby-keyword kw">end</span>
321
+ </pre>
322
+ </div>
323
+ </div>
324
+ </div>
325
+
326
+ <div id="method-M000054" class="method-detail">
327
+ <a name="M000054"></a>
328
+
329
+ <div class="method-heading">
330
+ <a href="#M000054" class="method-signature">
331
+ <span class="method-name">construct</span><span class="method-args">(query, format=&quot;application/rdf+xml&quot;)</span>
332
+ </a>
333
+ </div>
334
+
335
+ <div class="method-description">
336
+ <p>
337
+ Perform a SPARQL CONSTRUCT <a href="SparqlClient.html#M000050">query</a>.
338
+ </p>
339
+ <table>
340
+ <tr><td valign="top"><a href="SparqlClient.html#M000050">query</a>:</td><td>the SPARQL <a href="SparqlClient.html#M000050">query</a>
341
+
342
+ </td></tr>
343
+ <tr><td valign="top">format:</td><td>the preferred response format
344
+
345
+ </td></tr>
346
+ </table>
347
+ <p><a class="source-toggle" href="#"
348
+ onclick="toggleCode('M000054-source');return false;">[Source]</a></p>
349
+ <div class="method-source-code" id="M000054-source">
350
+ <pre>
351
+ <span class="ruby-comment cmt"># File lib/pho/sparql.rb, line 223</span>
352
+ <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">construct</span>(<span class="ruby-identifier">query</span>, <span class="ruby-identifier">format</span>=<span class="ruby-value str">&quot;application/rdf+xml&quot;</span>)
353
+ <span class="ruby-keyword kw">return</span> <span class="ruby-identifier">query</span>(<span class="ruby-identifier">query</span>, <span class="ruby-identifier">format</span>)
354
+ <span class="ruby-keyword kw">end</span>
355
+ </pre>
356
+ </div>
357
+ </div>
358
+ </div>
359
+
360
+ <div id="method-M000052" class="method-detail">
361
+ <a name="M000052"></a>
362
+
363
+ <div class="method-heading">
364
+ <a href="#M000052" class="method-signature">
365
+ <span class="method-name">describe</span><span class="method-args">(query, format=&quot;application/rdf+xml&quot;)</span>
366
+ </a>
367
+ </div>
368
+
369
+ <div class="method-description">
370
+ <p>
371
+ Perform a SPARQL DESCRIBE <a href="SparqlClient.html#M000050">query</a>.
372
+ </p>
373
+ <table>
374
+ <tr><td valign="top"><a href="SparqlClient.html#M000050">query</a>:</td><td>the SPARQL <a href="SparqlClient.html#M000050">query</a>
375
+
376
+ </td></tr>
377
+ <tr><td valign="top">format:</td><td>the preferred response format
378
+
379
+ </td></tr>
380
+ </table>
381
+ <p><a class="source-toggle" href="#"
382
+ onclick="toggleCode('M000052-source');return false;">[Source]</a></p>
383
+ <div class="method-source-code" id="M000052-source">
384
+ <pre>
385
+ <span class="ruby-comment cmt"># File lib/pho/sparql.rb, line 202</span>
386
+ <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">describe</span>(<span class="ruby-identifier">query</span>, <span class="ruby-identifier">format</span>=<span class="ruby-value str">&quot;application/rdf+xml&quot;</span>)
387
+ <span class="ruby-keyword kw">return</span> <span class="ruby-identifier">query</span>(<span class="ruby-identifier">query</span>, <span class="ruby-identifier">format</span>)
388
+ <span class="ruby-keyword kw">end</span>
389
+ </pre>
390
+ </div>
391
+ </div>
392
+ </div>
393
+
394
+ <div id="method-M000051" class="method-detail">
395
+ <a name="M000051"></a>
396
+
397
+ <div class="method-heading">
398
+ <a href="#M000051" class="method-signature">
399
+ <span class="method-name">describe_uri</span><span class="method-args">(uri, format=&quot;application/rdf+xml&quot;, type=:cbd)</span>
400
+ </a>
401
+ </div>
402
+
403
+ <div class="method-description">
404
+ <p>
405
+ Describe a uri, optionally specifying a form of bounded description
406
+ </p>
407
+ <table>
408
+ <tr><td valign="top">uri:</td><td>the uri to <a href="SparqlClient.html#M000052">describe</a>
409
+
410
+ </td></tr>
411
+ <tr><td valign="top">format:</td><td>mimetype for results
412
+
413
+ </td></tr>
414
+ <tr><td valign="top">type:</td><td>symbol indicating type of description, i.e. +:cbd+, +:scbd+, +:lcbd+, or
415
+ +:slcbd+
416
+
417
+ </td></tr>
418
+ </table>
419
+ <p><a class="source-toggle" href="#"
420
+ onclick="toggleCode('M000051-source');return false;">[Source]</a></p>
421
+ <div class="method-source-code" id="M000051-source">
422
+ <pre>
423
+ <span class="ruby-comment cmt"># File lib/pho/sparql.rb, line 189</span>
424
+ <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">describe_uri</span>(<span class="ruby-identifier">uri</span>, <span class="ruby-identifier">format</span>=<span class="ruby-value str">&quot;application/rdf+xml&quot;</span>, <span class="ruby-identifier">type</span>=<span class="ruby-identifier">:cbd</span>)
425
+ <span class="ruby-identifier">template</span> = <span class="ruby-constant">Pho</span><span class="ruby-operator">::</span><span class="ruby-constant">Sparql</span><span class="ruby-operator">::</span><span class="ruby-constant">DESCRIPTIONS</span>[<span class="ruby-identifier">type</span>]
426
+ <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">template</span> <span class="ruby-operator">==</span> <span class="ruby-keyword kw">nil</span>
427
+ <span class="ruby-identifier">raise</span> <span class="ruby-value str">&quot;Unknown description type&quot;</span>
428
+ <span class="ruby-keyword kw">end</span>
429
+ <span class="ruby-identifier">query</span> = <span class="ruby-constant">Pho</span><span class="ruby-operator">::</span><span class="ruby-constant">Sparql</span><span class="ruby-operator">::</span><span class="ruby-constant">SparqlHelper</span>.<span class="ruby-identifier">apply_initial_bindings</span>(<span class="ruby-identifier">template</span>, {<span class="ruby-value str">&quot;uri&quot;</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-node">&quot;&lt;#{uri}&gt;&quot;</span>} )
430
+ <span class="ruby-keyword kw">return</span> <span class="ruby-identifier">describe</span>(<span class="ruby-identifier">query</span>, <span class="ruby-identifier">format</span>)
431
+ <span class="ruby-keyword kw">end</span>
432
+ </pre>
433
+ </div>
434
+ </div>
435
+ </div>
436
+
437
+ <div id="method-M000053" class="method-detail">
438
+ <a name="M000053"></a>
439
+
440
+ <div class="method-heading">
441
+ <a href="#M000053" class="method-signature">
442
+ <span class="method-name">multi_describe</span><span class="method-args">(uris, format=&quot;application/rdf+xml&quot;)</span>
443
+ </a>
444
+ </div>
445
+
446
+ <div class="method-description">
447
+ <p>
448
+ DESCRIBE multiple resources in a single <a
449
+ href="SparqlClient.html#M000050">query</a>. The provided array should
450
+ contain the uris that are to be described
451
+ </p>
452
+ <p>
453
+ This will generate a <a href="SparqlClient.html#M000050">query</a> like:
454
+ </p>
455
+ <pre>
456
+ DESCRIBE &lt;http://www.example.org&gt; &lt;http://www.example.com&gt; ...
457
+ </pre>
458
+ <table>
459
+ <tr><td valign="top">uris:</td><td>list of the uris to be described
460
+
461
+ </td></tr>
462
+ <tr><td valign="top">format:</td><td>the preferred response format. Default is <a href="../RDF.html">RDF</a>/XML
463
+
464
+ </td></tr>
465
+ </table>
466
+ <p><a class="source-toggle" href="#"
467
+ onclick="toggleCode('M000053-source');return false;">[Source]</a></p>
468
+ <div class="method-source-code" id="M000053-source">
469
+ <pre>
470
+ <span class="ruby-comment cmt"># File lib/pho/sparql.rb, line 214</span>
471
+ <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">multi_describe</span>(<span class="ruby-identifier">uris</span>, <span class="ruby-identifier">format</span>=<span class="ruby-value str">&quot;application/rdf+xml&quot;</span>)
472
+ <span class="ruby-identifier">query</span> = <span class="ruby-value str">&quot;DESCRIBE &quot;</span> <span class="ruby-operator">+</span> <span class="ruby-identifier">uris</span>.<span class="ruby-identifier">map</span> {<span class="ruby-operator">|</span><span class="ruby-identifier">u</span><span class="ruby-operator">|</span> <span class="ruby-node">&quot;&lt;#{u}&gt;&quot;</span> }.<span class="ruby-identifier">join</span>(<span class="ruby-value str">&quot; &quot;</span>)
473
+ <span class="ruby-keyword kw">return</span> <span class="ruby-identifier">query</span>(<span class="ruby-identifier">query</span>, <span class="ruby-identifier">format</span>)
474
+ <span class="ruby-keyword kw">end</span>
475
+ </pre>
476
+ </div>
477
+ </div>
478
+ </div>
479
+
480
+ <div id="method-M000050" class="method-detail">
481
+ <a name="M000050"></a>
482
+
483
+ <div class="method-heading">
484
+ <a href="#M000050" class="method-signature">
485
+ <span class="method-name">query</span><span class="method-args">(sparql, format=nil, graphs=nil, named_graphs=nil)</span>
486
+ </a>
487
+ </div>
488
+
489
+ <div class="method-description">
490
+ <p>
491
+ Perform a sparql <a href="SparqlClient.html#M000050">query</a>
492
+ </p>
493
+ <table>
494
+ <tr><td valign="top">sparql:</td><td>a valid SPARQL <a href="SparqlClient.html#M000050">query</a>
495
+
496
+ </td></tr>
497
+ <tr><td valign="top">format:</td><td>specific a request format. Usually a media-type, but may be a name for a
498
+ type, if not using Conneg
499
+
500
+ </td></tr>
501
+ <tr><td valign="top">graphs:</td><td>an array of default graphs
502
+
503
+ </td></tr>
504
+ <tr><td valign="top">named_graphs:</td><td>an array of named graphs
505
+
506
+ </td></tr>
507
+ </table>
508
+ <p><a class="source-toggle" href="#"
509
+ onclick="toggleCode('M000050-source');return false;">[Source]</a></p>
510
+ <div class="method-source-code" id="M000050-source">
511
+ <pre>
512
+ <span class="ruby-comment cmt"># File lib/pho/sparql.rb, line 153</span>
513
+ <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">query</span>(<span class="ruby-identifier">sparql</span>, <span class="ruby-identifier">format</span>=<span class="ruby-keyword kw">nil</span>, <span class="ruby-identifier">graphs</span>=<span class="ruby-keyword kw">nil</span>, <span class="ruby-identifier">named_graphs</span>=<span class="ruby-keyword kw">nil</span>)
514
+
515
+ <span class="ruby-identifier">params</span> = {}
516
+ <span class="ruby-identifier">params</span>[<span class="ruby-value str">&quot;query&quot;</span>] = <span class="ruby-identifier">sparql</span>
517
+
518
+ <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">graphs</span> <span class="ruby-operator">!=</span> <span class="ruby-keyword kw">nil</span>
519
+ <span class="ruby-identifier">params</span>[<span class="ruby-value str">&quot;default-graph-uri&quot;</span>] = <span class="ruby-identifier">graphs</span>
520
+ <span class="ruby-keyword kw">elsif</span> <span class="ruby-ivar">@graphs</span> <span class="ruby-operator">!=</span> <span class="ruby-keyword kw">nil</span>
521
+ <span class="ruby-identifier">params</span>[<span class="ruby-value str">&quot;default-graph-uri&quot;</span>] = <span class="ruby-ivar">@graphs</span>
522
+ <span class="ruby-keyword kw">end</span>
523
+
524
+ <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">named_graphs</span> <span class="ruby-operator">!=</span> <span class="ruby-keyword kw">nil</span>
525
+ <span class="ruby-identifier">params</span>[<span class="ruby-value str">&quot;named-graph-uri&quot;</span>] = <span class="ruby-identifier">named_graphs</span>
526
+ <span class="ruby-keyword kw">elsif</span> <span class="ruby-ivar">@named_graphs</span> <span class="ruby-operator">!=</span> <span class="ruby-keyword kw">nil</span>
527
+ <span class="ruby-identifier">params</span>[<span class="ruby-value str">&quot;named-graph-uri&quot;</span>] = <span class="ruby-ivar">@named_graphs</span>
528
+ <span class="ruby-keyword kw">end</span>
529
+
530
+ <span class="ruby-identifier">headers</span> = {}
531
+ <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">format</span> <span class="ruby-operator">!=</span> <span class="ruby-keyword kw">nil</span>
532
+
533
+ <span class="ruby-keyword kw">if</span> <span class="ruby-ivar">@output_parameter_name</span> <span class="ruby-operator">!=</span> <span class="ruby-keyword kw">nil</span>
534
+ <span class="ruby-identifier">params</span>[<span class="ruby-ivar">@output_parameter_name</span>] = <span class="ruby-identifier">format</span>
535
+ <span class="ruby-keyword kw">else</span>
536
+ <span class="ruby-identifier">headers</span>[<span class="ruby-value str">&quot;Accept&quot;</span>] = <span class="ruby-identifier">format</span>
537
+ <span class="ruby-keyword kw">end</span>
538
+
539
+ <span class="ruby-keyword kw">end</span>
540
+
541
+ <span class="ruby-keyword kw">return</span> <span class="ruby-ivar">@client</span>.<span class="ruby-identifier">get</span>( <span class="ruby-ivar">@endpoint</span>, <span class="ruby-identifier">params</span>, <span class="ruby-identifier">headers</span> )
542
+ <span class="ruby-keyword kw">end</span>
543
+ </pre>
544
+ </div>
545
+ </div>
546
+ </div>
547
+
548
+ <div id="method-M000056" class="method-detail">
549
+ <a name="M000056"></a>
550
+
551
+ <div class="method-heading">
552
+ <a href="#M000056" class="method-signature">
553
+ <span class="method-name">select</span><span class="method-args">(query, format=Pho::Sparql::SPARQL_RESULTS_XML)</span>
554
+ </a>
555
+ </div>
556
+
557
+ <div class="method-description">
558
+ <p>
559
+ Perform a SPARQL SELECT <a href="SparqlClient.html#M000050">query</a>.
560
+ </p>
561
+ <table>
562
+ <tr><td valign="top"><a href="SparqlClient.html#M000050">query</a>:</td><td>the SPARQL <a href="SparqlClient.html#M000050">query</a>
563
+
564
+ </td></tr>
565
+ <tr><td valign="top">format:</td><td>the preferred response format
566
+
567
+ </td></tr>
568
+ </table>
569
+ <p><a class="source-toggle" href="#"
570
+ onclick="toggleCode('M000056-source');return false;">[Source]</a></p>
571
+ <div class="method-source-code" id="M000056-source">
572
+ <pre>
573
+ <span class="ruby-comment cmt"># File lib/pho/sparql.rb, line 239</span>
574
+ <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">select</span>(<span class="ruby-identifier">query</span>, <span class="ruby-identifier">format</span>=<span class="ruby-constant">Pho</span><span class="ruby-operator">::</span><span class="ruby-constant">Sparql</span><span class="ruby-operator">::</span><span class="ruby-constant">SPARQL_RESULTS_XML</span>)
575
+ <span class="ruby-keyword kw">return</span> <span class="ruby-identifier">query</span>(<span class="ruby-identifier">query</span>, <span class="ruby-identifier">format</span>)
576
+ <span class="ruby-keyword kw">end</span>
577
+ </pre>
578
+ </div>
579
+ </div>
580
+ </div>
581
+
582
+
583
+ </div>
584
+
585
+
586
+ </div>
587
+
588
+
589
+ <div id="validator-badges">
590
+ <p><small><a href="http://validator.w3.org/check/referer">[Validate]</a></small></p>
591
+ </div>
592
+
593
+ </body>
594
+ </html>