///////////////////////////////////////////////////////////////////////////////
// 
// This file is part of Serleena.
// 
// The MIT License (MIT)
//
// Copyright (C) 2015 Antonio Cavestro, Gabriele Pozzan, Matteo Lisotto, 
//   Nicola Mometto, Filippo Sestini, Tobia Tesan, Sebastiano Valle.    
//
// Permission is hereby granted, free of charge, to any person obtaining a copy
// of this software and associated documentation files (the "Software"), to 
// deal in the Software without restriction, including without limitation the
// rights to use, copy, modify, merge, publish, distribute, sublicense, and/or
// sell copies of the Software, and to permit persons to whom the Software is
// furnished to do so, subject to the following conditions:
//
// The above copyright notice and this permission notice shall be included in
// all copies or substantial portions of the Software.
//
// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS
// IN THE SOFTWARE.
//
///////////////////////////////////////////////////////////////////////////////


/**
 * Name: ITelemetry
 * Package: com.hitchikers.serleena.model
 * Author: Tobia Tesan <tobia.tesan@gmail.com>
 * Date: 2015-05-05
 *
 * History:
 * Version    Programmer    Date        Changes
 * 1.0        Tobia Tesan   2015-05-05  Creazione del file
 */

package com.kyloth.serleena.model;

import com.kyloth.serleena.common.TelemetryEvent;
import com.kyloth.serleena.common.TelemetryEventType;

/**
 * Interfaccia realizzata da oggetti che rappresentano un
 * Tracciamento
 *
 * @author  Tobia Tesan <tobia.tesan@gmail.com>
 * @version 1.0
 * @since   1.0
 */
public interface ITelemetry {

    /**
     * Restituisce gli eventi che costituiscono il Tracciamento.
     *
     * @return  Un Iterable che contiene tutti gli eventi del Tracciamento.
     * @version 1.0
     */
    public Iterable<TelemetryEvent> getEvents();

    /**
     * Restituisce gli eventi che costituiscono il Tracciamento, filtrati
     * secondo un intervallo di tempo specificato.
     *
     * @return  Insieme enumerabile che contiene tutti gli eventi del
     *          Tracciamento compresi nell'intervallo di secondi specificato.
     * @param from L'inizio dell'intervallo, comprensivo degli
     *             eventi da restituire, espresso in secondi dall'avvio del
     *             Tracciamento.
     *             Se from > to, viene sollevata un'eccezione
     *             IllegalArgumentException.
     * @param to L'inizio dell'intervallo, comprensivo degli
     *           eventi da restituire, espresso in secondi dall'avvio del
     *           Tracciamento.
     *           Se from > to, viene sollevata un'eccezione
     *           IllegalArgumentException.
     * @version 1.0
     */
    public Iterable<TelemetryEvent> getEvents(int from, int to)
            throws IllegalArgumentException;

    /**
     * Restituisce gli eventi che costituiscono il Tracciamento, filtrati in
     * base a uno specifico tipo di evento.
     *
     * @return  Insieme enumerabile che contiene tutti e soli gli eventi del
     *          Tracciamento di tipo specificato.
     * @param type Tipo di eventi da restituire.
     * @version 1.0
     */
    public Iterable<TelemetryEvent> getEvents(TelemetryEventType type);

    /**
     * Restituisce la durata totale del Tracciamento.
     *
     * @return  Durata temporale in secondi del Tracciamento.
     * @version 1.0
     */
    public int getDuration();

}

@@ -3572,35 +3572,77 @@
 re.%0A     * @
-version 1.0
+return Insieme enumerabile di eventi di Tracciamento.
 %0A     */%0A   
@@ -3708,16 +3708,65 @@
 pe type)
+%0A            throws NoSuchTelemetryEventException
 ;%0A%0A    /

Modifica signature e javadoc ITelemetry.getEvents()