gridviewertablemodel.java

编辑视频文件

/*
 * File:     GridViewerTableModel.java
 * Project:  MPI Linguistic Application
 * Date:     02 May 2007
 *
 * Copyright (C) 2001-2007  Max Planck Institute for Psycholinguistics
 *
 * This program 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 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 General Public License for more details.
 *
 * You should have received a copy of the GNU General Public License
 * along with this program; if not, write to the Free Software
 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
 */

/* This program 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 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 General Public License for more details.
 *
 * You should have received a copy of the GNU General Public License
 * along with this program; if not, write to the Free Software
 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
 */
package mpi.eudico.client.annotator.grid;

import mpi.eudico.server.corpora.clom.Annotation;
import mpi.eudico.server.corpora.clom.AnnotationCore;

import mpi.util.TimeFormatter;

import java.util.ArrayList;
import java.util.Arrays;
import java.util.Enumeration;
import java.util.Hashtable;
import java.util.List;

import javax.swing.table.AbstractTableModel;


/**
 * Class that holds the data that are displayed in the table. <br>
 * The Vector of column names are only used as internal identifiers; the text that is displayed in
 * the headers is stored in the ColumnModel. <br>
 * <br>
 * The ordering of the columns in the table is more or less fixed. In single tier mode the columns
 * from left to right are:
 *
 * <ul>
 * <li>
 * triangle icon (mediatime indicator)
 * </li>
 * <li>
 * row/annotation number
 * </li>
 * <li>
 * file name
 * </li>
 * <li>
 * tier name
 * </li>
 * <li>
 * left context
 * </li>
 * <li>
 * annotation value
 * </li>
 * <li>
 * right context
 * </li>
 * <li>
 * annotation begintime
 * </li>
 * <li>
 * annotation endtime
 * </li>
 * <li>
 * annotation duration
 * </li>
 * </ul>
 *
 * In multi tier mode the subsequent dependant tiers that are added to the table are inserted
 * between the column of the parent annotation's value and the begintime column. Currently hiding
 * a column means setting the width to zero, which means it is not removed from the model.
 */
public class GridViewerTableModel extends AbstractTableModel {
    /**DOCUMENT ME! */
    public static final String TIMEPOINT = "ColumnTriangle";

    /**DOCUMENT ME! */
    public static final String COUNT = "ColumnCount";

    /**DOCUMENT ME! */
    public static final String FILENAME = "ColumnFileName";

    /**DOCUMENT ME! */
    public static final String TIERNAME = "ColumnTierName";

    /**DOCUMENT ME! */
    public static final String LEFTCONTEXT = "ColumnLeftContext";

    /**DOCUMENT ME! */
    public static final String ANNOTATION = "ColumnAnnotation";

    /**DOCUMENT ME! */
    public static final String RIGHTCONTEXT = "ColumnRightContext";

    /**DOCUMENT ME! */
    public static final String BEGINTIME = "ColumnBeginTime";

    /**DOCUMENT ME! */
    public static final String ENDTIME = "ColumnEndTime";

    /**DOCUMENT ME! */
    public static final String DURATION = "ColumnDuration";

    /**DOCUMENT ME! */
    public static final String[] fixedColumnNames = {
        TIMEPOINT, COUNT, FILENAME, TIERNAME, LEFTCONTEXT, ANNOTATION,
        RIGHTCONTEXT, BEGINTIME, ENDTIME, DURATION
    };

    /**DOCUMENT ME! */
    protected static final String HHMMSSsss = "TIMECODE";

    /**DOCUMENT ME! */
    protected static final String MILLISECONDS = "MILLISECONDS";

    /**DOCUMENT ME! */
    protected List annotations;

    /* holds the internal column identifiers */

    /**DOCUMENT ME! */
    protected List usedColumnNames;

    /**DOCUMENT ME! */
    protected boolean isFiltering = false;

    //   private final Hashtable numberHash = new Hashtable();

    /** Holds value of property DOCUMENT ME! */
    private final String EMPTY = "";

    /*
     * a table containing the Vectors of annotations/empty slots of each child
     * tier of the proper kind, stored with the tiername as key
     */
    private Hashtable childTierHash = new Hashtable();
    private String strTimeFormat = HHMMSSsss;

    /**
     * Creates a new GridViewerTableModel object.
     */
    public GridViewerTableModel() {
        this(new ArrayList());
    }

    /**
     * Creates a GridResultModel using the specified annotations as the data provider and the id's
     * as the columnidentifiers.
     *
     * @param annotations the (parent) annotations
     */
    GridViewerTableModel(List annotations) {
        this.annotations = annotations;

        //minimum set; to be extended by subclasses
        usedColumnNames = new ArrayList();
        usedColumnNames.add(TIMEPOINT);
        usedColumnNames.add(COUNT);
        usedColumnNames.add(ANNOTATION);
        usedColumnNames.add(BEGINTIME);
        usedColumnNames.add(ENDTIME);
        usedColumnNames.add(DURATION);
    }

    /**
     * DOCUMENT ME!
     *
     * @param row DOCUMENT ME!
     *
     * @return DOCUMENT ME!
     */
    public AnnotationCore getAnnotationCore(int row) {
        return ((AnnotationCore) annotations.get(row));
    }

    /**
     * Returns whether or not the cell at the given row and column can be edited. This is the case
     * if the corresponding value is an instance of Annotation (e.g. not a Match) or a (possibly)
     * empty value in a column of a child tier. ! Be sure that all editable cells can be handled
     * by GridEditor !
     *
     * @param row the row index
     * @param column the column index
     *
     * @return true if the cell can be edited, false otherwise
     */
    public boolean isCellEditable(int row, int column) {
        return getValueAt(row, column) instanceof Annotation ||
        !Arrays.asList(fixedColumnNames).contains(getColumnName(column));
    }

