~ubuntu-branches/debian/sid/redland-bindings/sid : revision 14

1

<?xml version="1.0" encoding="utf-8"?>

2

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"

3

"http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">

4

5

<head>

6

<title>Redland RDF Application Framework - Ruby RDoc - Class: Redland::Parser</title>

7

8

9

// <![CDATA[

10

11

function popupCode( url ) {

12

window.open(url, "Code", "resizable=yes,scrollbars=yes,toolbar=no,status=no,height=150,width=400")

13

}

14

15

function toggleCode( id ) {

16

if ( document.getElementById )

17

elem = document.getElementById( id );

18

else if ( document.all )

19

elem = eval( "document.all." + id );

20

else

21

return false;

22

23

elemStyle = elem.style;

24

25

if ( elemStyle.display != "block" ) {

26

elemStyle.display = "block"

27

} else {

28

elemStyle.display = "none"

29

}

30

31

return true;

32

}

33

34

// Make codeblocks hidden by default

35

document.writeln( "<style type=\"text/css\">div.method-source-code { display: none }<\/style>" )

36

37

// ]]>

38

</script>

39

</head>

40

<body>

41

42

43

44

Go to <a href="/" target="_parent">Redland Home</a> -

45

<a href="/bindings/" target="_parent">Language Bindings Home</a> -

46

47

</div>

48

49

50

51

52

<td>Class</td>

53

<td class="class-name-in-header">Redland::Parser</td>

54

</tr>

55

56

57

<td><a href="../../files/rdf/redland/parser_rb.html">rdf/redland/parser.rb</a> </td>

58

</tr>

59

60

<td>Parent:</td>

61

<td>Object</td>

62

</tr>

63

</table>

64

</div>

65

66

67

68

69

The <a href="Parser.html">Parser</a> class for rdf. There are currently three types of parsers *’rdfxml’- a rdf parser *’<a href="Parser.html#M000021">ntriples</a>’ a An triples parser *’<a href="Parser.html#M000022">turtle</a>’ - a parser for the <a href="Parser.html#M000022">turtle</a> syntax as defined in

70

<pre>

71

http://www.dajobe.org/2004/01/turtle/

72

</pre>

73

*’rss-tag-soup’ - a parser for all RSS flavours and some atom *’grddl’ - GRDDL

74

The last two may or may not be available depending on systems.

75

<pre>

76

model = Model.new()

77

parser = Parser.ntriples()

78

parser.parse_into_model(model,'file:./ical.rdf')

79

</pre></div>

80

</div>

81

82

<h3 class="section-bar">Methods</h3>

83

<div class="name-list"><a href="#M000030">add_ident</a>   <a href="#M000020">create_finalizer</a>   <a href="#M000028">feature</a>   <a href="#M000019">new</a>   <a href="#M000021">ntriples</a>   <a href="#M000024">parse_as_stream</a>   <a href="#M000025">parse_into_model</a>   <a href="#M000026">parse_string_as_stream</a>   <a href="#M000027">parse_string_into_model</a>   <a href="#M000023">raptor</a>   <a href="#M000029">setFeature</a>   <a href="#M000032">smush_file</a>   <a href="#M000031">smush_string</a>   <a href="#M000022">turtle</a>  </div>

84

</div>

85

</div>

86

87

88

89

<h3 class="section-bar">Attributes</h3>

90

91

<table>

92

93

<td class="context-item-name">context</td>

94

95

96

</tr>

97

</table>

98

</div>

99

</div>

100

101

102

<h3 class="section-bar">Public Class methods</h3>

103

104

<div class="method-heading"><a href="#M000020" class="method-signature">create_finalizer(parser)</a></div>

105

106

<a class="source-toggle" href="#" onclick="toggleCode('M000020-source');return false;">[Source]</a>

107

108

<pre>

109

# File rdf/redland/parser.rb, line 34

110

def Parser.create_finalizer(parser)

111

proc {|id| "Finalizer on #{id}"

112

#$log_final.info "closing parser"

113

Redland::librdf_free_parser(parser)

114

}

115

end

116

</pre></div>

117

</div>

118

</div>

119

120

<div class="method-heading"><a href="#M000019" class="method-signature">new(name='rdfxml',mime_type="application/rdf+xml",uri=nil,context=nil)</a></div>

