Package de.svws_nrw.data.gost

Klasse DBUtilsGost

java.lang.Object
de.svws_nrw.data.gost.DBUtilsGost
public final class DBUtilsGost extends Object
Dies Klassen stellt Hilfmethoden für den Datenbankzugriff zur Verfügung, welche in den Data-Klassen an mehreren Stellen verwendet werden.

  • Methodendetails

    • pruefeSchuleMitGOSt

      public static DTOEigeneSchule pruefeSchuleMitGOSt(DBEntityManager conn) throws ApiOperationException
      Prüft, ob es die Schule eine Schulform mit einer Gymnasiale Oberstufe (GOSt) hat.
      Parameter:
      conn - die aktuelle Datenbankverbindung
      Gibt zurück:
      das Datenbank-DTO der Schule, falls eine Schule mit Gymnasialer Oberstufe vorliegt
      Löst aus:
      ApiOperationException - falls keine Schule definiert ist oder die Schulform keine Gymnasiale Oberstufe hat

    • pruefeSchuleMitGOStAndGetSchuljahr

      public static int pruefeSchuleMitGOStAndGetSchuljahr(DBEntityManager conn, int abijahr) throws ApiOperationException
      Prüft, ob es die Schule eine Schulform mit einer Gymnasiale Oberstufe (GOSt) hat.
      Parameter:
      conn - die aktuelle Datenbankverbindung
      abijahr - der Abiturjahrgang
      Gibt zurück:
      das Datenbank-DTO der Schule, falls eine Schule mit Gymnasialer Oberstufe vorliegt
      Löst aus:
      ApiOperationException - falls keine Schule definiert ist oder die Schulform keine Gymnasiale Oberstufe hat

    • pruefeHatOberstufenKurseInAbschnitt

      public static boolean pruefeHatOberstufenKurseInAbschnitt(DBEntityManager conn, GostHalbjahr halbjahr, Schuljahresabschnitt abschnitt)
      Prüft, ob in dem angebenen Schuljahresabschnitt für das angebene Halbjahr der gymnasialen Oberstufe bereits Kurse der gymnasialen Oberstufe vorhanden sind oder nicht.
      Parameter:
      conn - die aktuelle Datenbankverbindung
      halbjahr - das Halbjahr
      abschnitt - der Schuljahresabschnitt
      Gibt zurück:
      true, wenn bereits Kurse vorhanden sind und ansonsten false

    • getOberstufenKurseInAbschnitt

      public static Set<DTOKurs> getOberstufenKurseInAbschnitt(DBEntityManager conn, GostHalbjahr halbjahr, Schuljahresabschnitt abschnitt)
      Ermittelt in dem angebenen Schuljahresabschnitt für das angebene Halbjahr der gymnasialen Oberstufe die Menge der Kurse (DB-DTOs) der gymnasialen Oberstufe.
      Parameter:
      conn - die aktuelle Datenbankverbindung
      halbjahr - das Halbjahr
      abschnitt - der Schuljahresabschnitt
      Gibt zurück:
      die Menge der Kurse (DB-DTOs)

    • getLernabschnitteFuerGostHalbjahrInAbschnitt

      public static List<DTOSchuelerLernabschnittsdaten> getLernabschnitteFuerGostHalbjahrInAbschnitt(DBEntityManager conn, GostHalbjahr halbjahr, Schuljahresabschnitt abschnitt)
      Prüft, ob in dem angebenen Schuljahresabschnitt für das angebene Halbjahr der gymnasialen Oberstufe bereits Kurse der gymnasialen Oberstufe vorhanden sind und Schülern in diesem Abschnitt bei diesen Kursen bereits Quartalsnoten oder Noten zugewiesen wurden oder nicht.
      Parameter:
      conn - die aktuelle Datenbankverbindung
      halbjahr - das Halbjahr
      abschnitt - der Schuljahresabschnitt
      Gibt zurück:
      true, wenn bereits Kurse vorhanden sind und Schüler dort Quartalsnoten oder Noten zugewiesen wurden, ansonsten false

    • pruefeHatNotenFuerOberstufeInAbschnitt

      public static boolean pruefeHatNotenFuerOberstufeInAbschnitt(DBEntityManager conn, GostHalbjahr halbjahr, Schuljahresabschnitt abschnitt)
      Prüft, ob in dem angebenen Schuljahresabschnitt für das angebene Halbjahr der gymnasialen Oberstufe bereits Kurse der gymnasialen Oberstufe vorhanden sind und Schülern in diesem Abschnitt bei diesen Kursen bereits Quartalsnoten oder Noten zugewiesen wurden oder nicht.
      Parameter:
      conn - die aktuelle Datenbankverbindung
      halbjahr - das Halbjahr
      abschnitt - der Schuljahresabschnitt
      Gibt zurück:
      true, wenn bereits Kurse vorhanden sind und Schüler dort Quartalsnoten oder Noten zugewiesen wurden, ansonsten false

    • deleteOberstufenKurseUndLeistungsdaten

      public static void deleteOberstufenKurseUndLeistungsdaten(DBEntityManager conn, GostHalbjahr halbjahr, Schuljahresabschnitt abschnitt) 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 aktuelle Datenbankverbindung
      halbjahr - das Halbjahr
      abschnitt - der Schuljahresabschnitt
      Löst aus:
      ApiOperationException - im Fehlerfall

    • pruefeIstAnSchule

      public static boolean pruefeIstAnSchule(DTOSchueler dto, GostHalbjahr halbjahr, int abijahrgang, Map<Long,DTOSchuljahresabschnitte> mapSchuljahresabschnitte)
      Prüft, ob der Schüler bei dem angegebehen GOSt-Halbjahr des angegeben Halbjahres an der Schule gewesen ist.
      Parameter:
      dto - der Schüler
      halbjahr - das GOSt-Halbjahr
      abijahrgang - der Abiturjahrgang
      mapSchuljahresabschnitte - die Schuljahresabschnitte, welche ihrer ID zugeordnet sind
      Gibt zurück:
      true, wenn der Schüler an der Schule ist, und ansonsten false

    • getAbiturjahr

      public static Integer getAbiturjahr(Schulform schulform, Schulgliederung schulgliederung, int schuljahr, Jahrgaenge jahrgang)
      Bestimmt für den übergegebenen Lernabschnitt eines Schülers das zugehörige Abiturjahr.
      Parameter:
      schulform - die Schulform der Schule des Schülers
      schulgliederung - die Schulgliederung des Schülers
      schuljahr - das aktuelle Schuljahr, in welchem sich der Schüler befindet
      jahrgang - der Jahrgang des Schülers
      Gibt zurück:
      das voraussichtliche Jahr des Abiturs

    • getLeistungsdaten

      public static GostLeistungen getLeistungsdaten(DBEntityManager conn, long id) throws ApiOperationException
      Ermittelt die Leistungsdaten der gymnasialen Oberstufe für den Schüler mit der angegebenen ID aus der Datenbank.
      Parameter:
      conn - die Datenbank-Verbindung
      id - die ID des Schülers
      Gibt zurück:
      die Leistungsdaten der gymnasialen Oberstufe für den Schüler mit der angegebenen ID
      Löst aus:
      ApiOperationException - im Fehlerfall

    • getLeistungsdaten

      public static Map<Long,GostLeistungen> getLeistungsdaten(int schuljahr, DBEntityManager conn, List<Long> ids) throws ApiOperationException
      Ermittelt die Leistungsdaten der gymnasialen Oberstufe für die Schüler mit den angegebenen IDs aus der Datenbank.
      Parameter:
      schuljahr - das Schuljahr der Schule
      conn - die Datenbank-Verbindung
      ids - die IDs der Schüler
      Gibt zurück:
      die Leistungsdaten der gymnasialen Oberstufe für die Schüler mit den angegebenen IDs
      Löst aus:
      ApiOperationException - im Fehlerfall

    • getLeistungsdatenFromDTOs

      public static Map<Long,GostLeistungen> getLeistungsdatenFromDTOs(List<Long> ids, GostFaecherManager gostFaecherManager, Map<Long,DTOSchuljahresabschnitte> mapSchuljahresabschnitte, Map<Long,DTOSchueler> mapSchueler, Map<Long,List<DTOSchuelerLernabschnittsdaten>> mapAlleGostAbschnitte, Map<Long,List<DTOSchuelerLeistungsdaten>> mapLeistungenByAbschnittID, Map<Long,Sprachendaten> mapSprachendaten, Map<Long,DTOJahrgang> mapJahrgaenge) throws ApiOperationException
      Ermittelt die Leistungsdaten der gymnasialen Oberstufe für die Schüler mit den angegebenen IDs aus der Datenbank.
      Parameter:
      ids - die IDs der Schüler
      gostFaecherManager - der Manager für die Fächer des Abiturjahrgangs
      mapSchuljahresabschnitte - die Schuljahresabschnitte
      mapSchueler - die DTOs der Schüler
      mapAlleGostAbschnitte - die Lernabschnitte der Schüler
      mapLeistungenByAbschnittID - die Leistungsdaten zu den Lernabschnitten
      mapSprachendaten - die Sprachendaten der Schüler
      mapJahrgaenge - die Jahrgänge der Schule
      Gibt zurück:
      die Leistungsdaten der gymnasialen Oberstufe für die Schüler mit den angegebenen IDs
      Löst aus:
      ApiOperationException - im Fehlerfall