1 /* 2 * (c) Copyright 2000, 2001, 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 * 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.7 $' Date='$Date: 2005/02/21 12:13:59 $' 50 */ 51 52 53 public interface Bag extends Container { 54 55 /** Remove a value from the container. 56 * 57 * <p>The predicate of the statement <CODE>s</CODE> identifies the 58 * ordinal of the value to be removed. Once removed, the values in the 59 * container with a higher ordinal value are renumbered. The renumbering 60 * algorithm is implementation dependent.<p> 61 * @param s The statement to be removed from the model. 62 * @return this container to enable cascading calls. 63 */ 64 public Container remove(Statement s); 65 66 /** Remove a value from the container. 67 * 68 * <p>Any statement with an ordinal predicate and object <CODE>v</CODE> 69 * may be selected and removed. Once removed, the values in the 70 * container with a higher ordinal value are renumbered. The renumbering 71 * algorithm is implementation dependent.<p> 72 * @param v The value to be removed from the bag. 73 * @return this container to enable cascading calls. 74 */ 75 //TODO public Container remove(String v) ; 76 } 77 78