Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

--- faecher:informatik:oberstufe:datenbanken:projekt:dokuwiki_plugin:microblogging:step02:start [21.06.2021 18:05] – [Benutzer] sbel
+++ faecher:informatik:oberstufe:datenbanken:projekt:dokuwiki_plugin:microblogging:step02:start [Unbekanntes Datum] (aktuell) – gelöscht - Externe Bearbeitung (Unbekanntes Datum) 127.0.0.1
@@ Zeile 1: / Zeile 1: @@
-====== Neue Klassen mit Datenbankzugriff ======
-Wir wollen unserem Projekt nun weitere Klassen hinzufügen, von denen einige Datenbankzugriff benötigen. Die jeweiligen Operationen auf der Datenbank sollen aber in den jeweiligen Klassen gekapselt sein.
-Um dieses Ziel zu erreichen, //reduzieren// wir zunächst die Funktionalität unserer mysqldb-Klasse darauf, eine ((und nur eine)) Datenbankverbindung herzustellen und ein entsprechendes PDO-Objekt, das diese Verbindung repräsentiert, zurückzuliefern, welches dann innerhalb der anderen Klassen für den Datenbankzugriff verwendet werden kann.
-===== Die neue DB Klasse =====
-Passe die Datenbank Klasse in der Datei ''mysqldb.class.php'' folgendermaßen an:
-<code php>
-class mysqldb {
-    static public $connection = null;
-    private $dbobject;
-    /**
-     * Constructor - connect to db, set handle attribute
-     *
-     * @param string        $dbusername   DB username
-     * @param string        $dbpassword   DB password
-     * @param string        $dbname       Database to connect to
-     * @param string        $host         Database host to connect to (optional)
-     *
-     */
-    private function __construct($dbusername, $dbpassword, $dbname, $host ) {
-        try {
-            self::$connection = new PDO("mysql:host=$host;dbname=$dbname", "$dbusername", "$dbpassword");
-            self::$connection->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);
-        } catch ( PDOException $e ) {
-            echo 'Verbindung zur Datenbank fehlgeschlagen: ' . $e->getMessage();
-            exit();
-        }
-    }
-    public static function getConnection($dbusername, $dbpassword, $dbname, $host ) {
-        // Wenn das Objekt noch keine PDO-Instanz hat
-        // wird eine erzeugt
-        if(self::$connection === null) {
-            $dbobject = new mysqldb($dbusername, $dbpassword, $dbname, $host);
-        }
-     //Und das PDO-Objekt zurückgeben
-     return self::$connection;
-    }
-    // Das Klonen dieser Instanz verhindern.
-    private final function __clone () {}
-}
-</code>
-**Anmerkungen:**
-  * Die Schreibweise mit dem Doppel-Doppelpunkt ermöglicht den Zugriff auf statische Methoden und Felder, ohne ein Objekt der Klasse zu besitzen. Das benutzen wir, um in weiteren Klassen ein Datenbank-Handle zu erhalten.
-  * Die Klasse selbst ist so konstruiert, dass sie nur eine Datenbankverbindung aufbaut. Wenn noch keine Datenbankverbindung existiert, wird ein neues myqldb-Objekt samt Datenbankhandle erzeugt, andernfalls lediglich das Handle zurückgegeben.
-  * Außerdem verhindern wir, dass die Instanz geklont werden kann.
-===== Benutzer =====
-Nun wenden wir uns der Benutzer-Klasse zu. Diese hat zunächst vor allem die Aufgabe, zu überprüfen, ob der angemeldete Dokuwiki Benutzer bereits einen Eintrag als Blog-Benutzer in der Datenbank hat. Wenn nicht muss der Benutzer angelegt werden.
-Erstelle im Unterverzeichnis ''class'' deines Plugins eine Datei ''bloguser.class.php'' und definiere darin die Klasse bloguser:
-<code php>
-<?php
-class bloguser {
-    protected $db;           // Das DB-Handle
-    //Konstruktor
-    public function __construct ($dbusername, $dbpassword, $dbname, $host="localhost" )
-    {
-       // PDO Connection erzeugen/holen und als
-       // Objektattribut "speichern". Damit werden DB Zugriffe möglich.
-       $this->db = mysqldb::getConnection($dbusername, $dbpassword, $dbname, $host);
-    }
-    public function checkBlogUser ($dwusername) {
-        print "Überprüfe, ob der Dokuwiki-Benutzer " . $_SERVER['REMOTE_USER'] . " schon in der Datenbank angelegt ist.";
-    }
-}
-?>
-</code>
-Das ganze kann man dann etwa so in der ''syntax.php'' einbinden:
-<code php>
-[...]
-public function render($mode, Doku_Renderer $renderer, $data)
-    {
-        // Wir rendern nur HTML, sonst nix!
-        if ($mode !== 'xhtml') {
-            return false;
-        }
-        // Breche die Verarbeitung ab, wenn der Benutzer nicht angemeldet ist.
-        if ( ! isset($_SERVER['REMOTE_USER']) ) {
-            $renderer->doc .= "Um das Blog zu benutzen, müssen Sie sich anmelden";
-            return true
-        }
-        // get settings
-        $dbpasswd = $this->getConf('dbpasswd');
-        $dbname = $this->getConf('dbname');
-        $dbhost = $this->getConf('dbhost');
-        $dbtable = $this->getConf('dbtable');
-        // make db connection
-        $bloguser = new bloguser($this->getConf('dbusername'), $dbpasswd, $dbname, $dbhost);
-        // Prüfe, ob es den angemeldetn Benutzer schon in der DB gibt, lege ihn an wenn
-        // nicht. Liefer die bloguserID des Nutzers zur weiteren Verwendung zurück
-        $bloguser->checkBlogUser($_SERVER['REMOTE_USER']);
-[...]
-</code>
-{{:aufgabe.png?nolink  |}}
-=== (A1) ===
-Füge die Codebestandteile von oben so in dein Projekt ein, dass diese dort funktionieren. Als angemeldeter Benutzer solltest du also die Ausgabe erhalten, dass es den Benutzer noch nicht gibt und dieser angelegt werden sollte.
-{{:aufgabe.png?nolink  |}}
-=== (A2) ===
-Ergänze die Klasse ''bloguser'' um zwei private Felder/Attribute für die ID und den Namen des Benutzers.
-Implementiere in der Methode ''checkBlogUser'' die Funktionalität, dass der Benutzer angelegt wird, wenn er noch nicht existiert.
-**** Hallo |
-****
-----
-[[{}..:step01:start|<- Schritt 1]][[{|float-right}..:step03:start|Schritt 3 ->]]