1 /* Copyright (C) 2003 Internet Archive. 2 * 3 * This file is part of the Heritrix web crawler (crawler.archive.org). 4 * 5 * Heritrix is free software; you can redistribute it and/or modify 6 * it under the terms of the GNU Lesser Public License as published by 7 * the Free Software Foundation; either version 2.1 of the License, or 8 * any later version. 9 * 10 * Heritrix is distributed in the hope that it will be useful, 11 * but WITHOUT ANY WARRANTY; without even the implied warranty of 12 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the 13 * GNU Lesser Public License for more details. 14 * 15 * You should have received a copy of the GNU Lesser Public License 16 * along with Heritrix; if not, write to the Free Software 17 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA 18 * 19 * Stack.java 20 * Created on May 21, 2004 21 * 22 * $Header: /cvsroot/archive-crawler/ArchiveOpenCrawler/src/java/org/archive/queue/Stack.java,v 1.2 2006/09/07 19:21:50 stack-sf Exp $ 23 */ 24 25 package org.archive.queue; 26 27 28 /** 29 * Simple Stack: supports add and remove at top. 30 * 31 * @author gojomo 32 * @deprecated As of 1.10.0. Unused. 33 */ 34 public interface Stack { 35 /** 36 * Add object to top of Stack 37 * 38 * @param object 39 */ 40 public void push(Object object); 41 42 /** 43 * Remove and return item from top of Stack 44 * @return Item removed from top of Stack 45 */ 46 public Object pop(); 47 48 /** 49 * @return Return item from top of Stack without removing it. 50 */ 51 public Object peek(); 52 53 /** 54 * Number of items in the Stack. 55 */ 56 public long height(); 57 58 /** 59 * Release any OS resources, if necessary. 60 */ 61 public void release(); 62 63 /** 64 * @return True if empty. 65 */ 66 public boolean isEmpty(); 67 } 68