KickJava   Java API By Example, From Geeks To Geeks.

Java > Open Source Codes > org > archive > queue > Stack


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 JavaDoc object);
41
42     /**
43      * Remove and return item from top of Stack
44      * @return Item removed from top of Stack
45      */

46     public Object JavaDoc pop();
47
48     /**
49      * @return Return item from top of Stack without removing it.
50      */

51     public Object JavaDoc 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
Popular Tags