AnnotationsContentViewer.java

Go to the documentation of this file.

/*
 * Autopsy Forensic Browser
 *
 * Copyright 2018-2021 Basis Technology Corp.
 * Contact: carrier <at> sleuthkit <dot> org
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *     http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */
package org.sleuthkit.autopsy.contentviewers.annotations;
 
import com.google.common.collect.ImmutableSet;
import java.awt.Component;
import java.beans.PropertyChangeEvent;
import java.beans.PropertyChangeListener;
import java.util.EnumSet;
import java.util.Set;
import java.util.concurrent.ExecutionException;
import java.util.logging.Level;
import javax.swing.SwingWorker;
import org.apache.commons.lang3.tuple.Pair;
 
import static org.openide.util.NbBundle.Messages;
import org.openide.nodes.Node;
import org.openide.util.lookup.ServiceProvider;
import org.sleuthkit.autopsy.corecomponentinterfaces.DataContentViewer;
import org.sleuthkit.autopsy.coreutils.Logger;
import org.jsoup.nodes.Document;
import org.openide.util.WeakListeners;
import org.sleuthkit.autopsy.casemodule.Case;
import org.sleuthkit.autopsy.casemodule.events.BlackBoardArtifactTagAddedEvent;
import org.sleuthkit.autopsy.casemodule.events.BlackBoardArtifactTagDeletedEvent;
import org.sleuthkit.autopsy.casemodule.events.CommentChangedEvent;
import org.sleuthkit.autopsy.casemodule.events.ContentTagAddedEvent;
import org.sleuthkit.autopsy.casemodule.events.ContentTagDeletedEvent;
import org.sleuthkit.autopsy.contentviewers.annotations.AnnotationUtils.DisplayTskItems;
import org.sleuthkit.autopsy.contentviewers.layout.ContentViewerHtmlStyles;
import org.sleuthkit.autopsy.contentviewers.utils.ViewerPriority;
import org.sleuthkit.autopsy.ingest.IngestManager;
import org.sleuthkit.autopsy.ingest.ModuleDataEvent;
import org.sleuthkit.datamodel.BlackboardArtifact;

@SuppressWarnings("PMD.SingularField") // UI widgets cause lots of false positives
@ServiceProvider(service = DataContentViewer.class, position = 9)
@Messages({
    "AnnotationsContentViewer.title=Annotations",
    "AnnotationsContentViewer.toolTip=Displays tags and comments associated with the selected content.",
    "AnnotationsContentViewer.onEmpty=No annotations were found for this particular item."
})
public class AnnotationsContentViewer extends javax.swing.JPanel implements DataContentViewer {
 
    private static final long serialVersionUID = 1L;
    private static final Logger logger = Logger.getLogger(AnnotationsContentViewer.class.getName());
 
    private static final Set<Case.Events> CASE_EVENTS_OF_INTEREST = EnumSet.of(
            Case.Events.BLACKBOARD_ARTIFACT_TAG_ADDED,
            Case.Events.BLACKBOARD_ARTIFACT_TAG_DELETED,
            Case.Events.CONTENT_TAG_ADDED,
            Case.Events.CONTENT_TAG_DELETED,
            Case.Events.CR_COMMENT_CHANGED);
 
    private static final Set<IngestManager.IngestModuleEvent> INGEST_MODULE_EVENTS_OF_INTEREST = EnumSet.of(IngestManager.IngestModuleEvent.DATA_ADDED);

    @SuppressWarnings("deprecation")
    private static final Set<BlackboardArtifact.Type> ARTIFACT_TYPES_OF_INTEREST = ImmutableSet.of(
            BlackboardArtifact.Type.TSK_HASHSET_HIT,
            BlackboardArtifact.Type.TSK_INTERESTING_FILE_HIT,
            BlackboardArtifact.Type.TSK_INTERESTING_ITEM
    );
 
    private final PropertyChangeListener ingestEventListener = (evt) -> {
        Long curArtifactId = AnnotationsContentViewer.this.curArtifactId;
        Long curContentId = AnnotationsContentViewer.this.curContentId;
 
        if (curArtifactId == null && curContentId == null) {
            return;
        }
 
        // if it is a module data event
        if (IngestManager.IngestModuleEvent.DATA_ADDED.toString().equals(evt.getPropertyName())
                && evt.getOldValue() instanceof ModuleDataEvent) {
 
            ModuleDataEvent moduleDataEvent = (ModuleDataEvent) evt.getOldValue();
 
            // if an artifact is relevant, refresh
            if (ARTIFACT_TYPES_OF_INTEREST.contains(moduleDataEvent.getBlackboardArtifactType())) {
                for (BlackboardArtifact artifact : moduleDataEvent.getArtifacts()) {
                    if ((curArtifactId != null && artifact.getArtifactID() == curArtifactId)
                            || (curContentId != null && artifact.getObjectID() == curContentId)) {
                        refresh();
                        return;
                    }
                }
            }
        }
    };
 
