EventUpdateHandler.java

Go to the documentation of this file.

/*
 * Autopsy Forensic Browser
 *
 * Copyright 2020 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.datasourcesummary.uiutils;
 
import java.beans.PropertyChangeEvent;
import java.beans.PropertyChangeListener;
import java.util.Set;
import org.sleuthkit.autopsy.casemodule.Case;
import org.sleuthkit.autopsy.guiutils.RefreshThrottler;
import org.sleuthkit.autopsy.ingest.IngestManager;
import org.sleuthkit.autopsy.ingest.IngestManager.IngestJobEvent;
import org.sleuthkit.autopsy.ingest.ModuleContentEvent;
import org.sleuthkit.autopsy.ingest.ModuleDataEvent;
import org.sleuthkit.datamodel.AbstractFile;

public class EventUpdateHandler {

    private final RefreshThrottler refreshThrottler = new RefreshThrottler(new RefreshThrottler.Refresher() {
        @Override
        public void refresh() {
            // delegate to EventUpdateHandler method.
            EventUpdateHandler.this.onRefresh();
        }
 
        @Override
        public boolean isRefreshRequired(PropertyChangeEvent evt) {
            String eventType = evt.getPropertyName();
            if (Case.isCaseOpen()) {
                if (IngestManager.IngestModuleEvent.DATA_ADDED.toString().equals(eventType) && evt.getOldValue() instanceof ModuleDataEvent) {
                    ModuleDataEvent dataEvent = (ModuleDataEvent) evt.getOldValue();
                    return EventUpdateHandler.this.isRefreshRequired(dataEvent);
                } else if (IngestManager.IngestModuleEvent.CONTENT_CHANGED.toString().equals(eventType) && evt.getOldValue() instanceof ModuleContentEvent) {
                    ModuleContentEvent contentEvent = (ModuleContentEvent) evt.getOldValue();
                    return EventUpdateHandler.this.isRefreshRequired(contentEvent);
                } else if (IngestManager.IngestModuleEvent.FILE_DONE.toString().equals(eventType) && evt.getNewValue() instanceof AbstractFile) {
                    AbstractFile analyzedFile = (AbstractFile) evt.getNewValue();
                    return EventUpdateHandler.this.isRefreshRequired(analyzedFile);
                }
            }
            return false;
        }
    });

    private final PropertyChangeListener caseEventsListener = (evt) -> {
        if (isRefreshRequiredForCaseEvent(evt)) {
            onRefresh();
        }
    };
 
    private final PropertyChangeListener ingestJobEventsListener = (evt) -> {
        if (evt == null) {
            return;
        }
 
        String eventName = evt.getPropertyName();
        for (IngestJobEvent ingestEvt : IngestJobEvent.values()) {
            if (ingestEvt.name().equals(eventName) && isRefreshRequired(ingestEvt)) {
                onRefresh();
            }
        }
    };
 
    private final UpdateGovernor governor;
    private final Set<Case.Events> caseEvents;
    private final Set<IngestJobEvent> ingestEvents;
    private final Runnable onUpdate;

    public EventUpdateHandler(Runnable onUpdate, UpdateGovernor governor) {
        if (onUpdate == null) {
            throw new IllegalArgumentException("onUpdate parameter must be non-null.");
        }
 
        this.onUpdate = onUpdate;
        this.governor = governor;
        this.caseEvents = governor.getCaseEventUpdates();
        this.ingestEvents = governor.getIngestJobEventUpdates();
    }

    protected boolean isRefreshRequired(ModuleDataEvent evt) {
        return governor.isRefreshRequired(evt);
    }

    protected boolean isRefreshRequired(ModuleContentEvent evt) {
        return governor.isRefreshRequired(evt);
    }

    protected boolean isRefreshRequired(AbstractFile evt) {
        return governor.isRefreshRequired(evt);
    }

    protected boolean isRefreshRequired(IngestJobEvent evt) {
        return governor.isRefreshRequired(evt);
    }

    protected boolean isRefreshRequiredForCaseEvent(PropertyChangeEvent evt) {
        return governor.isRefreshRequiredForCaseEvent(evt);
    }

    protected void onRefresh() {
        onUpdate.run();
    }

    public void register() {
        if (!caseEvents.isEmpty()) {
            Case.addEventTypeSubscriber(caseEvents, caseEventsListener);
        }
 
        IngestManager.getInstance().addIngestJobEventListener(ingestEvents, ingestJobEventsListener);
        refreshThrottler.registerForIngestModuleEvents();
    }

    public void unregister() {
        if (!caseEvents.isEmpty()) {
            Case.removeEventTypeSubscriber(caseEvents, caseEventsListener);
        }
 
        IngestManager.getInstance().removeIngestJobEventListener(ingestEvents, ingestJobEventsListener);
        refreshThrottler.unregisterEventListener();
    }
}