Galileo Computing < openbook > Galileo Computing - Professionelle Bücher. Auch für Einsteiger.
Professionelle Bücher. Auch für Einsteiger.

Inhaltsverzeichnis
Vorwort
1 Java ist auch eine Sprache
2 Sprachbeschreibung
3 Klassen und Objekte
4 Der Umgang mit Zeichenketten
5 Mathematisches
6 Eigene Klassen schreiben
7 Angewandte Objektorientierung
8 Exceptions
9 Generics, innere Klassen
10 Die Klassenbibliothek
11 Threads und nebenläufige Programmierung
12 Datenstrukturen und Algorithmen
13 Raum und Zeit
14 Dateien und Datenströme
15 Die eXtensible Markup Language (XML)
16 Grafische Oberflächen mit Swing
17 Grafikprogrammierung
18 Netzwerkprogrammierung
19 Verteilte Programmierung mit RMI und Web–Services
20 JavaServer Pages und Servlets
21 Applets
22 Midlets und die Java ME
23 Datenbankmanagement mit JDBC
24 Reflection und Annotationen
25 Logging und Monitoring
26 Sicherheitskonzepte
27 Java Native Interface (JNI)
28 Dienstprogramme für die Java-Umgebung
Stichwort

Download:
- ZIP, ca. 14,1 MB
Buch bestellen
Ihre Meinung?

Spacer
<< zurück
Java ist auch eine Insel (8. Auflage) von Christian Ullenboom
Programmieren mit der Java Standard Edition Version 6
Buch: Java ist auch eine Insel (8. Auflage)

Java ist auch eine Insel (8. Aufl.)
8., aktual. Auflage, geb., mit DVD
1.475 S., 49,90 Euro
Galileo Computing
ISBN 978-3-8362-1371-4
Pfeil 24 Reflection und Annotationen
Pfeil 24.1 Metadaten
Pfeil 24.1.1 Metadaten durch JavaDoc-Tags
Pfeil 24.2 Metadaten der Klassen mit dem Class-Objekt
Pfeil 24.2.1 An ein Class-Objekt kommen
Pfeil 24.2.2 Was das Class-Objekt beschreibt
Pfeil 24.2.3 Der Name der Klasse
Pfeil 24.2.4 instanceof mit Class-Objekten
Pfeil 24.2.5 Oberklassen finden
Pfeil 24.2.6 Implementierte Interfaces einer Klasse oder eines Interfaces
Pfeil 24.2.7 Modifizierer und die Klasse Modifier
Pfeil 24.2.8 Die Arbeit auf dem Feld
Pfeil 24.3 Attribute, Methoden und Konstruktoren
Pfeil 24.3.1 Reflections – Gespür für Attribute einer Klasse
Pfeil 24.3.2 Methoden einer Klasse erfragen
Pfeil 24.3.3 Properties einer Bean erfragen
Pfeil 24.3.4 Konstruktoren einer Klasse
Pfeil 24.3.5 Annotationen
Pfeil 24.4 Objekte erzeugen und manipulieren
Pfeil 24.4.1 Objekte erzeugen
Pfeil 24.4.2 Die Belegung der Variablen erfragen
Pfeil 24.4.3 Eine generische toString()-Funktion
Pfeil 24.4.4 Variablen setzen
Pfeil 24.4.5 Private Attribute ändern
Pfeil 24.5 Methoden aufrufen
Pfeil 24.5.1 Statische Methoden aufrufen
Pfeil 24.5.2 Dynamische Methodenaufrufe bei festen Methoden beschleunigen
Pfeil 24.6 Annotationen
Pfeil 24.6.1 Neue Annotationen definieren
Pfeil 24.6.2 Annotationen mit genau einem Element
Pfeil 24.6.3 Beliebige Schlüssel-Werte-Paare
Pfeil 24.6.4 Vorbelegte Elemente
Pfeil 24.6.5 Annotieren von Annotationstypen
Pfeil 24.6.6 Annotationen zur Laufzeit auslesen
Pfeil 24.6.7 Mögliche Nachteile von Annotationen
Pfeil 24.6.8 XDoclet
Pfeil 24.7 Zum Weiterlesen


Galileo Computing - Zum Seitenanfang