121

122

create a <a href="Parser.html#M000019">new</a> <a href="Parser.html">Parser</a>. if no name is given, it defaults to parsing RDF/XML syntax

123

<a class="source-toggle" href="#" onclick="toggleCode('M000019-source');return false;">[Source]</a>

124

125

<pre>

126

# File rdf/redland/parser.rb, line 25

127

def initialize(name='rdfxml',mime_type="application/rdf+xml",uri=nil,context=nil)

128

@context = nil

129

@idents = []

130

uri=uri.uri if uri

131

@parser = Redland.librdf_new_parser($world.world,name,mime_type,uri)

132

raise RedlandError.new("Parser construction failed") if !@parser

133

ObjectSpace.define_finalizer(self,Parser.create_finalizer(@parser))

134

end

135

</pre></div>

136

</div>

137

</div>

138

139

<div class="method-heading"><a href="#M000021" class="method-signature">ntriples(uri=nil)</a></div>

140

141

create a parser for the <a href="Parser.html#M000021">ntriples</a> syntax

142

<a class="source-toggle" href="#" onclick="toggleCode('M000021-source');return false;">[Source]</a>

143

144

<pre>

145

# File rdf/redland/parser.rb, line 42

146

def Parser.ntriples(uri=nil)

147

return Parser.new('ntriples',"",uri)

148

end

149

</pre></div>

150

</div>

151

</div>

152

153

<div class="method-heading"><a href="#M000023" class="method-signature">raptor(uri=nil)</a></div>

154

155

create a parser for rdf syntax

156

<a class="source-toggle" href="#" onclick="toggleCode('M000023-source');return false;">[Source]</a>

157

158

<pre>

159

# File rdf/redland/parser.rb, line 52

160

def Parser.raptor(uri=nil)

161

return Parser.new('rdfxml','application/rdf+xml',uri)

162

end

163

</pre></div>

164

</div>

165

</div>

166

167

<div class="method-heading"><a href="#M000022" class="method-signature">turtle(uri=nil)</a></div>

168

169

create a parser for the <a href="Parser.html#M000022">turtle</a> syntax

170

<a class="source-toggle" href="#" onclick="toggleCode('M000022-source');return false;">[Source]</a>

171

172

<pre>

173

# File rdf/redland/parser.rb, line 47

174

def Parser.turtle(uri=nil)

175

return Parser.new('turtle',"",uri)

176

end

177

</pre></div>

178

</div>

179

</div>

180

<h3 class="section-bar">Public Instance methods</h3>

181

182

<div class="method-heading"><a href="#M000030" class="method-signature">add_ident(node)</a></div>

183

184

<a class="source-toggle" href="#" onclick="toggleCode('M000030-source');return false;">[Source]</a>

185

186

<pre>

187

# File rdf/redland/parser.rb, line 165

188

def add_ident(node)

189

@idents << node

190

end

191

</pre></div>

192

</div>

193

</div>

194

195

<div class="method-heading"><a href="#M000028" class="method-signature">feature(uri)</a></div>

196

197

Get a parser <a href="Parser.html#M000028">feature</a>. The <a href="Parser.html#M000028">feature</a> is a <a href="Uri.html">Uri</a>

198

<a class="source-toggle" href="#" onclick="toggleCode('M000028-source');return false;">[Source]</a>

199

200

<pre>

201

# File rdf/redland/parser.rb, line 147

202

def feature(uri)

203

if uri.class == String then uri = Uri.new(uri) end

204

value = Redland::librdf_parser_get_feature(@parser,uri.uri)

205

if value == "NULL" or value == nil

206

return nil

207

else

208

return Node.new(:from_object=>value)

209

end

210

end

211

</pre></div>

212

</div>

213

</div>

214

215

<div class="method-heading"><a href="#M000024" class="method-signature">parse_as_stream(uri,base_uri=nil) {|stream.current| ...}</a></div>

216

217

Parse the given uri with optional base_uri and return a <a href="Stream.html">Stream</a>. If block_given, yield the <a href="Statement.html">Statement</a> instead Returns nil on failure.

218

<a class="source-toggle" href="#" onclick="toggleCode('M000024-source');return false;">[Source]</a>

