1 /* 2 * @(#)IAttributeSet.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; 30 31 32 33 /** 34 * Contains a queryable set of attribute name-value pairs associated with 35 * issue types. Implementations may have direct accessors for these 36 * attributes. Common attributes include: who reported the issue, a list 37 * of comments written about this issue, and a history of the changes the 38 * issue has gone through. All <tt>IAttributeSet</tt> implementations must be 39 * immutable, unless they also implement <tt>IEditableAttributeSet</tt>. 40 * 41 * @author Matt Albrecht <a HREF="mailto:groboclown@users.sourceforge.net">groboclown@users.sourceforge.net</a> 42 * @version $Date: 2003/02/10 22:51:54 $ 43 * @since July 6, 2002 44 */ 45 public interface IAttributeSet 46 { 47 /** 48 * Returns a list of all attributes. 49 */ 50 public IAttribute[] getAttributes(); 51 52 53 /** 54 * 55 */ 56 public String[] getAttributeNames(); 57 58 59 /** 60 * Finds the attribute for the given name. 61 * 62 * @return the attribute for the name, or <tt>null</tt> if no such 63 * attribute exists. 64 */ 65 public IAttribute getAttribute( String name ); 66 } 67 68