Formator

1. Formatowanie liczb i dat

• destynację formatowanych danych (dokąd mają być zapisane), którą m.in. może być String, StringBuffer, plik tekstowy,

• lokalizację (ustawienia regionalne, reprezentowane przez obiekt klasyLocale), wpływającą  m.in. na reprezentację liczb i dat,

• stronę kodową (do kodowania napisów) - m.in. dla plików i Stringów

• statyczne metody format w klasie String, pozwalające na uzyskiwanie sformatowanych napisów,
• metody format i printf (działające tak samo) w klasach PrintStream i PrintWriter, wyprowadzające sformatowane napisy "na wyjście" (np. na standardowe wyjście lub do pliku).

import java.util.*;

public class Format1 {

  public static void main(String[] args) {
    double cena = 1.52;
    double ilosc = 3;
    double koszt = cena * ilosc;
    System.out.printf("Koszt wynosi %.2f zł", koszt);
    System.out.printf("\nData: %tF", Calendar.getInstance());
  }

}

System.out.printf(Locale.ROOT, "Koszt wynosi %.2f zł", koszt);

import javax.swing.*;

public class Format2 {

  public static void main(String[] args) {
    System.out.println("Wyrównany wydruk tablicy (po 2 elementy w wierszu)");
    int[] arr = { 1, 100, 200, 4000 };
    int k = 1;
    for (int i : arr) {
      System.out.printf("%5d", i);
      if (k%2 ==0) System.out.println();
      k++;
    }
    // Zastosowanie znaku < (element formatu stosowany wobec argumentu z poprzedniego formatowania)
    System.out.println("Zaokraglenia");
    System.out.printf("%.3f %<.2f %<.1f", 1.256 );
    
    // Znak < szczególnie przydatny w datach/czasie
    Calendar c = Calendar.getInstance();
    c.set(Calendar.MONTH, 1);
    System.out.printf("\nW roku %tY i miesiącu %<tm mamy %d dni", c, c.getActualMaximum(Calendar.DATE) );
    
    // Oczywiście możemy formatować do Stringów
    String dateNow = String.format("%td-%<tm-%<tY", System.currentTimeMillis());
    JOptionPane.showMessageDialog(null, dateNow);
  }

}

2. Interfejs Formattable

1. wywoływana jest metoda formatTo z klasy obiektu,
2. metodzie formatTo jest przekazywany formator (jako parametr formatter), flagi formatowania (parametr flags), szerokość pola (parametr width) i precyzja (parametr precision),
3. w metodzie formatTo możemy sprawdzić wartości przekazanych informacji (np. locale formatora, flagi, szerokość precyzje) i na tej podstawie podjąć odpowiednie działania przetwarzające obiekt do wynikowego napisu,
4. przed zwróceniem sterowania z metody formatTo wywołujemy metodę format przekazanego formatora,
5. sformatowany napis będzie przez formator zapisany do odpowiedniej destynacji (np. wyprowadzony na standardowe wyjście).

• ALTERNATE - oznacza, że należy użyć alternatywnej formy sformatowania obiektu (w formacie użyto znaku #),
• LEFT_JUSTIFY - sformatowany napis będzie wyrównany w polu do lewej (w formacie użyto znaku -),
• UPPERCASE - zamiana liter na duże (użyto wielkiej litery w symbolu konwersji np. S, zamiast s).

import java.util.*;
import static java.util.FormattableFlags.*;

public class Person implements Formattable{
  
  private String fname;
  private String lname;

  public Person(String fname, String lname) {
    this.fname = fname;
    this.lname = lname;
  }

  @Override
  public void formatTo(Formatter formatter, int flags, int width, int precision) {
    String txt = lname;
    if ((flags & ALTERNATE) == ALTERNATE) txt += ' ' + fname;
    String fs = "%";
    if ((flags & LEFT_JUSTIFY) == LEFT_JUSTIFY) fs += '-';
    if (width >= 0) fs += width;
    if (precision >= 0) fs += "."+precision;
    fs += ((flags & UPPERCASE) == UPPERCASE) ?  "S" : "s";
    formatter.format(fs, txt);
  }


  public static void main(String[] args) {
    Person e =  new Person("Jan", "Kowalski");
    System.out.printf("%#s\n", e);
    System.out.printf("%20s\n", e);
    System.out.printf("%#30S\n", e);
    System.out.printf("%#.10S\n", e);
  }

}