de.bund.bfr.knime.pmm.js.common.Matrix.java Source code

Introduction

Here is the source code for de.bund.bfr.knime.pmm.js.common.Matrix.java

Source

/*******************************************************************************
 * Copyright (c) 2015 Federal Institute for Risk Assessment (BfR), Germany
 *
 * 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 3 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, see <http://www.gnu.org/licenses/>.
 *
 * Contributors:
 *     Department Biological Safety - BfR
 *******************************************************************************/
package de.bund.bfr.knime.pmm.js.common;

import org.knime.core.node.NodeSettingsRO;
import org.knime.core.node.NodeSettingsWO;

import com.fasterxml.jackson.annotation.JsonAutoDetect;
import com.fasterxml.jackson.annotation.JsonTypeInfo;
import com.google.common.base.Strings;

import de.bund.bfr.knime.pmm.common.MatrixXml;

/**
 * PmmLab matrix. Holds:
 * <ul>
 * <li>id
 * <li>name
 * <li>detail
 * <li>dbuuid
 * </ul>
 */
@JsonAutoDetect
@JsonTypeInfo(use = JsonTypeInfo.Id.CLASS, include = JsonTypeInfo.As.PROPERTY, property = "@class")
public class Matrix implements ViewValue {

    // Configuration keys
    static final String ID = "id";
    static final String NAME = "name";
    static final String DETAIL = "detail";
    static final String DBUUID = "dbuuid";

    private Integer id;
    private String name;
    private String detail;
    private String dbuuid;

    /**
     * Returns the id of this {@link Matrix}.
     * 
     * If not set returns null.
     * 
     * @return the id of this {@link Matrix}
     */
    public Integer getId() {
        return id;
    }

    /**
     * Returns the name of this {@link Matrix}.
     * 
     * If not set returns null.
     * 
     * @return the name of this {@link Matrix}.
     */
    public String getName() {
        return name;
    }

    /**
     * Returns the detail of this {@link Matrix}.
     * 
     * If not set returns null.
     * 
     * @return the name of this {@link Matrix}.
     */
    public String getDetail() {
        return detail;
    }

    /**
     * Returns the dbuuid of this {@link Matrix}.
     * 
     * If not set returns null.
     * 
     * @return the dbuuid of this {@link Matrix}.
     */
    public String getDbuuid() {
        return dbuuid;
    }

    /**
     * Sets the id of this {@link Matrix}.
     * 
     * @param id
     *            the id to be set
     */
    public void setId(Integer id) {
        this.id = id;
    }

    /**
     * Sets the name of this {@link Matrix}.
     * 
     * Empty strings are converted to null.
     * 
     * @param name
     *            the name to be set
     */
    public void setName(String name) {
        this.name = Strings.emptyToNull(name);
    }

    /**
     * Sets the detail of this {@link Matrix}.
     * 
     * Empty strings are converted to null.
     * 
     * @param detail
     *            the detail to be set
     */
    public void setDetail(String detail) {
        this.detail = Strings.emptyToNull(detail);
    }

    /**
     * Sets the dbuuid of this {@link Matrix}.
     * 
     * Empty strings are conveted to null.
     * 
     * @param dbuuid
     *            the dbuuid to be set
     */
    public void setDbuuid(String dbuuid) {
        this.dbuuid = Strings.emptyToNull(dbuuid);
    }

    /**
     * Saves matrix properties into a {@link NodeSettingsWO}.
     * 
     * @param settings
     *            settings where to save the {@link Matrix} properties
     */
    public void saveToNodeSettings(NodeSettingsWO settings) {
        SettingsHelper.addInt(ID, id, settings);
        SettingsHelper.addString(NAME, name, settings);
        SettingsHelper.addString(DETAIL, detail, settings);
        SettingsHelper.addString(DBUUID, dbuuid, settings);
    }

    /**
     * Loads matrix properties from a {@link NodeSettingsRO}.
     * 
     * @param settings
     *            the settings where to load the {@link Matrix} from
     */
    public void loadFromNodeSettings(NodeSettingsRO settings) {
        id = SettingsHelper.getInteger(ID, settings);
        name = SettingsHelper.getString(NAME, settings);
        detail = settings.getString(DETAIL, detail);
        dbuuid = settings.getString(DBUUID, dbuuid);
    }

    /**
     * Creates a Matrix from a MatrixXml.
     * 
     * @param matrixXml
     */
    public static Matrix toMatrix(MatrixXml matrixXml) {
        Matrix matrix = new Matrix();
        matrix.setId(matrixXml.getId());
        matrix.setName(matrixXml.getName());
        matrix.setDetail(matrixXml.getDetail());
        matrix.setDbuuid(matrixXml.getDbuuid());

        return matrix;
    }

    /**
     * Returns an equivalent MatrixXml.
     * 
     * @return an equivalent MatrixXml
     */
    public MatrixXml toMatrixXml() {
        return new MatrixXml(id, name, detail, dbuuid);
    }
}