formatting in Java

Ordne Code so, dass ein Leser Bloecke und Operatoren auf einen Blick sieht. In Yard.java behalte die oeffentliche Klasse Yard. Innerhalb von main ruecke die Koerperzeilen ein, schreibe int sum = 10 + 2; mit Leerzeichen um = und +, dann drucke sum. Kompiliere mit javac Yard.java und starte java Yard. Der Bildschirm soll 12 zeigen. Lass Daten fuer die naechste Seite — diese Lektion ist Abstand und indent, nicht Kalendertypen.

Indent innerhalb der geschweiften Klammern

Die Naming-Seite hat exakte Schreibweisen bewiesen. Diese Seite beweist aufgeraeumtes Layout. Oeffne Yard.java. Behalte den oeffentlichen Klassennamen Yard. Loesche uebrige ticketCount / TicketCount-Demos, wenn sie die Formatierungsgeschichte begraben, uebrige nur-Javadoc-add-Dateien, uebrige Debug-Label-Jagden und jeden Tastatur-Scanner. Das Programm darf nicht auf Tippen warten. Eine Importzeile brauchst du nicht.
Schreibe die Klasse und main mit geschweiften Klammern, die einen Block markieren. Die Anweisungen, die zu main gehoeren, einen indent-Level tiefer als die main-Zeile setzen. Eine gaengige Anfaengergewohnheit sind vier Leerzeichen pro Level. Halte in dieser Demo dieselbe Breite auf jeder eingerueckten Zeile.
Halte Leerzeichen um die Zuweisung und das Pluszeichen, damit die Augen Namen von Operatoren trennen koennen:
int sum = 10 + 2;
Dann drucke das Ergebnis:
System.out.println(sum);
Formatierung aendert die Mathematik nicht. Zehn plus zwei ist immer noch zwoelf. Der indent und die Leerzeichen helfen einem Menschen zu scannen, welche Zeilen in main sitzen.

Aus dem Ordner, der Yard.java haelt, starte javac Yard.java. Wenn Klammern, geschweifte Klammern und Semikolons passen, schreibt javac keine eigene Zeile. Dann starte java Yard — nicht java Yard.java. Lass die Endung .java beim Startbefehl weg. Halte eine oeffentliche Klasse in der Datei, damit der Name zu Yard passt.
Der Bildschirm zeigt 12. Geh den Lauf einmal durch. Java startet bei Yard.main. Die eingerueckten Zeilen sind der Koerper. Die Zuweisung speichert zwoelf unter sum. Der Druck schreibt 12. Wenn du die Leerzeichen um = entfernst und trotzdem kompilierst, kann das Ergebnis 12 bleiben — die Leerzeichen waren fuer Leser. Wenn du noetige geschweifte Klammern entfernst oder die Struktur brichst, klagt javac. Diese Seite haelt absichtlich eine vollstaendige, lesbare Form.
Sag die Regel, waehrend du den Bildschirm beobachtest: ruecke den Koerper ein, setze Leerzeichen um die Operatoren, die Augen fangen sollen, dann kompiliere und starte, um zu beweisen, dass das Programm noch funktioniert. Erfinde auf dieser Seite keine Datums- und Zeit-APIs. Daten warten auf die naechste Lektion.
Wenn du noch 4 dann 9 aus einer Naming-Datei siehst, wechsle zur Formatierungs-Lehrdatei und starte java Yard erneut. Wenn jede Zeile ohne indent in Spalte null sitzt, laeuft das Programm vielleicht noch, aber die Blockgrenzen sind schwerer zu lesen. Behalte den indent in der Lehrdatei.

Eine kurze Formatierungs-Karte

Die kurze Karte unten ist die kurze Landkarte dieser Seite. Zuerst rueckst du den Koerper ein. Dann haeltst du Leerzeichen um klare Operatoren. Dann pruefst du mit javac und java Yard. Rate nicht, dass Leerzeichen die Summe aendern. Loesche nicht allen indent, bevor du weisst, dass der Bildschirm noch 12 zeigt.