24.3 Attribute, Methoden und Konstruktoren Zur nächsten ÜberschriftZur vorigen Überschrift

Ein Class-Objekt bietet nicht nur Zugriff auf Oberklassen, Sichtbarkeiten, Modifizierer und Schnittstellen, sondern natürlich auch auf die Variablen, Methoden und Konstruktoren einer Klasse oder Schnittstelle. Daher kooperiert Class mit fünf weiteren Typen:

  • Constructor. Steht für die Konstruktoren einer Klasse. Es gibt zum Beispiel getConstructors() ein Feld von Konstruktoren zurück.
  • Field. Ermöglicht Zugriff auf die Objekt- und Klassenvariablen, um später Belegungen lesen und Werte verändern zu können.
  • Method. Steht für die Methoden einer Klasse beziehungsweise Operationen der Schnittstellen. Es liefert getDeclaredMethods() die Methoden, die dann später mit invoke() aufgerufen werden können.
  • Annotation. Repräsentiert die Annotationen, die an der Klasse/Schnittstelle festgemacht sind. So liefert zum Beispiel die Class-Methode getAnnotations() die festgemachten Annotationen.
  • Package. Es liefert getPackage() ein Package-Objekt für die Klasse, die eine Versionsnummer beinhaltet, wenn diese im Manifest gesetzt wurde.

Weiterhin gibt es folgende allgemeine Implementierungsbeziehungen:

  • Die Klassen Class, Method, Field und Constructor implementieren eine Schnittstelle Member, um etwa den Namen, die Modifizierer oder die definierende Klasse zu erfragen.
  • Die Klassen Class, Constructor und Method implementieren die Schnittstelle Generic-Declaration, da sie generische Typvariablen deklarieren können.
  • Die Klassen Constructor, Field und Method implementieren AccessibleObject, um die Sichtbarkeit auszuschalten.
  • Class, Constructor, Field, Method und Package implementieren AnnotatedElement, weil sie Annotationen tragen können.

Galileo Computing - Zum Seitenanfang

24.3.1 Reflections – Gespür für Attribute einer Klasse Zur nächsten ÜberschriftZur vorigen Überschrift

Besonders bei Klassen-Browsern oder GUI-Buildern ist es interessant, auf die Variablen eines Objekts zuzugreifen, das heißt, ihre Werte auszulesen und zu verändern. Damit wir an beschreibende Objekte für die in einer Klasse definierten beziehungsweise aus Oberklassen geerbten Variablen gelangen, rufen wir die Methode getFields() für das Class-Objekt der interessierenden Klasse auf. Als Ergebnis erhalten wir ein Array von Field-Objekten. Jeder Array-Eintrag beschreibt eine Objekt- oder Klassenvariable, auf die wir zugreifen dürfen. Nur auf öffentliche, also public-Elemente, haben wir per (gewöhnlicher) Reflection Zugriff. (Auf eine privilegierte Reflection gehen wir hier nicht ein.) Schnittstellen definieren ja bekanntlich nur Konstanten. Somit ist der schreibende Zugriff, den wir später näher betrachten wollen, nur auf in Klassen definierte Variablen beschränkt. Lesen ist natürlich bei Konstanten und Variablen gleichermaßen erlaubt. Beim Zugriff auf die Attribute mittels getFields() müssen wir aufpassen, dass wir uns keine SecurityException einfangen. Das kann uns aber bei vielen Methoden passieren, und weil SecurityException eine RuntimeException ist, muss sie auch nicht extra aufgefangen werden. In der Dokumentation ist sie daher nicht angegeben.

Um für SimpleDateFormat alle Objekt- und Klassenvariablen mit ihren Datentypen herauszufinden, lassen wir eine Schleife über das Field-Array laufen. Die Namen der Variablen finden sich leicht mit getName(). Wir haben aber den zugehörigen Datentyp noch nicht. Dazu müssen wir erst mit getType() ein Class-Objekt für den Typ ermitteln, und dann liefert uns getName() eine String-Repräsentation des Typs.

Listing 24.7 com/tutego/insel/meta/ShowFields.java, main()

