tmf/org.eclipse.tracecompass.tmf.analysis.xml.core/src/org/eclipse/tracecompass/internal/tmf/analysis/xml/core/model/ITmfXmlStateValue.java

   1 /*******************************************************************************
   2  * Copyright (c) 2014 École Polytechnique de Montréal
   3  *
   4  * All rights reserved. This program and the accompanying materials are
   5  * made available under the terms of the Eclipse Public License v1.0 which
   6  * accompanies this distribution, and is available at
   7  * http://www.eclipse.org/legal/epl-v10.html
   8  *
   9  * Contributors:
  10  *   Geneviève Bastien - Initial API and implementation
  11  *******************************************************************************/
  12
  13 package org.eclipse.tracecompass.internal.tmf.analysis.xml.core.model;
  14
  15 import java.util.List;
  16
  17 import org.eclipse.jdt.annotation.Nullable;
  18 import org.eclipse.tracecompass.statesystem.core.exceptions.AttributeNotFoundException;
  19 import org.eclipse.tracecompass.statesystem.core.exceptions.StateValueTypeException;
  20 import org.eclipse.tracecompass.statesystem.core.exceptions.TimeRangeException;
  21 import org.eclipse.tracecompass.statesystem.core.statevalue.ITmfStateValue;
  22 import org.eclipse.tracecompass.tmf.core.event.ITmfEvent;
  23
  24 /**
  25  * Interface that describe operations on a state value described in an XML
  26  * element
  27  *
  28  * @author Geneviève Bastien
  29  */
  30 public interface ITmfXmlStateValue {
  31
  32     /**
  33      * Get the current {@link ITmfStateValue} of this state value for an event.
  34      * It does not increment the value and does not any other processing of the
  35      * value.
  36      *
  37      * @param event
  38      *            The current event or <code>null</code> if no event is
  39      *            available.
  40      * @param scenarioInfo
  41      *            The active scenario details. Or <code>null</code> if there is
  42      *            no scenario.
  43      * @return the {@link ITmfStateValue}
  44      * @throws AttributeNotFoundException
  45      *             May be thrown by the state system during the query
  46      */
  47     ITmfStateValue getValue(@Nullable ITmfEvent event, @Nullable TmfXmlScenarioInfo scenarioInfo) throws AttributeNotFoundException;
  48
  49     /**
  50      * Get the value of the event field that is the path of this state value
  51      *
  52      * @param event
  53      *            The current event
  54      * @return the value of the event field
  55      */
  56     ITmfStateValue getEventFieldValue(ITmfEvent event);
  57
  58     /**
  59      * Get the list of state attributes, the path to the state value
  60      *
  61      * @return the list of Attribute to have the path in the State System
  62      */
  63     List<ITmfXmlStateAttribute> getAttributes();
  64
  65     /**
  66      * Handles an event, by setting the value of the attribute described by the
  67      * state attribute path in the state system.
  68      *
  69      * @param event
  70      *            The event to process
  71      * @param scenarioInfo
  72      *            The active scenario details. Or <code>null</code> if there is
  73      *            no scenario.
  74      * @throws AttributeNotFoundException
  75      *             Pass through the exception it received
  76      * @throws TimeRangeException
  77      *             Pass through the exception it received
  78      * @throws StateValueTypeException
  79      *             Pass through the exception it received
  80      */
  81     void handleEvent(ITmfEvent event, @Nullable TmfXmlScenarioInfo scenarioInfo) throws AttributeNotFoundException, StateValueTypeException, TimeRangeException;
  82
  83 }