com.basecmp.core.persistence.impl
Class PersistentAssetFactory

java.lang.Object
  com.basecmp.core.persistence.impl.PersistentAssetFactory

public class PersistentAssetFactory

extends java.lang.Object

Persistenz-Factory-Klasse für die vereinfachte Erzeugung von Persistenz-Objekten. Wann immer mit Persistenzen gearbeitet wird, sollte diese Factory-Klasse benutzt werden, da es sonst bei eingeschaltetem Cache zu Inkonsistenzen kommen kann! Created on 24.05.03 Refactored on 13.01.2006

Author:

Wolfgang Schröder

Method Summary

static PersistentAsset	byAliasId(java.lang.String domain, java.lang.String aliasId)
static PersistentAsset	byAssetType(java.lang.String assetType) Liefert eine leere, unpersistierte PersistentAsset-Instanz des angegebenen Asset-Typs.
static PersistentAsset	byAssetType(java.lang.String assetType, java.lang.Long clientId)
static PersistentAsset	byAssetType(java.lang.String assetType, java.lang.Long clientId, java.lang.String domainname)
static PersistentAsset	byAssetType(java.lang.String assetType, PersistentAsset defaultXmlParentAsset) Liefert eine leere, unpersistierte PersistentAsset-Instanz des angegebenen Asset-Typs, die zusätzlich im Feld XML_ATTRIBUTES leer initialisiertes XML der mit dem defaultXmlParentAsset verknüpften DataTypes.
static PersistentAsset	byAssetType(java.lang.String assetType, java.lang.String domainname)
static PersistentAsset	byCid(long cid) Bequemlichkeitsmethode ruft byCid(String) auf.
static PersistentAsset	byCid(java.lang.Long cid) Bequemlichkeitsmethode ruft byCid(String) auf.
static PersistentAsset	byCid(long cid, java.lang.String assetType) Bequemlichkeitsmethode ruft byCid(String, String) auf.
static PersistentAsset	byCid(java.lang.Long cid, java.lang.String assetType) Bequemlichkeitsmethode ruft byCid(String, String) auf.
static PersistentAsset	byCid(java.lang.String cid) Findet zunächst den Assettyp via der Spalte 'ATY_FK' in der Tabelle COMMON_ASSET für die angegebene CID heraus und ruft dann byCid(String, String) auf.
static PersistentAsset	byCid(java.lang.String cid, java.lang.String assetType) Liefert für einen beliebigen Assettyp vollständig initialisiert PersistentAsset-Objekte.
static java.util.ArrayList	byKey(java.lang.String assetType, java.lang.String[] keyColumns, java.lang.String[] keyValues, boolean live) Liefert ein List-Objekt mit PersistentAsset-Objekten der angegebenen Keys.
static PersistentAsset	byKey(java.lang.String assetType, java.lang.String[] keyColumns, java.lang.String[] keyValues, int index, boolean live) Bequemlichkeitsmethode für #byKey(String, String[], String[]).
static java.util.ArrayList	byKey(java.lang.String assetType, java.lang.String keyColumn, java.lang.String keyValue, boolean live) Bequemlichkeitsmethode für #byKey(String, String[], String[]).
static PersistentAsset	byKey(java.lang.String assetType, java.lang.String keyColumn, java.lang.String keyValue, int index, boolean live) Bequemlichkeitsmethode für #byKey(String, String[], String[]).
static java.lang.String	getAssetType(java.lang.String cid)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

byAliasId

public static PersistentAsset byAliasId(java.lang.String domain,
                                        java.lang.String aliasId)
                                 throws java.lang.Exception

Throws:

java.lang.Exception

byAssetType

public static PersistentAsset byAssetType(java.lang.String assetType)

Liefert eine leere, unpersistierte PersistentAsset-Instanz des angegebenen Asset-Typs.

Ist der angeforderte Asset-Typ nicht im XML definiert, oder geht während der Instanzierung etwas schief, wird eine Exception geworfen. Diese Factory-Methode kann bei allen Persistenztypen verwendet werden.

byAssetType

public static PersistentAsset byAssetType(java.lang.String assetType,
                                          java.lang.Long clientId)

byAssetType

public static PersistentAsset byAssetType(java.lang.String assetType,
                                          java.lang.Long clientId,
                                          java.lang.String domainname)

byAssetType

public static PersistentAsset byAssetType(java.lang.String assetType,
                                          PersistentAsset defaultXmlParentAsset)
                                   throws java.lang.Exception

Liefert eine leere, unpersistierte PersistentAsset-Instanz des angegebenen Asset-Typs, die zusätzlich im Feld XML_ATTRIBUTES leer initialisiertes XML der mit dem defaultXmlParentAsset verknüpften DataTypes.

