ts-api/core/abschluss/AbschlussManager.ts

import { JavaObject, cast_java_lang_Object } from '../../java/lang/JavaObject';
import { GEAbschlussFach, cast_de_nrw_schule_svws_core_data_abschluss_GEAbschlussFach } from '../../core/data/abschluss/GEAbschlussFach';
import { AbschlussErgebnis, cast_de_nrw_schule_svws_core_data_abschluss_AbschlussErgebnis } from '../../core/data/abschluss/AbschlussErgebnis';
import { GEAbschlussFaecher, cast_de_nrw_schule_svws_core_data_abschluss_GEAbschlussFaecher } from '../../core/data/abschluss/GEAbschlussFaecher';
import { StringBuilder, cast_java_lang_StringBuilder } from '../../java/lang/StringBuilder';
import { List, cast_java_util_List } from '../../java/util/List';
import { JavaString, cast_java_lang_String } from '../../java/lang/JavaString';
import { Abschluss, cast_de_nrw_schule_svws_core_types_Abschluss } from '../../core/types/Abschluss';
import { JavaBoolean, cast_java_lang_Boolean } from '../../java/lang/JavaBoolean';
import { GELeistungsdifferenzierteKursart, cast_de_nrw_schule_svws_core_types_ge_GELeistungsdifferenzierteKursart } from '../../core/types/ge/GELeistungsdifferenzierteKursart';
import { Vector, cast_java_util_Vector } from '../../java/util/Vector';
import { HashSet, cast_java_util_HashSet } from '../../java/util/HashSet';

export class AbschlussManager extends JavaObject {


	public constructor() {
		super();
	}

	/**
	 * Erzeugt ein Ergebnis der Abschlussberechnung unter Angabe, ob dieser erworben 
	 * wurde. Die Liste der Nachprüfungsfächer ist leer und ein Log ist nicht zugeordnet.
	 * Sollten Nachprüfungsmöglichkeiten bestehen so ist die Methode 
	 * {@link AbschlussManager#getErgebnisNachpruefung} zu nutzen.
	 * und ob dieser erworben wurde. 
	 *  
	 * @param abschluss   der Abschluss für den das Ergebnis erzeugt wird 
	 * @param erworben    true, falls der Abschluss erworben wurde, sonst false
	 * 
	 * @return das Ergebnis der Abschlussberechnung 
	 */
	public static getErgebnis(abschluss : Abschluss | null, erworben : boolean) : AbschlussErgebnis {
		let ergebnis : AbschlussErgebnis = new AbschlussErgebnis();
		ergebnis.abschluss = abschluss === null ? null : abschluss.toString();
		ergebnis.erworben = erworben;
		ergebnis.npFaecher = null;
		ergebnis.log = null;
		return ergebnis;
	}

	/**
	 * Erzeugt ein Ergebnis der Abschlussberechnung, wo der Abschluss nicht erreicht wurde, aber ggf. 
	 * noch durch Nachprüfungen erreicht werden kann. Ein log wird nicht zugeordnet.
	 * 
	 * @param abschluss    der Abschluss für den das Ergebnis erzeugt wird 
	 * @param np_faecher   eine Liste von Nachprüfungsfächern, falls eine Nachprüfung möglich ist, 
	 *                     ansonsten null oder eine leere Liste
	 *
	 * @return das Ergebnis der Abschlussberechnung 
	 */
	public static getErgebnisNachpruefung(abschluss : Abschluss | null, np_faecher : List<String> | null) : AbschlussErgebnis {
		let ergebnis : AbschlussErgebnis = new AbschlussErgebnis();
		ergebnis.abschluss = abschluss === null ? null : abschluss.toString();
		ergebnis.erworben = false;
		if ((np_faecher === null) || (np_faecher.size() === 0)) 
			ergebnis.npFaecher = null; else 
			ergebnis.npFaecher = np_faecher;
		ergebnis.log = null;
		return ergebnis;
	}

	/**
	 * Gibt an, ob für einen Abschluss eine Nachprüfungsmöglichkeit besteht.
	 * 
	 * @param ergebnis   das Abschluss-Ergebnis bei dem auf eine Nachprüfungsmöglichkeit 
	 *                   geprüft werden soll. 
	 * 
	 * @return true, falls eine Nachprüfungsmöglichkeit besteht, sonst false
	 */
	public static hatNachpruefungsmoeglichkeit(ergebnis : AbschlussErgebnis) : boolean {
		return (ergebnis.npFaecher !== null) && ergebnis.npFaecher.size() > 0;
	}

	/**
	 * Gibt die Nachprüfungsfächer als Komma-separierten String zurück.
	 * 
	 * @param ergebnis   das Abschluss-Ergebnis bei dem die Nachprüfungsmöglichkeiten 
	 *                   ausgegeben werden sollen
	 *                    
	 * @return die Nachprüfungsfächer als Komma-separierten String
	 */
	public static getNPFaecherString(ergebnis : AbschlussErgebnis) : String {
		if (ergebnis.npFaecher === null) 
			return "";
		let sb : StringBuilder | null = new StringBuilder();
		for (let fach of ergebnis.npFaecher) {
			if (sb.length() > 0) 
				sb.append(", ");
			sb.append(fach);
		}
		return sb.toString();
	}