    private final PropertyChangeListener weakIngestEventListener = WeakListeners.propertyChange(ingestEventListener, null);
 
    private final PropertyChangeListener caseEventListener = (evt) -> {
        Long curArtifactId = AnnotationsContentViewer.this.curArtifactId;
        Long curContentId = AnnotationsContentViewer.this.curContentId;
 
        if (curArtifactId == null && curContentId == null) {
            return;
        }
 
        Pair<Long, Long> artifactContentId = getIdsFromEvent(evt);
        Long artifactId = artifactContentId.getLeft();
        Long contentId = artifactContentId.getRight();
 
        // if there is a match of content id or artifact id and the event, refresh
        if ((curArtifactId != null && curArtifactId.equals(artifactId)) || (curContentId != null && curContentId.equals(contentId))) {
            refresh();
        }
    };
 
    private final PropertyChangeListener weakCaseEventListener = WeakListeners.propertyChange(caseEventListener, null);
 
    private final Object updateLock = new Object();
 
    private AnnotationWorker worker = null;
    private Node node;
    private Long curArtifactId;
    private Long curContentId;

    public AnnotationsContentViewer() {
        initComponents();
        ContentViewerHtmlStyles.setupHtmlJTextPane(textPanel);
        registerListeners();
    }

    private void registerListeners() {
        Case.addEventTypeSubscriber(CASE_EVENTS_OF_INTEREST, weakCaseEventListener);
        IngestManager.getInstance().addIngestModuleEventListener(INGEST_MODULE_EVENTS_OF_INTEREST, weakIngestEventListener);
    }
 
    @Override
    protected void finalize() throws Throwable {
        unregisterListeners();
    }

    private void unregisterListeners() {
        Case.removeEventTypeSubscriber(CASE_EVENTS_OF_INTEREST, weakCaseEventListener);
        IngestManager.getInstance().addIngestModuleEventListener(INGEST_MODULE_EVENTS_OF_INTEREST, weakIngestEventListener);
    }
 
    @Override
    public void setNode(Node node) {
        this.node = node;
        DisplayTskItems displayItems = AnnotationUtils.getDisplayContent(node);
        this.curArtifactId = displayItems.getArtifact() == null ? null : displayItems.getArtifact().getArtifactID();
        this.curContentId = displayItems.getContent() == null ? null : displayItems.getContent().getId();
        updateData(this.node, true);
    }

    private static Pair<Long, Long> getIdsFromEvent(PropertyChangeEvent evt) {
        Case.Events eventType = null;
        try {
            eventType = Case.Events.valueOf(evt.getPropertyName());
        } catch (IllegalArgumentException ex) {
            logger.log(Level.SEVERE, "Unknown event type: " + evt.getPropertyName(), ex);
            return Pair.of(null, null);
        }
 
        Long artifactId = null;
        Long contentId = null;
 
        switch (eventType) {
            case BLACKBOARD_ARTIFACT_TAG_ADDED:
                if (evt instanceof BlackBoardArtifactTagAddedEvent) {
                    BlackboardArtifact art = ((BlackBoardArtifactTagAddedEvent) evt).getAddedTag().getArtifact();
                    artifactId = art.getArtifactID();
                    contentId = art.getObjectID();
                }
                break;
            case BLACKBOARD_ARTIFACT_TAG_DELETED:
                if (evt instanceof BlackBoardArtifactTagDeletedEvent) {
                    artifactId = ((BlackBoardArtifactTagDeletedEvent) evt).getDeletedTagInfo().getArtifactID();
                    contentId = ((BlackBoardArtifactTagDeletedEvent) evt).getDeletedTagInfo().getContentID();
                }
                break;
            case CONTENT_TAG_ADDED:
                if (evt instanceof ContentTagAddedEvent) {
                    contentId = ((ContentTagAddedEvent) evt).getAddedTag().getContent().getId();
                }
                break;
            case CONTENT_TAG_DELETED:
                if (evt instanceof ContentTagDeletedEvent) {
                    contentId = ((ContentTagDeletedEvent) evt).getDeletedTagInfo().getContentID();
                }
                break;
            case CR_COMMENT_CHANGED:
                if (evt instanceof CommentChangedEvent) {
                    long commentObjId = ((CommentChangedEvent) evt).getContentID();
                    artifactId = commentObjId;
                    contentId = commentObjId;
                }
                break;
            default:
                break;
        };
 
        return Pair.of(artifactId, contentId);
    }

