Klasse DataBenutzerDaten

java.lang.Object
de.svws_nrw.data.DataManager<Long>
de.svws_nrw.data.benutzer.DataBenutzerDaten

public final class DataBenutzerDaten extends DataManager<Long>
Diese Klasse erweitert den abstrakten DataManager für den Core-DTO BenutzerDaten.
  • Konstruktordetails

    • DataBenutzerDaten

      public DataBenutzerDaten(DBEntityManager conn)
      Erstellt einen neuen DataManager für den Core-DTO BenutzerDaten.
      Parameter:
      conn - die Datenbank-Verbindung für den Datenbankzugriff
  • Methodendetails

    • addAdmin

      public jakarta.ws.rs.core.Response addAdmin(Long id) throws ApiOperationException
      Setzt für die angegebene Benutzer-ID den Benutzer administrativ.
      Parameter:
      id - die ID des Benutzers
      Gibt zurück:
      bei Erfolg eine HTTP-Response 200
      Löst aus:
      ApiOperationException - im Fehlerfall
    • addKompetenzen

      public jakarta.ws.rs.core.Response addKompetenzen(Long id, List<Long> kids) throws ApiOperationException
      Setzt für die angegebene Benutzer-ID die Benutzerkompetenzen.
      Parameter:
      id - die ID des Benutzers
      kids - die IDs der Kompetenzen
      Gibt zurück:
      bei Erfolg eine HTTP-Response 200
      Löst aus:
      ApiOperationException - eine Exception mit dem entsprechenden HTTP-Fehlercode im Fehlerfall
    • createBenutzerAllgemein

      public jakarta.ws.rs.core.Response createBenutzerAllgemein(BenutzerAllgemeinCredentials cred) throws ApiOperationException
      Erstellt einen neuen Benutzer *
      Parameter:
      cred - Das JSON-Objekt mit den Daten für Credentials-Obejkt
      Gibt zurück:
      Eine Response mit dem neuen Benutzer
      Löst aus:
      ApiOperationException - im Fehlerfall
    • createBenutzerErzieher

      public jakarta.ws.rs.core.Response createBenutzerErzieher()
      Erstellt einen neuen Benutzer mit dem Benutzertyp Erzieher
      Gibt zurück:
      Eine Response mit dem neuen Benutzer
    • createBenutzerLehrer

      public jakarta.ws.rs.core.Response createBenutzerLehrer()
      Erstellt einen neuen Benutzer mit dem Benutzertyp Lehrer
      Gibt zurück:
      Eine Response mit dem neuen Benutzer
    • createBenutzerSchueler

      public jakarta.ws.rs.core.Response createBenutzerSchueler()
      Erstellt einen neuen Benutzer mit dem Benutzertyp Lehrer
      Gibt zurück:
      Eine Response mit dem neuen Benutzer
    • 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
    • getKlassenVonKlassenleitungen

      public static List<Long> getKlassenVonKlassenleitungen(DBEntityManager conn, int typBenutzer, long idBenutzer)
      Bestimmt die Menge der Klassen-IDs, welche dem Benutzer als Klassenleitungen zugeordnet sind. Bei einem Benutzer-Typ der nicht Lehrer ist, wird eine leere Liste zurückgegeben.
      Parameter:
      conn - die aktuelle Datenbankverbindung
      typBenutzer - der Typ des Benutzer
      idBenutzer - die ID des Benutzers in Abhängigkeit vom Typ
      Gibt zurück:
      die Liste der Klassen-IDs
    • getKlassenVonAbteilungsleitungen

      public static List<Long> getKlassenVonAbteilungsleitungen(DBEntityManager conn, int typBenutzer, long idBenutzer)
      Bestimmt die Menge der Klassen-IDs, welche dem Benutzer aufgrund von Abteilungsleitungen zugeordnet sind. Bei einem Benutzer-Typ der nicht Lehrer ist, wird eine leere Liste zurückgegeben.
      Parameter:
      conn - die aktuelle Datenbankverbindung
      typBenutzer - der Typ des Benutzer
      idBenutzer - die ID des Benutzers in Abhängigkeit vom Typ
      Gibt zurück:
      die Liste der Klassen-IDs
    • getKlassenFunktionsbezogen

      public static List<Long> getKlassenFunktionsbezogen(DBEntityManager conn, int typBenutzer, long idBenutzer)
      Bestimmt die Menge der Klassen-IDs, welche dem Benutzer aufgrund von Klassenleitungen und Abteilungsleitungen zugeordnet sind. Bei einem Benutzer-Typ der nicht Lehrer ist, wird eine leere Liste zurückgegeben.
      Parameter:
      conn - die aktuelle Datenbankverbindung
      typBenutzer - der Typ des Benutzer
      idBenutzer - die ID des Benutzers in Abhängigkeit vom Typ
      Gibt zurück:
      die Liste der Klassen-IDs
    • getLeitungsfunktionen

      public static List<LehrerLeitungsfunktion> getLeitungsfunktionen(DBEntityManager conn, int typBenutzer, long idBenutzer)
      Gibt die Liste der aktuellen Leitunsfunktionen des Lehrers mit den angegebenen ID zurück.
      Parameter:
      conn - die aktuelle Datenbankverbindung
      typBenutzer - der Typ des Benutzer
      idBenutzer - die ID des Benutzers in Abhängigkeit vom Typ
      Gibt zurück:
      die aktuellen Leitunsfunktionen
    • getLeitungsfunktionenIDs

      public static List<Long> getLeitungsfunktionenIDs(int schuljahr, DBEntityManager conn, int typBenutzer, long idBenutzer)
      Gibt die Liste der IDs der aktuellen Leitungsfunktionen des Lehrers mit den angegebenen ID zurück.
      Parameter:
      schuljahr - das aktuelle Schuljahr der Schule
      conn - die aktuelle Datenbankverbindung
      typBenutzer - der Typ des Benutzer
      idBenutzer - die ID des Benutzers in Abhängigkeit vom Typ
      Gibt zurück:
      die IDs der aktuellen Leitunsfunktionen
    • getBeratungslehrerAbiturjahrgaenge

      public static List<Integer> getBeratungslehrerAbiturjahrgaenge(DBEntityManager conn, int typBenutzer, long idBenutzer)
      Gibt die Liste der Abiturjahrgänge des Lehrers mit den angegebenen ID zurück.
      Parameter:
      conn - die aktuelle Datenbankverbindung
      typBenutzer - der Typ des Benutzer
      idBenutzer - die ID des Benutzers in Abhängigkeit vom Typ
      Gibt zurück:
      die Liste der Abiturjahrgänge
    • 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
    • removeAdmin

      public jakarta.ws.rs.core.Response removeAdmin(Long id) throws ApiOperationException
      Entfernt die Admin-Berechtigung des Benutzers.
      Parameter:
      id - die ID des Benutzers
      Gibt zurück:
      bei Erfolg eine HTTP-Response 200
      Löst aus:
      ApiOperationException - im Fehlerfall
    • removeBenutzerMenge

      public jakarta.ws.rs.core.Response removeBenutzerMenge(List<Long> benutzerIDs) throws ApiOperationException
      Entfernt die Benutzer mit den übergebenen IDs
      Parameter:
      benutzerIDs - die IDs der zu entfernenden Benutzer
      Gibt zurück:
      die HTTP-Response mit dem Status OK (200)
      Löst aus:
      ApiOperationException - im Fehlerfall
    • removeKompetenzen

      public jakarta.ws.rs.core.Response removeKompetenzen(Long id, List<Long> kids) throws ApiOperationException
      Entfernt für die angegebene Benutzer-ID die Benutzerkompetenzen.
      Parameter:
      id - die ID des Benutzers
      kids - die IDs der Kompetenzen
      Gibt zurück:
      bei Erfolg eine HTTP-Response 204
      Löst aus:
      ApiOperationException - im Fehlerfall
    • patch

      public jakarta.ws.rs.core.Response patch(Long id, InputStream is)
      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
    • setAnzeigename

      public jakarta.ws.rs.core.Response setAnzeigename(Long id, String name) throws ApiOperationException
      Setzt für die angegebene Benutzer-ID den Anzeigenamen.
      Parameter:
      id - die ID der Benutzergruppe
      name - der neue Azeigename
      Gibt zurück:
      die Response 200 bei Erfolg.
      Löst aus:
      ApiOperationException - im Fehlerfall
    • setBenutzername

      public jakarta.ws.rs.core.Response setBenutzername(Long id, String name) throws ApiOperationException
      Setzt für die angegebene Benutzer-ID den Name des Benutzers (Anmeldename).
      Parameter:
      id - die ID des Benutzers
      name - der neue Benutzername für die Anmeldung
      Gibt zurück:
      die Response 200 bei Erfolg.
      Löst aus:
      ApiOperationException - im Fehlerfall
    • setPassword

      public jakarta.ws.rs.core.Response setPassword(Long id, String password) throws ApiOperationException
      Erstellt für den Benutzer mit der übergebenen ID einen neuen Kennwort-Hash basierend auf dem übergebenen Kennwort
      Parameter:
      id - die ID des Benutzers, dessen Kennwort neu gesetzt werden soll
      password - das Kennwort
      Gibt zurück:
      bei Erfolg eine HTTP-Response 204
      Löst aus:
      ApiOperationException - im Fehlerfall