{"id":64,"date":"2018-06-11T08:51:12","date_gmt":"2018-06-11T06:51:12","guid":{"rendered":"http:\/\/gundermann2.bplaced.net\/htdocs\/wordpress\/?p=64"},"modified":"2018-06-11T08:51:12","modified_gmt":"2018-06-11T06:51:12","slug":"implementierung-eines-daos","status":"publish","type":"post","link":"https:\/\/blog.nigdev.de\/?p=64","title":{"rendered":"Implementierung eines DAOs"},"content":{"rendered":"<p>APersist erm\u00f6glicht das Persistieren und Auslesen von Objekten in relationalen Datenbanken. F\u00fcr den Zugriff auf die Datenbank werden i.d.R. so geannte <em>Data-Access-Objekte <\/em>(DAO) verwendet. In diesem Beitrag wird erkl\u00e4rt, wie ein solches DAO f\u00fcr APersist implementiert und angemeldet werden muss.<\/p>\n<p><!--more--><\/p>\n<h1>1. Konfigurieren einer Entit\u00e4t<\/h1>\n<p>Um ein DAO f\u00fcr APersist zu implementieren, wird zuerst eine Klasse f\u00fcr je zu persistierende Entit\u00e4t ben\u00f6tigt.<\/p>\n<p>siehe: <a href=\"http:\/\/gundermann2.bplaced.net\/htdocs\/wordpress\/?p=69&amp;preview=true\">Konfiguration einer Entity-Klasse<\/a><\/p>\n<h1>2. Implementieren des DAO<\/h1>\n<p>Als Beispiel solle ein DAO f\u00fcr eine Entit\u00e4t <em>Car<\/em> implementiert werden. Der Aufbau der Klasse <em>Car<\/em> ist dem Artikel XYZ zu entnehmen.<\/p>\n<p>Die DAO in APersist sind immer auf eine bestimmte Entit\u00e4t zugeschnitten. Dann bedeutet, dass f\u00fcr jede Entit\u00e4t ein entsprechendes DAO implementiert werden muss.<\/p>\n<p>Zu Implementierung des DAO steht eine abstrakte generische Klasse bereit: <em><span class=\"pl-smi\">com.ng.apersist.dao.DAO<\/span><\/em><\/p>\n<p>F\u00fcr die Implementierung eines DAO f\u00fcr die Entit\u00e4t <em>Car<\/em> wird eine Klasse <em>CarDAO<\/em> angelegt, welche von der o.g. abstrakten Klasse <em>Dao <\/em>erbt:<\/p>\n<pre><code lang=\"java\">public class CarDAO extends DAO&lt;Car&gt; {}<\/code><\/pre>\n<p>Im Codebeispiel ist zu sehen, wie der generische Typ der Klasse <em>DAO<\/em> zu der entsprechenden Entit\u00e4t konkretisiert wird, deren Persistenz \u00fcber das konrete DAO geh\u00e4ndelt werden soll.<\/p>\n<p>Mit der Implementierung von <em>CarDAO <\/em>ist man damit allerdings noch nicht fertig. Es fehlen noch mindestens 3 Methoden.<\/p>\n<h2>1. Default-Konstruktor<\/h2>\n<p>F\u00fcr die Verwendung ben\u00f6tigt das Framework einen Default-Konstruktor, der den Aufruf an die Oberklasse delegiert:<\/p>\n<pre><code lang=\"java\">public CarDAO(){\r\n    super();\r\n}<\/code><\/pre>\n<h2>2. Konstruktor zur Initialisierung f\u00fcr die Datenbank<\/h2>\n<p>Damit das DAO auch in Verbindung mit der Datenbank benutzt werden kann, wird ein weitere Konsturktor ben\u00f6tigt, der das APersist-Datenbank-Objekt <em>(<span class=\"pl-smi\">com.ng.apersist.Database<\/span>) <\/em>\u00fcbergeben bekommt:<\/p>\n<pre><code lang=\"java\">public CarDAO( Database db ){\r\n    super( db );\r\n}<\/code><\/pre>\n<h2>3. Funktion f\u00fcr den Entit\u00e4t-Typ<\/h2>\n<p>Zum Schluss muss noch eine Funktion <em>(<span class=\"pl-en\">getParameterType<\/span>)<\/em> implementiert werden, welche die Klasse der Entit\u00e4ten liefert:<\/p>\n<pre><code lang=\"java\">public Class&lt;Car&gt; getParameterType(){\r\n    return Car.class;\r\n}<\/code><\/pre>\n<h2>Was kann das DAO nun?<\/h2>\n<p>Das DAO, so wie es jetzt implementiert wurde, stellt Methoden f\u00fcr folgende Operationen bereit:<\/p>\n<ul>\n<li><em>load( objectID ) <\/em>&#8211; l\u00e4dt ein bestimmtes Objekt mit der \u00fcbergebenen ID<\/li>\n<li><em><span class=\"pl-en\">insertOrUpdate<\/span>( object ) <\/em>&#8211; wenn das \u00fcbergebene Objekt bereits in der Datenbank vorhanden ist, wird dieses in der Datenbank aktualisiert, anderenfalls wird es in die Datenbank geschrieben<\/li>\n<li><em><span class=\"pl-en\">delete<\/span>( object )<\/em> &#8211; l\u00f6sche das \u00fcbergebene Objekt aus der Datenbank<\/li>\n<li><em><span class=\"pl-en\">loadAll<\/span>( ) <\/em>&#8211; L\u00e4dt alle Objekte, die in der Datenbank existieren und \u00fcber das jeweilige DAO geh\u00e4ndelt werden<\/li>\n<\/ul>\n<p>Neben den o.g. Methoden kann das konrete DAO nat\u00fcrlich beliebig um erweitert werden.<\/p>\n<p>Die Implementierung eines DAO reicht jedoch nicht aus, um das DAO im Kontext von APersist zu verwenden. Um das tun zu k\u00f6nnen, muss das DAO zus\u00e4tzlich angemeldet werden.<\/p>\n<h1>3. Anmelden des DAO<\/h1>\n<p>Das Anmelder des DAOs erfolgt \u00fcber die <em><span class=\"pl-smi\">com.ng.apersist.DbRegistry<\/span><\/em>, welche bei der Initialisierung der Datenbank \u00fcbergeben werden muss (siehe Artikel <a href=\"http:\/\/gundermann2.bplaced.net\/htdocs\/wordpress\/?p=77&amp;preview=true\">Initialisieren der Datenbank<\/a>).<\/p>\n<p>Die Klasse <em><span class=\"pl-smi\">com.ng.apersist.DbRegistry<\/span><\/em> wird hierzu wieder durch eine eigenen Klasse konkretisiert.<\/p>\n<p>Im Beispiel wird eine Klasse <em>VehicleDbRegistry<\/em> erzeugt:<\/p>\n<pre><code lang=\"java\">public class VehicleDbRegistry extends DbRegistry {\r\n   \r\n    @Override\r\n    protected void setup() {\r\n    \r\n    }\r\n}<\/code><\/pre>\n<p>Diese Klasse wei\u00dft eine Methode <em>setup( ) <\/em> auf, in der die DAOs mit ihrene korrespondierenden Entity-Klassen \u00fcber eine zur Verf\u00fcgung stehende Methode <em>add( daoClass, entityClass )<\/em> angemeldet werden:<\/p>\n<pre><code lang=\"java\">public class VehicleDbRegistry extends DbRegistry {\r\n\r\n    @Override\r\n    protected void setup() {\r\n        add( CarDAO.class, Car.class );\r\n    }\r\n}<\/code><\/pre>\n<p>Den Rest \u00fcbernimmt APersist. Der Nutzer muss sich lediglich noch um den Zugriff auf das DAO k\u00fcmmern.<\/p>\n\n<div class=\"twitter-share\"><a href=\"https:\/\/twitter.com\/intent\/tweet?via=NielsGundermann\" class=\"twitter-share-button\">Twittern<\/a><\/div>\n","protected":false},"excerpt":{"rendered":"<p>APersist erm\u00f6glicht das Persistieren und Auslesen von Objekten in relationalen Datenbanken. F\u00fcr den Zugriff auf die Datenbank werden i.d.R. so geannte Data-Access-Objekte (DAO) verwendet. In diesem Beitrag wird erkl\u00e4rt, wie ein solches DAO f\u00fcr APersist implementiert und angemeldet werden muss.<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":[],"categories":[1],"tags":[7],"_links":{"self":[{"href":"https:\/\/blog.nigdev.de\/index.php?rest_route=\/wp\/v2\/posts\/64"}],"collection":[{"href":"https:\/\/blog.nigdev.de\/index.php?rest_route=\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/blog.nigdev.de\/index.php?rest_route=\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/blog.nigdev.de\/index.php?rest_route=\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/blog.nigdev.de\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=64"}],"version-history":[{"count":9,"href":"https:\/\/blog.nigdev.de\/index.php?rest_route=\/wp\/v2\/posts\/64\/revisions"}],"predecessor-version":[{"id":101,"href":"https:\/\/blog.nigdev.de\/index.php?rest_route=\/wp\/v2\/posts\/64\/revisions\/101"}],"wp:attachment":[{"href":"https:\/\/blog.nigdev.de\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=64"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/blog.nigdev.de\/index.php?rest_route=%2Fwp%2Fv2%2Fcategories&post=64"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/blog.nigdev.de\/index.php?rest_route=%2Fwp%2Fv2%2Ftags&post=64"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}