formatting en Java

Ordena el codigo para que un lector vea bloques y operadores de un vistazo. En Yard.java, mantén la clase publica Yard. Dentro de main, indenta las lineas del cuerpo, escribe int sum = 10 + 2; con espacios alrededor de = y +, luego imprime sum. Compila con javac Yard.java y ejecuta java Yard. La pantalla debe mostrar 12. Deja las fechas para la pagina siguiente — esta leccion es espaciado e indent, no tipos de calendario.

Indenta dentro de las llaves

La pagina de naming probo ortografias exactas. Esta pagina prueba un layout ordenado. Abre Yard.java. Mantén el nombre de clase publica Yard. Borra demos sobrantes de ticketCount / TicketCount si entierran la historia de formatting, archivos solo-Javadoc de add, cazas de etiquetas debug, y cualquier Scanner de teclado. El programa no debe esperar que escribas. No necesitas linea import.
Escribe la clase y main con llaves que marcan un bloque. Pon las sentencias que pertenecen a main un nivel de indent mas profundo que la linea main. Un habito comun de principiante es cuatro espacios por nivel. Mantén el mismo ancho en cada linea indentada de esta demo.
Mantén espacios alrededor de la asignacion y del signo mas para que los ojos separen nombres de operadores:
int sum = 10 + 2;
Luego imprime el resultado:
System.out.println(sum);
El formatting no cambia la matematica. Diez mas dos sigue siendo doce. El indent y los espacios ayudan a un humano a ver cuales lineas se sientan dentro de main.

Desde la carpeta que guarda Yard.java, ejecuta javac Yard.java. Cuando parentesis, llaves y puntos y coma coinciden, javac no escribe una linea propia. Luego ejecuta java Yard — no java Yard.java. Quita la extension .java del comando de ejecucion. Mantén una clase publica en el archivo para que el nombre coincida con Yard.
La pantalla muestra 12. Recorre la ejecucion una vez. Java empieza en Yard.main. Las lineas indentadas son el cuerpo. La asignacion guarda doce bajo sum. La impresion escribe 12. Si quitas los espacios alrededor de = y aun compilas, el resultado puede seguir siendo 12 — los espacios eran para lectores. Si quitas llaves requeridas o rompes la estructura, javac se queja. Esta pagina mantiene a proposito una forma completa y legible.
Di la regla mientras miras la pantalla: indenta el cuerpo, espacia los operadores que quieres que los ojos atrapen, luego compila y ejecuta para probar que el programa sigue funcionando. No inventes APIs de fecha y hora en esta pagina. Las fechas esperan la siguiente leccion.
Si aun ves 4 luego 9 de un archivo de naming, cambia al archivo de enseñanza de formatting y ejecuta java Yard otra vez. Si cada linea se sienta en la columna cero sin indent, el programa quizas aun se ejecute, pero los limites del bloque son mas duros de leer. Mantén el indent en el archivo de enseñanza.

Un mapa corto de formatting

El mapa de abajo es el mapa corto de esta pagina. Primero indentas el cuerpo. Luego mantienes espacios alrededor de operadores claros. Luego verificas con javac y java Yard. No adivines que los espacios cambian la suma. No borres todo el indent antes de saber que la pantalla sigue mostrando 12.

Mantén la tabla junto al archivo de enseñanza mientras editas. Señala la llave de apertura de main, luego la linea indentada de sum, luego la llave de cierre. Ese juego de emparejar es toda la idea de principiante en una pasada. Las herramientas que auto-formatean despues siguen habitos similares. Los humanos usan el mismo mapa cuando el archivo crece.
Si demos de naming sobrantes siguen cerca, guardalas como historia. Para esta leccion ejecuta el archivo de enseñanza de formatting para que la pantalla muestre una suma ordenada, no un par de sensibilidad a mayusculas. Si javac se queja de clases publicas duplicadas, mantén solo Yard public.

El formatting no es la matematica

Una linea apretada aun puede calcular la misma suma. int sum=10+2; sin espacios puede compilar e imprimir 12. Esta pagina aun ensena espacios porque los lectores se cansan menos cuando los operadores destacan. El indent es la misma idea para bloques: el compilador cuida las llaves; los lectores cuidan ver cuales lineas van juntas.
No trates el formatting como un segundo lenguaje de programacion. Mantén un estilo claro en el archivo de enseñanza. No mezcles tabs y espacios de un modo que haga saltar las lineas. Cuatro espacios por nivel basta para esta forma de principiante.
Cuando el layout esta mal pero los tokens estan bien, javac aun puede tener exito. Por eso lees las llaves y el indent juntos, no solo el numero en pantalla.

Comparado con ortografias de naming

En la pagina de naming, ticketCount y TicketCount eran nombres distintos. En esta pagina, espacios e indent no crean nombres nuevos. Ordenan los mismos nombres y operadores para que el bloque sea obvio. Sigues compilando Yard.java y ejecutando java Yard. El habito nuevo es indent consistente dentro de las llaves mas espaciado legible de operadores.
El naming respondio cual ortografia buscar. El formatting responde como debe verse el archivo mientras miras. Mantén ambos habitos despues. Esta leccion aisla el layout para que la pantalla pruebe la suma tras una edicion ordenada.
Si un archivo de naming sobrante sigue abierto, puedes ver 4 y 9. Cambia al archivo de formatting para que main imprima sum como 12. Mantén demos de fechas fuera de esta pagina. Mantén la entrada de teclado fuera de esta pagina.

Antes de las fechas

Puedes indentar main, espaciar = y +, guardar sum como 10 + 2, y ver 12 despues de java Yard. Compila Yard.java y ejecuta java Yard para la demo que mantienes. El layout ayudo a los lectores; la matematica se quedo en doce. La pagina siguiente es fechas, donde trabajas con valores de calendario en Java.
Mantén la demo de suma ordenada para un par claro de layout-mas-ejecucion. Mantén archivos de naming fuera de esta pagina cuando practiques indent. Mantén archivos de dates fuera de esta pagina hasta esa leccion. Esos tres habitos son el punto de control antes de avanzar. Cuando las llaves muestran el bloque y la pantalla muestra 12, el formatting hizo su trabajo en esta leccion y estas listo para el siguiente tema sobre fechas.
Una ultima pasada por la carpeta: un Yard publico, cuerpo de main indentado, operadores espaciados, sin espera de teclado, sin tipos de fecha forzados. Ejecuta javac Yard.java y java Yard una vez mas en la demo que mantienes abierta. Si la pantalla sigue mostrando 12 y el indent sigue marcando el cuerpo, la forma de formatting es solida y el curso puede pasar a fechas en la pagina siguiente. Prefiere un habito claro de layout por lectura para que cada pasada ensene el mismo mapa.