home *** CD-ROM | disk | FTP | other *** search
/ The Net: Ultimate Internet Guide / WWLCD1.ISO / pc / java / un2maiq4 / pjjava / src / pj / io / storycontainer.java < prev    next >
Encoding:
Java Source  |  1996-08-14  |  2.0 KB  |  83 lines
  1. /*---------------------------------------------------------------------------
  2.  
  3.     Written by the Personal Journal developers of Dow Jones & Company, Inc.
  4.  
  5.     Dow Jones makes no representations or warranties about 
  6.     the suitability of this software, either express or 
  7.     implied, including but not limited to the implied warranties 
  8.     of merchantability, fitness for a particular purpose, 
  9.     or non-infringement.  Dow Jones will not be liable for 
  10.     any damages suffered by a user as a result of using, 
  11.     modifying or distributing this software or its derivatives.
  12.  
  13.  
  14.  
  15.     @(#)StoryContainer.java    0.00    20-Dec-95
  16.  
  17.  
  18.         Capabilities of a generic Container for PaperStories.
  19.  
  20.  
  21.     Authors:
  22.  
  23.         rphall      Rick Hall
  24.  
  25.  
  26.     Version Ident:
  27.  
  28.         $Header$
  29.  
  30.  
  31.     History:
  32.  
  33.         12/20/95    rphall      Initial Creation
  34.  
  35.  
  36. ---------------------------------------------------------------------------*/
  37.  
  38. package pj.io;
  39.  
  40. import pj.io.IncompatiblePaperStoryException;
  41. import pj.io.MalformedPaperStoryException;
  42. import pj.io.PaperStory;
  43.  
  44. import collections.ImplementationError;
  45. import java.lang.IllegalArgumentException;
  46. import java.util.NoSuchElementException;
  47.  
  48. /**
  49.  * Capabilities of a generic Container for PaperStories.
  50.  * @version 0.00, 20-Dec-95
  51.  * @author     Rick Hall
  52.  */
  53. public interface StoryContainer
  54.     {
  55.  
  56.  
  57.     // --- Public operations
  58.  
  59.     public void addStory(PaperStory ps)
  60.         throws MalformedPaperStoryException, IncompatiblePaperStoryException,
  61.                IllegalArgumentException;
  62.  
  63.     public int numStories();
  64.  
  65.     public void removeStories();
  66.  
  67.     public PaperStory firstStory()
  68.         throws NoSuchElementException;
  69.  
  70.     public PaperStory nextStory()
  71.         throws NoSuchElementException;
  72.  
  73.     public PaperStory lastStory()
  74.         throws NoSuchElementException;
  75.  
  76.     public PaperStory previousStory()
  77.         throws NoSuchElementException;
  78.  
  79.     public PaperStory currentStory()
  80.         throws NoSuchElementException;
  81.  
  82.     } // StoryContainer
  83.