219

220

<pre>

221

# File rdf/redland/parser.rb, line 59

222

def parse_as_stream(uri,base_uri=nil)

223

if uri.class == String then uri = Uri.new(uri) end

224

if base_uri.class == String then base_uri = Uri.new(base_uri) end

225

unless base_uri

226

my_stream = Redland::librdf_parser_parse_as_stream @parser, uri.uri, nil

227

else

228

my_stream = Redland::librdf_parser_parse_as_stream @parser, uri.uri ,base_uri.uri

229

end

230

return nil if !my_stream

231

stream = Stream.new(my_stream,self)

232

if !block_given?

233

return stream

234

else

235

while not stream.end?

236

yield stream.current

237

stream.next

238

end

239

end

240

end

241

</pre></div>

242

</div>

243

</div>

244

245

<div class="method-heading"><a href="#M000025" class="method-signature">parse_into_model(model,uri,base_uri=nil,context=@context)</a></div>

246

247

Parse the syntax at the uri <a href="Uri.html">Uri</a> with optional base <a href="Uri.html">Uri</a> base_uri into <a href="Model.html">Model</a> model. If the base_uri is given then the content is parsed as if it was at the base_uri rather than the uri. If the optional context is given, the statement is added to the context

248

NOTE: The order of the arguments to this method is different from the C API and other language bindings.

249

<a class="source-toggle" href="#" onclick="toggleCode('M000025-source');return false;">[Source]</a>

250

251

<pre>

252

# File rdf/redland/parser.rb, line 85

253

def parse_into_model(model,uri,base_uri=nil,context=@context)

254

#puts "parse_into_model context is #{context}"

255

if uri.class == String

256

uri = Uri.new(uri)

257

end

258

if base_uri

259

if base_uri.class == String

260

base_uri = Uri.new(base_uri)

261

end

262

else

263

base_uri=uri

264

end

265

if not context

266

begin

267

r = Redland.librdf_parser_parse_into_model(@parser,uri.uri,base_uri.uri,model.model)

268

rescue RedlandError => err

269

print "caught error"+ err

270

end

271

else #context

272

raise RedlandError.new("Cannot make a Node from an object of #{context.class}") if not context

273

context = Node.ensure(context)

274

my_stream = Redland::librdf_parser_parse_as_stream(@parser,uri.uri,base_uri.uri)

275

Redland.librdf_model_context_add_statements(model.model,context,my_stream)

276

#self.parse_as_stream(uri,base_uri){|s| model.add_statement(s,context)}

277

end

278

279

end

280

</pre></div>

281

</div>

282

</div>

283

284

<div class="method-heading"><a href="#M000026" class="method-signature">parse_string_as_stream(string,base_uri) {|stream.current| ...}</a></div>

285

286

Parse the syntax in string with required base <a href="Uri.html">Uri</a> base_uri

287

Returns a <a href="Stream.html">Stream</a> or yields <a href="Statement.html">Statement</a> if block given. Returns nil on failure.

288

<a class="source-toggle" href="#" onclick="toggleCode('M000026-source');return false;">[Source]</a>

289

290

<pre>

291

# File rdf/redland/parser.rb, line 118

292

def parse_string_as_stream(string,base_uri)

293

if base_uri.class == String then base_uri = Uri.new(base_uri) end

294

if not base_uri then raise RedlandError("A base URI is required when parsing a string") end

295

my_stream = Redland::librdf_parser_parse_string_as_stream(@parser,string,base_uri.uri)

296

return nil if !my_stream

297

stream = Stream.new(my_stream,self)

298

return stream if !block_given?

299

while not stream.end?

300

yield stream.current

301

stream.next

302

end

303

end

304

</pre></div>

305

</div>

306

</div>

307

308

<div class="method-heading"><a href="#M000027" class="method-signature">parse_string_into_model(model,string,base_uri=nil,context=@context)</a></div>

309

310

Parse the syntax in String string with required <a href="Uri.html">Uri</a> base_uri into <a href="Model.html">Model</a> model. if context is given then the context information is stored as well

311

NOTE: The order of the arguments to this method is different from the C API and other language bindings.

312

<a class="source-toggle" href="#" onclick="toggleCode('M000027-source');return false;">[Source]</a>

