IOBP2

Abstrakte Oberklasse für die in der Java-Klassenbibliothek verfügbaren Kalendarsysteme. (Für Europa wichtig: java.util.GregorianCalendar)

Die Verwendung von GregorianCalendar ähnelt der von Date. Man erhält ein Objekt das den Zeitpunkt der Erstellung repräsentiert, und es stehen überladenen Konstruktoren zur Verfügung.

Es existieren entsprechende Setter-Methoden.

kalendar1.set(Calendar.YEAR, 2016);

kalendar1.set(Calendar.MONTH, Calendar.AUGUST);

kalendar1.set(Calendar.DAY_OF_MONTH, 24);

kalendar1.set(Calendar.DAY_OF_WEEK, Calendar.MONDAY);

kalendar1.set(Calendar.HOUR_OF_DAY, 20);

kalendar1.set(Calendar.MINUTE, 18);

kalendar1.set(Calendar.SECOND, 12);

Für das Abfragen existiert eine allgemeine get-Methode, die ähnlich funktioniert. Man verwendet diesselben Konstanten.

roll-Methode, mit der einzelne Attribute einfach weitergeschaltet werden können. Sie funktioniert wie die Set- und Get-Methoden:

datum.roll(Calendar.MONTH, 6);

Desweiteren lässt sichmit der getTime-Methode ein normales Date-Objekt erhalten, um es z.B. mittels sdf zu formatieren.

Zu finden im Paket java.io. Die wichtigste Klasse ist die Klasse File. File-Instanzen repräsentieren Dateipfade, an denen Ordner und Dateien vorhanden sein oder erstellt werden können.

Listet die Wurzelverzeichnisse auf. Gibt einen Array mit File-Objekten zurück, die die vorhandenen Wurzelverzeichnisse auflisten.

Zählt die in den Verzeichnissen enthaltenen Unterverzeichnisse und Dateien auf.

Ist eine Zeichenkette, die den Pfad zu einem Ordner, bzw. einer Datei in einem Dateisystem darstellt. DIe Ordner und Unterordner im Pfad werden über ein spezielles Trennzeichen voneinander getrennt.

Ist ein plattformunabhängiges Trennzeichen, welches es einem erspart für jedes OS Dateipfade anders implementieren zu müssen.

• exists()
• isDirectory()
• isFile()
• canRead()
• canWrite()
• length()
• lastModified()

Legen neue Verzeichnisse, oder sogar Verzeichnisspfade an und liefern zurück ob die Operation erfolgreich war.

renameTo-Methode:

"public boolean verschiebeImportierte(File datei) {

String sep = File.seperator;

String pfad = sep + "var" + sep + "imported" + sep;

pfad = pfad + datei.getName();

File neuerOrt = new File(pfad);

return datei.renameTo(neuerOrt);

Sie transportieren Daten zwischen Datenquellen, Datensenken und dem Programm. Eingabedaten werden von einer Datenquelle transportiert, Ausgabedaten werden zu einer Datensenke transportiert.

• Zeichenorientierte Datenströme
  • Reader oder Writer
• Byteorientierte Datenströme
  • InputStream oder OutputStream

jeweils im Paket java.io

• FileInputStream
• AudioInputStream
• ObjectInputStream

• FileOutputStream
• FilterOutputStream
• ObjectOutputStream

• InputStreamReader
• BufferedReader
• StringReader

• OutputStreamWriter
• BufferedWriter
• StringWriter

Transportiert Daten von einer Quelle zu einem Ziele und kann aus verschiedenen Teilen bestehen, durch die die Daten nacheinander fließen.

• FileNotFoundException
• IOException (Fehler bei der Verarbeitung des Eingabestroms.)

Deflater/InflaterInputStream.

• Zweck einer Klasse
• Umstände zur Verwendung
• Vererbung und was dabei zu beachten ist.

Beschreiben die Bedeutung eines Attributs für die Klasse.

