01: /*
02: * (c) Copyright 2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008 Hewlett-Packard Development Company, LP
03: * All rights reserved.
04: *
05: * Redistribution and use in source and binary forms, with or without
06: * modification, are permitted provided that the following conditions
07: * are met:
08: * 1. Redistributions of source code must retain the above copyright
09: * 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: * Bag.java
28: *
29: * Created on 26 July 2000, 15:23
30: */
31:
32: package com.hp.hpl.jena.rdf.model;
33:
34: /** An RDF Bag container.
35: *
36: * <p>This interface defines methods for accessing RDF Bag resources.
37: * These methods operate on the RDF statements contained in a model. The
38: * Bag implementation may cache state from the underlying model, so
39: * objects should not be added to or removed a the Bag by directly
40: * manipulating its properties, whilst the Bag is being
41: * accessed through this interface.</p
42: *
43: * <p>When a member is deleted from a Bag using this interface, or an
44: * iterator returned through this interface, all the other members with
45: * higher ordinals are renumbered using an implementation dependendent
46: * algorithm.</p>
47: *
48: * @author bwm
49: * @version Release='$Name: $' Revision='$Revision: 1.10 $' Date='$Date: 2008/01/02 12:05:47 $'
50: */
51:
52: public interface Bag extends Container {
53:
54: /** Remove a value from the container.
55: *
56: * <p>The predicate of the statement <CODE>s</CODE> identifies the
57: * ordinal of the value to be removed. Once removed, the values in the
58: * container with a higher ordinal value are renumbered. The renumbering
59: * algorithm is implementation dependent.<p>
60: * @param s The statement to be removed from the model.
61: * @return this container to enable cascading calls.
62: */
63: public Container remove(Statement s);
64:
65: /** Remove a value from the container.
66: *
67: * <p>Any statement with an ordinal predicate and object <CODE>v</CODE>
68: * may be selected and removed. Once removed, the values in the
69: * container with a higher ordinal value are renumbered. The renumbering
70: * algorithm is implementation dependent.<p>
71: * @param v The value to be removed from the bag.
72: * @return this container to enable cascading calls.
73: */
74: //TODO public Container remove(String v) ;
75: }
|