1 // You can redistribute this software and/or modify it under the terms of 2 // the Ozone Library License version 1 published by ozone-db.org. 3 // 4 // This file is 5 // Copyright (C) 2002-@year@ Leo Mekenkamp. All rights reserved. 6 // $Id: OzoneStack.java,v 1.1 2002/10/24 15:41:16 per_nyfelt Exp $ 7 8 package org.ozoneDB.collections; 9 10 import java.util.Stack; 11 12 /** 13 * See the overall description on {@link org.ozoneDB.collections.OzoneCollection}. 14 * @author <a HREF="mailto:ozoneATmekenkampD0Tcom">Leo Mekenkamp (mind the anti-sp@m)</a> 15 */ 16 public interface OzoneStack extends OzoneList { 17 18 public boolean empty(); 19 20 public Object peek(); 21 22 public Object pop(); /*update*/ 23 24 public Object push(Object object); /*update*/ 25 26 public int search(Object object); 27 28 /** 29 * <p>Returns a <code>Stack</code> that contains the same entries as this 30 * persistent one; it is (by nature of the client-server enviromnent) always 31 * a 'deep' copy of this <code>OzoneStack</code>. I.e. the contents of 32 * this <code>OzoneStack</code> instance are always copied to the client 33 * by use of serialization.</p> 34 * <p>Note that the difference of calling <code>iterator()</code> 35 * compared to <code>getClientStack().iterator()</code> is that in 36 * the first case you go through the real collection on the server and in 37 * the second case you go through a local copy on the client side.</p> 38 */ 39 public Stack getClientStack(); 40 41 } 42