Dokumentieren den Zweck der Methode, was die Parameter der Methode bedeuten, und was von der Methode unter welche Bedingungen zurückgegeben wird.

Ist ein Programm, das automatische eine Dokumentation aus speziell kommentiertem Quellcode erstellt. Eingebunden werden nur geklammerte Kommentare die Mit einem doppelten Stern nach dem Slash eröffnet werden. ("/**....*/")

Javadoc erzeugt HTML-Seiten als Codedokumentation, also darf innerhalb der Kommentare auch HTML-Quellcode verwendet werden.

Zur Beschreibung von Methoden und diversen Details stehen sogenannte Javadoc-Tags zur Verfügung, z.B.:

• @param (Beschreibung Methodenparameter. Pro Parameter wird ein @param verwendet.)
• @return (Beschreibung dessen was zurückgegeben wird)
• @throws (Aufführung möglicher Fehlerquellen und die Exceptions die dabei geworfen werden. Pro Exception wird ein @throws verwendet.)
• @author (Angabe des Urhebers)
• @version (Versionsangabe).

Zusätzliche Details zum Quellcode, die Aussagen über den Code machen.

Meta-Informationen zum Quellcode, die vom Java-Compiler und zur Laufzeit programmatisch ausgewertet werden können.

Zum Beispiel:

• @Override: Kennzeichnet überschriebene Methoden. Compiler gibt einen Fehler aus, falls die so gekennzeichnete Methode keine andere überschreibt.
• @Deprecated: Kennzeichnet veraltete Klassen, Attribute und Methoden, welche nicht mehr genutzt werden sollen. Im Code der diese Codeteile benutzt wird dadurch eine Warnung ausgelöst.

Allgemeine Regeln zur Formatierung von Code, welche die Lesbarkeit und Verständlichkeit des Codes wesentlich erleichtern. Insbesondere wenn mehrere Personen an einem Projekt arbeiten und auf Quellcode anderer Entwickler zugreifen müssen. Diese Konventionen wirken sich auf die Strukturierung und Formatierung, sowie die Benennung von Variablen und Methoden aus.

• Paketnamen stets klein geschrieben
• Klassen und Interfaces stets mit Substantiv beschrieben und großer Anfangsbuchstabe. verwendung von Camel-Cases bei zusammengesetzten Wörtern.
• Klassenkonstante werden komplett groß geschrieben und mit Unetrstrich getrennt.
• Methodennamen möglichst als Verben, kleiner Anfangsbuchstabe und Camel-Case.
• Attribute und Variablen sinnvoll benennen um Inhalt daraus schließen zu können.

