PersonaMetadata.java

Go to the documentation of this file.

/*
 * Central Repository
 *
 * 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.centralrepository.datamodel;
 
import java.sql.ResultSet;
import java.sql.SQLException;
import java.time.Instant;
import java.util.ArrayList;
import java.util.Collection;
import java.util.Collections;
import java.util.List;
import org.apache.commons.lang3.StringUtils;

public class PersonaMetadata {
 
    private static final String SELECT_QUERY_BASE
            = "SELECT pmd.id, pmd.persona_id, pmd.name, pmd.value, pmd.justification, pmd.confidence_id, pmd.date_added, pmd.examiner_id, e.login_name, e.display_name "
            + "FROM persona_metadata as pmd "
            + "INNER JOIN examiners as e ON e.id = pmd.examiner_id ";
 
    private final long id;
    private final long personaId;
    private final String name;
    private final String value;
    private final String justification;
    private final Persona.Confidence confidence;
    private final long dateAdded;
    private final CentralRepoExaminer examiner;
 
    public long getId() {
        return id;
    }
 
    public long getPersonaId() {
        return personaId;
    }
 
    public String getName() {
        return name;
    }
 
    public String getValue() {
        return value;
    }
 
    public String getJustification() {
        return justification;
    }
 
    public Persona.Confidence getConfidence() {
        return confidence;
    }
 
    public long getDateAdded() {
        return dateAdded;
    }
 
    public CentralRepoExaminer getExaminer() {
        return examiner;
    }
 
    public PersonaMetadata(long id, long personaId, String name, String value, String justification, Persona.Confidence confidence, long dateAdded, CentralRepoExaminer examiner) {
        this.id = id;
        this.personaId = personaId;
        this.name = name;
        this.value = value;
        this.justification = justification;
        this.confidence = confidence;
        this.dateAdded = dateAdded;
        this.examiner = examiner;
    }

    static PersonaMetadata addPersonaMetadata(long personaId, String name, String value, String justification, Persona.Confidence confidence) throws CentralRepoException {
 
        CentralRepoExaminer examiner = getCRInstance().getOrInsertExaminer(System.getProperty("user.name"));
 
        Instant instant = Instant.now();
        Long timeStampMillis = instant.toEpochMilli();
 
        String insertSQL = "INSERT INTO persona_metadata (persona_id, name, value, justification, confidence_id, date_added, examiner_id ) "
                + "VALUES ( ?, ?, ?, ?, ?, ?, ?)";
 
        List<Object> params = new ArrayList<>();
        params.add(personaId);
        params.add(name);
        params.add(value);
        params.add(StringUtils.isBlank(justification) ? "" : justification);
        params.add(confidence.getLevelId());
        params.add(timeStampMillis);
        params.add(examiner.getId());
 
        getCRInstance().executeCommand(insertSQL, params);
 
        String queryClause = SELECT_QUERY_BASE
                + "WHERE pmd.persona_id = ?"
                + " AND pmd.name = ?"
                + " AND pmd.value = ?"
                + " AND pmd.date_added = ?"
                + " AND pmd.examiner_id = ?";
 
        List<Object> queryParams = new ArrayList<>();
        queryParams.add(personaId);
        queryParams.add(name);
        queryParams.add(value);
        queryParams.add(timeStampMillis);
        queryParams.add(examiner.getId());
 
        PersonaMetadataQueryCallback queryCallback = new PersonaMetadataQueryCallback();
        getCRInstance().executeQuery(queryClause, queryParams, queryCallback);
 
        Collection<PersonaMetadata> metadata = queryCallback.getMetadataList();
        if (metadata.size() != 1) {
            throw new CentralRepoException("Metadata add query failed");
        }
 
        return metadata.iterator().next();
    }

    static void removePersonaMetadata(PersonaMetadata metadata) throws CentralRepoException {
        String deleteSql = " DELETE FROM persona_metadata WHERE id = ?";
 
        List<Object> params = new ArrayList<>();
        params.add(metadata.getId());
 
        getCRInstance().executeCommand(deleteSql, params);
    }

    static void modifyPersonaMetadata(PersonaMetadata metadata, Persona.Confidence confidence, String justification) throws CentralRepoException {
        CentralRepository cr = CentralRepository.getInstance();
 
        if (cr == null) {
            throw new CentralRepoException("Failed to modify persona metadata, Central Repo is not enabled");
        }
 
        String updateSql = "UPDATE persona_metadata SET confidence_id = ?, justification = ? WHERE id = ?";
 
        List<Object> params = new ArrayList<>();
        params.add(confidence.getLevelId());
        params.add(StringUtils.isBlank(justification) ? "" : justification);
        params.add(metadata.id);
 
        getCRInstance().executeCommand(updateSql, params);
    }

    private static class PersonaMetadataQueryCallback implements CentralRepositoryDbQueryCallback {
 
        Collection<PersonaMetadata> personaMetadataList = new ArrayList<>();
 
        @Override
        public void process(ResultSet rs) throws SQLException {
 
            while (rs.next()) {
                CentralRepoExaminer examiner = new CentralRepoExaminer(
                        rs.getInt("examiner_id"),
                        rs.getString("login_name"));
 
                PersonaMetadata metaData = new PersonaMetadata(
                        rs.getLong("id"),
                        rs.getLong("persona_id"),
                        rs.getString("name"),
                        rs.getString("value"),
                        rs.getString("justification"),
                        Persona.Confidence.fromId(rs.getInt("confidence_id")),
                        Long.parseLong(rs.getString("date_added")),
                        examiner);
 
                personaMetadataList.add(metaData);
            }
        }
 
        Collection<PersonaMetadata> getMetadataList() {
            return Collections.unmodifiableCollection(personaMetadataList);
        }
    };

    static Collection<PersonaMetadata> getPersonaMetadata(long personaId) throws CentralRepoException {
        String queryClause = SELECT_QUERY_BASE
                + "WHERE pmd.persona_id = ?";
 
        List<Object> params = new ArrayList<>();
        params.add(personaId);
 
        PersonaMetadataQueryCallback queryCallback = new PersonaMetadataQueryCallback();
        getCRInstance().executeQuery(queryClause, params, queryCallback);
 
        return queryCallback.getMetadataList();
 
    }

    private static CentralRepository getCRInstance() throws CentralRepoException {
        CentralRepository instance = CentralRepository.getInstance();
 
        if (instance == null) {
            throw new CentralRepoException("Failed to get instance of CentralRespository, CR was null");
        }
 
        return instance;
    }
}