[JPA Support] ist ein Module für die Unterstützung von Hibernate in Zusammenarbeit mit [JSF], insbesondere mit [JSF Ext].

!!!Features
Im wesentlichen sind folgende Features enthalten:

* __Enum-Liste:__ Mit den Datentypen EnumListType und EnumSetType können Enum-Sets in eine einfache Datenbank-Spalte geschrieben werden. Damit wird der Umstand behoben, für jede Enum-Liste eine eigene Tabelle anlegen zu müssen. Über die Enum-List gibt es eine Set-Variante deshalb, weil die List-Variante im Zusammenhang mit der Persistenz zu Problemen führt. Diese werden durch das Set gelöst.
* __HibernateDynamicList:__ Eine dynamische Liste für den Gebrauch von Tables von JSF, Primefaces, Richfaces und weiteren. Die Liste vereinfacht das Datenbank gestützte Paging und Filtering, indem die gewünschte Tabelle einfach als DetachedCriteria übergeben wird. Adaptoren für Primefaces oder Richfaces ermöglichen den direkten Einsatz in den Tables.
* __LongType:__ Eine Basis auf Long-Datenbankspalten, um einfach Datentypen zu implementieren.
* __StringType:__ Eine Basis auf String-Datenbankspalten, um einfach Datentypen zu implementieren.

!!!Dynamische Daten
Viele Web-Oberflächen einschließlich [Primefaces] oder [Richfaces] liefern Listen, Trees und andere Darstellungen, die ein dynamisches Befüllen erlauben. Es werden von der Datenbank immer nur die gerade benötigte Anzahl von Datensätzen geholt. Durch Steuerelemente wie Pager oder Tree-Expansion werden dann Elemente nachgeladen.

Wieso werden solche Elemente nicht öfters  eingesetzt? Die Hemmschwelle sitzt im Anbinden der Datenbank. [JPA Support] enthält Interfaces und Implementierungen, um den wiederholten Code zu kapseln.

!!Dynamic List
Das Interface DynamicList<T> ist die Grundlage für die Anbindung von dynamischen Daten. In [JPA Support] werden dabei die Implementierung mitgeliefert: HibernateDynamicList und RevisionDynamicList:

* __HibernateDynamicList:__ Die wohl meist gebrauchte Implementierung. Diese nimmt im Konstruktor eine DetachedCriteria und eine Class als zugehörigen Ergebnistyp.
* __RevisionDynamicList:__ Nur für die Verwendung von Envers sinnvoll. Nimmt Class, Serializable id und List<Number> revisions als Parameter. Damit können Revisionen aufgelistet werden, die Envers transparent anlegt.

!!Dynamic List Wrapper
In einigen Fällen reicht das einfache Durchreichen der Datensätze nicht aus. Dafür gibt es die Klasse DynamicListWrapper. Diese Klasse nimmt eine andere DynamicList als Parameter und wrappt jedes Ergebnis-Element in eine neue Klasse, indem die Methode list(...) überschrieben wird:

{{{
	@Override
	public List<ProcessStats> list(int first, Integer pageSize, String sortField, Boolean sortOrder,
			Map<String, Object> filters) {
		Processor processor = Context.getContext().getBean(Processor.class);
		List<ProcessStats> list = new ArrayList<>();
		for (Process process : getWrapped().list(first, pageSize, sortField, sortOrder, filters)) {
			long transactionCount = processor.getTransactionCount(user, process, false);
			ProcessStats stats = new ProcessStats(process, transactionCount);
			list.add(stats);
		}
		return list;
	}
}}}

!!!Frontend
Wie kommen die Daten nun ins Frontend? Bei Primefaces kann dies so aussehen:

{{{
<p:dataTable value="#{processList.list}" var="process" lazy="true">
    <p:column>
        <h:outputText value="#{process.value}"/>
    </p:column>
</p:dataTable>
}}}

Die dazugehörige Bean:

{{{
	private PrimefacesDataModel<Process> list;
	
	public PrimefacesDataModel<Process> getList() {
		if (list == null) {
		        DetachedCriteria criteria = DetachedCriteria.forClass(Process.class);
			list = new PrimefacesDataModel<>(new HibernateDynamicList<>(criteria, Process.class));
		}
		return list;
	}
}}}

Die HibernateDynamicList kann natürlich auch an anderer Stelle verwendet werden, als diese direkt in PrimefacesDataModel oder RichfacesDataModel zu kapseln.

!!!Hibernate Helper
Mit dieser Klasse können einige Hibernate-Funktionen genutzt werden, die sonst umständlicher sind oder nur intern zur Verfügung stehen.

||Methode||Beschreibung
|saveAndRefresh|Die Methode speichert eine Entity und läd die Daten neu aus der Datenbank. Der Sinn darin ist, Werte zu aktualisieren, die durch die Datenbank erzeugt wurden. Dies ist dann nützlich, wenn Datenbankskripte, Trigger und Sequenzgeneratoren verwendet werden.
|list|Listet eine Detached Criteria.
|Merged Save|Die Methode save führt einen Save-Or-Update durch, indem ein Merge bei Bedarf durchgeführt wird und anschließend Save bzw. Update ausgeführt wird.
|uniqueResult|Liefer ein Unique Result für eine Detached Criteria.
|makeExecutable|Macht eine Detached Criteria ausführbar.
|getPersister|Ermöglicht den Zugriff auf den Hibernate Persister für ein Entity-Objekt oder eine Entity-Klasse.
|getModified|Gibt eine Map zurück, welche Felder einer Entity modifiziert wurden.
|getDatabaseSnapshot|Gibt den Database Snapshot einer Entity zurück. Es kann sich entweder um einen Cached Snapshot handeln oder es wird ein solcher erstellt.
|getId|Liefert die Id zu einem Entity.

!!!Tree Nodes
Die Klasse com.intersult.jpa.primefaces.BaseTreeNode ist eine abstrakte Implementierung einer Primefaces Treenode. Die Klasse ist vorbereitet, um Daten dynamisch zu erzeugen. Beispielsweise also über die DynamicList aus der Datenbank laden zu können.

{{{
public class CompareTreeNode extends BaseTreeNode {
        [...]

	@Override
	protected void createChildren() {
		if (childMap != null)
			getChildren().addAll(childMap.values());
	}
}
}}}