Konventionen und Anforderungen für die Definition von mit pureQuery zu verwendenden Beans

Die Konventionen für die Definition von Beans sind flexibel und es gibt nur wenige Anforderungen.

Sie können Beans mit pureQuery verwenden, um die Werte der Parameter in SQL-Anweisungen anzugeben und Abfrageergebnisse zurückzugeben.

Die JavaBeans™-Spezifikation definiert Konventionen für die Definition einer Objektklasse, Konventionen zur Deklaration von Eigenschaften im Objekt sowie die Benennung der Methoden get() und set() für die Bearbeitung dieser Eigenschaften. Eine Objektklasse, die den JavaBeans-Konventionen entspricht, ist optimal für die Nutzung des Leistungsspektrums von pureQuery geeignet.

pureQuery ist jedoch auch für die Nutzung mit Objekten geeignet, die nicht genau den Konventionen entsprechen. Wenn beispielsweise die Methoden get() oder set() für eine bestimmte Eigenschaft nicht vorhanden sind, kann pureQuery die Eigenschaft direkt lesen oder setzen.

pureQuery ermittelt Eigenschaften in einer Bean auf der Grundlage der allgemein zugänglichen Methoden get() und set() sowie der allgemein zugänglichen Felder in der Bean.

pureQuery stellt lediglich sieben Anforderungen an die Definition einer Bean, die die Ergebnisse einer Abfrage aufnehmen soll:
  • Eine Bean muss entweder explizit oder implizit einen No-Arg-Konstruktor haben.
  • Die Namen der Eigenschaften in einer einzelnen Bean müssen für eine von der Groß-/Kleinschreibung unabhängige Suche eindeutig sein. Daher können Sie beispielsweise keine Eigenschaften mit den Namen "id" und "ID" in derselben Bean erstellen.
  • Die Methoden get() und set() müssen paarweise verwendet werden. Sie können keine Methode get() ohne eine entsprechende Methode set() verwenden und umgekehrt. Die Anzahl Parameter und ihre Typen müssen für beide Methoden identisch sein.
  • Beans können keine Methoden get() oder set() ohne zugehörige Eigenschaften enthalten.
  • Beans können allgemein zugängliche Felder enthalten. Wenn Sie geschützte oder private Felder verwenden, muss die Bean allgemein zugängliche Methoden get() (oder allgemein zugängliche Methoden is() für boolesche Eigenschaften) und allgemein zugängliche Methoden set() enthalten. Wenn eine Bean ein allgemein zugängliches Feld enthält und die entsprechende Methode get(), is() oder set() ebenfalls allgemein zugänglich ist, gibt pureQuery eine Ausnahmebedingung aus.
  • Wenn eine Methode get() den Namen getNAME() aufweist, muss die entsprechende Eigenschaft nAME sein.
  • Felder können nur die Java™-Typen sein, die von JDBC unterstützt werden.

Für Beans, die zur Bereitstellung von Eingabeparametern für eine SQL-Anweisung verwendet werden, gibt es nur die folgende Einschränkung: die Eigenschaften, auf die Parametermarken in der SQL-Anweisung verweisen, müssen für eine von der Groß-/Kleinschreibung unabhängige Suche eindeutig sein.


Feedback