Die Datatypes müssen mit dem angegebenen Asset unter dem Referenz-Type PersistenceConstants.REFTYPE_XML_ATTRIBUTE_COLLECTIONverknüpft sein. Intern wird die XmlAttributeFactory benutzt, um das XML zu erzeugen.
Bei allen Assets, die mit dieser Methode erzeugt werden, wird das interne Flag enableXmlAttributes gesetzt.

Ist der angeforderte Asset-Typ nicht im XML definiert, oder geht während der Instanzierung etwas schief, wird eine Exception geworfen. Diese Factory-Methode kann bei allen Persistenztypen verwendet werden.

Throws:

java.lang.Exception

byAssetType

public static PersistentAsset byAssetType(java.lang.String assetType,
                                          java.lang.String domainname)

byCid

public static PersistentAsset byCid(long cid)
                             throws java.lang.Exception

Bequemlichkeitsmethode ruft byCid(String) auf.

Throws:

java.lang.Exception

byCid

public static PersistentAsset byCid(java.lang.Long cid)
                             throws java.lang.Exception

Bequemlichkeitsmethode ruft byCid(String) auf.

Throws:

java.lang.Exception

byCid

public static PersistentAsset byCid(long cid,
                                    java.lang.String assetType)
                             throws java.lang.Exception

Bequemlichkeitsmethode ruft byCid(String, String) auf.

Throws:

java.lang.Exception

byCid

public static PersistentAsset byCid(java.lang.Long cid,
                                    java.lang.String assetType)
                             throws java.lang.Exception

Bequemlichkeitsmethode ruft byCid(String, String) auf.

Throws:

java.lang.Exception

byCid

public static PersistentAsset byCid(java.lang.String cid)
                             throws java.lang.Exception

Findet zunächst den Assettyp via der Spalte 'ATY_FK' in der Tabelle COMMON_ASSET für die angegebene CID heraus und ruft dann byCid(String, String) auf. Liefert null, wenn der Asset unter der cid nicht existiert!

Achtung! Da der Assettyp vom Framework automatisch herausgefunden werden muss, funktioniert diese Methode nur bei Persistenzen die auf der Tabelle COMMON_ASSET aufbauen! Wird diese Methode trotzdem benutzt, werden falsche Assets geliefert, da das Framework nur aufgrund der ID nicht wissen kann, in welcher Tabelle der tatsächliche Asset steht!

Throws:

java.lang.Exception

byCid

public static PersistentAsset byCid(java.lang.String cid,
                                    java.lang.String assetType)
                             throws java.lang.Exception

Liefert für einen beliebigen Assettyp vollständig initialisiert PersistentAsset-Objekte. Diese Methode funktioniert auch für Non-Basic-Assets, d.h. Assets die nicht auf der COMMON_ASSET-Tabelle aufbauen!

Throws:

java.lang.Exception

byKey

public static java.util.ArrayList byKey(java.lang.String assetType,
                                        java.lang.String[] keyColumns,
                                        java.lang.String[] keyValues,
                                        boolean live)
                                 throws java.lang.Exception

Liefert ein List-Objekt mit PersistentAsset-Objekten der angegebenen Keys. Die Anzahl der angegebenen Keys und Key-Spalten muss gleich gross sein.

Throws:

java.lang.Exception

byKey

public static PersistentAsset byKey(java.lang.String assetType,
                                    java.lang.String[] keyColumns,
                                    java.lang.String[] keyValues,
                                    int index,
                                    boolean live)
                             throws java.lang.Exception

Bequemlichkeitsmethode für #byKey(String, String[], String[]). Liefert nur den ersten Asset oder null, der angegebenen Werte.

Throws:

java.lang.Exception

byKey

public static java.util.ArrayList byKey(java.lang.String assetType,
                                        java.lang.String keyColumn,
                                        java.lang.String keyValue,
                                        boolean live)
                                 throws java.lang.Exception

Bequemlichkeitsmethode für #byKey(String, String[], String[]). Setzt intern die Skalare keyColumn und keyValue als Arrays mit einem Eintrag.

Throws:

java.lang.Exception

byKey

public static PersistentAsset byKey(java.lang.String assetType,
                                    java.lang.String keyColumn,
                                    java.lang.String keyValue,
                                    int index,
                                    boolean live)
                             throws java.lang.Exception

Bequemlichkeitsmethode für #byKey(String, String[], String[]). Setzt intern die Skalare keyColumn und keyValue als Arrays mit einem Eintrag. Liefert nur den ersten Asset oder null, der angegebenen Werte.

Throws:

java.lang.Exception

getAssetType

public static java.lang.String getAssetType(java.lang.String cid)