1 /* 2 * @(#)IParserCollator.java 3 * 4 * Copyright (C) 2002-2003 Matt Albrecht 5 * groboclown@users.sourceforge.net 6 * http://groboutils.sourceforge.net 7 * 8 * Part of the GroboUtils package at: 9 * http://groboutils.sourceforge.net 10 * 11 * Permission is hereby granted, free of charge, to any person obtaining a 12 * copy of this software and associated documentation files (the "Software"), 13 * to deal in the Software without restriction, including without limitation 14 * the rights to use, copy, modify, merge, publish, distribute, sublicense, 15 * and/or sell copies of the Software, and to permit persons to whom the 16 * Software is furnished to do so, subject to the following conditions: 17 * 18 * The above copyright notice and this permission notice shall be included in 19 * all copies or substantial portions of the Software. 20 * 21 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR 22 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, 23 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL 24 * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER 25 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING 26 * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER 27 * DEALINGS IN THE SOFTWARE. 28 */ 29 package net.sourceforge.groboutils.pmti.v1.itf.parser; 30 31 import net.sourceforge.groboutils.pmti.v1.itf.ITestIssueRecordSet; 32 33 /** 34 * Logic to extract parser parsed test-issue records. 35 * 36 * @author Matt Albrecht <a HREF="mailto:groboclown@users.sourceforge.net">groboclown@users.sourceforge.net</a> 37 * @version $Date: 2003/02/10 22:52:01 $ 38 * @since July 7, 2002 39 */ 40 public interface IParserCollator 41 { 42 /** 43 * Adds a new parser to the internal collection. It is up to the 44 * individual collator to lazily parse the records or parse the records 45 * at the time of this invocation. 46 * <P> 47 * It is illegal to invoke this method after a call to 48 * <tt>getRecords()</tt>. 49 * 50 * @param p parser to add, which may be <tt>null</tt> (which should never 51 * cause an error). 52 * @exception IllegalStateException thrown if this is called after the 53 * <tt>getRecords()</tt> method has been invoked. 54 */ 55 public void addParser( IParser p ); 56 57 58 /** 59 * Returns the parsed test-issue records for all known parsers. 60 */ 61 public ITestIssueRecordSet getRecords(); 62 } 63 64