All Downloads are FREE. Search and download functionalities are using the official Maven repository.

gate.gui.STreeNode Maven / Gradle / Ivy

The newest version!
/*
 *  STreeNode.java
 *
 *  Copyright (c) 1995-2012, The University of Sheffield. See the file
 *  COPYRIGHT.txt in the software or at http://gate.ac.uk/gate/COPYRIGHT.txt
 *
 *  This file is part of GATE (see http://gate.ac.uk/), and is free
 *  software, licenced under the GNU Library General Public License,
 *  Version 2, June 1991 (in the distribution as file licence.html,
 *  and also available at http://gate.ac.uk/gate/licence.html).
 *
 *  Kalina Bontcheva, 07/08/2001
 *
 *  $Id: STreeNode.java 19184 2016-04-02 14:42:05Z markagreenwood $
 */

package gate.gui;

import gate.Annotation;
import gate.AnnotationSet;
import gate.Document;
import gate.Factory;
import gate.FeatureMap;
import gate.util.InvalidOffsetException;
import gate.util.Out;

import java.util.ArrayList;
import java.util.HashMap;
import java.util.Iterator;
import java.util.List;
import java.util.Map;
import java.util.concurrent.atomic.AtomicInteger;

import javax.swing.tree.DefaultMutableTreeNode;


@SuppressWarnings("serial")
public class STreeNode extends DefaultMutableTreeNode {

  private static final String ADDEDSET = "TreeViewerTempAdded";
  private static final String REMOVEDSET = "TreeViewerTempRemoved";

  static final AtomicInteger nextID = new AtomicInteger(0);

  int level;            // level in the syntax tree
  int nodeID;           //ID of the node

  long start, end;       //the start and end nodes for this annotation
  Annotation annot;     //the annotation that's created during import/export
                        //not to be used otherwise. During import span is set to
                        //be the same as the annotation span. During export the
                        //annotation span is set to be the same as the span.

  public STreeNode(Annotation annot) {
    level = -1;
    nodeID = nextID.getAndIncrement();
    //span = annot.getSpans().getElementAt(0);
    //get the first span, there should be no others
    this.annot = annot;
    this.start = annot.getStartNode().getOffset().longValue();
    this.end = annot.getEndNode().getOffset().longValue();
  }// public STreeNode(Annotation annot)

  public STreeNode(long start, long end) {
    level = -1;
    nodeID = nextID.getAndIncrement();
    this.start = start;
    this.end = end;
  }// public STreeNode(int start, int end)

  public STreeNode() {
    level = -1;
    nodeID = nextID.getAndIncrement();
    start = 0;
    end = 0;
  }// public STreeNode()

  @Override
  public int getLevel() {
    return level;
  }// public int getLevel()

  public void setLevel(long level) {
    this.level = (int) level;
  }// public void setLevel(int level)

  public void setLevel(int level) {
    this.level = level;
  }// public void setLevel(int level)

  public int getID() {
    return nodeID;
  }// public int getID()

  public long getStart() {
    return start;
  }// public int getStart()

  public void setStart(long start) {
    this.start = start;
  }// public void setStart(int start)

  public long getEnd() {
    return end;
  }// public int getEnd()

  public void setEnd(long end) {
    this.end = end;
  }// public void setEnd(int end)

  /**
    * This also sets the span to match the annotation span!
    */
  public void setAnnotation(Annotation annot) {
    this.annot = annot;
    this.start = annot.getStartNode().getOffset().longValue();
    this.end = annot.getEndNode().getOffset().longValue();
  }// public void setAnnotation(Annotation annot)

  public Annotation getAnnotation() {
    return annot;
  }// public Annotation getAnnotation()

  public void disconnectChildren() {
    for (Iterator i = this.children.iterator(); i.hasNext(); )
      ((STreeNode) i.next()).setParent(null);
    this.children.clear();
  }// public void disconnectChildren()

