Erster Fall: Die Rechnungen der Kunden werden nicht in der Nuclos-Datenbank gespeichert, sondern werden auf einem Drittsystem gepflegt. Dazu kann ein sogenanntes "ProxyBO" Rechnungen im Bo-Wizard erstellt werden. Damit wird ein Interface (hier: "org.nuclet.businessentity.RechnungProxy", wichtig ist das komplette Ausschreiben des Pfades, damit die Klasse aus Proxy-Implementation erkannt wird) zur Verfügung gestellt, dessen Implementation die Daten holt, bzw. schreibt:
package org.nuclet.businessentity; import java.util.*; import org.nuclos.api.exception.*; import org.nuclos.api.rule.*; public class RechnungProxyImpl implements org.nuclet.businessentity.RechnungProxy { private User user; public List<Rechnung> getByKunde(Long id) { List<Rechnung> rlist = new ArrayList<>(); // Get Rechnungen for Kunde with "id" from another source // ... // rlist.add(...) // return rlist; } public List<Rechnung> getAll() { // Get Data from another source } public List<Long> getAllIds() { // Get Data from another source } public Rechnung getById(Long id) { // Get Data from another source } public void insert(Rechnung rechnung) throws BusinessException { // Write Data to another source } public void update(Rechnung rechnung) throws BusinessException { // Write Data to another source } public void delete(Long id) throws BusinessException { // Delete Data within another source } public void commit() { } public void rollback() { } public void setUser(User user) { this.user = user; } }
Zweiter Fall: Es soll eine Sammelbearbeitung geben, bei der die Rechnungen mehrerer Kunden auf einmal bearbeitet werden. Grundsätzlich ist das schon mit dem Standard-Proxy-Interface oben möglich. Um die Performance zu verbessern, gibt es die Option eines weiteren Interface: "org.nuclos.api.rule.CollectiveProcessingProxy" fordert die Implementierung einer zusätzlichen Methode "getForCollectiveProcessing", mit der die Rechnungen mehrerer Kunden auf einmal geholt werden können:
package org.nuclet.businessentity; import java.util.*; import org.nuclos.api.businessobject.attribute.*; import org.nuclos.api.exception.*; import org.nuclos.api.rule.*; import org.nuclos.api.*; public class RechnungProxyImpl implements org.nuclet.businessentity.RechnungProxy, CollectiveProcessingProxy { private User user; public <PK> List getForCollectiveProcessing(ForeignKeyAttribute<PK> attribute, Collection<PK> ids) { if (attribute == Rechnung.KundeId) { List ret = new ArrayList<>(); // Fetch Rechnungen für several Kunden (ids) at once // ret.add(...); // return ret; } return null; // When null is returned, the standard proxy methods (like getByKunde()) will be called } public List<Rechnung> getByKunde(Long id) { // Rest is the same as before // ...
Bitte beachten, dass mit dem Interface "CollectiveProcessingProxy" beim Laden von abhängigen Daten immer zuerst "getForCollectiveProcessing" aufgerufen wird. Nur wenn diese Methode "null" zurück gibt, wird die Standard-Methode "getByKunde" aufgerufen (bei mehreren ids in einer Schleife). Die vollständige Bezeichnung der Methode mit Generics lautet:
<PK> List<? extends BusinessObject<PK>> getForCollectiveProcessing(ForeignKeyAttribute<PK> attribute, Collection<PK> ids);