Das hier ist ein experimentelles Projekt zur Anlage und Verwaltung von Urlaubsanträgen o.Ä.

Das Projekt ist eine Java-Web-Anwendung.

• Servlet-Container (Tomcat, Jetty, JBoss etc.)
• MySQL-Datenbank
• Java 1.6 (Höher geht auch)

Die Datenbankzugangsdaten sind hartcodiert. Die Datenbank liegt auf localhost, hat den Namen "anwesenheit" mit Benutzername und Passwort "anwesenheit".

Anlage der Datenbank:

In mysql:

create database anwesenheit default character set utf8; grant all on anwesenheit.* to 'anwesenheit'@'localhost' identified by 'anwesenheit';

Anlage des Datenbankschemas (im Unterprojekt "anwesenheit-core"):

mvn liquibase:update

Wenn man zur Datenbankgenerierung abweichende Verbindungsdaten verwenden möchte, kann man dem Maven-Kommando entsprechende Properties auf der Kommandozeile mitgeben:

• liquibase.db.driver
• liquibase.db.url
• liquibase.db.username
• liquibase.db.password

Beispielwerte findet man im pom.xml von anwesenheit-core. Beispiel:

mvn liquibase:update -Dliquibase.db.url='jdbc:mysql://localhost/anwesenheit_test'

Laden von Testdaten:

mysql -panwesenheit -uanwesenheit anwesenheit < src/main/db/testdata.sql

Es gibt vier Testbenutzer (alle mit Passwort "test"):

• boss
• chef
• demo
• ralli

Der Benutzer "demo" hat Sonderberechtigungen, d.h. dieser Benutzer kann sich die Urlaubsanträge aller anderen Benutzer anzeigen lassen.

Laden von Feiertagen

Die für die korrekte Berechnung des Urlaubszeitraums benötigten Daten lassen sich zur Zeit über einen Unit-Test (CreateFeiertageTest) ausführen. Der Test schreibt die Feiertage der nächsten 10 Jahre in die Tabelle "feiertag". am einfachsten geht das über das Kommando:

mvn test

Die Anwendung wird als Maven-Anwendung gebaut. Im Verzeichnis "anwesenheit":

mvn install

Das War befindet sich dann im Verzeichnis anwesenheit-web/target/anwesenheit-web.war

Um das Projekt in Eclipse zu bearbeiten muss Eclipse maven, WTP und git verstehen. Die notwendigen Eclipse-Plugins können über den Eclipse Marketplace direkt installiert werden:

• Maven Integration for Eclipse WTP (a.k.a m2e-wtp)
• eGit

Die Anwendung wird als normales WAR auf dem Servlet-Container deployed.

Auf JBoss verwendet die Anwendung eine JNDI-Datenquelle. D.h. auch, dass die Anwendung ohne konfigurierte JNDI-Datenquelle nicht startet.

Der Name der Datenquelle ist: AnwesenheitDS. Eine mögliche Konfiguration der Datenquelle sieht in der Datei "standard.xml" folgendermaßen aus:

<datasource jndi-name="java:jboss/datasources/AnwesenheitDS" pool-name="AnwesenheitDS" enabled="true">
  <connection-url>jdbc:mysql://localhost/anwesenheit</connection-url>
  <driver>mysql</driver>
  <security>
      <user-name>anwesenheit</user-name>
      <password>anwesenheit</password>
  </security>
</datasource>

In den Treibern muss dann auch der My-SQL-Treiber stehen:

<drivers>
    <driver name="h2" module="com.h2database.h2">
        <xa-datasource-class>org.h2.jdbcx.JdbcDataSource</xa-datasource-class>
    </driver>
    <driver name="mysql" module="com.mysql"/>
</drivers>

Voraussetzung ist, dass der MySQL-Treiber auf dem JBoss installiert ist. Ein Beispiel für die Installation findet man beispielsweise hier: http://javathreads.de/2011/09/jboss-as-7-mysql-datasource-konfigurieren/ .

Auf JBoss verwendet die Anwendung die Default Mail Session, die man unter dem JNDI-Namen java:jboss/mail/Default findet.