Java API lesen lernen

[JavaL]

Hallo,
mag eventuell etwas doof klingen, aber ich versuche gerade die Java API besser lesen zu lernen. Mir ist nicht immer ganz klar, was mit den verschiedenen Ausdrücken in der API gemeint ist. Bitte steinigt mich also nicht.

Ich möchte mal am Beispiel von ArrayList (Java Platform SE 7 ) meine Fragen los werden.

1.) "All Implemented Interfaces": Sind damit alle Interfaces gemeint, auch die die vererbt wurden?
Ich frage deshalb, weil hier angegeben ist:

Serializable, Cloneable, Iterable<E>, Collection<E>, List<E>, RandomAccess

Weiter unten aber nur noch:

implements List<E>, RandomAccess, Cloneable, Serializable

(hier fehlen Iterable und Collection)
Collection wird dafür in der AbstractCollection angegeben, woher das Iterable aber kommt, kann ich nicht nachvollziehen.

2.) "Direct Known Subclasses": Damit sind die Klassen gemeint, die von ArrayList erben, oder? Was genau bedeutet das "direct"?

3.) Oft wird "Field" angegeben, z.B. bei ArrayList modCount. Was ist das genau? Sind das Klassenattribute?

4.) modCount erbt ja von java.util.AbstractList, und enthält dann auch einen entsprechenden Wert?

5.) Bei der Detailbeschreibung von Methoden wird angegeben:
5.1) "Specified by": Was genau ist damit gemeint?
5.2) "Overrides": z.B. "add in class AbstractList<E>": Wird die add Methode also in der ArrayList überschrieben oder nicht?
5.3) "Returns": Hier wird oftmals noch angegeben, z.B. "as specified by Collection.add(E)". Gleiche Frage, was heißt hier spezifiziert?

Ich hoffe ihr könnt mich erhellen.
Danke schonmal!

 

[calousy]

1) Ja. Iterable kommt vom Collection-Interface, das das implementiert: public interface Collection<E> extends Iterable<E>

2) Genau. Direct bedeutet nur in der ersten Ebene. Bsp:

class FirstLevel<T> extends ArrayList<T> {}
	
class SecondLevel<T> extends FirstLevel<T> {}

Die Klasse würde bei ArrayList also in den direct known subclasses stehen, SecondLevel nicht, da es zwar auch von ArrayList erbt, aber nicht direkt sondern mittels einer weiteren Klasse

3) Ja, sind Klassenattribute, die in der Klasse sichtbar sind, da sie vererbt wurden (protected oder public) Bsp.:

class FirstLevel<T> extends ArrayList<T> {
	public FirstLevel() {
		this.modCount = 0; // valider Code; modCount wird durch java.util.AbstractList vererbt
	}
}

4) modCount wurde von AbstractList<E> an ArrayList<E> vererbt.

5.1) Methoden von Interfaces müssen ja implementiert werden (das ist eine Art "Vertrag"); Bspw. ist die Methode "size()" (neben anderen Interfaces) im Interface Collection<E> definiert und muss daher in der Klasse ArrayList<E> (die ja Collection<E> implementiert), auch konkret definiert werden. Beispiel:

interface MyInterface{
	void myMethod();
}
	
class MyClass implements MyInterface
{	
}

Hier würde bei "MyClass" die IDE meckern, da die Methode myMethod() nicht in MyClass definiert ist ("The type Main.MyClass must implement the inherited abstract method
Main.MyInterface.myMethod()"

class MyClass implements MyInterface
{
	public void myMethod() {}
}

und alles ist gut

5.2) genau. add() ist in AbstractList<E> schon implementiert, wird aber in ArrayList<E> überschrieben

5.3) siehe die Methode im Interface. Hier ist der Rückgabewert definiert (im Bsp. zu 5.1 void)


Du kannst dir auch die Implementierungen von ArrayList etc. z.B. in Eclipse ansehen. JDK installieren, und dann mit Strg+Klick (oder F3) auf den Typ und du siehst den Inhalt vom .class-File des Codes.

 

[JavaL]

Hallo,
super vielen Dank, das hat mir sehr geholfen. Ich hab nur noch eine kurze Rückfrage zu diesem "Specified by".

Bei add (ArrayList (Java Platform SE 7 ))) gibt es ja zwei Interfaces, in denen add deklariert ist (Collection und List).

Specified by:
add in interface Collection<E>
Specified by:
add in interface List<E>

Bei "Returns" steht ja

as specified by Collection.add(E)

. Könnte da nicht auch

as specified by List.add(E)

stehen?

 

[calousy]

Nein, kann nicht. Das Interface List<E> wird erweitert um das Interface Collection<E> (also: List<E> extends Collection<E>). In Collection<E> ist die Signatur der Methode add() bereits definiert, wie du der API von Collection<E> ja entnehmen kannst. Das ist also die unterste Ebene, die den Rückgabewert definiert.

Der Code wird ungefähr so aussehen (im Interface stehen ja nur die Methodensignaturen, keine Implementierung)

public interface Collection<E> extends Iterable<E> {
    boolean add(E e);
}

public interface List<E> extends Collection<E>{
}

 

[JavaL]

Alles klar. Danke für die sehr verständlichen Erklärungen!