ozonestack.java

来自「Java的面向对象数据库系统的源代码」· Java 代码 · 共 42 行

// 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: OzoneStack.java,v 1.1 2002/10/24 15:41:16 per_nyfelt Exp $

package org.ozoneDB.collections;

import java.util.Stack;

/**
 * See the overall description on {@link org.ozoneDB.collections.OzoneCollection}.
 * @author <a href="mailto:ozoneATmekenkampD0Tcom">Leo Mekenkamp (mind the anti-sp@m)</a>
 */
public interface OzoneStack extends OzoneList {
    
    public boolean empty();
    
    public Object peek();
    
    public Object pop(); /*update*/
    
    public Object push(Object object); /*update*/
    
    public int search(Object object);

    /**
     * <p>Returns a <code>Stack</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>OzoneStack</code>. I.e. the contents of 
     * this <code>OzoneStack</code> instance are always copied to the client
     * by use of serialization.</p>
     * <p>Note that the difference of calling <code>iterator()</code>
     * compared to <code>getClientStack().iterator()</code> is that in 
     * the first case you go through the real collection on the server and in 
     * the second case you go through a local copy on the client side.</p>
     */
    public Stack getClientStack();
    
}