web/lib/LocSubject.php

<?
class LocSubject{
	public int $LocSubjectId;
	public string $Name;

	// *******
	// METHODS
	// *******

	/**
	 * @throws Exceptions\InvalidLocSubjectException
	 */
	public function Validate(): void{
		$error = new Exceptions\InvalidLocSubjectException();

		if(isset($this->Name)){
			$this->Name = trim($this->Name);

			if($this->Name == ''){
				$error->Add(new Exceptions\LocSubjectNameRequiredException());
			}

			if(strlen($this->Name) > EBOOKS_MAX_STRING_LENGTH){
				$error->Add(new Exceptions\StringTooLongException('LoC subject: '. $this->Name));
			}
		}
		else{
			$error->Add(new Exceptions\LocSubjectNameRequiredException());
		}

		if($error->HasExceptions){
			throw $error;
		}
	}

	/**
	 * @throws Exceptions\InvalidLocSubjectException
	 */
	public function Create(): void{
		$this->Validate();

		$this->LocSubjectId = Db::QueryInt('
			INSERT into LocSubjects (Name)
			values (?)
			returning LocSubjectId
		', [$this->Name]);
	}

	/**
	 * @throws Exceptions\InvalidLocSubjectException
	 */
	public function GetByNameOrCreate(string $name): LocSubject{
		$result = Db::Query('
				SELECT *
				from LocSubjects
				where Name = ?
			', [$name], LocSubject::class);

		if(isset($result[0])){
			return $result[0];
		}
		else{
			$this->Create();
			return $this;
		}
	}

	/**
	 * Deletes `LocSubject`s that are not associated with any `Ebook`s.
	 */
	public static function DeleteUnused(): void{
		Db::Query('
			DELETE ls
			from LocSubjects ls
				left join EbookLocSubjects els using (LocSubjectId)
			where els.LocSubjectId is null
		');
	}
}