    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$
    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  }