Package de.svws_nrw.data.kurse

Klasse DataKurse

java.lang.Object
de.svws_nrw.data.DataManagerRevised<Long,DTOKurs,KursDaten>
de.svws_nrw.data.kurse.DataKurse
public final class DataKurse extends DataManagerRevised<Long,DTOKurs,KursDaten>
Data-Manager für Kurse KursDaten.

  • Konstruktordetails

    • DataKurse

      public DataKurse(DBEntityManager conn)
      Erstellt einen neuen DataManager für den Core-DTO KursDaten.
      Parameter:
      conn - die Datenbank-Verbindung für den Datenbankzugriff

  • Methodendetails

    • getById

      public KursDaten getById(Long id) throws ApiOperationException
      Gibt die Daten eines Kurses zu dessen ID zurück.
      Setzt außer Kraft:
      getById in Klasse DataManagerRevised<Long,DTOKurs,KursDaten>
      Parameter:
      id - die ID des Kurses.
      Gibt zurück:
      die Daten des Kurses zur ID.
      Löst aus:
      ApiOperationException - im Fehlerfall

    • getLongId

      protected long getLongId(DTOKurs kurs)
      Beschreibung aus Klasse kopiert: DataManagerRevised
      Diese Methode muss überschrieben werden, damit die Methode deleteMultipleAsSimpleResponseList genutzt werden kann. Sie ermittelt zu den übergeben Datenbank-DTO den long-Wert der zugehörigen ID.
      Setzt außer Kraft:
      getLongId in Klasse DataManagerRevised<Long,DTOKurs,KursDaten>
      Parameter:
      kurs - das Datenbank-DTO
      Gibt zurück:
      der long-Wert der ID

    • initDTO

      protected void initDTO(DTOKurs dto, Long newId, Map<String,Object> initAttributes)
      Beschreibung aus Klasse kopiert: DataManagerRevised
      Initialisiert das Datenbank-DTO mit der übergebenen ID.
      Wichtig: Diese Methode muss überschrieben werden, damit die Add-Methoden ausführbar sind.
      Setzt außer Kraft:
      initDTO in Klasse DataManagerRevised<Long,DTOKurs,KursDaten>
      Parameter:
      dto - das Datenbank-DTO
      newId - die ID
      initAttributes - die Attribute zur Initialisierung

    • map

      protected KursDaten map(DTOKurs dto) throws ApiOperationException
      Beschreibung aus Klasse kopiert: DataManagerRevised
      Wandelt das Datenbank-DTO in das Core-DTO um, soweit die Daten in dem Datenbank-DTO enthalten sind.
      Angegeben von:
      map in Klasse DataManagerRevised<Long,DTOKurs,KursDaten>
      Parameter:
      dto - das Datenbank-DTO
      Gibt zurück:
      das neu erstellte Core-DTO
      Löst aus:
      ApiOperationException - im Fehlerfall

    • mapAttribute

      protected void mapAttribute(DTOKurs dto, String name, Object value, Map<String,Object> map) throws ApiOperationException
      Beschreibung aus Klasse kopiert: DataManagerRevised
      Führt das Mapping eines Attributes des Core-DTOs auf das zugehörige Datenbank-DTO durch.
      Wichtig: Diese Methode muss überschrieben werden, damit die Add-Methoden und Patch-Methoden ausführbar sind.
      Setzt außer Kraft:
      mapAttribute in Klasse DataManagerRevised<Long,DTOKurs,KursDaten>
      Parameter:
      dto - das Datenbank-DTO
      name - der Name des Core-DTO-Attributes
      value - der Wert des Core-DTO-Attributes
      map - die map von Attribut-Namen des Core-DTOs auf den zugehörigen Attributwertes
      Löst aus:
      ApiOperationException - wenn ein Fehler bei dem Mapping auftritt

    • getKursdaten

      public static KursDaten getKursdaten(DBEntityManager conn, Long id) throws ApiOperationException
      Ermittelt die Daten zu dem Kurs mit der angegebenen ID.
      Parameter:
      conn - die Datenbankverbindung
      id - die ID des Kurses
      Gibt zurück:
      die Daten des Kurses
      Löst aus:
      ApiOperationException - im Fehlerfall

    • convertSchienenStrToList

      public static List<Integer> convertSchienenStrToList(String strSchienen)
      Wandelt den übergebenen String aus komma-separierten Schienenlisten in eine Liste der Schienen-Nummern um.
      Parameter:
      strSchienen - der String mit der Schienenliste
      Gibt zurück:
      die Liste der Schienennummern

    • getListBySchuljahresabschnittID

      public List<KursDaten> getListBySchuljahresabschnittID(Long idSchuljahresabschnitt, boolean attachSchueler) throws ApiOperationException
      Ermittelt die Kurse zu dem Schuljahresabschnitt mit der angegebenen ID.
      Parameter:
      idSchuljahresabschnitt - die ID des Schuljahresabschnitts
      attachSchueler - gibt an, ob die Schüler zu den Kursen mit geladen werden sollen
      Gibt zurück:
      eine Liste mit den Kursen des Schuljahresabschnitts
      Löst aus:
      ApiOperationException - im Fehlerfall

    • getListByIDs

      public List<KursDaten> getListByIDs(List<Long> ids, boolean attachSchueler) throws ApiOperationException
      Ermittelt die Kurse zu den übergebenen Kurs-IDs.
      Parameter:
      ids - die ID des Schuljahresabschnitts
      attachSchueler - gibt an, ob die Schüler zu den Kursen mit geladen werden sollen
      Gibt zurück:
      eine Liste mit den Kursen zu den übergebenen IDs
      Löst aus:
      ApiOperationException - im Fehlerfall

    • getKursListenFuerAbschnitt

      @NotNull public static @NotNull List<KursDaten> getKursListenFuerAbschnitt(DBEntityManager conn, Long idSchuljahresabschnitt, boolean mitSchuelerListe)
      Bestimmt die Liste der Kurse für den angegeben Abschnitt. Ist dieser Abschnitt null, so werden die Kurse aller Abschnitte zurückgegeben. Dabei kann gewählt werden, ob die Schülerlisten zu den Kursen mitbestimmt werden sollen oder nicht.
      Parameter:
      conn - die Datenbankverbindung
      idSchuljahresabschnitt - die ID des Schuljahresabschnitts
      mitSchuelerListe - gibt an, ob die Kurslisten-Einträge die Information zu Schülern beinhalten soll
      Gibt zurück:
      die Liste der Kurse

    • getKurslistenFuerAbschnittAsResponse

      public static jakarta.ws.rs.core.Response getKurslistenFuerAbschnittAsResponse(DBEntityManager conn, Long idSchuljahresabschnitt, boolean mitSchuelerListe)
      Bestimmt die Liste der Kurse für den angegeben Abschnitt. Ist dieser Abschnitt null, so werden die Kurse aller Abschnitte zurückgegeben. Dabei kann gewählt werden, ob die Schülerlisten zu den Kursen mitbestimmt werden sollen oder nicht.
      Parameter:
      conn - die Datenbankverbindung
      idSchuljahresabschnitt - die ID des Schuljahresabschnitts
      mitSchuelerListe - gibt an, ob die Kurslisten-Einträge die Information zu Schülern beinhalten soll
      Gibt zurück:
      die Liste der Kurse