	/**
	 * Vergleicht die beiden Abschlüsse, ob sie identisch sind. Ein
	 * Übergabewert null wird als {@link Abschluss#OHNE_ABSCHLUSS}
	 * interpretiert.
	 *  
	 * @param a   der eine Abschluss
	 * @param b   der andere Abschluss
	 * 
	 * @return true, falls sie identisch sind und ansonsten false
	 */
	public static equalsAbschluesse(a : String | null, b : String | null) : boolean {
		if ((a === null) || (Abschluss.OHNE_ABSCHLUSS.is(a))) 
			return (b === null) || (Abschluss.OHNE_ABSCHLUSS.is(b));
		return JavaObject.equalsTranspiler(a, (b));
	}

	/**
	 * Gibt den Abschluss zurück. Im Falle das kein Abschluss angegeben ist
	 * wird Abschluss.OHNE_ABSCHLUSS zurückgegeben.
	 * 
	 * @param ergebnis   das Ergebnis 
	 * 
	 * @return der Abschluss
	 */
	public static getAbschluss(ergebnis : AbschlussErgebnis) : String {
		return ergebnis.abschluss === null ? Abschluss.OHNE_ABSCHLUSS.toString() : ergebnis.abschluss;
	}

	/**
	 * Die Methode dient dem Erzeugen eines Faches für die Abschlussberechnung.
	 * 
	 * @param kuerzel           das Kürzel des Faches
	 * @param bezeichnung       die Bezeichnung des Faches
	 * @param note              die Note, die in dem Fach erteilt wurde
	 * @param kursart           gibt die Kursart Faches an: leistungsdifferenzierter (E-Kurs, G-Kurs) oder sonstiger Kurs
	 * @param istFremdsprache   gibt an, ob es sich bei dem Fach um eine Fremdsprache handelt oder nicht
	 * 
	 * @return das Abschlussfach 
	 */
	public static erstelleAbschlussFach(kuerzel : String, bezeichnung : String | null, note : number, kursart : GELeistungsdifferenzierteKursart, istFremdsprache : Boolean | null) : GEAbschlussFach {
		let fach : GEAbschlussFach = new GEAbschlussFach();
		fach.kuerzel = kuerzel;
		fach.bezeichnung = (bezeichnung === null || JavaObject.equalsTranspiler("", (bezeichnung))) ? "---" : bezeichnung;
		fach.note = note;
		fach.kursart = kursart.kuerzel;
		fach.istFremdsprache = istFremdsprache === null ? false : istFremdsprache;
		return fach;
	}

	/**
	 * Liefert eine List mit den Fachkürzeln aus der übergebenen Liste mit Abschlussfächern.
	 * 
	 * @param faecher   die Liste mit Abschlussfächern
	 * 
	 * @return die Liste mit den Fachkürzeln
	 */
	public static getKuerzel(faecher : List<GEAbschlussFach>) : List<String> {
		let result : Vector<String> = new Vector();
		for (let i : number = 0; i < faecher.size(); i++){
			let fach : GEAbschlussFach = faecher.get(i);
			if ((fach === null) || fach.kuerzel === null) 
				continue;
			if (result.contains(fach.kuerzel)) 
				continue;
			result.add(fach.kuerzel);
		}
		return result;
	}

	/**
	 * Prüft, ob vier leistungsdifferenzierte Fächer belegt wurden. Dabei wird nicht geprüft, ob 
	 * es sich um G oder E-Kurse handelt.
	 * 
	 * @param abschluss_faecher   die Abschlussfächer 
	 * 
	 * @return true, falls vier leistungsdifferenzierte Fächer belegt wurden, sonst false
	 */
	public static pruefeHat4LeistungsdifferenzierteFaecher(abschluss_faecher : GEAbschlussFaecher) : boolean {
		if (abschluss_faecher.faecher === null) 
			return false;
		let count : number = 0;
		let faecher : List<GEAbschlussFach> = abschluss_faecher.faecher;
		for (let fach of faecher) {
			if (fach === null) 
				continue;
			let kursart : GELeistungsdifferenzierteKursart = GELeistungsdifferenzierteKursart.from(fach.kursart);
			if ((kursart as unknown === GELeistungsdifferenzierteKursart.E as unknown) || (kursart as unknown === GELeistungsdifferenzierteKursart.G as unknown)) 
				count++;
		}
		return (count === 4);
	}

	/**
	 * Prüft, ob Duplikate bei den Kürzeln der Fächer vorkommen. Dies darf zur korrekten
	 * Ausführung des Abschlussalgorithmus nicht vorkommen.
	 * 
	 * @param abschluss_faecher   die Abschlussfächer 
	 * 
	 * @return true, falls keine Duplikate vorkommen, sonst false
	 */
	public static pruefeKuerzelDuplikate(abschluss_faecher : GEAbschlussFaecher) : boolean {
		if (abschluss_faecher.faecher === null) 
			return true;
		let kuerzel : HashSet<String> = new HashSet();
		let faecher : List<GEAbschlussFach> = abschluss_faecher.faecher;
		for (let fach of faecher) {
			if ((fach === null) || (fach.kuerzel === null)) 
				continue;
			if (!kuerzel.add(fach.kuerzel)) 
				return false;
		}
		return true;
	}

	isTranspiledInstanceOf(name : string): boolean {
		return ['de.nrw.schule.svws.core.abschluss.AbschlussManager'].includes(name);
	}

}

export function cast_de_nrw_schule_svws_core_abschluss_AbschlussManager(obj : unknown) : AbschlussManager {
	return obj as AbschlussManager;
}