313

314

<pre>

315

# File rdf/redland/parser.rb, line 136

316

def parse_string_into_model(model,string,base_uri=nil,context=@context)

317

if base_uri.class == String then base_uri = Uri.new(base_uri)end

318

if not base_uri then raise RedlandError.new("A base URI is required when parsing a string") end

319

if not context

320

return (Redland::librdf_parser_parse_string_into_model(@parser,string,base_uri.uri,model.model)== 0)

321

else

322

self.parse_string_as_stream(@parser,string,base_uri.uri){|s| model.add_statement(s,context)}

323

end

324

end

325

</pre></div>

326

</div>

327

</div>

328

329

<div class="method-heading"><a href="#M000029" class="method-signature">setFeature(uri,value)</a></div>

330

331

Set a parser <a href="Parser.html#M000028">feature</a>. The <a href="Parser.html#M000028">feature</a> is named <a href="Uri.html">Uri</a> uri and the value is a <a href="Node.html">Node</a>.

332

<a class="source-toggle" href="#" onclick="toggleCode('M000029-source');return false;">[Source]</a>

333

334

<pre>

335

# File rdf/redland/parser.rb, line 159

336

def setFeature(uri,value)

337

if uri.class == String then uri = Uri.new(uri) end

338

if value.class == String then value = Node.new(:literal=>value) end

339

return (Redland::librdf_parser_set_feature(@parser,uri.uri,value.node) == 0)

340

end

341

</pre></div>

342

</div>

343

</div>

344

345

<div class="method-heading"><a href="#M000032" class="method-signature">smush_file(model,uri,base_uri=nil,context=nil,idents=@idents)</a></div>

346

347

<a class="source-toggle" href="#" onclick="toggleCode('M000032-source');return false;">[Source]</a>

348

349

<pre>

350

# File rdf/redland/parser.rb, line 190

351

def smush_file(model,uri,base_uri=nil,context=nil,idents=@idents)

352

to_change = {}

353

temp_model = Model.new()

354

self.parse_into_model(temp_model,uri,base_uri,context)

355

idents.each do |ident|

356

temp_model.find(nil,ident,nil){|s,p,o|

357

old_id = s

358

new_id = model.subject(p,o)

359

if new_id

360

to_change[old_id.to_s]= new_id if !to_change.key?(old_id.to_s)

361

end

362

}

363

end

364

#puts to_change

365

temp_model.triples do |s,p,o|

366

s = to_change[s.to_s] if to_change.key?(s.to_s)

367

model.add(s,p,o,context)

368

end

369

370

end

371

</pre></div>

372

</div>

373

</div>

374

375

<div class="method-heading"><a href="#M000031" class="method-signature">smush_string(string,model,idents=@idents)</a></div>

376

377

<a class="source-toggle" href="#" onclick="toggleCode('M000031-source');return false;">[Source]</a>

378

379

<pre>

380

# File rdf/redland/parser.rb, line 169

381

def smush_string(string,model,idents=@idents)

382

to_change = {}

383

temp_model = Model.new()

384

self.parse_string_into_model(temp_model,string,'http://xml.com')

385

idents.each do |ident|

386

temp_model.find(nil,ident,nil){|s,p,o|

387

old_id = s

388

new_id = model.subject(p,o)

389

if new_id

390

to_change[old_id.to_s]= new_id if !to_change.key?(old_id.to_s)

391

end

392

}

393

end

394

#puts to_change

395

temp_model.triples do |s,p,o|

396

s = to_change[s.to_s] if to_change.key?(s.to_s)

397

model.add(s,p,o)

398

end

399

400

end

401

</pre></div>

402

</div>

403

</div>

404

</div>

405

</div>

406

<hr />

407

408

409

Go to <a href="/" target="_parent">Redland Home</a> -

410

<a href="/bindings/" target="_parent">Language Bindings Home</a> -

411

412

</div>

413

414

(C) Copyright 2004-2011 <a href="http://www.dajobe.org/" target="_parent">Dave Beckett</a>, (C) Copyright 2004-2005 <a href="http://www.bristol.ac.uk/" target="_parent">University of Bristol</a>

415

416

</div>

417

418

</body>

419

</html>