/* ----------------------------------------------------------------------------
   The Kiwi Toolkit - A Java Class Library
   Copyright (C) 1998-2004 Mark A. Lindner

   This library is free software; you can redistribute it and/or
   modify it under the terms of the GNU General Public License as
   published by the Free Software Foundation; either version 2 of the
   License, or (at your option) any later version.

   This library is distributed in the hope that it will be useful,
   but WITHOUT ANY WARRANTY; without even the implied warranty of
   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
   General Public License for more details.

   You should have received a copy of the GNU General Public License
   along with this library; if not, write to the Free Software
   Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA
   02111-1307, USA.
 
   The author may be contacted at: mark_a_lindner@yahoo.com
   ----------------------------------------------------------------------------
   $Log: DomainObjectFieldAdapter.java,v $
   Revision 1.9  2004/05/05 21:37:04  markl
   comment block updates

   Revision 1.8  2003/02/06 07:43:23  markl
   fixed javadoc typo

   Revision 1.7  2003/01/19 09:35:41  markl
   Javadoc & comment header updates.

   Revision 1.6  2001/03/12 05:58:46  markl
   Javadoc cleanup.

   Revision 1.5  2001/03/12 01:17:30  markl
   Source code cleanup.

   Revision 1.4  1999/08/13 07:11:57  markl
   Added support for column widths.

   Revision 1.3  1999/07/25 13:39:10  markl
   Minor fixes.

   Revision 1.2  1999/07/16 07:13:25  markl
   DomainObjectFieldAdapter

   Revision 1.1  1999/06/28 09:37:47  markl
   Initial revision

   Revision 1.3  1999/04/19 05:30:29  markl
   Added getName()/setName() methods.

   Revision 1.2  1999/01/10 01:00:58  markl
   added GPL header & RCS tag
   ----------------------------------------------------------------------------
*/

package kiwi.db;

import javax.swing.table.*;

/** An interface that describes an adapter for accessing fields in a domain
 * object. Consider a domain object as an array of fields which map to
 * corresponding columns in a table (specifically, a <code>JTable</code>).
 * In order to display a domain object as a row in such a table, data
 * members of the domain object must be mapped to cardinal fields. This adapter
 * provides the interface to accomplish this.
 *
 * @author Mark Lindner
 *
 * @see javax.swing.JTable
 */

public interface DomainObjectFieldAdapter
  {
  /** Get the field count.
   *
   * @return The number of fields in the domain object.
   */
  
  public int getFieldCount();

  /** Get the name of a field. The name may be used for display purposes, such
   * as in a table column header.
   *
   * @param field The field number.
   * @return The name of the field.
   */
  
  public String getFieldName(int field);

  /** Get a field value.
   *
   * @param object The domain object for which a field value is being
   * requested.
   * @param field The field number.
   * @return The value of the field.
   */

  public Object getField(DomainObject object, int field);

  /** Set a field value.
   *
   * @param object The domain object for which a field value is being set.
   * @param field The field number.
   * @param value The new value for the field.
   * @exception kiwi.db.MutatorException If the value could not be set.
   */
  
  public void setField(DomainObject object, int field, Object value)
    throws MutatorException;

  /** Get a cell renderer that is appropriate for rendering a given field.
   *
   * @param field The field number.
   * @return A <code>TableCellRenderer</code> that can be used to render the
   * value of this field.
   */  

  public TableCellRenderer getCellRenderer(int field);

  /** Get a cell editor that is appropriate for editing a given field.
   *
   * @param field The field number.
   * @return A <code>TableCellEditor</code> that can be used to edit the
   * value of this field.
   */  
  
  public TableCellEditor getCellEditor(int field);

  /** Determine if the given field is editable.
   *
   * @param field The field number.
   * @return <code>true</code> if the field can be edited by external means
   * (such as through a table control), and <code>false</code> if it is
   * immutable (display-only).
   */
  
  public boolean isFieldEditable(int field);

  /** Determine the type of a given field.
   *
   * @param field The field number.
   * @return The type of the field.
   */
  
  public Class getFieldClass(int field);

  /** Get the preferered column width for this field. This value is used by
   * the <code>JTable</code> or similar component to determine column sizing
   * for the data model that uses this adapter.
   *
   * @param field The field number.
   * @return The preferred width for the field, or 0 if there is no preferred
   * width.
   */
  
  public int getFieldPreferredWidth(int field);

  /** Get the minimum column width for this field. This value is used by
   * the <code>JTable</code> or similar component to determine column sizing
   * for the data model that uses this adapter.
   *
   * @param field The field number.
   * @return The minimum width for the field, or 0 if there is no minimum
   * width.
   */  
  
  public int getFieldMinWidth(int field);

  /** Get the maximum column width for this field. This value is used by
   * the <code>JTable</code> or similar component to determine column sizing
   * for the data model that uses this adapter.
   *
   * @param field The field number.
   * @return The maximum width for the field, or 0 if there is no minimum
   * width.
   */
  
  public int getFieldMaxWidth(int field);
  }

/* end of source file */