Class<?> c = java.text.SimpleDateFormat.class; 
System.out.println( "class " + c.getName() + " {" ); 
for ( Field publicField : c.getFields() ) { 
  String fieldName = publicField.getName(); 
  String fieldType = publicField.getType().getName(); 
  System.out.printf( "  %s %s;%n", fieldType, fieldName ); 
} 
System.out.println( "}" );

Dies ergibt die (gekürzte) Ausgabe:

class java.text.SimpleDateFormat { 
  int ERA_FIELD; 
  int YEAR_FIELD; 
  ... 
  int SHORT; 
  int DEFAULT; 
}

final class java.lang.Class<T> 
implements Serializable, GenericDeclaration, Type, AnnotatedElement

  • Field[] getFields()
    Liefert ein Array mit Field-Objekten. Die Einträge sind unsortiert. Das Array hat die Länge 0, wenn die Klasse beziehungsweise Schnittstelle keine öffentlichen Variablen definiert oder erbt. getFields() liefert automatisch auch Einträge für die aus Oberklassen beziehungsweise Schnittstellen geerbten öffentlichen Variablen.
  • Field getField( String name ) throws NoSuchFieldException
    Erfragt ein bestimmtes Feld.

Die Klasse Field implementiert im Übrigen das Interface Member und ist eine Erweiterung von AccessibleObject. AccessibleObject ist die Basisklasse für Field-, Method- und Constructor-Objekte. Auch Method und Constructor implementieren das Interface Member, das zur Identifikation über getName() oder getModifiers() dient. Zusätzlich liefert getDeclaringClass() das Class-Objekt, das tatsächlich eine Variable oder Methode definiert. Da geerbte Elemente in der Aufzählung mit auftauchen, ist dies der einzige Weg, um die Position der Deklaration in der Vererbungshierarchie exakt zu bestimmen.

Das Field-Objekt lässt sich vieles fragen: nach dem Namen des Attributs, nach dem Datentyp und auch wieder nach den deklarierten Modifizierern. Werfen wir einen Blick auf die to-String()-Methode der Klasse Field:

public String toString() { 
  int mod = getModifiers(); 
  return (((mod == 0) ? "" : (Modifier.toString(mod) + " ")) 
      + getTypeName(getType()) + " " 
      + getTypeName(getDeclaringClass()) + "." 
      + getName()); 
}

Beispiel Für die Schleife über die Field-Objekte von SimpleDateFormat und einem Aufruf von toString() liefern die Zeilen

for ( Field publicField : c.getFields() ) 
  System.out.println( "  " + publicFields );

dann:

class java.text.SimpleDateFormat { 
  public static final int java.text.DateFormat.ERA_FIELD 
  public static final int java.text.DateFormat.YEAR_FIELD 
  ... 
  public static final int java.text.DateFormat.SHORT 
  public static final int java.text.DateFormat.DEFAULT 
}


final class java.lang.reflect.Field 
extends AccessibleObject 
implements Member

  • Class<?> getDeclaringClass()
    Liefert das Class-Exemplar für die Klasse oder die Schnittstelle, in der die Variable definiert wurde. Diese Methode ist Teil der Schnittstelle Member.
  • int getModifiers()
    Liefert die deklarierten Modifizierer für die Variable.
  • String getName()
    Liefert den Namen der Variable. Diese Methode ist Teil der Schnittstelle Member.
  • Class<?> getType()
    Liefert ein Class-Objekt, das dem Datentyp der Variable entspricht.
  • String toString()
    Liefert eine String-Repräsentation. Am Anfang stehen die Sichtbarkeitsmodifizierer (public, protected oder private), und es folgen die weiteren Modifizierer (static, final, transient, volatile). Dann kommt der Datentyp, gefolgt vom voll qualifizierten Namen der definierenden Klasse und schließlich der Name der Variable.

Galileo Computing - Zum Seitenanfang

24.3.2 Methoden einer Klasse erfragen Zur nächsten ÜberschriftZur vorigen Überschrift

Um herauszufinden, über welche Methoden eine Klasse verfügt, wenden wir eine ähnliche Vorgehensweise an wie bei den Variablen: getMethods(). Diese Methode liefert ein Array mit Method-Objekten. Über ein Method-Objekt lassen sich Methodenname, Ergebnistyp, Parametertypen, Modifizierer und eventuell resultierende Exceptions erfragen. Wir werden später sehen, dass sich die durch ein Method-Exemplar repräsentierte Methode über invoke() aufrufen lässt.