    /**
     * Returns the number of columns in the tablemodel.
     *
     * @return the number of columns
     */
    public int getColumnCount() {
        return usedColumnNames.size();
    }

    /**
     * Returns the identifier of the column at the specified model index.
     *
     * @param nr the index of the column
     *
     * @return the identifier of the column
     */
    public String getColumnName(int nr) {
        if ((0 <= nr) && (nr < usedColumnNames.size())) {
            return (String) usedColumnNames.get(nr);
        }

        return EMPTY;
    }

    /**
     * DOCUMENT ME!
     *
     * @param filtering DOCUMENT ME!
     */
    public void setFiltering(boolean filtering) {
        isFiltering = filtering;
    }

    /**
     * DOCUMENT ME!
     *
     * @return DOCUMENT ME!
     */
    public boolean isFiltering() {
        return isFiltering;
    }

    /**
     * Returns the number of annotations on the (parent) tier.
     *
     * @return the number of annotations on the (parent) tier
     */
    public int getRowCount() {
        return annotations.size();
    }

    /**
     * DOCUMENT ME!
     *
     * @param strTimeFormat DOCUMENT ME!
     */
    public void setTimeFormat(String strTimeFormat) {
        this.strTimeFormat = strTimeFormat;
    }

    /**
     * DOCUMENT ME!
     *
     * @return DOCUMENT ME!
     */
    public String getTimeFormat() {
        return strTimeFormat;
    }

    /**
     * This method is only to be used to update a table cell in a column for the Annotation of a
     * child tier; so it is only usefull in multi tier mode. <br>
     * This method does not call fireTableDataChanged(); changes in an Annotation in a table cell
     * will be visible after the next repaint.
     *
     * @param annotation DOCUMENT ME!
     * @param row DOCUMENT ME!
     * @param column DOCUMENT ME!
     */
    public void setValueAt(Object annotation, int row, int column) {
        if (annotation instanceof AnnotationCore) {
            int size = childTierHash.size();

            if (size > 0) {
                if ((column > 2) && (column <= (2 + size)) &&
                        (row < getRowCount())) {
                    String tierName = getColumnName(column);

                    if (childTierHash.containsKey(tierName)) {
                        List anns = (List) childTierHash.get(tierName);
                        anns.set(row, annotation);
                    }
                }
            }
        }
    }

    /**
     * Returns the value for the table cell at the specified row and column.
     *
     * @param row the row index
     * @param column the column index
     *
     * @return the value that has to be rendered
     */
    public Object getValueAt(int row, int column) {
        try {
            if ((column < 0) || (column >= usedColumnNames.size()) ||
                    (row < 0) || (row >= annotations.size())) {
                return null;
            }

            String cn = getColumnName(column);

            if (cn.equals(TIMEPOINT)) {
                return null;
            }

            if (cn.equals(COUNT)) {
                return EMPTY + (row + 1);
            }

            if (cn.equals(ANNOTATION)) {
                return annotations.get(row);
            }

            if (cn.equals(BEGINTIME)) {
                return getStringRepresentation(((AnnotationCore) annotations.get(
                        row)).getBeginTimeBoundary()); //begintime
            }

            if (cn.equals(ENDTIME)) {
                return getStringRepresentation(((AnnotationCore) annotations.get(
                        row)).getEndTimeBoundary()); //endtime
            }

            if (cn.equals(DURATION)) {
                AnnotationCore ann = (AnnotationCore) annotations.get(row);

                return getStringRepresentation(ann.getEndTimeBoundary() -
                    ann.getBeginTimeBoundary()); //duration
            }

            if (childTierHash.containsKey(cn)) {
                List v = (List) childTierHash.get(cn);

                if (row < v.size()) {
                    return v.get(row);
                }
            }
        } catch (ArrayIndexOutOfBoundsException aie) {
            return null;
        }

        return null;
    }

    /**
     * DOCUMENT ME!
     *
     * @param aa DOCUMENT ME!
     */
    public void addAnnotation(AnnotationCore aa) {
        annotations.add(aa);
        fireTableDataChanged();
    }

    /**
     * DOCUMENT ME!
     *
     * @param list DOCUMENT ME!
     */
    public void addAnnotations(List list) {
        annotations.addAll(list);
        fireTableDataChanged();
    }

    /**
     * Adds a child tier and its annotations/empty slots to the model. Insert the new tier just
     * before the begin time column.
     *
     * @param tierName the name of the tier
     * @param annotations the annotations
     */
    public void addChildTier(String tierName, List annotations) {
        if (childTierHash.containsKey(tierName)) {
            return;
        }

        childTierHash.put(tierName, annotations);

        int index = findColumn(BEGINTIME);
        usedColumnNames.add(index, tierName);
        fireTableDataChanged();
    }

    /**
     * Replaces the Vector of annotations of the current tier. Called when the parent tier has not
     * changed, but annotations on the tier might have been changed.
     *
     * @param annotations the annotations
     * @param annotationNumbers DOCUMENT ME!
     */
    public void updateAnnotations(List annotations) {
        this.annotations = annotations;
        removeChildTiers();
        fireTableDataChanged();
    }

    private String getStringRepresentation(long l) {
        return strTimeFormat.equals(HHMMSSsss) ? TimeFormatter.toString(l)
                                               : (EMPTY + l);
    }

    /**
     * Removes the annotations of child tiers from the model.
     */
    private void removeChildTiers() {
        int numChildTiers = childTierHash.size();

        if (numChildTiers > 0) {
            Enumeration en = childTierHash.keys();

            while (en.hasMoreElements()) {
                usedColumnNames.remove(en.nextElement());
            }

            childTierHash.clear();
        }
    }
}