Halte die Tabelle neben der Lehrdatei, waehrend du editierst. Zeige auf die oeffnende geschweifte Klammer von main, dann auf die eingerueckte sum-Zeile, dann auf die schliessende Klammer. Dieses Zuordnungsspiel ist die ganze Anfaengeridee in einem Durchgang. Werkzeuge, die spaeter automatisch formatieren, folgen aehnlichen Gewohnheiten. Menschen nutzen dieselbe Landkarte, wenn die Datei waechst.
Wenn uebrige Naming-Demos noch in der Naehe liegen, behalte sie als Geschichte. Fuer diese Lektion starte die Formatierungs-Lehrdatei, damit der Bildschirm eine aufgeraeumte Summe zeigt, nicht ein Gross-/Kleinschreibungs-Paar. Wenn javac ueber doppelte oeffentliche Klassen klagt, halte nur Yard public.

Formatierung ist nicht die Mathematik

Eine gedraengte Zeile kann dieselbe Summe berechnen. int sum=10+2; ohne Leerzeichen kann kompilieren und 12 drucken. Diese Seite lehrt trotzdem Leerzeichen, weil Leser weniger ermueden, wenn Operatoren hervorstehen. Indent ist dieselbe Idee fuer Bloecke: der Compiler kuemmert sich um geschweifte Klammern; Leser darum, welche Zeilen zusammengehoeren.
Behandle Formatierung nicht als zweite Programmiersprache. Halte einen klaren Stil in der Lehrdatei. Mische Tabs und Leerzeichen nicht so, dass Zeilen springen. Vier Leerzeichen pro Level reichen fuer diese Anfaengerform.
Wenn das Layout falsch ist, die Token aber stimmen, kann javac trotzdem erfolgreich sein. Deshalb liest du die geschweiften Klammern und den indent zusammen, nicht nur die Bildschirmzahl.

Verglichen mit Naming-Schreibweisen

Auf der Naming-Seite waren ticketCount und TicketCount unterschiedliche Namen. Auf dieser Seite erzeugen Leerzeichen und indent keine neuen Namen. Sie ordnen dieselben Namen und Operatoren so, dass der Block klar ist. Du kompilierst weiterhin Yard.java und startest java Yard. Die neue Gewohnheit ist konsistenter indent in geschweiften Klammern plus lesbarer Operator-Abstand.
Naming beantwortete, welche Schreibweise du nachschlagen sollst. Formatierung beantwortet, wie die Datei aussehen soll, waehrend du hinsiehst. Behalte spaeter beide Gewohnheiten. Diese Lektion isoliert Layout, damit der Bildschirm die Summe nach einem aufgeraeumten Edit beweist.
Wenn eine uebrige Naming-Datei noch offen ist, siehst du vielleicht 4 und 9. Wechsle zur Formatierungsdatei, damit main sum als 12 druckt. Halte Datums-Demos von dieser Seite fern. Halte Tastatureingabe von dieser Seite fern.

Vor den Daten

Du kannst main einruecken, Leerzeichen um = und + setzen, sum als 10 + 2 speichern und nach java Yard den Wert 12 sehen. Kompiliere Yard.java und starte java Yard fuer die behaltene Demo. Das Layout half Lesern; die Mathematik blieb zwoelf. Die naechste Seite sind Daten, wo du mit Kalenderwerten in Java arbeitest.
Behalte die aufgeraeumte Summen-Demo fuer ein klares Layout-plus-Lauf-Paar. Halte Naming-Dateien von dieser Seite fern, wenn du indent uebst. Halte Dates-Dateien von dieser Seite fern bis zu jener Lektion. Diese drei Gewohnheiten sind der Checkpoint, bevor du weitergehst. Wenn die geschweiften Klammern den Block zeigen und der Bildschirm 12 zeigt, hat Formatierung fuer diese Lektion ihre Arbeit getan und du bist bereit fuer das naechste Thema ueber Daten.
Ein letzter Gang durch den Ordner: ein oeffentliches Yard, eingerueckter main-Koerper, beabstandete Operatoren, kein Tastaturwarten, keine erzwungenen Datumstypen. Starte javac Yard.java und java Yard noch einmal auf der Demo, die du offen haeltst. Wenn der Bildschirm noch 12 zeigt und der indent noch den Koerper markiert, ist die Formatierungsform solid und der Kurs kann auf der naechsten Seite zu Daten wechseln. Bevorzuge eine klare Layout-Gewohnheit pro Lesen, damit jeder Durchgang dieselbe Karte lehrt.