    private void refresh() {
        if (this.isVisible()) {
            updateData(this.node, false);
        }
    }

    private void updateData(Node node, boolean forceReset) {
        if (node == null) {
            return;
        }
 
        if (forceReset) {
            resetComponent();
        }
 
        synchronized (updateLock) {
            if (worker != null) {
                if (forceReset) {
                    worker.cancel(true);
                    worker = null;
                } else {
                    return;
                }
            }
 
            worker = new AnnotationWorker(node, forceReset);
            worker.execute();
        }
    }

    @SuppressWarnings("unchecked")
    // <editor-fold defaultstate="collapsed" desc="Generated Code">//GEN-BEGIN:initComponents
    private void initComponents() {
 
        javax.swing.JScrollPane scrollPane = new javax.swing.JScrollPane();
        textPanel = new javax.swing.JTextPane();
 
        setPreferredSize(new java.awt.Dimension(100, 58));
 
        textPanel.setEditable(false);
        textPanel.setName(""); // NOI18N
        textPanel.setPreferredSize(new java.awt.Dimension(600, 52));
        scrollPane.setViewportView(textPanel);
 
        javax.swing.GroupLayout layout = new javax.swing.GroupLayout(this);
        this.setLayout(layout);
        layout.setHorizontalGroup(
            layout.createParallelGroup(javax.swing.GroupLayout.Alignment.LEADING)
            .addComponent(scrollPane, javax.swing.GroupLayout.DEFAULT_SIZE, 907, Short.MAX_VALUE)
        );
        layout.setVerticalGroup(
            layout.createParallelGroup(javax.swing.GroupLayout.Alignment.LEADING)
            .addComponent(scrollPane, javax.swing.GroupLayout.Alignment.TRAILING, javax.swing.GroupLayout.DEFAULT_SIZE, 435, Short.MAX_VALUE)
        );
    }// </editor-fold>//GEN-END:initComponents
 
    // Variables declaration - do not modify//GEN-BEGIN:variables
    private javax.swing.JTextPane textPanel;
    // End of variables declaration//GEN-END:variables
 
    @Override
    public String getTitle() {
        return Bundle.AnnotationsContentViewer_title();
    }
 
    @Override
    public String getToolTip() {
        return Bundle.AnnotationsContentViewer_toolTip();
    }
 
    @Override
    public DataContentViewer createInstance() {
        return new AnnotationsContentViewer();
    }
 
    @Override
    public boolean isSupported(Node node) {
        return AnnotationUtils.isSupported(node);
    }
 
    @Override
    public int isPreferred(Node node) {
        return ViewerPriority.viewerPriority.LevelOne.getFlag();
    }
 
    @Override
    public Component getComponent() {
        return this;
    }
 
    @Override
    public void resetComponent() {
        textPanel.setText("");
 
    }

    private class AnnotationWorker extends SwingWorker<String, Void> {
 
        private final Node node;
        private final boolean resetCaretPosition;

        AnnotationWorker(Node node, boolean resetCaretPosition) {
            this.node = node;
            this.resetCaretPosition = resetCaretPosition;
        }
 
        @Override
        protected String doInBackground() throws Exception {
            Document doc = AnnotationUtils.buildDocument(node);
 
            if (isCancelled()) {
                return null;
            }
 
            if (doc != null) {
                return doc.html();
            } else {
                return "<span class='" + ContentViewerHtmlStyles.getMessageClassName() + "'>" + Bundle.AnnotationsContentViewer_onEmpty() + "</span>";
            }
        }
 
        @Override
        public void done() {
            if (!isCancelled()) {
                try {
                    String text = get();
                    ContentViewerHtmlStyles.setStyles(textPanel);
                    textPanel.setText(text);
 
                    if (resetCaretPosition) {
                        textPanel.setCaretPosition(0);
                    }
 
                } catch (InterruptedException | ExecutionException ex) {
                    logger.log(Level.SEVERE, "Failed to get annotation information for node", ex);
                }
            }
 
            synchronized (updateLock) {
                if (worker == this) {
                    worker = null;
                }
            }
        }
 
    }
}