/*
  Zeitrechnung - a class library to determine calendar events
  Copyright (c) 1984-2022 Ulrich Hilger, http://uhilger.de

  This program is free software: you can redistribute it and/or modify
  it under the terms of the GNU Affero 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 Affero General Public License for more details.

  You should have received a copy of the GNU Affero General Public License
  along with this program.  If not, see <http://www.gnu.org/licenses/>.
 */
package de.uhilger.zeitrechnung.ereignis;

import de.uhilger.zeitrechnung.Datum;
import de.uhilger.zeitrechnung.Definition;
import java.util.List;

/**
 * Die Schnittstelle Ereignis modelliert Kalenderereignisse in Form von 
 * Ereignis-Typen und bis zu vier Ganzzahl-Parametern, die je nach 
 * Ereignis-Typ den Zeitpunkt beschreiben, an dem ein Ereignis stattfindet.
 * 
 * Die Bedeutung und Verwendung der Parameter ist fuer jeden Ereignis-Typ 
 * in der Klassenbeschreibung des jeweiligen Ereignis-Typs enthalten.
 * 
 * @author Ulrich Hilger
 */
public interface Ereignis {

  /* Typnummer fuer DatumEreignis */
  public static final int TYP_DATUM = 1;
  
  /* Typnummer TagWocheMonatEreignis */
  public static final int TYP_TAG_WOCHE_MONAT = 2;
  
  /** Typnummer fuer TagDatumEreignis */
  public static final int TYP_TAG_DATUM = 3;
  
  /** Typnummer fuer OsterEreignis */
  public static final int TYP_OSTERN = 4;
  
  /** Typnummer fuer JahreszeitEreignis */
  public static final int TYP_JAHRESZEIT = 5;
  
  /** Typnummer fuer HebraeischesEreignis */
  public static final int TYP_HEBRAEISCH = 6;

  /** Typnummer fuer EinzelEreignis */
  public static final int TYP_EINZEL = 7;
  
  /** Typnummer fuer MuslimischesEreignis */
  public static final int TYP_MUSLIMISCH = 8;
  
  /** Typnummer fuer JulianischesEreignis */
  public static final int TYP_JULIANISCH = 9;
  
  /** Typnummer fuer ChinesischesEreignis */
  public static final int TYP_CHINESISCH = 10;
  
  public static final int GREGORIANISCHER_KALENDER = 1;
  public static final int JULIANISCHER_KALENDER = 2;
  
  /**
   * Den Typ des Ereignisses ermitteln
   * 
   * @return Ereignis.TYP_DATUM oder Ereignis.TYP_OSTERN oder 
   * Ereignis.TYP_WOCHENTAG_DATUM usw. 
   */
  public int getTyp();
  
  /**
   * Die Definition des Ereignisses ermitteln
   * @return das Definitionsobjekt fuer dieses Ereignis
   */
  public Definition getDefinition();
  
  /**
   * Die Definition dieses Ereignisses angeben
   * @param definition  das Definitionsobjekt dieses Ereignisses
   */
  public void setDefinition(Definition definition);
  
  /**
   * Die Tage eines Jahres im gregorianischen Kalendersystem 
   * ermitteln, an denen das Ereignis stattfindet.
   * 
   * @param isoJahr das Jahr im gregorianischen Kalender, 
   * fuer das ermittelt werden soll, an welchen Tagen das Ereignis stattfindet
   * @return die Liste aus Datum-Objekten, die die Tage im gregorianischen 
   * Kalender bezeichnet, an denen das Ereignis stattfindet
   */
  public List<Datum> getZeitpunkte(long isoJahr);
}