Frage zu einem Exception oder Api-Dokument

[math.iso@live.de]

Hallo java-programmierer

Methoden die Exception auslösen ,werden in der Api-Dokumentation erwähnt.

Bei einem Auschnitt an einem Beispiel Programm "Java einstieg 6" hat der Autor ,

eine add Methode aus der Basisklasse Container in einem Try-catch Block versehen

Programmauschnitt

setSize(500, 300);
setLayout(new BorderLayout());


try {
    add("North", new TextField("Text 1"));
      add("East", new TextField("Text 1"));
      add("West", new TextField("Text 1"));
      add("South", new TextField("Text 1"));
      add("Center", new TextField("Text 1"));
   }
   catch (IllegalArgumentException ex){
   System.out.println("Falscher Parameter:"+ex);
   }

nun hab ich nach der add Methode in Container nachgeforscht und sehe da kein IllegalArgumentException auslösung

public Component add(String name,
Component comp)Adds the specified component to this container. This is a convenience method for addImpl(java.awt.Component, java.lang.Object, int).
This method is obsolete as of 1.1. Please use the method add(Component, Object) instead.


Throws:
NullPointerException - if comp is null
See Also:
add(Component, Object)

ich hoffe ihr könnt mir behilflich sein

 

[Landei]

Container.add(String name, Component comp) ruft Container.addImpl(Component comp, Object constraints, int index) auf und dort steht geschrieben

...
* @param comp the component to be added
* @param constraints an object expressing layout constraints
* for this component
* @param index the position in the container's list at which to
* insert the component, where <code>-1</code>
* means append to the end
* @exception IllegalArgumentException if {@code index} is invalid;
* if {@code comp} is a child of this container, the valid
* range is {@code [-1, getComponentCount()-1]}; if component is
* not a child of this container, the valid range is
* {@code [-1, getComponentCount()]}
*
* @exception IllegalArgumentException if {@code comp} is an ancestor of
* this container
* @exception IllegalArgumentException if adding a window to a container
* @exception NullPointerException if {@code comp} is {@code null}
* @see #add(Component)
* @see #add(Component, int)
* @see #add(Component, java.lang.Object)
* @see LayoutManager
* @see LayoutManager2
* @since JDK1.1

 

[math.iso@live.de]

aber da steht doch gar nicht dass es augerufen wird sondern ,dass die methode veraltet ist und gegenüber der methode addImpl(Component comp, Object constraints, int index) ihren vorteil hat.

This is a convenience method for addImpl(java.awt.Component, java.lang.Object, int).

convenience = der Vorteil ,der Komfort,der Nutzen (nach übersetzung von Leo.org)

Aus welcher Information etnimmst du ,die Bedeutung der ausrufung in der Api-Dokumentation Landei ????

 

[Landei]

add ruft addImpl auf:

    public Component add(String name, Component comp) {
	addImpl(comp, name, -1);
	return comp;
    }

Und addImpl sagt, es würfe u.U. eine IllegalArgumentException (die auch in add nicht gefangen wird). Adde z.B. ein Window zu deinem Container, und es fliegt eine IllegalArgumentException. Und dein Autor ist etwas übervorsichtig und fängt sie, obwohl sie in dem Beispiel nicht auftreten wird - wo siehst du ein Problem?

 

[math.iso@live.de]

was heißt bei dir es würfe ???würfe ?

u.U???

ich bin doch kein pro wie du :noe:


aber in dem text steht doch gar nicht mit add drine ;

mit meinen englisch-übersetzen heißt das

Adds the specified component to this container. This is a convenience method for addImpl(java.awt.Component, java.lang.Object, int).

nun übersetzt:

Fügt ein festgelegten Komponente zu diesem Container.Diese ist ein bequemliche(oder vorteilhafte ,einfache ) methode für addImpl(parameter 1,parameter 2)

dieses addimpl,das ist der name der methode ,es wird doch gar nicht von aurufen der methode geredet ,hab ich ein übersetzungsfehler ???

 

[voidee]

Verstehe zwar das Problem nicht ganz, aber trotzdem mal folgendes:

die Java Dokumentation zeigt (meistens) immer nur die Fehler, die in der Funktion direkt ausgelöst werden, oder die dem Entwickler/Dokumentierer wichtig erschienen. Da läuft kein Programm drüber, sondern ein Mensch schreibt die Doku, und der gibt an, was ihm wichtig ist und was nicht. In der speziellen Methode add(...) hätte man den Hinweis auf die NullPointerException auch weglassen können, da sie nicht direkt ausgelöst wird. Aber tieger in der Implementation ist das schon wichtig, und deshalb hat man es hier nochmals(!) erwähnt.

Die Methode add(...) ruft intern addImpl(...) auf, und diese kann - unter gewissen Umständen - eine IllegalArgumentException aufrufen. Was heisst hier unter gewissen Umständen?

Container ist eine Basisklasse, die mehrere Komponenten aufnehmen kann, also z.B. auch ein Panel. Auf dieses fiktive Panel kann man das selbe Panel (ähnlich einer Rekursion) nicht nochmal hinzufügen. Es gibt also immer sowas wie eine Eltern-Kind Beziehung der Komponenten. Aber Eltern-(selbe) Eltern geht nicht.

Deswegen gibt es meistens - d.h. dann hat man es "richtig" gemacht - keinen Fehler aber in besonderen Fällen kann ein Fehler auftreteten. Gerade bei verschachtelten Programmen mit vielen Klassen kann das schon mal aus Versehen passieren.

 

[math.iso@live.de]

Also nochmal :

Die Api-Dokumentation ist ja dazu da , dass man weiß ,welche methode ,was ausführt (zum beispiel)

ich will nur eine Sache wissen.

ich will wir wissen , wo bei der api-dokumentation steht ,dass die add(String name , Compenent blabla)methode ,die methode ausruft addimpl...(nach aussage von Landei)

 

[Tobias]

Das steht NICHT in der API-Dokumentation. Aber im Quellcode, der ja für jedermann frei zugänglich ist.. Landei ging es nur darum, dir zu erklären, warum der Autor deines Buches hier meint eine IllegalArgumentException fangen zu müßen.

 

[math.iso@live.de]

wo kann ich mir den quellcode angucken ,auf welcher webseite bzw wo bei java sun?

 

[voidee]

In der API Doku steht doch gleich im ersten Satz:

    /**
     * Adds the specified component to this container.
     * This is a convenience method for {@link #addImpl}.

D.h. doch, dass ich mir auch um die API von addImpl anschauen sollte (ist ja sogar verlinkt).

Dort heisst es

     *
     * @exception IllegalArgumentException if {@code comp} is an ancestor of
     *                                     this container
     * @exception IllegalArgumentException if adding a window to a container
     * @exception NullPointerException if {@code comp} is {@code null}

Steht alles da.[/code]

 

[Tobias]

In deinem JDK-Ordner liegt ein src.zip, da sind alle Quellcodes drin.

 

[Landei]

was heißt bei dir es würfe ???würfe ?

u.U???

u.U. ist natürlich "unter Umständen"

Und "würfe" ist korrekt - wenn auch genauso ungebräuchlich wie veraltet:

http://www.spiegel.de/kultur/zwiebelfisch/0,1518,329439,00.html