Package de.svws_nrw.data.gost

Klasse DataGostBlockungsergebnisse

java.lang.Object
de.svws_nrw.data.DataManager<Long>
de.svws_nrw.data.gost.DataGostBlockungsergebnisse
public final class DataGostBlockungsergebnisse extends DataManager<Long>
Diese Klasse erweitert den abstrakten DataManager für den Core-DTO GostBlockungsergebnis.

  • Konstruktordetails

  • Methodendetails

    • getAll

      public jakarta.ws.rs.core.Response getAll()
      Beschreibung aus Klasse kopiert: DataManager
      Ermittelt eine Liste mit allen Informationen in der DB. Wird üblicherweise durch GET-Methoden für Listen verwendet. Meist ist die Methode getList zu bevorzugen.
      Angegeben von:
      getAll in Klasse DataManager<Long>
      Gibt zurück:
      eine Liste mit den Informationen

    • getList

      public jakarta.ws.rs.core.Response getList()
      Beschreibung aus Klasse kopiert: DataManager
      Ermittelt eine Liste mit Informationen. Wird üblicherweise durch GET-Methoden für Listen verwendet. Bei dieser Liste werden ggf. Filter verwendet (z.B. nur als sichtbar markierte Einträge)
      Angegeben von:
      getList in Klasse DataManager<Long>
      Gibt zurück:
      eine Liste mit den Informationen

    • getErgebnisListe

      public static void getErgebnisListe(@NotNull @NotNull DBEntityManager conn, @NotNull @NotNull GostBlockungsdatenManager datenManager) throws ApiOperationException
      Bestimmt die Liste der Blockungsergebnisse und das aktuelle Blockungsergebnis für den angegebenen Blockungsdaten-Manager
      Parameter:
      conn - die Datenbankverbindung
      datenManager - der Blockungsdaten-Manager
      Löst aus:
      ApiOperationException - im Fehlerfall

    • getErgebnismanager

      public static GostBlockungsergebnisManager getErgebnismanager(@NotNull @NotNull DBEntityManager conn, @NotNull @NotNull DTOGostBlockungZwischenergebnis ergebnis, @NotNull @NotNull GostBlockungsdatenManager datenManager) throws ApiOperationException
      Liest die Daten für das Blockungsergebnis aus der Datenbank ein und erstellt den dazugehörigen Ergebnis-Manager
      Parameter:
      conn - die Datenbankverbindung
      ergebnis - das Datenbank-DTO des Blockungsergebnisses
      datenManager - der Blockungsdaten-Manager
      Gibt zurück:
      der Manager für das Blockungsergebnis
      Löst aus:
      ApiOperationException - falls das Ergebnis nicht in der Datenbank existiert.

    • getErgebnis

      public static GostBlockungsergebnis getErgebnis(@NotNull @NotNull DBEntityManager conn, @NotNull @NotNull DTOGostBlockungZwischenergebnis ergebnis, @NotNull @NotNull GostBlockungsdatenManager datenManager) throws ApiOperationException
      Liest die Daten für das Blockungsergebnis aus der Datenbank ein und erstellt das zugehörige Core-DTO
      Parameter:
      conn - die Datenbankverbindung
      ergebnis - das Datenbank-DTO des Blockungsergebnisses
      datenManager - der Blockungsdaten-Manager
      Gibt zurück:
      das Core-DTO für das Blockungsergebnis
      Löst aus:
      ApiOperationException - falls das Ergebnis nicht in der Datenbank existiert.

    • getErgebnisFromID

      public static GostBlockungsergebnis getErgebnisFromID(@NotNull @NotNull DBEntityManager conn, long id) throws ApiOperationException
      Liest die Daten für das Blockungsergebnis aus der Datenbank ein und erstellt das zugehörige Core-DTO
      Parameter:
      conn - die Datenbankverbindung
      id - die ID des Blockungsergebnisses aus der Datenbank
      Gibt zurück:
      das Core-DTO für das Blockungsergebnis
      Löst aus:
      ApiOperationException - falls das Ergebnis nicht in der Datenbank existiert.

    • getErgebnismanagerFromID

      public static GostBlockungsergebnisManager getErgebnismanagerFromID(@NotNull @NotNull DBEntityManager conn, long id) throws ApiOperationException
      Erzeugt den Blockungsergebnis-Manager für die übergeben Ergebnis-ID aus der Datenbank.
      Parameter:
      conn - die Datenbankverbindung
      id - die ID des Blockungsergebnisses aus der Datenbank
      Gibt zurück:
      der Blockungsergebnis-Manager
      Löst aus:
      ApiOperationException - falls das Ergebnis nicht in der Datenbank existiert.

    • get

      public jakarta.ws.rs.core.Response get(Long id) throws ApiOperationException
      Beschreibung aus Klasse kopiert: DataManager
      Ermittelt die Informationen anhand der angegebenen ID. Wird üblicherweise durch GET-Methoden verwendet.
      Angegeben von:
      get in Klasse DataManager<Long>
      Parameter:
      id - die ID der gesuchten Informationen
      Gibt zurück:
      die Information mit der angebenen ID
      Löst aus:
      ApiOperationException - im Fehlerfall

    • patch

      public jakarta.ws.rs.core.Response patch(Long id, InputStream is) throws ApiOperationException
      Beschreibung aus Klasse kopiert: DataManager
      Passt die Informationen mithilfe des JSON-Patches aus dem übergebenen InputStream an.
      Angegeben von:
      patch in Klasse DataManager<Long>
      Parameter:
      id - die ID der anzupassenden Informationen
      is - der InputStream mit dem JSON-Patch
      Gibt zurück:
      Die HTTP-Response der Patch-Operation
      Löst aus:
      ApiOperationException - im Fehlerfall

    • delete

      public jakarta.ws.rs.core.Response delete(Long id) throws ApiOperationException
      Entfernt das Zwischenergebnis mit der angegebenen ID aus der Datenbank.
      Parameter:
      id - die ID des zu löschenden Blockungsergebnis
      Gibt zurück:
      die HTTP-Response, welchen den Erfolg der Lösch-Operation angibt.
      Löst aus:
      ApiOperationException - im Fehlerfall

    • deleteMultiple

      public jakarta.ws.rs.core.Response deleteMultiple(List<Long> ids) throws ApiOperationException
      Entfernt die Zwischenergebnis mit den angegebenen IDs aus der Datenbank.
      Parameter:
      ids - die IDs der zu löschenden Blockungsergebnisse
      Gibt zurück:
      die HTTP-Response, welchen den Erfolg der Lösch-Operation angibt.
      Löst aus:
      ApiOperationException - im Fehlerfall

    • markiereErgebnisAktiv

      public static DTOGostBlockungZwischenergebnis markiereErgebnisAktiv(DBEntityManager conn, long idErgebnis, boolean aktiv) throws ApiOperationException
      Markiert das Blockungsergebnis als aktiv und alle anderen Ergebnisse der Blockung als inaktiv, wenn der Wert auf true gesetzt ist und ansonsten nur das angegebene Blockungsergebnis auf inaktiv
      Parameter:
      conn - die Datenbankverbindung
      idErgebnis - die ID des Blockungsergebnisses
      aktiv - gibt an,
      Gibt zurück:
      das DTO zur Blockung, falls damit weitergearbeitet werden soll
      Löst aus:
      ApiOperationException - im Fehlerfall

    • createKursSchuelerZuordnung

      public jakarta.ws.rs.core.Response createKursSchuelerZuordnung(Long idZwischenergebnis, Long idSchueler, Long idKurs) throws ApiOperationException
      Erstellt eine Kurs-Schüler-Zuordnung in der Datenbank.
      Parameter:
      idZwischenergebnis - die ID der Zwischenergebnis
      idSchueler - die ID des Schülers
      idKurs - die ID des neuen Kurses
      Gibt zurück:
      die HTTP-Response, welchen den Erfolg der Update-Operation angibt.
      Löst aus:
      ApiOperationException - im Fehlerfall

    • updateKursSchuelerZuordnung

      public jakarta.ws.rs.core.Response updateKursSchuelerZuordnung(Long idZwischenergebnis, Long idSchueler, Long idKursAlt, Long idKursNeu) throws ApiOperationException
      Aktualisiert eine Kurs-Schüler-Zuordnung in der Datenbank.
      Parameter:
      idZwischenergebnis - die ID der Zwischenergebnis
      idSchueler - die ID des Schülers
      idKursAlt - die ID des alten Kurses
      idKursNeu - die ID des neuen Kurses
      Gibt zurück:
      die HTTP-Response, welchen den Erfolg der Update-Operation angibt.
      Löst aus:
      ApiOperationException - im Fehlerfall

    • updateKursSchuelerZuordnungen

      public jakarta.ws.rs.core.Response updateKursSchuelerZuordnungen(Long idZwischenergebnis, @NotNull @NotNull GostBlockungsergebnisKursSchuelerZuordnungUpdate update) throws ApiOperationException
      Entfernt alle zum Entfernen angegebenen Kurs-Schüler-Zuordnungen und fügt anschließend alle zum Hinzufügen angegebenen Kurs-Schüler-Zuordnungen hinzu.
      Parameter:
      idZwischenergebnis - die ID des Blockungsergebnisses, bei dem die Zuordnungen vorgenommen werden sollen
      update - die zu entfernenden Kurs-Schüler-Zuordnungen und die hinzuzufügenden Kurs-Schüler-Zuordnungen
      Gibt zurück:
      die HTTP-Response, welchen den Erfolg der Update-Operation angibt.
      Löst aus:
      ApiOperationException - im Fehlerfall

    • deleteKursSchuelerZuordnung

      public jakarta.ws.rs.core.Response deleteKursSchuelerZuordnung(Long idZwischenergebnis, Long idSchueler, Long idKurs) throws ApiOperationException
      Entfernt die die Zuordnung des Schüler zu dem Kurs bei einem Zwischenergebnis.
      Parameter:
      idZwischenergebnis - die ID der Zwischenergebnis
      idSchueler - die ID des Schülers
      idKurs - die ID des Kurses
      Gibt zurück:
      die HTTP-Response, welchen den Erfolg der Lösch-Operation angibt.
      Löst aus:
      ApiOperationException - im Fehlerfall

    • deleteKursSchuelerZuordnungen

      public jakarta.ws.rs.core.Response deleteKursSchuelerZuordnungen(Long idZwischenergebnis, @NotNull @NotNull List<@NotNull GostBlockungsergebnisKursSchuelerZuordnung> zuordnungen) throws ApiOperationException
      Entfernt die die Zuordnungen von Schülern zu Kursen bei einem Zwischenergebnis.
      Parameter:
      idZwischenergebnis - die ID der Zwischenergebnis
      zuordnungen - die Kurs-Schüler-Zuordnungen
      Gibt zurück:
      die HTTP-Response, welchen den Erfolg der Lösch-Operation angibt.
      Löst aus:
      ApiOperationException - im Fehlerfall

    • createKursSchieneZuordnung

      public jakarta.ws.rs.core.Response createKursSchieneZuordnung(Long idZwischenergebnis, Long idSchiene, Long idKurs) throws ApiOperationException
      Erstellt eine Kurs-Schienen-Zuordnung in der Datenbank.
      Parameter:
      idZwischenergebnis - die ID der Zwischenergebnis
      idSchiene - die ID der Schiene
      idKurs - die ID des neuen Kurses
      Gibt zurück:
      die HTTP-Response, welchen den Erfolg der Update-Operation angibt.
      Löst aus:
      ApiOperationException - im Fehlerfall

    • updateKursSchieneZuordnung

      public jakarta.ws.rs.core.Response updateKursSchieneZuordnung(Long idZwischenergebnis, Long idKurs, Long idSchieneAlt, Long idSchieneNeu) throws ApiOperationException
      Aktualisiert eine Kurs-Schiene-Zuordnung in der Datenbank.
      Parameter:
      idZwischenergebnis - die ID der Zwischenergebnis
      idKurs - die ID des Kurses
      idSchieneAlt - die ID der alten Schiene
      idSchieneNeu - die ID der neuen Schiene
      Gibt zurück:
      die HTTP-Response, welchen den Erfolg der Update-Operation angibt.
      Löst aus:
      ApiOperationException - im Fehlerfall

    • deleteKursSchieneZuordnung

      public jakarta.ws.rs.core.Response deleteKursSchieneZuordnung(Long idZwischenergebnis, Long idSchiene, Long idKurs) throws ApiOperationException
      Entfernt die die Zuordnung des Kurses zu der Schiene bei einem Zwischenergebnis.
      Parameter:
      idZwischenergebnis - die ID der Zwischenergebnis
      idSchiene - die ID der Schiene
      idKurs - die ID des Kurses
      Gibt zurück:
      die HTTP-Response, welchen den Erfolg der Lösch-Operation angibt.
      Löst aus:
      ApiOperationException - im Fehlerfall

    • deleteKursSchieneZuordnungen

      public jakarta.ws.rs.core.Response deleteKursSchieneZuordnungen(Long idZwischenergebnis, @NotNull @NotNull List<@NotNull GostBlockungsergebnisKursSchienenZuordnung> zuordnungen) throws ApiOperationException
      Entfernt die die Zuordnungen von Kursen zu Schienen bei einem Zwischenergebnis.
      Parameter:
      idZwischenergebnis - die ID der Zwischenergebnis
      zuordnungen - die Kurs-Schienen-Zuordnungen
      Gibt zurück:
      die HTTP-Response, welchen den Erfolg der Lösch-Operation angibt.
      Löst aus:
      ApiOperationException - im Fehlerfall

    • persist

      public jakarta.ws.rs.core.Response persist(Long idErgebnis) throws ApiOperationException
      Aktiviert bzw. persistiert das Blockungsergebnis in der Kursliste und in den Leistungsdaten der Schüler des Abiturjahrgangs
      Parameter:
      idErgebnis - das zu persistierende Blockungsergebnis
      Gibt zurück:
      die HTTP-Response, welchen den Erfolg der Operation angibt
      Löst aus:
      ApiOperationException - im Fehlerfall

    • unpersist

      public static jakarta.ws.rs.core.Response unpersist(DBEntityManager conn, int abiturjahr, int idHalbjahr) throws ApiOperationException
      Entfernt die Leistungsdaten für das angegeben Halbjahr der gymnasialen Oberstufe bei den Schülern des Abiturjahrgangs, welcher durch den Schuljahresabschnitt und das Halbjahr der gymnasialen Oberstufe gegeben ist. Dies wird nur durchgeführt, wenn Kurse für die gymnasiale Oberstufe angelegt sind und es keine Leistungsdaten für Oberstufenkursen bei den Schüler gibt, welche bereits Noten beinhalten.
      Parameter:
      conn - die Datenbankverbindung
      abiturjahr - die ID des Schuljahresabschnittes
      idHalbjahr - die ID des Halbjahres der gymnasialen Oberstufe
      Gibt zurück:
      die HTTP-Response 204
      Löst aus:
      ApiOperationException - im Fehlerfall

    • synchronisiere

      public jakarta.ws.rs.core.Response synchronisiere(Long idErgebnis) throws ApiOperationException
      Synchronisiert das Blockungsergebnis mit den Daten in der Kursliste und in den Leistungsdaten der Schüler des Abiturjahrgangs. Dabei werden
      • ggf. neue Kurse angelegt
      • keine (!) leeren Kurse entfernt
      • die Kurs-Schüler-Zuordnungen bei vorhanden (!) Leistungsdaten zu einem Fach auf die Zuordnungen der Blockungsdaten angepasst
      Parameter:
      idErgebnis - das zu synchronisierende Blockungsergebnis
      Gibt zurück:
      die HTTP-Response, welchen den Erfolg der Operation angibt
      Löst aus:
      ApiOperationException - im Fehlerfall

    • addErgebnisse

      public jakarta.ws.rs.core.Response addErgebnisse(long idBlockung, List<GostBlockungsergebnis> ergebnisse) throws ApiOperationException
      Fügt die Ergebnisse aus der übergebenen Liste zu der Blockung mit der angegebenen ID hinzu.
      Parameter:
      idBlockung - die ID der Blockung
      ergebnisse - die Ergebnisse, die hinzugefügt werden sollen.
      Gibt zurück:
      die HTTP-Response mit der Liste der hinzugefügten Ergebnisse, welche dann die Datenbank-IDs der persistierten Ergebnisse beinhalten.
      Löst aus:
      ApiOperationException - im Fehlerfall