/*
 * The Kuali Financial System, a comprehensive financial management system for higher education.
 * 
 * Copyright 2005-2014 The Kuali Foundation
 * 
 * This program is free software: you can redistribute it and/or modify
 * it under the terms of the GNU Affero General Public License as
 * published by the Free Software Foundation, either version 3 of the
 * License, or (at your option) any later version.
 * 
 * This program 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 Affero General Public License for more details.
 * 
 * You should have received a copy of the GNU Affero General Public License
 * along with this program.  If not, see <http://www.gnu.org/licenses/>.
 */
package org.kuali.kfs.sys.document.web;

import java.util.List;
import java.util.Map;

import org.kuali.kfs.sys.businessobject.AccountingLine;
import org.kuali.kfs.sys.document.AccountingDocument;
import org.kuali.kfs.sys.web.struts.KualiAccountingDocumentFormBase;

/**
 * A contract for classes which wish to provide information about an accounting line which is being rendered
 */
public interface AccountingLineRenderingContext extends RenderableElement {
    
    /**
     * @return the accounting line that would be rendered by the rendering of the given accounting line context
     */
    public abstract AccountingLine getAccountingLine();
    
    /**
     * @return the property path from the form to the accounting line returned by the getAccountingLine() method
     */
    public abstract String getAccountingLinePropertyPath();
    
    /**
     * @return a List of actions which can be performed on the given line
     */
    public abstract List<AccountingLineViewAction> getActionsForLine();
    
    /**
     * Tells callers if fields should render help or not
     * @return true if fields should render help, false otherwise
     */
    public abstract boolean fieldsShouldRenderHelp();
    
    /**
     * Tells callers if dynamic field labels should even be rendered
     * @return true if dynamic field labels can be labeled, false if they should not be labeled.
     */
    public abstract boolean fieldsCanRenderDynamicLabels();
    
    /**
     * Reports whether the tag to be rendered by this rendering context is "new" - ie, not added yet to the accounting group, but living on the form somewhere - or not
     * @return true if the line is new, false otherwise
     */
    public abstract boolean isNewLine();
    
    /**
     * If this is a new line, returns null; if it is a line in a collection, returns the line number within that collection
     * @return the current line count
     */
    public abstract Integer getCurrentLineCount();
    
    /**
     * Returns all the field names for the given accounting line, prefixed by the accounting line property path
     * @return a list of properly prefixed field names
     */
    public abstract List<String> getFieldNamesForAccountingLine();
    
    /**
     * Returns a Map of all values from the request which were unconverted to actuall business objects
     * @return the Map of unconverted values
     */
    public abstract Map getUnconvertedValues();
    
    /**
     * Forces the population of values for all fields used to render the accounting line
     */
    public abstract void populateValuesForFields();
    
    /**
     * @return the accounting document that this line to render is part of (or will be, once it is successfully added)
     */
    public abstract AccountingDocument getAccountingDocument();
    
    /**
     * Returns the tab state for the given tab key on the current form
     * @param tabKey the tab key to get the state of
     * @return the state (either "OPEN" or "CLOSED")
     */
    public abstract String getTabState(String tabKey);
    
    /**
     * Increments the tab index on the form this rendering is associated with
     */
    public abstract void incrementTabIndex();
    
    /**
     * @return the label of the group this accounting line is part of
     */
    public abstract String getGroupLabel();
    
    /**
     * @return the list of errors on the form
     */
    public abstract List getErrors();
    
    /**
     * @return the form that the rendered accounting line will be associated with
     */
    public abstract KualiAccountingDocumentFormBase getForm();
    
    /**
     * @return the property name of the object that contains the accounting lines
     */
    public abstract String getAccountingLineContainingObjectPropertyName();
    
    /**
     * Determines whether a field is modifyable or not
     * @param fieldName the simple name (that is, the name does not include the collection property) of the field
     * @return true if the field can be modified, false if the field can only be read
     */
    public abstract boolean isFieldModifyable(String fieldName);
    
    /**
     * Determines whether the accounting line is - as a whole line - editable or not
     * @return true if the line - as a whole line - is editable, false if nothing on the line can be edited
     */
    public abstract boolean isEditableLine();
    
    /**
     * Determines whether this line should be allowed to be deleted
     * @return true if it should be allowed to be deleted, false otherwise
     */
    public abstract boolean allowDelete();
    
    /**
     * Makes the line within this accounting line context deletable
     */
    public void makeDeletable();
    
    /**
     * @return the number of cells that will actually be rendered (ie, colspans are taken into account)
     */
    public int getRenderableCellCount();
    
    /**
     * Gets the rows attribute. 
     * @return Returns the rows.
     */
    public List<AccountingLineTableRow> getRows();
}