ozonecollection.java

Java的面向对象数据库系统的源代码

// You can redistribute this software and/or modify it under the terms of
// the Ozone Library License version 1 published by ozone-db.org.
//
// This file is
// Copyright (C) 2002-@year@ Leo Mekenkamp. All rights reserved.
// $Id: OzoneCollection.java,v 1.6 2003/11/27 15:55:11 leomekenkamp Exp $

package org.ozoneDB.collections;

import java.util.Collection;
import java.util.Iterator;
import org.ozoneDB.OzoneRemote;

/**
 * An ozone aware collection.
 *
 * @author <a href="mailto:ozoneATmekenkampD0Tcom">Leo Mekenkamp (mind the anti-sp@m)</a>
 */
public interface OzoneCollection extends Collection, OzoneRemote {

    /** <p>Returns a non-ozone <code>Collection</code> that contains the same
     * entries as this persistent one; it is (by nature of the client-server
     * enviromnent) always a 'deep' copy of this <code>OzoneCollection</code>.
     * I.e. the contents of this <code>OzoneCollection</code> instance are
     * always copied to the client by use of serialization.</p>
     * <p>This means that if this instance holds non-ozone objects, these
     * objects are send to the calling client by means of serialization. If
     * this instance holds ozone objects, it actually holds proxies to these
     * objects. These proxies are copied and send to the client, resulting in
     * different proxies to the same ozone objects.</p>
     * <p>Note that all subclasses of <code>OzoneCollection</code> (or
     * <code>OzoneMap</code>) have <code>getClientXxx()</code> member functions
     * that return a collection of type <code>java.util.Xxx</code>; these simply
     * return the same result value as <code>getClientCollection()</code>
     * without the need for a typecast.</p>
     */
    public Collection getClientCollection();

    public boolean add(Object obj); /*update*/

    public boolean addAll(Collection c); /*update*/

    public boolean remove(Object obj); /*update*/

    public boolean removeAll(Collection c); /*update*/

    public boolean retainAll(Collection c); /*update*/

    public void clear(); /*update*/
    
    public Iterator _org_ozoneDB_internalIterator();
    
}