<?php

/**
 * Diese Datei enthaelt die Klasse Film
 *
 * @author     Max Mustermann <maxmustermann@example.de>
 * @package    Medienbibliothek
 * @subpackage Video
 * @version    1.23
 * @copyright  Copyright (c) 2009 Max Mustermann
 */

include 'datenbank.php';

/**
 * Stellt einen Film-Eintrag in der Bibliothek dar.
 *
 * Die Klasse Film bietet Funktionen für den Zugriff auf
 * die in der Bibliothek enthaltenen Informationen ueber
 * den Film.
 *
 * @author     Max Mustermann <maxmustermann@example.de>
 * @package    Medienbibliothek
 * @subpackage Video
 * @todo       Die Funktion loeschen() funktioniert noch nicht richtig!
 */
class Film {
  /**
   * Der Name des Films
   * @var      string
   * @see      aendereName()
   */
  protected $name;

  /**
   * Die ID des Films für die Datenbank
   * @var      integer
   */
  protected $filmId;

  /**
   * Aendert den Namen des Films.
   * @param    string   $neuerName Der neue Name des Films.
   * @return   boolean  true bei Erfolg, false wenn ein Fehler aufgetreten ist.
   */
  public function aendereName($neuerName) {
    $this->name = $neuerName;
    
    // liefert true bei Erfolg, false bei Fehlern.
    $ergebnis = $datenbank->aendere($this->filmId, 'name', $neuerName);
    
    return $ergebnis;
  }

  /**
   * Loescht den Film aus der Datenbank
   *
   * Diese Funktion wird wie folgt benutzt:
   * <code>
   * $ergebnis = $film->loeschen();
   * if (!$ergebnis) echo "Film konnte nicht geloescht werden!";
   * </code>
   *
   * @author    Manuel Mustermann <manuelmustermann@example.de>
   * @return    true bei Erfolg, ansonsten false.
   */
   public function loeschen() {
     return $datenbank->loesche($this->filmId);
   }
}

?>