tmf/org.eclipse.tracecompass.tmf.core/src/org/eclipse/tracecompass/tmf/core/event/ITmfEventField.java

/*******************************************************************************
 * Copyright (c) 2012, 2015 Ericsson
 *
 * All rights reserved. This program and the accompanying materials are
 * made available under the terms of the Eclipse Public License 2.0 which
 * accompanies this distribution, and is available at
 * https://www.eclipse.org/legal/epl-2.0/
 *
 * SPDX-License-Identifier: EPL-2.0
 *
 * Contributors:
 *   Francois Chouinard - Initial API and implementation
 *   Alexandre Montplaisir - Removed arrays from the API
 *   Patrick Tasse - Use ellipsis for getField and remove getSubField
 *******************************************************************************/

package org.eclipse.tracecompass.tmf.core.event;

import java.util.Collection;

import org.eclipse.jdt.annotation.NonNull;
import org.eclipse.jdt.annotation.Nullable;

import com.google.common.primitives.Doubles;
import com.google.common.primitives.Ints;
import com.google.common.primitives.Longs;

/**
 * The generic event payload in TMF. Each field can be either a terminal or
 * further decomposed into subfields.
 *
 * @version 1.0
 * @author Francois Chouinard
 *
 * @see ITmfEvent
 * @see ITmfEventType
 */
public interface ITmfEventField {

    // ------------------------------------------------------------------------
    // Constants
    // ------------------------------------------------------------------------

    /**
     * The root field id (the main container)
     */
    public static final @NonNull String ROOT_FIELD_ID = ":root:"; //$NON-NLS-1$

    // ------------------------------------------------------------------------
    // Getters
    // ------------------------------------------------------------------------

    /**
     * @return the field name
     */
    @NonNull String getName();

    /**
     * @return the field value
     */
    Object getValue();

    /**
     * @return the value formatted as string
     */
    String getFormattedValue();

    /**
     * Return the subfield names. The iteration order is the same as
     * {@link #getFields()}. The returned Collection is immutable.
     *
     * @return The subfield names (empty Collection if none)
     */
    @NonNull Collection<@NonNull String> getFieldNames();

    /**
     * Return the subfields. The iteration order is the same as
     * {@link #getFieldNames()}. The returned Collection is immutable.
     *
     * @return The subfields (empty Collection if none)
     */
    @NonNull Collection<? extends ITmfEventField> getFields();

    /**
     * Return a subfield by its path relative to this field.
     * If the path is empty, this field is returned.
     * @param path The path to the subfield
     * @return a specific subfield by path (null if inexistent)
     */
    ITmfEventField getField(String @NonNull ... path);

    /**
     * Retrieve the value of a field, given an expected name/path and a value
     * type.
     *
     * This is a utility method that will do the proper null and instanceof
     * checks on the returned values of {@link #getField} and {@link #getValue}
     * accordingly.
     *
     * @param type
     *            The expected type of this field, to which the returned value
     *            will then be cast to.
     * @param fieldName
     *            The name or path of the subfield to look for
     * @return The value if a field with this name exists and the value is of
     *         the correct type, or 'null' otherwise
     * @since 2.1
     */

    default <T> @Nullable T getFieldValue(@NonNull Class<T> type, @NonNull String @NonNull ... fieldName) {
        ITmfEventField field = getField(fieldName);
        if (field == null) {
            return null;
        }
        Object value = field.getValue();
        if (value == null) {
            return null;
        }
        if (type.isAssignableFrom(value.getClass())) {
            @SuppressWarnings("unchecked")
            T ret = (T) value;
            return ret;
        }
        // See if we can force a cast to some known type
        if (type.equals(String.class)) {
            @SuppressWarnings("unchecked")
            T ret = (T) String.valueOf(value);
            return ret;
        }
        if (type.equals(Long.class)) {
            if (Number.class.isAssignableFrom(value.getClass())) {
                @SuppressWarnings("unchecked")
                T ret = (T) ((Long) ((Number) value).longValue());
                return ret;
            }
            Long longVal = Longs.tryParse(String.valueOf(value));
            if (longVal != null) {
                @SuppressWarnings("unchecked")
                T ret = (T) longVal;
                return ret;
            }
            return null;
        }
        if (type.equals(Integer.class)) {
            if (Number.class.isAssignableFrom(value.getClass())) {
                @SuppressWarnings("unchecked")
                T ret = (T) ((Integer) ((Number) value).intValue());
                return ret;
            }
            Integer intVal = Ints.tryParse(String.valueOf(value));
            if (intVal != null) {
                @SuppressWarnings("unchecked")
                T ret = (T) intVal;
                return ret;
            }
            return null;
        }
        if (type.equals(Double.class)) {
            if (Number.class.isAssignableFrom(value.getClass())) {
                @SuppressWarnings("unchecked")
                T ret = (T) ((Double) ((Number) value).doubleValue());
                return ret;
            }
            Double dblVal = Doubles.tryParse(String.valueOf(value));
            if (dblVal != null) {
                @SuppressWarnings("unchecked")
                T ret = (T) dblVal;
                return ret;
            }
            return null;
        }
        return null;
    }

}