Hinweis Auch wenn zwei Klassen die gleiche Methode besitzen, muss doch ein Method-Objekt immer für jede Klasse erfragt werden. Method-Objekte sind immer mit dem Class-Objekt verbunden.



final class java.lang.Class<T> 
implements Serializable, GenericDeclaration, Type, AnnotatedElement

  • Method[] getMethods()
    Gibt ein Array von Method-Objekten zurück, die alle öffentlichen Methoden der Klasse/Schnittstelle beschreiben. Geerbte Methoden werden mit in die Liste übernommen. Die Elemente sind nicht sortiert, und die Länge des Arrays ist null, wenn es keine öffentlichen Methoden gibt.
  • Method getMethod( String name, Class... parameterTypes ) throws NoSuchMethodException Liefert zu einem Methodennamen und einer Parameterliste das passende Method-Objekt oder löst eine NoSuchMethodException aus. Besitzt die Methode keine Parameter – wie eine übliche getXXX()-Methode –, ist das Argument null und wird wegen der Varargs auf Class[] angepasst.

Nachdem wir nun mittels getMethods() ein Array von Method-Objekten erhalten haben, lassen die Method-Objekte verschiedene Abfragen zu. So liefert getName() den Namen der Methode, getReturnType() den Ergebnistyp, und getParameterTypes() erzeugt ein Array von Class-Objekten, das die Typen der Methodenparameter widerspiegelt. Wir kennen dies schon von den Attributen.

Wir wollen nun ein Programm angeben, das alle Methoden und ihre Parametertypen sowie Ausnahmen ausgibt.

Listing 24.8 com/tutego/insel/meta/ShowMethods.java

package com.tutego.insel.meta; 
 
import java.lang.reflect.*; 
 
class ShowMethods 
{ 
  public static void main( String[] args ) 
  { 
    showMethods( java.awt.Color.BLACK ); 
  } 
 
  static void showMethods( Object o ) 
  { 
    for ( Method method : o.getClass().getMethods() ) 
    { 
      String returnString = method.getReturnType().getName(); 
      System.out.print( returnString + " " + method.getName() + "(" ); 
 
      Class<?>[] parameterTypes = method.getParameterTypes(); 
 
      for ( int k = 0; k < parameterTypes.length; k++ ) { 
        String parameterString = parameterTypes[k].getName(); 
        System.out.print( " " + parameterString ); 
 
        if ( k < parameterTypes.length – 1 ) 
          System.out.print( ", " ); 
      } 
      System.out.print( " )" ); 
 
      Class<?>[] exceptions = method.getExceptionTypes(); 
 
      if ( exceptions.length > 0 ) { 
        System.out.print( " throws " ); 
        for ( int k = 0; k < exceptions.length; k++ ) { 
          System.out.print( exceptions[k].getName() ); 
          if ( k < exceptions.length – 1 ) 
            System.out.print( ", " ); 
        } 
      } 
 
      System.out.println(); 
    } 
  } 
}

Die Ausgabe sieht gekürzt so aus:

int hashCode( ) 
boolean equals( java.lang.Object ) 
java.lang.String toString( ) 
... 
[F getRGBColorComponents( [F ) 
... 
void wait( long ) throws java.lang.InterruptedException 
void notify( ) 
void notifyAll( )

Wir bemerken an einigen Stellen eine kryptische Notation, wie etwa »[F«. Dies ist aber lediglich wieder die schon erwähnte Kodierung für Array-Typen. So gibt getRGB-Components() ein float-Array zurück und erwartet ein float-Array als Argument.


final class java.lang.reflect.Method 
extends AccessibleObject 
implements GenericDeclaration, Member

  • Class<?> getDeclaringClass()
    Liefert das Class-Exemplar für die Klasse oder die Schnittstelle, in der die Methode definiert wurde. Diese Methode ist Teil der Schnittstelle Member.
  • String getName()
    Liefert den Namen der Methode. Diese Methode ist Teil der Schnittstelle Member.
  • int getModifiers()
    Liefert die Modifizierer. Diese Methode ist Teil der Schnittstelle Member.
  • Class<?> getReturnType()
    Gibt ein Class-Objekt zurück, das den Ergebnistyp beschreibt.
  • Class<?>[] getParameterTypes()
    Liefert ein Array von Class-Objekten, die die Typen der Parameter beschreiben. Die Reihenfolge entspricht der deklarierten Parameterliste. Das Array hat die Länge null, wenn die Methode keine Parameter erwartet.
  • Class<?>[] getExceptionTypes()
    Liefert ein Array von Class-Objekten, die mögliche Exceptions beschreiben. Das Array hat die Länge null, wenn die Methode keine solchen Exceptions mittels throws deklariert. Das Feld spiegelt nur die throws-Klausel wider. Sie kann prinzipiell auch zu viele Exceptions enthalten, bei einer Methode foo() throws RuntimeException, NullPointerException etwa genau die beiden Ausnahmen.
  • String toString()
    Liefert eine String-Repräsentation der Methode, ähnlich dem Methodenkopf in einer Deklaration.

Galileo Computing - Zum Seitenanfang

24.3.3 Properties einer Bean erfragen Zur nächsten ÜberschriftZur vorigen Überschrift

Eine Bean besitzt Properties (Eigenschaften), die in Java (bisher) durch Setter und Getter ausgedrückt werden, also Methoden, die einer festen Namenskonvention folgen. Gibt es Interesse an den Properties, lässt sich natürlich getMethods() auf dem Class-Objekt aufrufen und nach den Methoden filtern, die der Namenskonvention entsprechen. Die Java-Bibliothek bietet aber im Paket java.beans eine einfachere Lösung für Beans: einen PropertyDescriptor.


Beispiel Gib alle Properties von Color aus (es gibt nur lesbare):

Listing 24.9 com/tutego/insel/meta/PropertyDescriptors.java, main()

BeanInfo beanInfo = Introspector.getBeanInfo( Color.class ); 
for ( PropertyDescriptor pd : beanInfo.getPropertyDescriptors() ) 
  System.out.println( pd.getDisplayName() + " : " + 
                      pd.getPropertyType().getName() );

Die Ausgabe:

RGB : int 
alpha : int 
blue : int 
class : java.lang.Class 
colorSpace : java.awt.color.ColorSpace 
green : int 
red : int 
transparency : int

Interessanter sind vom PropertyDescriptor die Methoden getReadMethod() und getWriteMethod(), die beide ein Method-Objekt liefern – sofern es verfügbar ist –, um so die Methode gleich aufrufen zu können.

BeanInfo liefert mit getPropertyDescriptors() zwar die Properties, kann jedoch über getMethodDescriptors() auch alle anderen Methoden liefern.


Galileo Computing - Zum Seitenanfang

24.3.4 Konstruktoren einer Klasse Zur nächsten ÜberschriftZur vorigen Überschrift

Konstruktoren und Methoden haben einige Gemeinsamkeiten, unterscheiden sich aber insofern, als Konstruktoren keinen Rückgabewert haben. Die Ähnlichkeit zeigt sich auch in der Methode getConstructors(), die ein Array von Constructor-Objekten zurückgibt. Über dieses Array lassen sich dann wieder Name, Modifizierer, Parameter und Exceptions der Konstruktoren einer Klasse erfragen. Wie wir in Abschnitt 24.4.1 sehen werden, lassen sich auch über die Methode newInstance() neue Objekte erzeugen. Wegen der weitgehenden Ähnlichkeit der Klassen Constructor und Method sind die folgenden Methoden hier nicht näher beschrieben.


Beispiel Zeige alle Konstruktoren der Color-Klasse:

Listing 24.10 com/tutego/insel/meta/ShowConstructors.java, main()

for ( Constructor<?> c : java.awt.Color.class.getConstructors() ) 
  System.out.println( c );

Wegen der Ähnlichkeit zu getMethods() gibt die auskunftsfreudige Methode toString() die Signatur aus. Nach dem Aufruf erhalten wir:

public java.awt.Color(float,float,float,float) 
public java.awt.Color(int) 
public java.awt.Color(int,int,int) 
public java.awt.Color(int,int,int,int) 
public java.awt.Color(java.awt.color.ColorSpace,float[],float) 
public java.awt.Color(int,boolean) 
public java.awt.Color(float,float,float)


final class java.lang.Class<T> 
implements Serializable, GenericDeclaration, Type, AnnotatedElement

  • Constructor[] getConstructors()
    Liefert ein Feld mit Constructor-Objekten.
  • Constructor<T> getConstructor( Class... parameterTypes ) throws NoSuchMethodException Liefert ein ausgewähltes Constructor-Objekt.

final class java.lang.reflect.Constructor<T> 
extends AccessibleObject 
implements GenericDeclaration, Member

  • Class<T> getDeclaringClass()
    Eine ziemlich langweilige Methode, da Konstruktoren nicht vererbt werden. Sie gibt immer nur jene Klasse aus, von der das Class-Objekt kommt. Das ist ein wichtiger Unterschied zwischen Methoden und Konstruktoren, der bei dieser Methode deutlich auffällt.
  • Class[] getExceptionTypes()
  • int getModifiers()
  • String getName()
  • Class[] getParameterTypes()

Galileo Computing - Zum Seitenanfang

24.3.5 Annotationen topZur vorigen Überschrift

Ob Annotationen zur Laufzeit vorhanden sind, erfragen Methoden der Schnittstelle AnnotatedElement, die unter anderem Class, Constructor, Field, Method, Package implementieren. Ein Blick in AnnotatedElement verrät, wie an die Annotationen heranzukommen ist:


interface java.lang.reflect.AnnotatedElement

  • Annotation[] getAnnotations()
    Liefert alle an diesem Element assoziierten Annotationen.
  • Annotation[] getDeclaredAnnotations()
    Liefert alle an diesem Element definierten Annotationen. Vererbte Annotationen werden ignoriert.
  • boolean isAnnotationPresent( Class<? extends Annotation> annotationType )
    Erfragt, ob das Element eine bestimmte Annotation besitzt.
  • <T extends Annotation> T getAnnotation( Class<T> annotationType )
    Liefert die Annotationen eines gewünschten Typs.

Im späteren Unterkapitel kommen wir auf Annotationen zurück.



Ihr Kommentar

Wie hat Ihnen das <openbook> gefallen? Wir freuen uns immer über Ihre freundlichen und kritischen Rückmeldungen.






<< zurück
  Zum Katalog
Zum Katalog: Java ist auch eine Insel





Java ist auch eine Insel
Jetzt bestellen


 Ihre Meinung?
Wie hat Ihnen das <openbook> gefallen?
Ihre Meinung

 Tipp
Zum Katalog: Coding for Fun





 Coding for Fun


 Buchempfehlungen
Zum Katalog: Objektorientierte Programmierung





 Objektorientierte
 Programmierung


Zum Katalog: Einstieg in Eclipse 3.4






 Einstieg in
 Eclipse 3.4


Zum Katalog: Java 6 lernen mit Eclipse






 Java 6 lernen
 mit Eclipse


Zum Katalog: NetBeans Platform 6






 NetBeans
 Platform 6


Zum Katalog: Java und XML






 Java und XML


Zum Katalog: Visual C# 2008






 Visual C# 2008


Zum Katalog: IT-Handbuch für Fachinformatiker






 IT-Handbuch für
 Fachinformatiker


Zum Katalog: C++ von A bis Z






 C++ von A bis Z


 Shopping
Versandkostenfrei bestellen in Deutschland und Österreich
InfoInfo




Copyright © Galileo Press 2009
Für Ihren privaten Gebrauch dürfen Sie die Online-Version natürlich ausdrucken. Ansonsten unterliegt das <openbook> denselben Bestimmungen, wie die gebundene Ausgabe: Das Werk einschließlich aller seiner Teile ist urheberrechtlich geschützt. Alle Rechte vorbehalten einschließlich der Vervielfältigung, Übersetzung, Mikroverfilmung sowie Einspeicherung und Verarbeitung in elektronischen Systemen.


[Galileo Computing]

Galileo Press, Rheinwerkallee 4, 53227 Bonn, Tel.: 0228.42150.0, Fax 0228.42150.77, info@galileo-press.de