@ejb.persistence (Methode)

Bereich: Methode

Multiplizität

(0..1): Sie können diesen Tag null oder ein Mal in der Java™-Quellendatei verwenden.

Zweck

Dieser Tag stellt Informationen über die Persistenz der Felder einer CMP-Entity-Bean (Container-Managed Persistence, CMP) bereit. Verwenden Sie diesen Tag für Methoden mit den folgenden Mustern: public abstract Foo getX(), public abstract boolean isX() und public abstract void setX(Foo newVal). Dadurch werden das CMP-Feld X in der generierten CMP-Schicht des Typs Foo sowie konkrete Implementierungen der Methoden getX und setX erstellt. Für BMP werden die Methoden "getXnd" und "setX" generiert, die eine genutzte Markierung überwachen (sodass ejbStore nur aufgerufen wird, wenn dies erforderlich ist).

Wenn der Typ boolean ist, können Sie die get-Methode mit dem Präfix is anstelle von get versehen. Wenn Sie die setter-Methode nicht definieren, wird für die konkrete BMP/CMP-Klasse keine setter-Methode generiert (eine konkrete CMP-Klasse wird nur in EJB 1.1 oder EJB 2.0 bei Verwendung von CMP 1.x generiert). Dies ist in den Fällen hilfreich, wenn nicht über das Programm, sondern über externe Quellen, wie beispielsweise eine gespeicherte Prozedur, definiert wird. Bei einigen Anwendungservern müssen die Parameter jdbc-type und sql-type zusammen angewendet werden, um das ordnungsgemäße Funktionieren sicherzustellen. Informationen hierzu enthält die entsprechende Subtask für den Anwendungsserver. Der Tag gilt für Felder von EJB-Entity-Beans und insbesondere bei den getter-Methoden der persistenten Felder.

.

Parameter

Parameter Typ Anwendbarkeit Beschreibung Verbindlich
column-name Text   Deklariert den Spaltennamen (column-name), dem das CMP-Feld zugeordnet wird falsch
jdbc-type Text   Deklariert den JDBC-Typ. Der Wert muss eines der Felder von java.sql.Types sein (z. B. BIT, CHAR). Dieser JDBC-Typ wird vom CMP-Provider verwendet, um festzulegen, welche Methode bei PreparedStatement und ResultSet für INSERT-, UPDATE- und SELECT-Abfragen aufgerufen werden soll. Sie müssen eines der folgenden Attribute angeben:
  • ARRAY
  • BIGINT
  • BINARY
  • BIT
  • BLOB
  • BOOLEAN
  • CHAR
  • CLOB
  • DATALINK
  • DATE
  • DECIMAL
  • DISTINCT
  • DOUBLE
  • FLOAT
  • INTEGER
  • JAVA_OBJECT
  • LONGVARBINARY
  • LONGVARCHAR
  • NULL
  • NUMERIC
  • OTHER
  • REAL
  • REF
  • SMALLINT
  • STRUCT
  • TIME
  • TIMESTAMP
  • TINYINT
  • VARBINARY
  • VARCHAR
Der Standardwert ist
  • VARCHAR
falsch
sql-type Text   Deklariert den tatsächlichen Typ des Felds in der Datenbank. Dieser Wert wird nur verwendet, wenn der CMP-Container Ihre Tabelle erstellt (falls möglich). falsch
read-only Boolesch   Gibt an, dass ein Feld schreibgeschützt ist. Sie müssen eines der folgenden Attribute angeben:
  • true
  • false
falsch

Feedback