  /**
    * Creates an annotation of the given type. If the children don't have their
    * annotation objects created, it creates them and assigns the pointers.
    * Expects the text string relative to which all offsets were created!
    */
  public boolean createAnnotation(Document doc, String type,
                                    String text, long utteranceOffset) {
    boolean created = false;

    if (annot != null )
      return false;

    //no document, so cannot add annotations
    if (doc == null)
      return false;

    // check if it has children. If it hasn't then it shouldn't have an
    // annotation because all our leaf nodes are actually just words
    // from the text (e.g. "this", "that"). Their categories are always
    // encoded as non-terminal nodes.
    if ( ! this.getAllowsChildren())
      return false;

    FeatureMap attribs = Factory.newFeatureMap();
    // the text spanned by the annotation is stored as the userObject of the
    // tree node
    // comes from the default Swing tree node
    List consists = new ArrayList();

    Long lStart = new Long(start), lEnd = new Long(end);
//    try {
//      attribs.put("text",
//                  doc.getContent().getContent(lStart, lEnd).toString());
//    } catch (InvalidOffsetException ex) {
//      throw new RuntimeException(ex.getMessage());
//    }
    attribs.put("text",
                  text.substring( (int) (start - utteranceOffset),
                                 (int) (end - utteranceOffset) )
    );
    attribs.put("cat", this.getUserObject());
    attribs.put("consists", consists);

    // children comes from DefaultMutableTreeNode
    for (Iterator i = children.iterator(); i.hasNext(); ) {
      STreeNode child = (STreeNode) i.next();
      if (child.getAnnotation() == null) {
        if (child.getAllowsChildren())
          if (createAnnotation(doc, type, text, utteranceOffset))
            consists.add(child.getAnnotation().getId());
      } else
        consists.add(child.getAnnotation().getId());
    }

    //!!! Need to account for the name of the Annot Set
    AnnotationSet theSet = doc.getAnnotations(ADDEDSET);
    try {
      Integer Id = theSet.add(lStart, lEnd, type, attribs);
      this.annot = theSet.get(Id);
      created = true;
    } catch (InvalidOffsetException ex) {
      Out.println("Invalid annotation offsets: "
                            + start + " and/or " + end);
      created = false;
    }

    return created;
  }// public boolean createAnnotation


  /**
    * Transfers the annotations from added to the given annotation set
    * Also, for each annotation in removed, removes it from the given annotation set
    * Called by OkAction() in the treeViewer to finalise the changes.
    */
  public static boolean transferAnnotations(Document doc, AnnotationSet targetAS) {
    if (doc == null || targetAS == null)
      return false;

    Map tempId2permId = new HashMap();
    List newAnnots = new ArrayList();
    AnnotationSet addedSet = doc.getAnnotations(ADDEDSET);
    if (addedSet != null && !addedSet.isEmpty()) {
      Iterator addedIter = addedSet.iterator();
      while (addedIter.hasNext()) {
        Annotation annot = addedIter.next();
        try {
          Integer permId =
              targetAS.add(annot.getStartNode().getOffset(),
                       annot.getEndNode().getOffset(),
                       annot.getType(),
                       annot.getFeatures());
          tempId2permId.put(annot.getId(), permId);
          newAnnots.add(targetAS.get(permId));
        } catch (InvalidOffsetException ex) {
          Out.println("Invalid annotation offsets: "
                        + annot.getStartNode().getOffset()
                        + " and/or " + annot.getEndNode().getOffset());
        }
      }//while

      //now update the consists Ids, because they have the old Ids in them
      for (int i=0; i < newAnnots.size(); i++) {
        Annotation newAnnot = newAnnots.get(i);
        
        FeatureMap features = newAnnot.getFeatures();
        
        Object value = features.get(SyntaxTreeViewer.NODE_CONSISTS_FEATURE_NAME);
        
        @SuppressWarnings("unchecked")
        List children = (List)value;
        
        if (children == null || children.size()== 0) {
          continue;
        }
        else {
          List newList = new ArrayList();
          for (int k=0; k< children.size(); k++) {
            Integer oldId = children.get(k);
            if (tempId2permId.get(oldId) != null)
              newList.add(tempId2permId.get(oldId));
            else
              newList.add(oldId);
          }
          newAnnot.getFeatures().put(SyntaxTreeViewer.NODE_CONSISTS_FEATURE_NAME,
                                     newList);
        }
      }//for

      addedSet.clear();

    }
    doc.removeAnnotationSet(ADDEDSET);


    AnnotationSet removedSet = doc.getAnnotations(REMOVEDSET);
    if (removedSet != null &&  ! removedSet.isEmpty()) {
      targetAS.removeAll(removedSet);
      removedSet.clear();
    }
    doc.removeAnnotationSet(REMOVEDSET);

    return true;
  }

