ModelCon


1   /*
2    *  (c) Copyright 2000, 2001, 2002, 2002, 2003, 2004, 2005 Hewlett-Packard Development Company, LP
3    *  All rights reserved.
4    *
5    * Redistribution and use in source and binary forms, with or without
6    * modification, are permitted provided that the following conditions
7    * are met:
8    * 1. Redistributions of source code must retain the above copyright
9    *    notice, this list of conditions and the following disclaimer.
10   * 2. Redistributions in binary form must reproduce the above copyright
11   *    notice, this list of conditions and the following disclaimer in the
12   *    documentation and/or other materials provided with the distribution.
13   * 3. The name of the author may not be used to endorse or promote products
14   *    derived from this software without specific prior written permission.
15  
16   * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
17   * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
18   * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
19   * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
20   * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
21   * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
22   * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
23   * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
24   * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
25   * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
26   *
27   * ModelCon.java
28   *
29   * Created on 7 December 2001, 11:00
30   */
31  
32  package com.hp.hpl.jena.rdf.model;
33  
34  import java.util.Calendar  ;
35  
36  import com.hp.hpl.jena.graph.Node;
37  
38  
39  /** Convenience methods which extend the {@link Model} interface.
40   * <P>The {@link Model} interface provides a set of primitive operations on
41   *    an RDF model.  This interface extends those methods with a 
42   *    set of convenience methods.</P>
43   * <p>This interface provides methods supporting typed literals.  This means
44   *    that methods are provided which will translate a built in type, or an
45   *    object to an RDF Literal.  This translation is done by invoking the
46   *    <CODE>toString()</CODE> method of the object, or its built in equivalent.
47   *    The reverse translation is also supported.  This is built in for built
48   *    in types.  Factory objects, provided by the application, are used
49   *    for application objects.</p>
50   * <p>This interface provides methods for supporting enhanced resources.  An
51   *    enhanced resource is a resource to which the application has added
52   *    behaviour.  RDF containers are examples of enhanced resources built in
53   *    to this package.  Enhanced resources are supported by encapsulating a
54   *    resource created by an implementation in another class which adds
55   *    the extra behaviour.  Factory objects are used to construct such
56   *    enhanced resources.</p>
57   * @author bwm
58   * @version Release='$Name:  $'
59              Revision='$Revision: 1.15 $'
60              Date='$Date: 2005/02/21 12:14:07 $'
61   */
62  public interface ModelCon {
63  
64  /** Return a Resource instance in this model.
65   *
66   * <p>Subsequent operations on the returned object may modify this model.</p>
67   * <p>The resource is assumed to already exist in the model.  If it does not,
68   * <CODE>createResource</CODE> should be used instead.</p>
69   * @return a resource instance created by the factory provided
70   * @param uri the URI of the resource
71   * @param f the factory object
72    
73   */    
74      Resource getResource(String   uri, ResourceF f) ;
75  
76  /** Return a Property instance in this model.
77   *
78   * <p>Subsequent operations on the returned property may modify this model.</p>
79   * <p>The property is assumed to already exist in the model.  If it does not,
80   * <CODE>createProperty</CODE> should be used instead.</p>
81   * @return a property object
82   * @param uri the URI of the property
83    
84  */
85      Property getProperty(String   uri) ;
86  
87  /** Return a Bag instance in this model.
88   *
89   * <p>Subsequent operations on the returned bag may modify this model.</p>
90   * <p>The bag is assumed to already exist in the model.  If it does not,
91   * <CODE>createBag</CODE> should be used instead.</p>
92   * @return a bag instance
93   * @param uri the URI of the bag.
94   
95   */ 
96      Bag getBag(String   uri) ;
97  
98  /** Return a bag instance based on a given resource.
99   *
100  * <p> This method enables an application to treat any resource as a bag.
101  *     It is in effect an unsafe downcast.</p>
102  *
103  * <p>Subsequent operations on the returned bag may modify this model.</p>
104  * <p>The bag is assumed to already exist in the model.  If it does not,
105  * <CODE>createBag</CODE> should be used instead.</p>
106  * @return a bag instance
107  * @param r an untyped Resource instance 
108  
109  */ 
110     Bag getBag(Resource r) ;
111 
112 /** Return an Alt instance in this model.
113  *
114  * <p>Subsequent operations on the returned object may modify this model.</p>
115  * <p>The alt is assumed to already exist in the model.  If it does not,
116  * <CODE>createAlt</CODE> should be used instead.</p>
117  * @return an alt instance
118  * @param uri the URI of the alt
119  
120  */ 
121     Alt getAlt(String   uri) ;
122 
123 /** Return an Alt instance based on a given resource.
124  *
125  * <p> This method enables an application to treat any resource as an Alt.
126  *     It is in effect an unsafe downcast.</p>
127  *
128  * <p>Subsequent operations on the returned Alt may modify this model.</p>
129  * <p>The bag is assumed to already exist in the model.  If it does not,
130  * <CODE>createAlt</CODE> should be used instead.</p>
131  * @return an Alt instance
132  * @param r an untyped Resource instance
133  
134  */ 
135     Alt getAlt(Resource r) ;
136 /** Return a Seq instance in this model.
137  *
138  * <p>Subsequent operations on the returned bag may modify this model.</p>
139  * <p>The seq is assumed to already exist in the model.  If it does not,
140  * <CODE>createSeq</CODE> should be used instead.</p>
141  * @return a seq instance
142  * @param uri the URI of the seq
143  
144  */ 
145     Seq getSeq(String   uri) ;
146 
147 /** Return a Seq instance based on a given resource.
148  *
149  * <p> This method enables an application to treat any resource as a Seq.
150  *     It is in effect an unsafe downcast.</p>
151  *
152  * <p>Subsequent operations on the returned Seq may modify this model.</p>
153  * <p>The Seq is assumed to already exist in the model.  If it does not,
154  * <CODE>createAlt</CODE> should be used instead.</p>
155  * @return an Alt instance
156  * @param r an untyped Resource instance
157  
158  */ 
159     Seq getSeq(Resource r) ;
160 
161 /** Create a new anonymous resource with a given type.
162  *
163  * <p> Subsequent operations on the returned resource may modify this model.
164  * </p>
165  * <p> The resource is created and an rdf:type property added to the model
166  * to specify its type. </p>
167  * @param type the type of the resource to be created.
168  * @return a new anonymous resource linked to this model.
169   */
170     public Resource createResource(Resource type) ;
171     
172 /**
173     Create or find an RDFNode 
174     (a {@link Resource} or a {@link Literal})
175     from a graph Node. This is provided for users and
176     developers operating at the API/SPI interface, where Resources are
177     constructed from Nodes. Providing this method allows each Model
178     the opportunity to cache node-to-resource maps if it requires. 
179     
180     @param n the graph.Node on which to base the Model.RDFNode
181     @return a suitable RDFNode 
182 */
183     public RDFNode getRDFNode( Node n );
184 
185 /** Create a new resource with a given type.
186  *
187  * <p> Subsequent operations on the returned resource may modify this model.
188  * </p>
189  * <p> The resource is created and an rdf:type property added to the model
190  * to specify its type. </p>
191  * @param type the type of the resource to be created.
192  * @return a new resource linked to this model.
193  * @param uri The URI of the new resource.
194   */
195     public Resource createResource(String   uri, Resource type);
196 
197 /** Create a new anonymous resource using the supplied factory.
198  *
199  * <p> Subsequent operations on the returned resource may modify this model.
200  * </p>
201  * @return a new anonymous resource linked to this model.
202  * @param f A factory object to create the returned object.
203  .
204  */
205     public Resource createResource(ResourceF f) ;
206  
207 /** Create a new resource using the supplied factory.
208  *
209  * <p> Subsequent operations on the returned resource may modify this model.
210  * </p>
211  * @return a new resource linked to this model.
212  * @param uri the URI of the resource
213  * @param f A factory to create the returned object.
214  .
215  */   
216     public Resource createResource(String   uri, ResourceF f) ;
217 
218 /** Create a property.
219  *
220  * <p> Subsequent operations on the returned property may modify this model.
221  * </p>
222  * @param uri the URI of the property
223  
224  * @return a property instance
225  */
226     public Property createProperty(String   uri) ;
227 
228     /** create a literal from a boolean value.
229      *
230      * <p> The value is converted to a string using its <CODE>toString</CODE>
231      * method. </p>
232      * @param v the value of the literal
233      * @return a new literal representing the value v
234      */
235     public Literal createLiteral(boolean v) ; 
236     /** create a literal from an integer value.
237      *
238      * @param v the value of the literal
239      * @return a new literal representing the value v
240      */   
241     public Literal createLiteral(long v) ;
242     /** create a literal from a char value.
243      *
244      * @param v the value of the literal
245      * @return a new literal representing the value v
246      */
247     public Literal createLiteral(char v) ;
248     /** create a literal from a float value.
249      *
250      * @param v the value of the literal
251      * @return a new literal representing the value v
252      */
253     public Literal createLiteral(float v) ;
254     /** create a literal from a double value.
255      *
256      * @param v the value of the literal
257      * @return a new literal representing the value v
258      */
259     public Literal createLiteral(double v) ;
260     
261     /** create a literal from a String value.
262      *
263      * @param v the value of the literal
264      * @return a new literal representing the value v
265      */
266     public Literal createLiteral(String   v) ;
267     
268     /** create a literal from an Object.
269      *
270      * @return a new literal representing the value v
271      * @param v the value of the literal.
272       
273      */
274     public Literal createLiteral(Object   v) ;
275  
276     /** create a type literal from a boolean value.
277      *
278      * <p> The value is converted to a string using its <CODE>toString</CODE>
279      * method. </p>
280      * @param v the value of the literal
281      * @return a new literal representing the value v
282      */
283     public Literal createTypedLiteral(boolean v) ; 
284     
285     /** create a typed literal from an integer value.
286      *
287      * @param v the value of the literal
288      * @return a new literal representing the value v
289      */   
290     public Literal createTypedLiteral(int v) ;
291     
292     /** create a typed literal from an integer value.
293      *
294      * @param v the value of the literal
295      * @return a new literal representing the value v
296      */   
297     public Literal createTypedLiteral(long v) ;
298 
299     /**
300      * Create a typed literal of type xsd:dateTime from a Calendar object. 
301      */
302     public Literal createTypedLiteral(Calendar   d);
303     
304     /** create a typed literal from a char value.
305      *
306      * @param v the value of the literal
307      * @return a new literal representing the value v
308      */
309     public Literal createTypedLiteral(char v) ;
310     
311     /** create a typed literal from a float value.
312      *
313      * @param v the value of the literal
314      * @return a new literal representing the value v
315      */
316     public Literal createTypedLiteral(float v) ;
317     
318     /** create a typed literal from a double value.
319      *
320      * @param v the value of the literal
321      * @return a new literal representing the value v
322      */
323     public Literal createTypedLiteral(double v) ;
324     
325     /** create a typed literal from a String value.
326      *
327      * @param v the value of the literal
328      * @return a new literal representing the value v
329      */
330     public Literal createTypedLiteral(String   v) ;
331     
332     /** create a literal from an Object.
333      *
334      * @return a new literal representing the value v
335      * @param v the value of the literal.
336      */
337     public Literal createTypedLiteral(Object   v) ;
338 
339     /**
340      * Build a typed literal from its lexical form. The
341      * lexical form will be parsed now and the value stored. If
342      * the form is not legal this will throw an exception.
343      * <p>
344      * Note that in preview releases of Jena2 it was also possible to specify
345      *   a language type. Changes to the RDF specification mean that this is no longer
346      *   legal except for plain literals. To create a plain literal with a language tag
347      *   use {@link Model#createLiteral(String, String) createLiteral}. 
348      * </p> 
349      * 
350      * @param lex the lexical form of the literal
351      * @param typeURI the uri of the type of the literal, null for old style "plain" literals
352      * @throws DatatypeFormatException if lex is not a legal form of dtype
353      */
354     public Literal createTypedLiteral(String   lex, String   typeURI)  ;
355     
356     /**
357      * Build a typed literal from its value form.
358      * <p>
359      * Note that in preview releases of Jena2 it was also possible to specify
360      *   a language type. Changes to the RDF specification mean that this is no longer
361      *   legal except for plain literals. To create a plain literal with a language tag
362      *   use {@link Model#createLiteral(String, String) createLiteral}. 
363      * </p> 
364      * 
365      * @param value the value of the literal
366      * @param typeURI the URI of the type of the literal, null for old style "plain" literals
367      */
368     public Literal createTypedLiteral(Object   value, String   typeURI);
369     
370     /** Create a Statement instance.
371      *
372      * <p>Subsequent operations on the statement or any of its parts may
373      * modify this model.</p>
374      * <p>Creating a statement does not add it to the set of statements in the
375      * model. </p>
376      * <p>The value o will be converted to a Literal.</P>
377      * @param s the subject of the statement
378      * @param p the predicate of the statement
379      * @param o is the value to be the object of the statement
380      
381      * @return the new statement
382      */
383     public Statement createStatement(Resource s, Property p, boolean o)  ;
384     
385     /** Create a Statement instance.
386      *
387      * <p>Subsequent operations on the statement or any of its parts may
388      * modify this model.</p>
389      * <p>Creating a statement does not add it to the set of statements in the
390      * model. </p>
391      * <p>The value o will be converted to a Literal.</P>
392      * @param s the subject of the statement
393      * @param p the predicate of the statement
394      * @param o is the value to be the object of the statement
395      
396      * @return the new statement
397      */
398     public Statement createStatement(Resource s, Property p, long o) ;
399     
400     /** Create a Statement instance.
401      *
402      * <p>Subsequent operations on the statement or any of its parts may
403      * modify this model.</p>
404      * <p>Creating a statement does not add it to the set of statements in the
405      * model. </p>
406      * <p>The value o will be converted to a Literal.</P>
407      * @param s the subject of the statement
408      * @param p the predicate of the statement
409      * @param o is the value to be the object of the statement
410      
411      * @return the new statement
412      */
413     public Statement createStatement(Resource s, Property p, char o) ;
414     
415     /** Create a Statement instance.
416      *
417      * <p>Subsequent operations on the statement or any of its parts may
418      * modify this model.</p>
419      * <p>Creating a statement does not add it to the set of statements in the
420      * model. </p>
421      * <p>The value o will be converted to a Literal.</P>
422      * @param s the subject of the statement
423      * @param p the predicate of the statement
424      * @param o is the value to be the object of the statement
425      
426      * @return the new statement
427      */
428     public Statement createStatement(Resource s, Property p, float o) ;
429     
430     /** Create a Statement instance.
431      *
432      * <p>Subsequent operations on the statement or any of its parts may
433      * modify this model.</p>
434      * <p>Creating a statement does not add it to the set of statements in the
435      * model. </p>
436      * <p>The value o will be converted to a Literal.</P>
437      * @param s the subject of the statement
438      * @param p the predicate of the statement
439      * @param o is the value to be the object of the statement
440      
441      * @return the new statement
442      */
443     public Statement createStatement(Resource s, Property p, double o) ;
444     
445     /** Create a Statement instance.
446      *
447      * <p>Subsequent operations on the statement or any of its parts may
448      * modify this model.</p>
449      * <p>Creating a statement does not add it to the set of statements in the
450      * model. </p>
451      * <p>The Object o will be converted to a Literal.</P>
452      * @param s the subject of the statement
453      * @param p the predicate of the statement
454      * @param o is the value to be the object of the statement
455      
456      * @return the new statement
457      */
458     public Statement createStatement(Resource s, Property p, String   o)  ;
459     
460     /** Create a Statement instance.
461      *
462      * <p>Subsequent operations on the statement or any of its parts may
463      * modify this model.</p>
464      * <p>Creating a statement does not add it to the set of statements in the
465      * model. </p>
466      * <p>The Object o will be converted to a Literal.</P>
467      * @param s the subject of the statement
468      * @param p the predicate of the statement
469      * @param o is the value to be the object of the statement
470      * @param l the language associated with the object
471      
472      * @return the new statement
473      */
474     public Statement createStatement(Resource s, Property p, String   o, String   l) ;
475 
476     /** Create a Statement instance.
477      *
478      * <p>Subsequent operations on the statement or any of its parts may
479      * modify this model.</p>
480      * <p>Creating a statement does not add it to the set of statements in the
481      * model. </p>
482      * <p>The Object o will be converted to a Literal.</P>
483      * @param s the subject of the statement
484      * @param p the predicate of the statement
485      * @param o is the value to be the object of the statement
486      * @param wellFormed true if the string is well formed XML
487      
488      * @return the new statement
489      */
490     public Statement createStatement(Resource s, Property p, String   o,
491                                      boolean wellFormed) ;
492     
493     /** Create a Statement instance.
494      *
495      * <p>Subsequent operations on the statement or any of its parts may
496      * modify this model.</p>
497      * <p>Creating a statement does not add it to the set of statements in the
498      * model. </p>
499      * <p>The Object o will be converted to a Literal.</P>
500      * @param s the subject of the statement
501      * @param p the predicate of the statement
502      * @param o is the value to be the object of the statement
503      * @param l the language associated with the object
504      * @param wellFormed true of the string is well formed XML
505      
506      * @return the new statement
507      */
508     public Statement createStatement(Resource s, Property p, String   o, String   l,
509                                      boolean wellFormed) ;
510     
511     /** Create a Statement instance.
512      *
513      * <p>Subsequent operations on the statement or any of its parts may
514      * modify this model.</p>
515      * <p>Creating a statement does not add it to the set of statements in the
516      * model. </p>
517      * <p>The value o will be converted to a Literal.</P>
518      * @param s the subject of the statement
519      * @param p the predicate of the statement
520      * @param o is the value to be the object of the statement
521      
522      * @return the new statement
523      */
524     public Statement createStatement(Resource s, Property p, Object   o)   ;
525     
526     /** Create a new anonymous bag.
527      *
528      * <p>Subsequent operations on the bag or any of its parts may
529      * modify this model.</p>
530      * <p>A statement defining the type of the new bag is added to this model.
531      * </p>
532      * @return a new anonymous bag.
533      */
534     public Bag createBag() ;
535     
536     /** Create a new bag.
537      *
538      * <p>Subsequent operations on the bag or any of its parts may
539      * modify this model.</p>
540      * <p>A statement defining the type of the new bag is added to this model.
541      * </p>
542      * @param uri The URI of the new Bag.
543      * @return a new bag.
544      */
545     public Bag createBag(String   uri) ;
546        
547     /** Create a new anonymous alt.
548      *
549      * <p>Subsequent operations on the alt or any of its parts may
550      * modify this model.</p>
551      * <p>A statement defining the type of the new alt is added to this model.
552      * </p>
553      * @return a new anonymous alt.
554      */
555     public Alt createAlt() ;
556     
557     /** Create a new alt.
558      *
559      * <p>Subsequent operations on the alt or any of its parts may
560      * modify this model.</p>
561      * <p>A statement defining the type of the new alt is added to this model.
562      * </p>
563      * @param uri The URI of the new alt.
564      * @return a new alt.
565      */
566     public Alt createAlt(String   uri) ;
567        
568     /** Create a new anonymous seq.
569      *
570      * <p>Subsequent operations on the seq or any of its parts may
571      * modify this model.</p>
572      * <p>A statement defining the type of the new seq is added to this model.
573      * </p>
574      * @return a new anonymous seq.
575      */
576     public Seq createSeq() ;
577     
578     /** Create a new seq.
579      *
580      * <p>Subsequent operations on the seq or any of its parts may
581      * modify this model.</p>
582      * <p>A statement defining the type of the new seq is added to this model.
583      * </p>
584      * @param uri The URI of the new seq.
585      * @return a new seq.
586      */
587     public Seq createSeq(String   uri) ;
588 
589 /** add a statement to this model.
590  * @return this model
591  * @param s the subject of the statement to add
592  * @param p the predicate of the statement to add
593  * @param o the object of the statement to add
594  */ 
595     Model add(Resource s, Property p, RDFNode o)     ;
596 
597 /** add a statement to this model.
598  *
599  * @return this model
600  * @param s the subject of the statement to add
601  * @param p the predicate of the statement to add
602  * @param o the object of the statement to add
603  */ 
604     Model add(Resource s, Property p, boolean o) ;
605     
606 /** add a statement to this model.
607  *
608  * @return this model
609  * @param s the subject of the statement to add
610  * @param p the predicate of the statement to add
611  * @param o the object of the statement to add
612 
613  */ 
614     Model add(Resource s, Property p, long o) ;
615     
616 /** add a statement to this model.
617  *
618  * @return this model
619  * @param s the subject of the statement to add
620  * @param p the predicate of the statement to add
621  * @param o the object of the statement to add
622 
623  */ 
624     Model add(Resource s, Property p, char o) ;
625     
626 /** add a statement to this model.
627  *
628  * @return this model
629  * @param s the subject of the statement to add
630  * @param p the predicate of the statement to add
631  * @param o the object of the statement to add
632  
633  */ 
634     Model add(Resource s, Property p, float o) ;
635 /** add a statement to this model.
636  *
637  * @return this model
638  * @param s the subject of the statement to add
639  * @param p the predicate of the statement to add
640  * @param o the object of the statement to add
641  
642  */ 
643     Model add(Resource s, Property p, double o) ;
644 
645 /** add a statement to this model.
646  *
647  * @return this model
648  * @param s the subject of the statement to add
649  * @param p the predicate of the statement to add
650  * @param o the object of the statement to add
651  
652  */ 
653     Model add(Resource s, Property p, String   o) ;
654  
655 /** add a statement to this model.
656  *
657  * @return this model
658  * @param s the subject of the statement to add
659  * @param p the predicate of the statement to add
660  * @param o the object of the statement to add
661  * @param wellFormed true if o is well formed XML
662  
663  */ 
664     Model add(Resource s, Property p, String   o, boolean wellFormed)
665       ;
666 
667 /** add a statement to this model.
668  *
669  * @return this model
670  * @param s the subject of the statement to add
671  * @param p the predicate of the statement to add
672  * @param o the object of the statement to add
673  * @param l the language associated with the object
674  
675  */ 
676     Model add(Resource s, Property p, String   o, String   l) ;
677 
678 /** 
679  * @deprecated since Jena2. It is no longer legal to have a language
680  * tag on a well-formed XMLLiteral. Use the 4-argument form of
681  * {@link #add(Resource, Property, String, boolean) add} instead.
682  * 
683  * add a statement to this model.
684  *
685  * @return this model
686  * @param s the subject of the statement to add
687  * @param p the predicate of the statement to add
688  * @param o the object of the statement to add
689  * @param l the language associated with the object
690  * @param wellFormed true if o is well formed XML
691  
692  */ 
693     Model add(Resource s, Property p, String   o, String   l, boolean wellFormed)
694       ;
695 
696 /** add a statement to this model.
697  *
698  * @return this model
699  * @param s the subject of the statement to add
700  * @param p the predicate of the statement to add
701  * @param o the object of the statement to add
702  
703  */ 
704     Model add(Resource s, Property p, Object   o) ;
705 
706 /** Remove all the Statements returned by an iterator.
707  * @return this model
708  * @param iter the iterator which returns the statements to be removed.
709  
710  */ 
711     Model remove(StmtIterator iter) ;
712 
713 /** Remove all the Statements in a given model, including reified statements
714  * @return this model
715  * @param m the model containing the statements to be removed.
716  
717  */ 
718     Model remove(Model m) ;
719     
720     /**
721         Remove from this model all the statements found in the given model.
722         If suppressreifications is true, remove the reified statements of m as well.
723         @param m the model containing the statements to remove
724         @param suppressReifications true to remove reified statements too
725         @return this model for cascading 
726     */
727     Model remove( Model m, boolean suppressReifications );
728 
729 /** Find all the statements matching a pattern.
730  * <p>Return an iterator over all the statements in a model
731  *  that match a pattern.  The statements selected are those
732  *  whose subject matches the <code>subject</code> argument,
733  *  whose predicate matches the <code>predicate</code> argument
734  *  and whose object matchesthe <code>object</code> argument.
735  *  If an argument is <code>null</code> it matches anything.</p>
736  * @return an iterator over the subjects
737  * @param subject   The subject sought
738  * @param predicate The predicate sought
739  * @param object    The value sought
740  
741  */ 
742     StmtIterator listStatements(Resource subject,
743                                 Property predicate,
744                                 boolean object)
745                                            ;
746 
747 /** Find all the statements matching a pattern.
748  * <p>Return an iterator over all the statements in a model
749  *  that match a pattern.  The statements selected are those
750  *  whose subject matches the <code>subject</code> argument,
751  *  whose predicate matches the <code>predicate</code> argument
752  *  and whose object matchesthe <code>object</code> argument.
753  *  If an argument is <code>null</code> it matches anything.</p>
754  * @return an iterator over the subjects
755  * @param subject   The subject sought
756  * @param predicate The predicate sought
757  * @param object    The value sought
758  
759  */ 
760     StmtIterator listStatements(Resource subject,
761                                 Property predicate,
762                                 long     object)
763                                            ;
764 
765 /** Find all the statements matching a pattern.
766  * <p>Return an iterator over all the statements in a model
767  *  that match a pattern.  The statements selected are those
768  *  whose subject matches the <code>subject</code> argument,
769  *  whose predicate matches the <code>predicate</code> argument
770  *  and whose object matchesthe <code>object</code> argument.
771  *  If an argument is <code>null</code> it matches anything.</p>
772  * @return an iterator over the subjects
773  * @param subject   The subject sought
774  * @param predicate The predicate sought
775  * @param object    The value sought
776  
777  */ 
778     StmtIterator listStatements(Resource subject,
779                                 Property predicate,
780                                 char    object)
781                                            ;
782 
783 /** Find all the statements matching a pattern.
784  * <p>Return an iterator over all the statements in a model
785  *  that match a pattern.  The statements selected are those
786  *  whose subject matches the <code>subject</code> argument,
787  *  whose predicate matches the <code>predicate</code> argument
788  *  and whose object matchesthe <code>object</code> argument.
789  *  If an argument is <code>null</code> it matches anything.</p>
790  * @return an iterator over the subjects
791  * @param subject   The subject sought
792  * @param predicate The predicate sought
793  * @param object    The value sought
794  
795  */ 
796     StmtIterator listStatements(Resource subject,
797                                 Property predicate,
798                                 float    object)
799                                            ;
800 
801 /** Find all the statements matching a pattern.
802  * <p>Return an iterator over all the statements in a model
803  *  that match a pattern.  The statements selected are those
804  *  whose subject matches the <code>subject</code> argument,
805  *  whose predicate matches the <code>predicate</code> argument
806  *  and whose object matchesthe <code>object</code> argument.
807  *  If an argument is <code>null</code> it matches anything.</p>
808  * @return an iterator over the subjects
809  * @param subject   The subject sought
810  * @param predicate The predicate sought
811  * @param object    The value sought
812  
813  */ 
814     StmtIterator listStatements(Resource subject,
815                                 Property predicate,
816                                 double  object)
817                                            ;
818 
819 /** Find all the statements matching a pattern.
820  * <p>Return an iterator over all the statements in a model
821  *  that match a pattern.  The statements selected are those
822  *  whose subject matches the <code>subject</code> argument,
823  *  whose predicate matches the <code>predicate</code> argument
824  *  and whose object matchesthe <code>object</code> argument.
825  *  If an argument is <code>null</code> it matches anything.</p>
826  * @return an iterator over the subjects
827  * @param subject   The subject sought
828  * @param predicate The predicate sought
829  * @param object    The value sought
830  
831  */ 
832     StmtIterator listStatements(Resource subject,
833                                 Property predicate,
834                                 String     object)
835                                            ;
836 
837 /** Find all the statements matching a pattern.
838  * <p>Return an iterator over all the statements in a model
839  *  that match a pattern.  The statements selected are those
840  *  whose subject matches the <code>subject</code> argument,
841  *  whose predicate matches the <code>predicate</code> argument
842  *  and whose object matchesthe <code>object</code> argument.
843  *  If an argument is <code>null</code> it matches anything.</p>
844  * @return an iterator over the subjects
845  * @param subject   The subject sought
846  * @param predicate The predicate sought
847  * @param object    The value sought
848  * @param lang      The lang code ofthe string.
849  
850  */ 
851     StmtIterator listStatements(Resource subject,
852                                 Property predicate,
853                                 String     object,
854                                 String     lang)
855                                            ;
856 
857 /** List all subjects with a given property and property value.
858  * @return an iterator over the subjects
859  * @param p The predicate sought
860  * @param o The value sought
861  
862  */ 
863     ResIterator listSubjectsWithProperty(Property p, boolean o)
864                                            ;
865 
866 /** List all the subjects with a given property and property value.
867  * @return an iterator over the subjects
868  * @param p The predicate sought
869  * @param o The value sought
870  
871  */ 
872     ResIterator listSubjectsWithProperty(Property p, long o)
873                                            ;
874 
875 /** List all subjects with a given property and property value.
876  * @return an iterator over the subjects
877  * @param p The predicate sought
878  * @param o The value sought
879  
880  */ 
881     ResIterator listSubjectsWithProperty(Property p, char o)
882                                           ;
883 
884 /** List all subjects with a given property and property value.
885  * @return an iterator over the subjects
886  * @param p The predicate sought
887  * @param o The value sought
888  
889  */ 
890     ResIterator listSubjectsWithProperty(Property p, float o)
891                                            ;
892 /** lists all subjects with a given property and property value.
893  * @return an iterator over the set of subjects
894  * @param p The property sought.
895  * @param o The property value sought.
896  
897  */ 
898     ResIterator listSubjectsWithProperty(Property p, double o)
899                                            ;
900 /** lists all subjects with a given property and property value.
901  * @return an iterator over the set of subjects
902  * @param p The predicate sought.
903  * @param o The property value sought.
904  
905  */ 
906     ResIterator listSubjectsWithProperty(Property p, String   o)
907                                           ;
908 /** lists all subjects with a given property and property value.
909  * @return an iterator over the set of subjects
910  * @param p The predicate sought.
911  * @param o The property value sought.
912  * @param l the language associated with the object
913  
914  */ 
915     ResIterator listSubjectsWithProperty(Property p, String   o, String   l)
916                                           ;
917 
918 /** List all subjects with a given property and property value.
919  * @return an iterator over the subjects
920  * @param p The predicate sought
921  * @param o The value sought
922  
923  */ 
924     ResIterator listSubjectsWithProperty(Property p, Object   o)
925                                            ;
926 
927 /** Determine if a statement is present in this model.
928  * @return true if the statement with subject s, property p and object o
929  * is in the model, false otherwise
930  * @param s The subject of the statment tested.
931  * @param p The predicate of the statement tested.
932  * @param o The object of the statement tested.
933  
934  */ 
935     boolean contains(Resource s, Property p, boolean o) ;
936 
937 /** Determine if a statement is present in this model.
938  * @return true if the statement with subject s, property p and object o
939  * is in the model, false otherwise
940  * @param s The subject of the statment tested.
941  * @param p The predicate of the statement tested.
942  * @param o The object of the statement tested.
943  
944  */ 
945     boolean contains(Resource s, Property p, long o) ;
946 
947 /** Determine if a statement is present in this model.
948  * @return true if the statement with subject s, property p and object o
949  * is in the model, false otherwise
950  * @param s The subject of the statment tested.
951  * @param p The predicate of the statement tested.
952  * @param o The object of the statement tested.
953  
954  */ 
955     boolean contains(Resource s, Property p, char o) ;
956 
957 /** Determine if a statement is present in this model.
958  * @return true if the statement with subject s, property p and object o
959  * is in the model, false otherwise
960  * @param s The subject of the statment tested.
961  * @param p The predicate of the statement tested.
962  * @param o The object of the statement tested.
963  
964  */ 
965     boolean contains(Resource s, Property p, float o) ;
966 
967 /** Determine if a statement is present in this model.
968  * @return true if the statement with subject s, property p and object o
969  * is in the model, false otherwise
970  * @param s The subject of the statment tested.
971  * @param p The predicate of the statement tested.
972  * @param o The object of the statement tested.
973  
974  */ 
975     boolean contains(Resource s, Property p, double o) ;
976 
977 /** Determine if a statement is present in this model.
978  * @return true if the statement with subject s, property p and object o
979  * is in the model, false otherwise
980  * @param s The subject of the statment tested.
981  * @param p The predicate of the statement tested.
982  * @param o The object of the statement tested.
983  
984  */ 
985     boolean contains(Resource s, Property p, String   o) ;
986 
987 /** Determine if a statement is present in this model.
988  * @return true if the statement with subject s, property p and object o
989  * is in the model, false otherwise
990  * @param s The subject of the statment tested.
991  * @param p The predicate of the statement tested.
992  * @param o The object of the statement tested.
993  * @param l the language associated with the object
994  
995  */ 
996     boolean contains(Resource s, Property p, String   o, String   l)
997        ;
998 
999 /** Determine if a statement is present in this model.
1000 * @return true if the statement with subject s, property p and object o
1001 * is in the model, false otherwise
1002 * @param s The subject of the statment tested.
1003 * @param p The predicate of the statement tested.
1004 * @param o The object of the statement tested.
1005 
1006 */ 
1007    boolean contains(Resource s, Property p, Object   o) ;
1008}
A to Z: JavaDoc & Examples Daily Java News & Articles Open Source Projects Open Source Codes Free Computer Books Remove Frame
Popular Tags