• Einrückung innerhalb eines Code-Blocks,
• Schließende Schweifklammer auf Höhe der Öffnung des Block unterhalb der letzten Zeile.
• Benötigte Variablen zu Beginn deklarieren und gleichzeitig initialisieren.
• Eine eigene Zeile für jede Deklaration.
• Leerzeilen verwenden um semantisch zusammenhängende Anweisungsabschnitte zu trennen.
• Leerzeichen trennen semantische Einheiten innerhalb einer Codezeile. (Zwische Operanden eines Ausdrucks, aber nicht vor Klammern.

1. Paketdeklaration
2. Importe (alphabetisch sortiert)
3. Klassendeklaration und Vererbung
4. Klassenvariablen und .konstanten
5. Instanzvariablen
6. Konstruktoren
7. Getter & Setter
8. Weitere Methoden.

toString(): String

equals(obj: Object): boolean

hashCode(): int

clone(): Object

Dient der Ausgabe von beliebig vielen Objektinhalten als Zeichenkette.

Wird die Methode nicht angeschrieben und an das gewünschte Ausgabeformat angepasst, so gibt sie stets den Namen der Klasse, gefolgt von einem Hashcode des Objekts aus.

Das Überschreiben bietet außerdem den Vorteil, dass wenn an einer Programmstelle ein String erwartet wird automatisch die toString()-Methode des Objekts aufgerufen wird.

Vergleicht Objekte hinsichtlich ihrer Identität, nicht ihres Inhaltes. Dies ist bei primitive Datenytpen eine triviale Aufgabe, führt bei komplexen Datentypen nur zur booleanschen Ausgabe true, wenn die Referenz identisch ist. Also beide Datentypen auf dasselbe Objekt verweisen.

Werden also zwei komplexe Datentypen mit gleichem Inhalt in unterschiedlichen Objekten verglichen liefert dies als Rückgabe false.

Die Funktionsweise dieses Operators ist also unterschiedlich je nachdem ob man primitve oder komplexe Daatentypen vergleicht.

Dient dem inhaltlichen Vergleich von Objekten. Muss in der Klasse überschrieben werden und in der Überschreibung muss festgelegt werden welche relevanten Daten der Objekte verglichen werden sollen.

Die Methode muss mit dem Abgleich if(this == obj) starten, um zu überprüfen ob bereits auf das gleiche Objekt referenziert wird. Anschließend muss mit dem instanceof-Operator geprüft werden, ob es sicht tatsächlich um Objekte derselben Klasse handelt. Anschließend kann der Vergleich anhand gewählter Attribute erfolgen.

Den Abschluss der Methode bildet die Anweisung return super.equals(obj). Hiermit wird die euqlas()-Methode der Oberklasse aufgerufen. Dies wird bis zum Aufruf der equals()-methode der Klasse Object fortgesetzt, diese unetrscheidet lediglich nurnoch anhand der Referenz.

• Reflexiv: gleiche Objekte müssen immer true liefern
• Symmetrisch: Gleiches Ergebnis egal in welche Richtung verglichen wird, d.h. x.equals(y) muss das gleiche Ergebnis liefern wie y.equals(x)
• Transistiv: Sind zwei Objekte identisch und ein drittes identisch zu einem der beiden, so muss es automatisch identisch zum anderen Objekt sein.
• Konsistent: Solange die relevanten Attribute unverändert bleiben darf sich das Ergebnis nicht verändern.
• Existent: Existiert ein zu vergleichendes Objekt nicht muss der Vergleich immer zu false ausgewertet werden.

Mithilfe eines Schlüssels, der das Objekt anhand seines Inhalts möglichst eindeutig indentifiziert wird ein Vergleich durchgeführt. Die Methode ist relativ schnell da nur der gehashte Code, also eine Ganzzahl, verglichen werden muss.

Müssen geschrieben werden wenn primitive Attribute verarbeitet werden sollen. Dabei sollten folgende Anforderungen erfüllt werden:

• Methode muss stabil sein => zwei inhaltlich gleiche Objekte sollten den gleichen Hashcode erzeugen.
• Die Berechnung muss zur equals-Methode passen, also die gleichen Attribute einbeziehen.
• Die Hash-Code sollten breit gestreut sein, d.h. nur wenige unterschiedliche Asttributbelegungen sollen den gleichen Hash-Wert erzeugen.
• Es sollten nur identitätsstiftende Attribute einbezogen werden.

Wird genutzt um zu vergleichen ob Objekte zueinander größer, kleiner oder gleich sind. Möglichen Rückgaben sind nur die drei Möglichkeiten: Zahl größer null, gleich null oder kleiner null. Für etwaige Fehler, z.B. aufgrund eines falschen Datentyps sollte eine ClassCastException eingefügt werden, die vom aufrufenden Programm aufgefangen und behandelt werden muss.

Mithilfe von Generics lässt sich explizit ein Vergleich für einen bestimmten Typ implementieren.

Diese kapseln primitve Datentypen in Objekte, sodass sie wie Objekte behandelt werden können. Innnerhalb dieser Wrapper-Klassen gibt es zum Beispiel auch implementierte compareTo()-Methoden für Zahlentypen (int, float, double...) mithilfe derer ein einfaches Vergleichen ohne vorige Implementierung einer eigenen Methode ermöglicht wird.