  public static void undo(Document doc) {
    AnnotationSet addedSet = doc.getAnnotations(ADDEDSET);
    AnnotationSet removedSet = doc.getAnnotations(REMOVEDSET);
    addedSet.clear();
    removedSet.clear();
    doc.removeAnnotationSet(ADDEDSET);
    doc.removeAnnotationSet(REMOVEDSET);
  }

  /** Store the annotation in the deleted list so it can retrieved later */
  public void removeAnnotation(Document doc) {
    if (this.annot == null || doc == null)
      return;

    doc.getAnnotations(REMOVEDSET).add(this.annot);

    this.annot = null;
  }//  public void removeAnnotation(Document doc)

} // STreeNode

// $Log$
// Revision 1.14  2005/01/11 13:51:34  ian
// Updating copyrights to 1998-2005 in preparation for v3.0
//
// Revision 1.13  2004/07/21 17:10:07  akshay
// Changed copyright from 1998-2001 to 1998-2005
//
// Revision 1.12  2004/03/25 13:01:03  valyt
// Imports optimisation throughout the Java sources
// (to get rid of annoying warnings in Eclipse)
//
// Revision 1.11  2003/01/28 10:01:16  marin
// [marin] bugfixes from Kali
//
// Revision 1.10  2001/12/03 14:04:04  kalina
// code cleanup in STreeNode.java
//
// Revision 1.9  2001/08/07 19:03:05  kalina
// Made the tree viewer use Token annotations to break the sentence for annotation
//
// Revision 1.8  2001/08/07 17:01:32  kalina
// Changed the AVR implementing classes in line with the updated AVR
// API (cancelAction() and setSpan new parameter).
//
// Also updated the TreeViewer, so now it can be used to edit and view
// Sentence annotations and the SyntaxTreeNodes associated with them.
// So if you have trees, it'll show them, if not, it'll help you build them.
//
// Revision 1.7  2001/04/09 10:36:36  oana
// a few changes in the code style
//
// Revision 1.6  2000/11/08 16:35:00  hamish
// formatting
//
// Revision 1.5  2000/10/26 10:45:25  oana
// Modified in the code style
//
// Revision 1.4  2000/10/18 13:26:47  hamish
// Factory.createResource now working, with a utility method that uses
// reflection (via java.beans.Introspector) to set properties on a resource
// from the
//     parameter list fed to createResource.
//     resources may now have both an interface and a class; they are indexed
//        by interface type; the class is used to instantiate them
//     moved createResource from CR to Factory
//     removed Transients; use Factory instead
//
// Revision 1.3  2000/10/16 16:44:32  oana
// Changed the comment of DEBUG variable
//
// Revision 1.2  2000/10/10 15:36:34  oana
// Changed System.out in Out and System.err in Err;
// Added the DEBUG variable seted on false;
// Added in the header the licence;
//
// Revision 1.1  2000/09/20 17:03:37  kalina
// Added the tree viewer from the prototype. It works now with the new
// annotation API.
//
// Revision 1.6  1999/08/23 14:13:38  kalina
// Fixed resizing bugs in tree viewers
//
// Revision 1.5  1999/08/20 21:11:56  kalina
// Fixed most bugs and TreeViewer can now import and export annotations
// correctly
// There is still a delete bug somewhere.
//
// Revision 1.4  1999/08/18 17:55:24  kalina
// Added annotation export for the TreeViewer. Annotation import is the only
// thing that remains.
//
// Revision 1.3  1999/08/13 17:56:31  kalina
// Fixed the annotation of nodes in the TreeViewer to be done with click
//
// Revision 1.2  1999/08/12 16:10:12  kalina
// Added a new tree stereotype. Not in final version but would do for testing.
//
// Improved the tree viewer to allow dynamic creation of all nodes.
// Now I can build many trees or one tree; can delete non-terminal nodes;
// select/unselect nodes for annotation
// Overlapping trees are not a big problem too :-) Not wonderfully drawn but
// would do.
//
// Revision 1.1  1999/08/09 18:00:53  kalina
// Made the tree viewer to display an utterance/sentence annotation to start annotating them
//




© 2015 - 2025 Weber Informatics LLC | Privacy Policy