imported>Christof46: /* MyBatis Generator */

2022-08-07T18:25:14Z

MyBatis Generator

Neue Seite

{{Infobox Software
| Name = MyBatis
| Logo =
| Hersteller = [[Apache Software Foundation]]
| AktuelleVersion = 
| AktuelleVersionFreigabeDatum = 
| Betriebssystem = [[plattformübergreifend]]
| Programmiersprache = [[Java (Programmiersprache)|Java]] und [[.Net-Framework]]
| Kategorie = [[Persistenz (Informatik)|Persistenz]]-[[Framework]]
| Lizenz = [[Apache License]] 2.0
| Website = [http://www.mybatis.org/ mybatis.org]
}}

'''MyBatis''' (früher '''iBATIS''' zusammengesetzt aus „internet“ und {{enS|''abatis''}} ‚[[Verhau]]‘) ist ein [[Open Source|Open-Source]]-[[Persistenz (Informatik)|Persistenz]]-[[Framework]] für [[Java (Programmiersprache)|Java]] und das [[.Net-Framework]]. Für [[Ruby (Programmiersprache)|Ruby]] und [[Ruby on Rails]] ist eine portierte Version namens '''RBatis''' verfügbar.<ref>[http://ibatis.apache.org/docs/ruby/ RDoc Dokumentation für RBatis]</ref>

Die Hauptaufgabe von MyBatis ist die Trennung von Datenbankzugriffscode vom restlichen Applikationscode. Dafür werden der Applikation [[Data Access Object|Data-Access-Objects]] (kurz DAOs) zur Verfügung gestellt und die SQL-Statements in XML-Dateien, sogenannte SQL-Maps, ausgelagert. Damit wird die Zuordnung von Tabellen zu Klassen von der Geschäftslogik entkoppelt.

MyBatis ist kein [[Object-Relational-Mapping]]-Framework (kurz ORM), die Abbildung zwischen objektorientierten Klassen und relationalen Tabellen muss von den Entwicklern selbst vorgenommen werden, ebenso das Schreiben der SQL-Statements für die Abfragen. Somit ist auch die automatische Erstellung eines Datenbankschemas aus der Klassenhierarchie nicht möglich.

== Geschichte ==
[[Datei:Ibatis.jpg|mini|ibatis-Logo]]
Das iBATIS-Projekt wurde von Clinton Begin im Jahre 2001 gegründet. Das ursprüngliche Ziel des Projektes war die Entwicklung von kryptographischer Software, was auch ausschlaggebend für den Teil „batis“ im Projektnamen verantwortlich ist („batis“ steht für „abatis“ – engl. für „[[Verhau]]“, eine militärische Verteidigungsanlage). Die erste von MyBatis fertiggestellte Software war „Secrets“, ein [[Open Source|Open-Source]]-[[Verschlüsselung]]s- und [[Elektronische Signatur|Signierungstool]] in Java.

Anfang 2002 erschien ein [[Microsoft]]-Artikel, der behauptete .NET wäre 10-mal schneller und 4-mal produktiver als J2EE. Das veranlasste das iBATIS-Projekt die Beispielapplikation „JPetStore“ (erste Version 1. Juli 2002) zu schreiben und damit die Behauptungen des Artikels zu widerlegen. Der dabei verwendete Persistenzlayer, die SQL-Maps und Data-Access-Objects, erregte das Aufsehen der Open-Source-Community. Daraus entstand das iBATIS-Framework, das einfach die Zusammenfassung der beiden Teile darstellt.<ref>[http://www.clintonbegin.com/downloads/JPetStore-1-2-0.pdf Clinton Begin – Implementing the Microsoft® .NET Pet Shop using Java] (PDF; 220 kB)</ref>

Im Laufe des Jahres 2010 zog iBATIS von der [[Apache Software Foundation]] nach Google Code um. Dieser Umzug wurde mit der Verfügbarkeit neuer Technologien im Bereich [[Soziales Netzwerk (Internet)|Soziale Netzwerke]], [[Versionsverwaltung]] und [[Open Source]] Infrastruktur begründet.<ref>[http://ibatis.apache.org/ Ankündigung zum Umstieg auf Google Code auf der iBATIS Homepage]</ref> Dabei wurde auch iBATIS in MyBatis umbenannt. Das Projekt steht aber weiterhin unter der [[Apache-Lizenz]].

Heute ist MyBatis nur mehr das Persistenzframework, weiterhin bestehend aus den beiden Hauptbestandteilen SQL-Maps und Data-Access-Objects. JPetStore fungiert dabei als das offizielle Beispiel für den typischen Gebrauch von MyBatis.<ref>[http://ibatis.apache.org/about.html iBATIS Geschichte] auf der iBATIS-Website</ref>

Das Framework gibt es derzeit in unterschiedlichen Versionen für die Programmiersprachen Java und .NET. Für Ruby gibt es eine Portierung namens RBatis. Das jBati-Projekt, ein ORM-Mapper für [[JavaScript]] ist von MyBatis inspiriert.<ref>[http://code.google.com/p/jbati/ JBati Homepage]</ref> Das Apache-Projekt iBator bietet ein Tool für MyBatis – es generiert aus Datenbanken die iBATIS-Mapping-Files.<ref>[http://ibatis.apache.org/ibator.html Ibator Seite] auf der iBATIS Site</ref>

== Funktionalität ==
Die Hauptfunktionalität von MyBatis ist die Trennung von Datenbankzugriffscode vom restlichen Applikationscode. Die wichtigsten Komponenten dafür sind die Data-Access-Objects, über die die Applikation mit dem Persistenzlayer kommuniziert, sowie die SQL-Maps, die die Datenbankzugriffe entkoppeln.

Wie die meisten Persistenzframeworks bietet MyBatis noch eine Reihe von über die reine Persistenz hinausgehenden Funktionen. Das sind z. B. die Unterstützung für [[Transaktion (Informatik)|Transaktionen]], sowohl lokale als auch globale (d. h. datenbankübergreifende) über [[Java Transaction API|JTA]] und diverse Performanceoptimierungen wie ''lazy loading'', ''join fetching'' oder ''caching''.

== MyBatis Generator ==
MyBatis beinhaltet einen Code Generator „MyBatis Generator“. MyBatis Generator fragt die Datenbank Tabellen ab und generiert „MyBatis artifacts“ mit denen CRUD Operationen (Create, Retrieve, Update, Delete) durchgeführt werden können.<ref>[http://mybatis.org/generator/ MyBatis Generator]</ref>

Ein [[Eclipse (IDE)|Eclipse]] plugin ist verfügbar.

== Beispiel ==
Es sei eine Tabelle KUNDE gegeben, die mit folgender SQL-Anweisung erstellt worden ist:

<syntaxhighlight lang="sql">
CREATE TABLE KUNDE (
K_ID INTEGER NOT NULL PRIMARY KEY,
K_NAME VARCHAR(128),
K_STR VARCHAR(128),
K_ORT VARCHAR(128),
K_PLZ INTEGER)
</syntaxhighlight>

Des Weiteren existiert folgendes [[Plain Old Java Object|POJO]]:

<syntaxhighlight lang="java">
package beispiel;

public class Kunde {
private int id;
private String name;
private String ort;
private String strasse;
private int plz;

//Getter- und Setter-Methoden folgen
}
</syntaxhighlight>

Um eine Abfrage ausführen zu können, muss eine XML-Deskriptordatei vorhanden sein:

<syntaxhighlight lang="xml">
<select id="getKunde" parameterClass="java.lang.Integer" resultClass="beispiel.Kunde">
SELECT K_ID AS id,
K_NAME AS name,
K_STR AS strasse,
K_ORT AS ort,
K_PLZ AS plz
FROM KUNDE
WHERE K_ID = #value#
</select>
</syntaxhighlight>

Die Angabe <code>#value#</code> bezieht sich auf den Integer-Wert, der bei der Abfrage mitgegeben werden muss. Als Parameter kann auch ein Objekt oder eine Map verwendet werden, wobei deren Attribute durch die <code>#</code>-Notation genauso eingebunden werden können.

Die Abfrage wird in Java wie folgt geschrieben:
<syntaxhighlight lang="java">
SqlMapClient sqlMap = SqlMapClientBuilder.buildSqlMapClient(Resources.getResourceAsReader("path-to-my-sqlMapConfig.xml"));
Kunde kunde = (Kunde) sqlMap.queryForObject("getKunde", 1);
System.out.println(kunde);
</syntaxhighlight>

Ohne MyBatis müsste man um funktional dasselbe zu bewirken in Java den folgenden Code schreiben:
<syntaxhighlight lang="java">
Connection conn = null;
PreparedStatement ps = null;
ResultSet rs = null;
String sql = "SELECT K_ID AS id, K_NAME AS name, K_STR AS strasse, K_ORT AS ort, K_PLZ AS plz FROM KUNDE WHERE K_ID = ?";
Kunde kunde;
conn = dataSource.getConnection();
ps = conn.preparedStatement(sql);
ps.setInt(1, id);
rs = ps.executeQuery();
rs.next();
kunde = new Kunde();
kunde.setId(rs.getInt("id"));
kunde.setName(rs.getString("name"));
kunde.setStrasse(rs.getString("strasse"));
kunde.setOrt(rs.getString("ort"));
kunde.setPlz(rs.getString("plz"));
rs.close();
conn.close();
System.out.println(kunde);
</syntaxhighlight>

Dieser Code wäre nicht nur wesentlich länger, komplexer, fehleranfälliger und schlechter wartbar, sondern wäre auch weniger performant, da hier noch keine der bei MyBatis eingebauten Performanceoptimierungen, wie beispielsweise [[Connection Pool]]ing, realisiert wurden.

== Siehe auch ==
* [[Java Data Objects]]
* [[Jakarta Persistence API]]
* [[Enterprise JavaBeans#Version 3.0|EJB 3.0 Persistierung]]
* [[Spring (Framework)]]
* [[Serialisierung]]
* [[Hibernate (Framework)]]

== Literatur ==
* {{Literatur
|Autor=Begin Clinton, Brandon Goodin, Larry Meadors
|Titel=iBATIS in Action
|Verlag=Manning
|Ort=Greenwich
|Jahr=2007
|ISBN=1-932394-82-6
|Seiten=384
|Online=[http://www.manning.com/begin/ manning.com]}}

== Weblinks ==
* [http://www.mybatis.org/ MyBatis Projektseite]
* [http://svn.apache.org/repos/asf/ibatis/java/ibatis-3/trunk/doc/en/iBATIS-3-User-Guide.pdf iBATIS 3.0 User Guide] (PDF; 617 kB; englisch)
* [http://ibatis.apache.org/ibator Das Ibator Subprojekt]

== Einzelnachweise ==
<references />

[[Kategorie:Persistenzframework]]
[[Kategorie:Freie Software]]
[[Kategorie:Java-Bibliothek]]
[[Kategorie:Apache-Projekt]]

MyBatis - Versionsgeschichte

imported>Christof46: /* MyBatis Generator */