1 /*******************************************************************************
2 * Copyright (c) 2014 École Polytechnique de Montréal
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
10 * Geneviève Bastien - Initial API and implementation
11 *******************************************************************************/
13 package org
.eclipse
.tracecompass
.tmf
.analysis
.xml
.core
.model
;
15 import java
.util
.List
;
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
;
25 * Interface that describe operations on a state value described in an XML
28 * @author Geneviève Bastien
30 public interface ITmfXmlStateValue
{
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
38 * The current event or <code>null</code> if no event is
41 * The active scenario details. Or <code>null</code> if there is
43 * @return the {@link ITmfStateValue}
44 * @throws AttributeNotFoundException
45 * May be thrown by the state system during the query
48 ITmfStateValue
getValue(@Nullable ITmfEvent event
, @Nullable TmfXmlScenarioInfo scenarioInfo
) throws AttributeNotFoundException
;
51 * Get the value of the event field that is the path of this state value
55 * @return the value of the event field
57 ITmfStateValue
getEventFieldValue(ITmfEvent event
);
60 * Get the list of state attributes, the path to the state value
62 * @return the list of Attribute to have the path in the State System
64 List
<ITmfXmlStateAttribute
> getAttributes();
67 * Handles an event, by setting the value of the attribute described by the
68 * state attribute path in the state system.
71 * The event to process
73 * The active scenario details. Or <code>null</code> if there is
75 * @throws AttributeNotFoundException
76 * Pass through the exception it received
77 * @throws TimeRangeException
78 * Pass through the exception it received
79 * @throws StateValueTypeException
80 * Pass through the exception it received
83 void handleEvent(ITmfEvent event
, @Nullable TmfXmlScenarioInfo scenarioInfo
) throws AttributeNotFoundException
, StateValueTypeException
, TimeRangeException
;