Programowanie Obiektowe Java

Programowanie Obiektowe Java Małgorzata Janik Zakład Fizyki Jądrowej malgorzata.janik@pw.edu.pl http://java.fizyka.pw.edu.pl/

Operacje wejścia-wyjścia strumienie

Pakiety IO Java dostarcza dwóch podstawowych pakietów (z podpakietami), służących do przeprowadzania operacji wejścia-wyjścia: java.io java.nio Pakiet java.io zawiera przede wszystkim klasy, które pozwalają operować na strumieniach danych. W pakiecie java.nio ("Java new input-output", w skrócie NIO) wprowadzono dodatkowe środki wejścia-wyjścia, takie jak kanały, bufory i selektory Mimo nazwy ("new input-output") środki te nie zastępują klas strumieniowych. Służą przede wszystkim do zapewnienia wysokiej efektywności i elastyczności programów, które w bardzo dużym stopniu obciążone są operacjami wejściawyjścia. W szczególności dotyczy to serwerów, które muszą równolegle obsługiwać ogromną liczbę połączeń sieciowych. Zródło: http://edu.pjwstk.edu.pl/wyklady/poj/scb/strumienie/strumienie.html 3/85

Pakiety IO Java dostarcza dwóch podstawowych pakietów (z podpakietami), służących do przeprowadzania operacji wejścia-wyjścia: java.io java.nio Pakiet java.io zawiera przede wszystkim klasy, które pozwalają operować na strumieniach danych. W pakiecie java.nio ("Java new input-output", w skrócie NIO) wprowadzono dodatkowe środki wejścia-wyjścia, takie jak kanały, bufory i selektory Mimo nazwy ("new input-output") środki te nie zastępują klas strumieniowych. Służą przede wszystkim do zapewnienia wysokiej efektywności i elastyczności programów, które w bardzo dużym stopniu obciążone są operacjami wejściawyjścia. W szczególności dotyczy to serwerów, które muszą równolegle obsługiwać ogromną liczbę połączeń sieciowych. Stosunkowo niedawno (w Javie 7) doszedł również pakiet NIO.2... Zródło: http://edu.pjwstk.edu.pl/wyklady/poj/scb/strumienie/strumienie.html 4/85

Strumienie Image by Thalpha 5/85

Strumienie Strumień danych jest pojęciem abstrakcyjnym, logicznym. Oznacza ciąg danych, właśnie strumień, do którego dane mogą być dodawane i z którego dane mogą być pobierane. Przy czym: strumień związany jest ze źródłem lub odbiornikiem danych, źródło lub odbiornik mogą być dowolne: plik, pamięć, URL, gniazdo, potok... strumień służy do zapisywania/odczytywania informacji - dowolnych danych, program: kojarzy strumień z zewnętrznym źródłem/odbiornikiem, otwiera strumień, dodaje lub pobiera dane ze strumienia, zamyka strumień. przy czytaniu lub zapisie danych z/do strumienia mogą być wykonywane dodatkowe operacje (np. buforowanie, kodowanie/dekodowanie, kompresja/dekompresja) w Javie dostarczono szereg klas reprezentujących strumienie; hierarchia tych klas pozwala na programowanie w sposób abstrahujący od konkretnych źródeł i odbiorników. Żródło: http://edu.pjwstk.edu.pl/wyklady/poj/scb/strumienie/strumienie.html 6/85

Klasy strumieni Żródło: Java Tutorial, Sun Microsystems 2002 7/85

Strumienie wejściowe / wyjściowe Strumień wejściowy 8/85

Strumienie wejściowe / wyjściowe Na strumieniach możemy wykonywać dwie podstawowe operacje: odczytywanie danych z pliku, z konsoli, z tablicy, z zewnętrznego urządzenia, z gniazda... zapisywanie danych do pliku, na ekran, do gniazda... Z tego punktu widzenia możemy mówić o strumieniach wejściowych i wyjściowych. I odpowiednio do tego Java wprowadza dwie rozłączne hierarchie klas strumieniowych: klasy strumieni wejściowych i klasy strumieni wyjściowych. Source: https://www.javatpoint.com/java-io 9/85

Strumienie wejściowe / wyjściowe Ilość wejściowych / wyjściowych strumieni w programie jest nieograniczona: od 0 do N. 10/85

Strumienie powiązane z konsolą W Javie istnieją strumienie tworzone automatycznie powiązane z konsolą: System.out: strumień standardowego wyjścia System.in: strumień stndardowego wejścia System.err: strumień standardowego wyjścia błędu Kod do wypisania informacji / błędu w konsoli: System.out.println("simple message"); System.err.println("error message"); Kod do wczytania informacji z konsoli: int i=system.in.read();//returns ASCII code of 1st character System.out.println((char)i);//will print the character https://www.javatpoint.com/javaio 11/85

Strumienie bajtowe / znakowe Pobranie/zapis danych może dotyczyć określonych atomistycznych (minimalnie rozróżnialnych w trakcie operacji) porcji danych. Mogą to być Bajty Znaki (standard w Javie to Unikod, znak Unikodu jest złożony z dwóch bajtów) Wobec tego powstają kolejne dwie rozłączne hierarchie klas strumieniowych: klasy strumieni bajtowych ( atomem operacji we-wy jest bajt), klasy strumieni znakowych ( atomem są znaki Unikodu 2 bajty). Przy przetwarzaniu tekstów należy korzystać ze strumieni znakowych ze względu na to, iż w trakcie czytania/pisania wykonywane są odpowiednie operacje kodowania/dekodowania ze względu na stronę kodową właściwą dla źródła/odbiornika Żródło: http://edu.pjwstk.edu.pl/wyklady/poj/scb/strumienie/strumienie.html 12/85

Strumienie znakowy / bajtowy Strumień wejściowy znakowy Strumień wejściowy bajtowy Nie można ich traktować tak samo Oddzielne klasy dla obu przypadków. 13/85

Rodzaje strumieni Zatem w Javie mamy 4 podstawowe rodzaje strumieni: Wejścia / wyjścia Bajtowe / znakowe Wejście Wyjście Strumień bajtowy InputStream OutputStream Strumień znakowy Reader Writer 14/85

Klasy strumieni InputStream, OutputStream, Reader, Writer 4 klasy strumieni abstrakcyjnych 4 klasy strumieni abstrakcyjnych Żródło: Java Tutorial, Sun Microsystems 2002

Rodzaje strumieni Wejście Wyjście Strumień bajtowy InputStream OutputStream Strumień znakowy Reader Writer Powyższe klasy strumieni to klasy abstrakcyjne, zatem bezpośrednio nie można tworzyć obiektów tych klas. Dostarczają one natomiast podstaw dla wszystkich innych klas strumieniowych oraz paru ogólnych użytecznych (choć bardzo podstawowych) metod. Metody te umożliwiają m.in. czytanie - read(..) (bajtów, znaków) - różne wersje tej (przeciążonej) metody pozwalają na przeczytanie jednego bajtu ze strumienia bajtowego lub znaku ze strumienia znakowego albo całej porcji bajtów/znaków, zapisywanie - write(..) (bajtów/znaków) - różne wersje tej (przeciążonej) metody pozwalają zapisywac pojedyńcze bajty/znaki lub tablice bajtów/znaków, a w przypadku strumieni znakowych również napisy (obiekty klasy String), pozycjonowanie strumieni (metody skip(..), mark(..), reset() ) - każdy strumień może być traktowany jako sekwencja bajtów/znaków, czytanie i zapisywanie zawsze dotyczy bieżącej pozycji tej sekwencji; po wykonaniu operacji czytania lub zapisu bieżąca pozycja zwiększa się o jeden; metody pozycjonowania pozwalają zmieniać bieżącą pozycję. zamykanie strumieni (metoda close()) - strumień zawsze należy zamknąć po zakończeniu operacji na nim. Metody te są zazwyczaj odpowiednio przedefiniowane w klasach dziedziczących; polimorfizm zapewnia ich oszczędne i właściwe użycie. 16/85

Przykład Klasa która kopiuje strumień wejściowy do strumienia wyjściowego class Stream { static void copy(inputstream in, OutputStream int c; while ((c = in.read())!= -1) out.write(c); } } out) throws IOException { static void copy(reader in, Writer out) throws IOException { int c; while ((c = in.read())!= -1) out.write(c); } Uwaga: metoda read() zwraca liczbę całkowitą, reprezentującą kolejny znak ze strumienia znakowego (lub bajt ze strumienia bajtowego) albo wartość -1 gdy czytanie sięga poza koniec pliku. Klasy abstrakcyjne Wejście Wyjście Strumień bajtowy InputStream OutputStream Strumień znakowy Reader Writer 17/85

Przykład Klasa która kopiuje strumień wejściowy do strumienia wyjściowego class Stream { static void copy(inputstream in, OutputStream int c; while ((c = in.read())!= -1) out.write(c); } } out) throws IOException { static void copy(reader in, Writer out) throws IOException { int c; while ((c = in.read())!= -1) out.write(c); } Uwaga: metoda read() zwraca liczbę całkowitą, reprezentującą kolejny znak ze strumienia znakowego (lub bajt ze strumienia bajtowego) albo wartość -1 gdy czytanie sięga poza koniec pliku. Możemy teraz użyć metody copy wobec dowolnych strumieni z odpowiednich konkretnych klas hierarchii klas strumieniowych, np. Stream.copy(input, output); By kopiowanie miało sens input musi być powiązane z konkretnym źródłem danych, a output konkretnym odbiornikiem danych. 18/85

Przykład Klasa która kopiuje strumień wejściowy do strumienia wyjściowego class Stream { static void copy(inputstream in, OutputStream int c; while ((c = in.read())!= -1) out.write(c); } } out) throws IOException { static void copy(reader in, Writer out) throws IOException { int c; while ((c = in.read())!= -1) out.write(c); } Uwaga: metoda read() zwraca liczbę całkowitą, reprezentującą kolejny znak ze strumienia znakowego (lub bajt ze strumienia bajtowego) albo wartość -1 gdy czytanie sięga poza koniec pliku. Możemy teraz użyć metody copy wobec dowolnych strumieni z odpowiednich konkretnych klas hierarchii klas strumieniowych, np. Stream.copy(input, output); By kopiowanie miało sens input musi być powiązane z konkretnym źródłem danych, a output konkretnym odbiornikiem danych. Strumień (w którymś momencie) musi być związany z konkretnym źródłem bądź odbiornikiem. 19/85

Wiązanie strumienia z danymi Żródło/ odbiornik Strumienie znakowe Strumienie bajtowe Wejście Wejście Wyjście źródła Wyjście źródła Pamięć CharArrayWriter CharArrayWriter ByteArrayInputStream ByteArrayOutputStream String StringReader StringWriter Potok PipedReader PipedWriter PipedInputStream PipedOutputStream Plik FileReader FileWriter FileInputStream FileOutputStream Wymienione wyżej klasy pozwalają na powiązanie strumienia z konkretnym wejściem lub wyjściem. Wyżej wymienione nie są jednak jedynymi, można tu wspomnieć np. o klasie GZIPInputStream który umożliwia obsługę strumieni spakowanych algorytmem gzip. 20/85

Przykład Chcielibyśmy wczytać informacje z jednego pliku tekstowego i zapisać do innego pliku Potrzebujemy Strumienia znakowego na wejściu wczytującego z pliku Strumienia znakowego na wyjściu, zapisującego do pliku 21/85

Przykład Chcielibyśmy wczytać informacje z jednego pliku tekstowego i zapisać do innego pliku Potrzebujemy Strumienia znakowego na wejściu wczytującego z pliku FileReader Strumienia znakowego na wyjściu, zapisującego do pliku FileWriter 22/85

Przykład Chcielibyśmy wczytać informacje z jednego pliku tekstowego i zapisać do innego pliku Potrzebujemy Strumienia znakowego na wejściu wczytującego z pliku FileReader Strumienia znakowego na wyjściu, zapisującego do pliku FileWriter Konstruktor przyjmuje np. static public void main(string[] args) { nazwę / ścieżkę do pliku try { FileReader in1 = new FileReader("plik0.txt"); FileWriter out1 = new FileWriter("plik1.txt"); Stream.copy(in1, out1); in1.close(); out1.close(); } catch(ioexception exc) { exc.printstacktrace(); Po użyciu strumienie } zawsze zamkykamy! 23/85

Przykład Chcielibyśmy wczytać informacje z jednego pliku tekstowego i zapisać do innego pliku Potrzebujemy Strumienia znakowego na wejściu wczytującego z pliku FileReader Strumienia znakowego na wyjściu, zapisującego do pliku FileWriter static public void main(string[] args) { try { FileReader in1 = new FileReader("plik0.txt"); FileWriter out1 = new FileWriter("plik1.txt"); Stream.copy(in1, out1); in1.close(); Możemy użyć kopiowania strumieni out1.close(); zaprezentowanego wcześniej } catch(ioexception exc) { exc.printstacktrace(); } 24/85

Przypomnienie Klasa która kopiuje strumień wejściowy do strumienia wyjściowego class Stream { static void copy(inputstream in, OutputStream int c; while ((c = in.read())!= -1) out.write(c); } } out) throws IOException { static void copy(reader in, Writer out) throws IOException { int c; while ((c = in.read())!= -1) out.write(c); } Uwaga: metoda read() zwraca liczbę całkowitą, reprezentującą kolejny znak ze strumienia znakowego (lub bajt ze strumienia bajtowego) albo wartość -1 gdy czytanie sięga poza koniec pliku. Możemy teraz użyć metody copy wobec dowolnych strumieni z odpowiednich konkretnych klas hierarchii klas strumieniowych, np. Stream.copy(input, output); By kopiowanie miało sens input musi być powiązane z konkretnym źródłem danych, a output konkretnym odbiornikiem danych. Strumień (w którymś momencie) musi być związany z konkretnym źródłem bądź odbiornikiem. 25/85

Przykład II Chcielibyśmy stworzyć strumień ze Stringa i zapisać do pliku Strumienia znakowego na wejściu używającego zadeklarowanego Stringa (z pamięci) Strumienia znakowego na wyjściu, zapisującego do pliku 26/85

Wiązanie strumienia z danymi Żródło/ odbiornik Strumienie znakowe Strumienie bajtowe Wejście Wyjście Wejście Wyjście CharArrayWriter CharArrayWriter ByteArrayInputStream ByteArrayOutputStream StringReader StringWriter Potok PipedReader PipedWriter PipedInputStream PipedOutputStream Plik FileReader FileWriter FileInputStream FileOutputStream Pamięć Strumienia znakowego na wejściu używającego zadeklarowanego Stringa Strumienia znakowego na wyjściu, zapisującego do pliku

Przykład II Chcielibyśmy stworzyć strumień ze Stringa i zapisać do pliku Strumienia znakowego na wejściu używającego zadeklarowanego Stringa StringReader Strumienia znakowego na wyjściu, zapisującego do pliku FileWriter static public void main(string[] args) StringReader { w konstruktorze try { przyjmuje String który ma być źródłem String msg = "Ala ma kota"; StringReader in2 = new StringReader(msg); FileWriter out2 = new FileWriter("plik2.txt"); Stream.copy(in2, out2); in2.close(); out2.close(); } catch(ioexception exc) { exc.printstacktrace(); }

Przykład II Chcielibyśmy stworzyć strumień ze Stringa i zapisać do pliku Strumienia znakowego na wejściu używającego zadeklarowanego Stringa StringReader Strumienia znakowego na wyjściu, zapisującego do pliku FileWriter static public void main(string[] args) { try { String msg = "Ala ma kota"; StringReader in2 = new StringReader(msg); FileWriter out2 = new FileWriter("plik2.txt"); Stream.copy(in2, out2); in2.close(); out2.close(); Przy używaniu strumieni } catch(ioexception exc) { ZAWSZE exc.printstacktrace(); łapiemy wyjątki IOException! }

Uwagi Komentarze: W podanym przykładzie używaliśmy jednej z wersji konstruktorów klas strumieniowych związanych z plikami 4 klasy strumieni abstrakcyjnych podaliśmy jako argument nazwę pliku przy tworzeniu obiektów klas strumieniowych, związanych z plikami, odpowiednie pliki są otwierane; można także utworzyć strumień plikowy podając jako argument konstruktora referenecję do obiektu klasy File (o tym zaraz) strumienie wejściowe są otwierane "tylko metody do odczytu", Nie ma jedynej słusznej otwarcia pliku. strumienie wyjściowe "tylko do zapisu". strumienie wyjściowe mogą być otwarte w trybie dopisywania (należy użyć konstruktora z Istnieje wiele konstruktorów, drugim argumentem "append mode" = true); w takim przypadku dane będo dopisywane do należy dobrać odpowiedni do danej sytuacji. końca strumienia, przy operacjach na strumieniach może powstać wyjątek klasy IOException oznaczający błąd operacji (np. odczytu lub zapisu), a także wyjątki klas pochodnych FileNotFoundException (brak pliku) oraz EOFException (w trakcie operacji czytania lub pozycjonowania osiągnięto koniec pliku), Strumienie danych są wykorzystywane przez wiele programów nie tylko do odczytu plików, ale np. do przesyłania danych pomiędzy poszczególnymi wątkami czy też do sieci.

Uwagi Komentarze: W podanym przykładzie używaliśmy jednej z wersji konstruktorów klas strumieniowych związanych z plikami 4 klasy strumieni abstrakcyjnych podaliśmy jako argument nazwę pliku przy tworzeniu obiektów klas strumieniowych, związanych z plikami, odpowiednie pliki są otwierane; strumienie wejściowe są otwierane "tylko do odczytu", strumienie wyjściowe "tylko do zapisu". można także utworzyć strumień plikowy podając jako argument konstruktora referenecję do obiektu klasy File (o tym zaraz) strumienie wyjściowe mogą być otwarte w trybie dopisywania (należy użyć konstruktora z drugim argumentem "append mode" = true); w takim przypadku dane będo dopisywane do końca strumienia, przy operacjach na strumieniach może powstać wyjątek klasy IOException oznaczający błąd operacji odczytu lub zapisu), a także wyjątki klas pochodnych FileWriter out (np. = new FileWriter("plik.txt"); FileNotFoundException (brak pliku) oraz EOFException (w trakcie operacji czytania lub pozycjonowania osiągnięto koniec pliku), Plik domyślnie otworzy się do zapisu. Nie ma metody open. Strumienie danych są wykorzystywane przez wiele programów nie tylko do odczytu plików, ale np. do przesyłania danych pomiędzy poszczególnymi wątkami czy też do sieci.

Uwagi Komentarze: W podanym przykładzie używaliśmy jednej z wersji konstruktorów klas strumieniowych związanych z plikami 4 klasy strumieni abstrakcyjnych podaliśmy jako argument nazwę pliku przy tworzeniu obiektów klas strumieniowych, związanych z plikami, odpowiednie pliki są otwierane; strumienie wejściowe są otwierane "tylko do odczytu", strumienie wyjściowe "tylko do zapisu". można także utworzyć strumień plikowy podając jako argument konstruktora referenecję do obiektu klasy File (o tym zaraz) strumienie wyjściowe mogą być otwarte w trybie dopisywania (należy użyć konstruktora z drugim argumentem "append mode" = true); w takim przypadku dane będo dopisywane do końca strumienia, przy operacjach na strumieniach może powstać wyjątek klasy IOException oznaczający błąd operacji (np. odczytu lub zapisu), a także wyjątki klas pochodnych FileNotFoundException (brak pliku) oraz EOFException (w trakcie operacji czytania lub pozycjonowania osiągnięto koniec pliku), Strumienie danych są wykorzystywane przez wiele programów nie tylko Trzeba pamiętać o obsłudze wyjątków! do odczytu plików, ale np. do przesyłania danych pomiędzy poszczególnyminależy wątkami czy też do sieci. chociaż wypisać printstacktrace() który wypisuje w konsoli szczegóły problemu

Uwagi Komentarze: W podanym przykładzie używaliśmy jednej z wersji konstruktorów klas strumieniowych związanych z plikami 4 klasy strumieni abstrakcyjnych podaliśmy jako argument nazwę pliku przy tworzeniu obiektów klas strumieniowych, związanych z plikami, odpowiednie pliki są otwierane; strumienie wejściowe są otwierane "tylko do odczytu", strumienie wyjściowe "tylko do zapisu". można także utworzyć strumień plikowy podając jako argument konstruktora referenecję do obiektu klasy File (o tym zaraz) strumienie wyjściowe mogą być otwarte w trybie dopisywania (należy użyć konstruktora z drugim argumentem "append mode" = true); w takim przypadku dane będo dopisywane do końca strumienia, przy operacjach na strumieniach może powstać wyjątek klasy IOException oznaczający błąd operacji (np. odczytu lub zapisu), a także wyjątki klas pochodnych Strumienie często służą(wdotrakcie obsługi plików, FileNotFoundException (brak pliku) oraz EOFException operacji nie tylko czytania lub pozycjonowania osiągnięto koniec ale pliku), Strumienie danych są wykorzystywane przez wiele programów nie tylko do odczytu plików, ale np. do przesyłania danych pomiędzy poszczególnymi wątkami czy też do sieci.

Klasy strumieni Szare elementy oznaczają związane z konkretnym źródłem/odbiornikiem 4 klasy strumieni abstrakcyjnych dyskutowane przed chwilą, Białe - klasy przetwarzające (realizujące określone rodzaje przetwarzania) 4 klasy strumieni abstrakcyjnych dyskutowane za chwilę. Żródło: Java Tutorial, Sun Microsystems 2002

Klasy przetwarzające Samo określenie strumienia często nie wystarcza. Ciągnąc dalej analogię z hydrobudownictwem na tym etapie mamy już źródło i rzekę. Teraz czas stawiać zapory i elektrownie.

Klasy przetwarzające Ciągnąc dalej analogię z hydrobudownictwem na tym etapie mamy już źródło i rzekę. Teraz czas stawiać zapory. Odpowiednikiem zapór są klasy przetwarzające strumienie, służą one do tego aby nasze strumienie bajtów bądź znaków wykorzystać w użyteczny sposób. Przykładem są klasy buforujące. Dzięki temu program może działać szybciej, bo nie musi co chwilę odwoływać się do danych (np. na dosyć powolnym dysku) a czyta je z bufora. Życiowym przykładem takiego bufora jest lodówka, która przechowuje (buforuje) nam kupione w sklepie produkty. Dzięki niej nie musimy biegać co chwilę do sklepu.

Klasy przetwarzające Rodzaj przetwarzania Strumienie znakowe Strumienie bajtowe Buforowanie BufferedReader, BufferedWriter BufferedInputStream, BufferedOutputStream Filtrowanie FilterReader, FilterWriter FilterInputStream, FilterOutputStream Konwersja: bajty-znaki InputStreamReader, OutputStreamWriter Serializacja obiektów ObjectInputStream, ObjectOutputStream Czytanie typów prostych z bajtów DataInputStream, DataOutputStream Zliczanie wierszy LineNumberReader LineNumberInputStream Drukowanie PrintWriter PrintStream

Klasy przetwarzające Jak użyć klasy przetwarzającej? Konstruktory klas przetwarzających mają jako argument referencję do obiektów podstawowych klas abstrakcyjnych hierarchii dziedziczenia (InputSteram, OutputSteram, Reader, Writer). Dlatego przetwarzanie (automatyczna transformacja) danych jest logicznie oderwana od fizycznego strumienia, stanowi swoistą na niego nakładkę. Zatem zastosowanie klas przetwarzających wymaga: stworzenia obiektu związanego z fizycznym źródłem/odbiornikiem, stworzenie obiektu odpowiedniej klasy przetwarzającej, "nałożonego" na fizyczny strumień. Żródło: http://edu.pjwstk.edu.pl/wyklady/poj/scb/strumienie/strumienie.html

Klasy przetwarzające Jak użyć klasy przetwarzającej? Zastosowanie klas przetwarzających wymaga: stworzenia obiektu związanego z fizycznym źródłem/odbiornikiem stworzenie obiektu odpowiedniej klasy przetwarzającej, "nałożonego" na fizyczny strumień. Przykład: najpierw trzeba stworzyć strumień wczytujący z pliku, a dopiero potem go zbuforować. BufferedInputStream bufferedinputstream = new BufferedInputStream(new FileInputStream(from)); Taki "tasiemcowy" dostęp do zbuforowanych danych powoduje znaczne zwiększenie elastyczności kodu, jeśli chce się np. tylko zmienić źródło strumienia wystarczy klasę FileInputStream zastąpić inną np. PipedInputStream. Reszty kodu zaś nie trzeba zmieniać..

Do czego mogą służyć klasy przetwarzające? Klasy buforujące Zmniejszają liczbę fizycznych odwołań do urządzeń zewnętrznych. Przy czytaniu dużych plików tekstowych należy unikać bezpośredniego czytania za pomocą klasy FileReader. To samo dotyczy zapisu. Konwersja bajty-znaki InputStreamReader czyta bajty ze strumienia definiowanego przez InputStream (strumień bajtowy) i zamienia je na znaki (16 bitowe), używając domyślnej lub podanej strony kodowej, OutputStreamWriter wykonuje przy zapisie konwersję odwrotną. Czytanie typów prostych z bajtów DataInputStream i DataOutputStream są strumieniami bajtowymi, ale pozwalają czytać/pisać dane typów pierwotnych (np. short, char, int, float, double, boolean) ze/do strumieni bajtowych. Żródło: http://edu.pjwstk.edu.pl/wyklady/poj/scb/strumienie/strumienie.html

Do czego mogą służyć klasy przetwarzające? Serializacja Klasy LineNumber... służy do "utrwalania" obiektów po to, by odtworzyć je w innym kontekście (przy ponownym uruchomieniu programu lub w innym miejscu, np. programie działającym w innym miejscu sieci po przekazaniu "utrwalonego" obiektu przez socket), zlicza wiersze strumienia przy czytaniu (i pozwala w każdym momencie uzyskać informację o numerze wiersza). Klasy Print... zawierają wygodne metody wyjścia (np. println). Niekoniecznie oznacza to drukowanie fizyczne, często wykorzystywane jest w powiązaniu z innymi strumieniami po to by łatwo wyprowadzać informacje. Żródło: http://edu.pjwstk.edu.pl/wyklady/poj/scb/strumienie/strumienie.html

Przykład Buforowanie wczytywanego pliku Czytanie linia po linii z pliku tekstowego FileReader fr = new FileReader("plik.txt"); // tu powstaje związek z fizycznym źródłem BufferedReader br = new BufferedReader(fr); // tu dodajemy "opakowanie" umożliwiające buforowanie czytamy wiersz po wierszu String line; while ((line = br.readline())!= null) { // kolejny wiersz pliku: metoda readline zwraca wiersz lub null jeśli koniec pliku //... tu coś robimy z odczytanym wierszem }

Przykład Buforowanie wczytywanego pliku Czytanie linia po linii z pliku tekstowego BufferedReader br = new BufferedReader(new FileReader("plik.txt")); // tu powstaje związek z fizycznym źródłem oraz dodajemy "opakowanie" umożliwiające buforowanie czytamy wiersz po wierszu String line; while ((line = br.readline())!= null) { // kolejny wiersz pliku: metoda readline zwraca wiersz lub null jeśli koniec pliku //... tu coś robimy z odczytanym wierszem }

Przykład II Przykład buforowania: program, czytający plik tekstowy i zapisujący jego zawartość do innego pliku tekstowego wraz z numerami wierszy. class Lines { public static void main(string args[]) { try { FileReader fr = new FileReader(args[0]); LineNumberReader lr = new LineNumberReader(fr); BufferedWriter bw = new BufferedWriter( new FileWriter(args[1])); String line; klasa LineNumberReader while ((line = lr.readline())!= null) { dziedziczy klasę BufferedReader, bw.write( lr.getlinenumber() + " " + line); dając możliwość uzyskania numeru wiersza bw.newline(); (metoda getlinenumber()) } lr.close(); bw.close(); } catch(ioexception exc) { System.out.println(exc.toString()); System.exit(1); } } }

Przykład II Przykład buforowania: program, czytający plik tekstowy i zapisujący jego zawartość do innego pliku tekstowego wraz z numerami wierszy. class Lines { public static void main(string args[]) { try { FileReader fr = new FileReader(args[0]); LineNumberReader lr = new LineNumberReader(fr); BufferedWriter bw = new BufferedWriter( new FileWriter(args[1])); String line; klasa LineNumberReader while ((line = lr.readline())!= null) { dziedziczy klasę BufferedReader, bw.write( lr.getlinenumber() + " " + line); dając możliwość uzyskania numeru wiersza bw.newline(); (metoda getlinenumber()) } lr.close(); bw.close(); } catch(ioexception exc) { System.out.println(exc.toString()); przy zamknięciu wyjściowego strumienia System.exit(1);buforowanego zawartość bufora jest zapisywana } do strumienia; istnieje też metoda void flush( ), zapisujące dane które pozostały w buforze } a nie zostały jeszcze zapisane w miejscu przeznaczenia; } takie "ręczne" opróżnianie bufora jest czasem przydatne.

Przykład II Przykład buforowania: program, czytający plik tekstowy i zapisujący jego zawartość do innego pliku tekstowego wraz z numerami wierszy. class Lines { public static void main(string args[]) { try { FileReader fr = new FileReader(args[0]); LineNumberReader lr = new LineNumberReader(fr); BufferedWriter bw = new BufferedWriter( new FileWriter(args[1])); String line; while ((line = lr.readline())!= null) { bw.write( lr.getlinenumber() + " " + line); bw.newline(); } lr.close(); Wyjątki: bw.close(); łapiemy IOException } catch(ioexception exc) { System.out.println(exc.toString()); System.exit(1); } } }

Przykład II Przykład buforowania: program, czytający plik tekstowy i zapisujący jego zawartość do innego pliku tekstowego wraz z numerami wierszy. class Lines { public static void main(string args[]) { try { FileReader fr = new FileReader(args[0]); LineNumberReader lr = new LineNumberReader(fr); BufferedWriter bw = new BufferedWriter( new FileWriter(args[1])); String line; while ((line = lr.readline())!= null) { bw.write( lr.getlinenumber() + " " + line); bw.newline(); zastosowanie metody newline() z klasy BufferedWriter } pozwala w niezależny od platformy systemowej lr.close(); sposób zapisywać separatory wierszy bw.close(); } catch(ioexception exc) { System.out.println(exc.toString()); System.exit(1); } } }

Klasy strumieni Szare elementy oznaczają związane z konkretnym źródłem/odbiornikiem, Białe - klasy przetwarzające (realizujące określone rodzaje przetwarzania). Żródło: Java Tutorial, Sun Microsystems 2002

Inne ważne klasy IO/NIO File Path Przykłady

File File, w przeciwieństwie do tego, co sugeruje nazwa, nie reprezentuje pliku Reprezentuje nazwę (wraz ze ścieżką) danego pliku albo nazwę (wraz ze ścieżką) zbioru plików w katalogu Konstruktory klasy file: File(String pathname) tworzy obiekt File na podstawie ścieżki podanej jako napis (to może być plik lub katalog) File(File parent, String child) tworzy obiekt File na podstawie innego obiektu File (zawierającego zbiór plików) i nazwy konkretnego pliku File(String parent, String child) tworzy obiekt File na podstawie ścieżki podanej jako napis (zawierającej zbiór plików) i nazwy konkretnego pliku File(URI uri) URI oznacza referencję Uniform Resource Identifier, pozwala m.in linkować do źródeł zewnętrznych (np. z internetu). https://docs.oracle.com/javase/7/docs/api/java/net/class-use/uri.html

File Wybrane metody public String getname() - zwraca nazwę pliku lub katalogu w postaci napisu public String getpath() - zwraca ścieżkę w postaci napisu public boolean isfile() - sprawdza, czy podany obiekt File jest zwykłym plikiem (a nie, np. katalogiem) public String[] list() - żeby wyciągnąć nazwy pojedynczych plików ze zbioru używamy list() która zwraca tablicę znaków public boolean delete(): usuwa plik albo katalog na który wskazuje dany obiekt File https://www.tutorialspoint.com/java/java_file_class.htm

import java.io.file; File Przykład public class FileDemo { FileDemo.java public static void main(string[] args) { File f = null; String[] strs = { "test1.txt", "test2.txt" }; try { // dla kazdego string w tablicy strs Tworzymy nowy for (String s : strs) { // stworz nowy obiekt File obiekt File f = new File(s); // true jesli wykonywalny boolean bool = f.canexecute(); // znajdz sciezke absolutna String a = f.getabsolutepath(); Wyciągamy dane o pliku // wypisz sciezke absolutna z informacja o wykonywalnosci System.out.print(a); System.out.println(" is executable: " + bool); } } } } catch (Exception e) { // jesli pojawi sie IO exception e.printstacktrace(); } Wyjątki: łapiemy IOException

Path Przed Javą SE 7 zawsze używano java.io.file Jednak wraz z Javą SE 7 powstała nowa klasa, Path, która robi to samo co File, tylko lepiej i więcej Ze względu na powszechność jej użycia, prawdopodobnie nigdy nie zostanie całkowicie wycofana / zastąpiona Mamy dostęp do metadanych takich jak uprawnienia (permissions) danego pliku, wsparcie dla linków symbolicznych, lepiej sobie radzi z bardzo dużymi katalogami, metoda rename(..) działa tak samo na różnych platformach, dokładniejsze informacje dotyczące sytuacji wyjątkowych Ogólne zasady: Dla nowych projektów lepiej używać Path Na tą chwilę File nie można uznać za przestarzałe

Path File Path file = new File("path/to/file.txt") path = Paths.get("path/to/file.txt") file = new File(parentFile, "file.txt") path = parentpath.resolve("file.txt") file.getfilename() path.getfilename().tostring() file.delete() Files.delete(path) path.tofile() file.topath() // Microsoft Windows syntax Path path = Paths.get("C:\\home\\joe\\foo"); // Linux syntax Path path = Paths.get("/home/joe/foo"); https://gquintana.github.io/2017/09/02/java-file-vs-path.html

JFileChooser JFileChooser chooser = new JFileChooser(); chooser.showdialog(null, "Wybierz"); chooser.getselectedfile();

JFileChooser Okienko pozwalające wybrać pik public class JFileChooserExample { public static void main(string[] args) { JFileChooser chooser = new JFileChooser(); PlikiWyborFile.java PlikiWyborPath.java chooser.setdialogtitle("wybierz plik"); //Otwarcie okienka; metoda blokuje się do czasu wybrania pliku lub zamknięcia okna int result = chooser.showdialog(null, "Wybierz"); if (JFileChooser.APPROVE_OPTION == result){ System.out.println("Wybrano plik: " + chooser.getselectedfile()); }else { System.out.println("Nie wybrano pliku"); }} } Wyciągamy plik tylko jeśli użytkownik go wybrał (a nie np. nacisnął X)

JFileChooser Okienko pozwalające wybrać pik public class JFileChooserExample { public static void main(string[] args) { JFileChooser chooser = new JFileChooser(); PlikiWyborFile.java PlikiWyborPath.java chooser.setdialogtitle("wybierz plik"); //Otwarcie okienka; metoda blokuje się do czasu wybrania pliku lub zamknięcia okna int result = chooser.showdialog(null, "Wybierz"); if (JFileChooser.APPROVE_OPTION == result){ System.out.println("Wybrano plik: " + chooser.getselectedfile().topath()); }else { System.out.println("Nie wybrano pliku"); }} }

Wczytywanie z pliku tekstowego PlikiTekstoweOdczyt2.java public class PlikiTekstoweOdczyt2 { public static void main(string[] args) { FileReader fr = null; String linia = ""; FileReader łączymy strumień // OTWIERANIE PLIKU: try { fr = new FileReader("plik.txt"); BufferedReader bfr = new BufferedReader(fr); // ODCZYT KOLEJNYCH LINII Z PLIKU: while ((linia = bfr.readline())!= null) { System.out.println(linia); } // ZAMYKANIE PLIKU fr.close(); } catch (Exception e) { System.out.println("BLAD IO!"); System.exit(1); } }} ze źródłem (plik.txt) BufferedReader buforujemy wczytywany plik Wczytywanie linia po linii używając readline Zamknięcie strumienia

public class PlikiTekstoweOdczyt { public static void main(string[] args) { FileReader fr = null; String linia = ""; PlikiTekstoweOdczyt.java Wczytywanie z pliku tekstowego // OTWIERANIE PLIKU: try { fr = new FileReader("plik.txt"); } catch (FileNotFoundException e) { System.out.println("BLAD PRZY OTWIERANIU PLIKU!"); System.exit(1); Otwarcie } BufferedReader bfr = new BufferedReader(fr); Jeden wspólny blok try-catch można zastąpić kilkoma blokami szczegółowymi // ODCZYT KOLEJNYCH LINII Z PLIKU: try { while((linia = bfr.readline())!= null){ Odczyt System.out.println(linia);} } catch (IOException e) { System.out.println("BLAD ODCZYTU Z PLIKU!"); System.exit(2); } // ZAMYKANIE PLIKU try {fr.close();} catch (IOException e) { System.out.println("BLAD PRZY ZAMYKANIU PLIKU!"); System.exit(3); }} } Zamknięcie

Zapisywanie do pliku tekstowego PlikiTekstoweZapis.java public class PlikiTekstoweZapis { public static void main(string[] args) { String[] linie = { "Pierwsza linia tekstu do zapisania", "druga linia - kilka liczb: (12), -23, 44.5, 2,5", "trzecia linia " }; FileWriter łączymy strumień z plikiem do zapisu (plik.txt) FileWriter fw = null; try { fw = new FileWriter("plik.txt"); BufferedWriter bw = new BufferedWriter(fw); for (int i = 0; i < linie.length; i++) { bw.write(linie[i]); bw.newline(); } bw.close(); } catch (IOException e) { e.printstacktrace(); } } } BufferedReader buforujemy zapisywany plik Zapisujemy linia po linii używając write + newline Zamknięcie pliku (zamykamy zewnętrzny strumień)

4 sposoby zapisu do pliku WriteToFile4Ways.java FileWriter BufferedWriter Podstawowa klasa do zapisu plików tekstowych; używaj jeśli liczba zapisów w programie jest niewielka Buforowanie umożliwia zmniejszenie ilości operacji IO; używaj jeśli spodziewasz się większej ilości zapisów do plików tekstowych OutputStream Zapisuje dane w postaci bajtów a nie znaków; nie poradzi sobie z bardziej zaawansowanym znakami Unicode, ale można używać do zapisu zwykłego tekstu ASCII; używaj jeśli potrzebujesz zapisać dane (niekoniecznie tekst) BufferedOutputStream, jeśli mamy dużo zapisów bajtowych Files.write Metoda dodana w Java SE 7, wewnętrznie wykorzystuje OutputStream

Random Access Files Jeśli potrzebujesz coś zapisać w konkretnym miejscu istniejącego pliku a nie tworzyć nowy lub dopisywać na końcu należy wtedy użyć RandomAccessFile pozwala na zapisanie na konkretnej pozycji w danym pliku Pozycja jest określana przez offset, przesunięcie, w stosunku do początku pliku. Uwaga, wtedy istniejący tekst zostanie NADPISANY private static void writetofile(string filepath, String data, int position) throws IOException { RandomAccessFile file = new RandomAccessFile(filePath, "rw"); file.seek(position); file.write(data.getbytes()); file.close(); } RandomAccessFileOdczyt.java RandomAccessFileZapis.java

Odczyt zasobów zawartych w JAR OdczytZPlikuJAR.java To się przyda na projektach jeśli mamy plik, który jest wewnątrz pliku JAR, możemy go otworzyć za pomocą wywołania: getclass().getresourceasstream("nazwa_pliku"); Przykład odczytu: InputStream inputstream = OdczytPlikuZJAR.class.getResourceAsStream("rekopis.txt"); BufferedReader bufferedreader = new BufferedReader( new InputStreamReader(inputStream, Charset.forName("UTF-8"))); String line = bufferedreader.readline(); while (line!= null) { System.out.println(line); line = bufferedreader.readline(); }

Kodowanie Czyli problemy z krzaczkami http://kursdlaopornych.pl/iso-ascii-unicode-kodowanie-znakow/

Kodowanie Z punktu widzenia informacji na dysku nie rozróżniamy plików znakowych od bajtowych Dla obu informacja jest zapisana za pomocą bajtów W przypadku plików tekstowych należy bajty przetworzyć na znaki. Sposób w jaki bajty są zamieniane na znaki nazywany jest kodowaniem. Popularne rodzaje kodowania: ASCII - pozwala zapisać znaki podstawowego alfabetu łacińskiego wykorzystując 1 bajt na zapis jednego znaku CP1250 - pozwala zapisać znaki podstawowego alfabetu łacińskiego oraz pewne znaki diakrytyczne (w tym polskie) wykorzysując 1 bajt na zapis jednego znaku UTF-8, UTF-16, UTF-32 - pozwala zapisać dowolne znaki, zużywając 1 (UTF-8), 2 (UTF-16) lub 4 (UTF-32) bajty na znak. Najpopularniejsze jest UTF-8 Windows (języki środkowoeuropejskie) domyślnie używa CP-1250 Java używa kodowania UTF-16 jako wewnętrznej reprezentacji wszystkich struktur, również string jest zbiorem znaków kodowanych w UTF-16.

Kodowanie Najprostszą metodą na obsługę kodowania jest wczytanie bajtów ze strumienia wejściowego i konwersja z odpowiednim kodowaniem przy użyciu konstruktora new String(tablica_bajtów, "kodowanie"). By odczytać pliki tekstowe w jakimś kodowaniu należy uzyskać instancję klasy Charset. Do uzyskania instancji klasy Charset służy metoda Charset.forName, przyjmująca nazwę danego kodowania: System.out.println("Kodowanie UTF-32: " + Charset.forName("UTF-32")); Dodatkowo w Javie istnieje domyślne kodowanie możliwe do uzyskania za pomocą: Charset.defaultCharset(). System.out.println("Domyślne kodowanie w tym komputerze: " + Charset.defaultCharset()); Wczytanie pliku z wybranym kodowaniem: InputStreamReader streamreader = new InputStreamReader(inputStream, Charset.forName("UTF-8"));

Strumienie przykładowe programy Podstawy BuforZnakowy.java przykład użycia StringBuffer Konsola.java wczytanie i wypisanie tekstu w konsoli Omawiane na wykładzie FileDemo.java używanie zmiennej File PlikiTekstoweOdczyt(2).java - odczyt z plików tekstowych PlikiTekstoweZapis.java zapis do plików tekstowych PlikiWyborFile.java, PlikiWyborPath.java użycie JFileChooser WriteToFile4Ways.java cztery sposoby na zapisywanie do plików RandomAccessFileOdczyt(Zapis).java użycie RandomAccessFile Inne ListNotes.java zapisywanie notatek do pliku tekstowego z konsoli LoadObjects.java zapisywanie obiektów klas (a nie tekstu / liczb) SaveObjects.java zapisywanie obiektów klas (a nie tekstu / liczb)

Więcej informacji http://edu.pjwstk.edu.pl/wyklady/poj/scb/strumienie/strumienie.html http://www.samouczekprogramisty.pl/strumienie-w-jezyku-java/ http://pojava.fizyka.pw.edu.pl/index.php/laboratoria/laboratorium-4 https://docs.oracle.com/javase/tutorial/essential/io/pathops.html

Quiz time

Pytanie 1 Regularnie chcielibyśmy zapisywać do pliku wyniki symulacji. Plik ma format tekstowy. Którego strumienia powinniśmy użyć do obsługi zapisu? (a) InputStream (b) OutputStream (c) FileWriter (d) BufferedWriter

Pytanie 2 Ile strumieni wyjściowych możemy mieć otwartych na raz? (a) Zawsze tylko jeden na raz (b) Jeden danego typu (1 wejściowy i 1 wyjściowy) (c) Wiele (tyle, na ile pozwolą nam zasoby systemu)

Pytanie 3 Połącz domyślne kodowania do środowiska (a) CP1250 (a) Linux (b) UTF-8 (b) Java (c) UTF-16 (c) Windows

Pytanie 4 Jeśli napisy w programie mi się brzydko krzaczą panieĺ skim rumieĺ cem dziä cielina jak najlepiej mogę zaradzić problemowi? (a) Skasować wszystkie polskie znaki (b) Sprawdzić, w jakim kodowaniu został zapisany problematyczny tekst i odpowiednio go wczytywać (c) Zmienić ustawienia w Javie by automatycznie zawsze dobrze wczytywała wszystkie teksty

Pytanie 4 Jeśli napisy w programie mi się brzydko krzaczą panieĺ skim rumieĺ cem dziä cielina jak najlepiej mogę zaradzić problemowi? (a) Skasować wszystkie polskie znaki (b) Sprawdzić, w jakim kodowaniu został zapisany problematyczny tekst i odpowiednio go wczytywać (c) Zmienić ustawienia w Javie by automatycznie zawsze dobrze wczytywała wszystkie teksty Cudów ni ma.

Prosta grafika w Javie

Dodawanie obrazów do projektu Dodajemy obrazek do konkretnego pakietu 1 PPM na nazwie pakietu 4 klasy strumieni abstrakcyjnych Import 4 klasy strumieni abstrakcyjnych File System 4 klasy strumieni abstrakcyjnych Browse.. 4 klasy strumieni abstrakcyjnych Wybrać katalog 4 klasy strumieni abstrakcyjnych Wybrać plik z listy 4 klasy strumieni abstrakcyjnych Finish 4 Import 5 wybór z listy 2 3 6

Dodawanie obrazów do projektu Dodajemy obrazek do konkretnego pakietu PPM na nazwie pakietu 4 klasy strumieni abstrakcyjnych Import 4 klasy strumieni abstrakcyjnych File System 4 klasy strumieni abstrakcyjnych Browse.. 4 klasy strumieni abstrakcyjnych Wybrać katalog 4 klasy strumieni abstrakcyjnych Wybrać plik z listy 4 klasy strumieni abstrakcyjnych Finish 1 Import nazwa_pakietu/nazwa_obrazka.jpg 54 wybór z listy 2 3 6

Rysowanie obrazka na panelu public class ImagePanel extends JPanel { ImagePanel.java private BufferedImage image; public ImagePanel() { super(); // Plik umieszczony w podpakiecie "obrazki" URL resource = getclass().getresource("obrazki/zdjecie.jpg"); try { image = ImageIO.read(resource); } catch (IOException e) { System.err.println("Blad odczytu obrazka"); e.printstacktrace(); } } } Dimension dimension = new Dimension(image.getWidth(), image.getheight()); setpreferredsize(dimension); public void paintcomponent(graphics g) { Graphics2D g2d = (Graphics2D) g; g2d.drawimage(image, 0, 0, this); }

Grafika 86/85

Grafika (Java2D) Klasa Graphics2D dużo większe możliwości tworzenia grafiki (m.in. łatwa obsługa przezroczystości, wypełnienia gradientowe, transformacje geometryczne, ) SimpleGraphics.java przykład wykorzystania klasy Graphics2d Gradient.java przykład wypełniania gradientowego TextureGraphics.java przykład wykorzystania tekstur SaveImage.java przykład tworzenia buforowanego obrazka i zapisu do pliku graficznego. 87/85

Przykład rysowania przy użyciu Graphics 2d // Tworzenie ksztaltu i rysowanie wypelnienienia - fill Ellipse2D e=new Ellipse2D.Double(80,80,180,80); g2.setpaint(color.cyan); g2.fill(e); // Kontruktor Color() z czterema argumentami float // czwarty odpowiada za "przezroczystosc": g2.setcolor(new Color(1.0f, 1.0f, 0.0f, 0.6f)); g2.fill(star); g2.setcolor(new Color (0.2f, 0.2f, 0.2f, 0.5f)); g2.draw(star); SimpleGraphics.java // Tworznie ksztaltu i rysownanie konturu - draw // set Stroke ustawia wlasciwosci linii Rectangle2D r=new Rectangle2D.Double(50,50,100,200); g2.setpaint(c0); g2.setstroke(new BasicStroke(10)); g2.draw(r); 88/85

Przykład wykorzystania tekstur przy użyciu Graphics 2d BufferedImage im = new BufferedImage(imW,imH, BufferedImage.TYPE_INT_RGB); // nalezy wypełnić odpowiednim wzorem BufferedImage im, np. Graphics2D g2im = im.creategraphics(); g2im.setcolor(new Color(192,192,192)); g2im.fillrect(0,0,imw,imh); //albo wczytać obrazek TextureGraphics.java // wykorzystanie tekstury do rysowania, tekstu itp. - setpaint() TexturePaint tp = new TexturePaint(im, new Rectangle(imW,imH)); g2.setpaint(tp); g2.fill(new RoundRectangle2D.Float(75,20,150,200,30,30)); g2.setfont(new Font("Verdana",Font.BOLD,24)); g2.drawstring("here's the text",10,260); 89/85

Przykład wykorzystania tekstur przy użyciu Graphics 2d BufferedImage im = new BufferedImage(imW,imH, BufferedImage.TYPE_INT_RGB); // nalezy wypełnić odpowiednim wzorem BufferedImage im, np. Graphics2D g2im = im.creategraphics(); g2im.setcolor(new Color(192,192,192)); g2im.fillrect(0,0,imw,imh); //albo wczytać obrazek TextureGraphics.java // wykorzystanie tekstury do rysowania, tekstu itp. - setpaint() TexturePaint tp = new TexturePaint(im, new Rectangle(imW,imH)); g2.setpaint(tp); g2.fill(new RoundRectangle2D.Float(75,20,150,200,30,30)); g2.setfont(new Font("Verdana",Font.BOLD,24)); g2.drawstring("here's the text",10,260); 90/85

Zapisywanie obrazka do pliku SaveImage.java BufferedImage im; // nalezy zadeklarować odpowiednio obrazek try { ImageIO.write( im, "png" /* "png" "jpeg"... format desired */, new File ( "gwiazda.png" ) /* target */ ); } catch (IOException e1) { e1.printstacktrace(); System.out.println("Blad przy zapisywaniu obrazku do pliku"); System.exit(1); } 91/85

Tworzenie i korzystanie z plików JAR Biblioteka JFreeChart

Czym są pliki JAR? JAR (ang. Java ARchive) archiwum ZIP używane do strukturalizacji i kompresji plików klas języka Java oraz powiązanych z nimi zasobów i metadanych. Archiwum JAR, o ile posiada wyszczególnioną klasę główną, może stanowić osobną aplikację

Plik manifestu Archiwum JAR powinno zawierać plik manifestu umieszczony w ścieżce META-INF/MANIFEST.MF, który informuje o sposobie użycia, przeznaczeniu archiwum, wskazuje klasę główną jeśli archiwum jest wykonywalne itp. Większość współczesnych IDE dla Javy pozwala na szybkie tworzenie plików JAR i generowanie plików manifestu http://docs.oracle.com/javase/tutorial/deployment/jar/manifestindex.html

Tworzenie pliku JAR w Eclipse poprzez eksport projektu/projektów Można tworzyć zwykłe archiwum JAR, lub uruchamialne archiwum ze wskazaniem klasy głównej

Tworzenie własnych bibliotek Eksportując wybrany projekt/projekty do archiwum JAR można utworzyć własną bibliotekę z klasami, którą można wykorzystać w innych projektach Przykład wyeksportowanie projektu z przykładami z dzisiejszego wykładu (oprócz klas wykład dzisiaj zawiera również zasoby w postaci plików graficznych, które również będą dostępne w utworzonym archiwum)

JAR Export PPM na projekcie 4 klasy strumieni abstrakcyjnych Export 4 klasy strumieni abstrakcyjnych JAR file

Korzystanie z bibliotek w Eclipse Najszybciej: Prawym klawiszem na nazwie projektu 4 klasy strumieni abstrakcyjnych Build Path 4 klasy strumieni abstrakcyjnych Configure Build Path

Korzystanie z bibliotek w Eclipse następnie w zakładce Libraries opcja Add External JARs i wskazanie lokalizacji biblioteki

Korzystanie z bibliotek w Eclipse Po poprawnym zaimportowaniu w widoku Eksploratora Pakietów powinny się pojawić pakiety z dołączonej biblioteki:

Korzystanie z bibliotek w Eclipse Po dołączeniu biblioteki do projektu można do tworzonych klas importować klasy zawarte w bibliotece: package pl.edu.pw.fizyka.pojava.wyklad; import pw.java.wyk5.grafika.logo; public class KorzystanieZBiblioteki { public static void main(string[] args) { Logo okno = new Logo(); okno.setvisible(true); } } Po zaimportowaniu można korzystać z tych klas, metod, konstruktorów które były deklarowane jako publiczne

Korzystanie z bibliotek w Eclipse package pl.edu.pw.fizyka.pojava.wyklad; import pw.java.wyk5.grafika.logo; public class KorzystanieZBiblioteki { public static void main(string[] args) { Logo okno = new Logo(); okno.setvisible(true); } } Obrazki bez problemów się wyświetlają ponieważ: - zawarte są w zaimportowanej bibliotece - w klasie Logo pobierane są metodą getresource odwołującą się do zasobu z konkretnego pakietu/podpakietu

Definiowanie bibliotek w Eclipse Jeśli jakaś biblioteka (zestaw bibliotek) jest często używana w wielu projektach Eclipse to warto zdefiniować w Eclipse User Library : Window 4 klasy strumieni abstrakcyjnych Preferences 4 klasy strumieni abstrakcyjnych Java 4 klasy strumieni abstrakcyjnychbuild Path 4 klasy strumieni abstrakcyjnych User Libraries, lub np. prawy klawisz mysz na projekcie 4 klasy strumieni abstrakcyjnychbuild Path 4 klasy strumieni abstrakcyjnychadd Library 4 klasy strumieni abstrakcyjnychuser Library

Definiowanie bibliotek w Eclipse

Definiowanie bibliotek w Eclipse Tak zdefiniowany zestaw bibliotek można szybko dodawać do nowych projektów:

Definiowanie bibliotek w Eclipse Należy pamiętać, że biblioteki użytkownika są definiowane lokalnie i przy eksporcie projektu na inny komputer trzeba ponownie zdefiniować bibliotekę lub wyeksportować również biblioteki użytkownika:

Umieszczanie bibliotek w projekcie Umieszczenie bibliotek (oraz wszelkich innych zasobów pliki graficzne, tekstowe, bazy danych itp.) bezpośrednio w projekcie (np. w podkatalogu /lib) ma sporo zalet: przede wszystkim eksport/import projektu jest prosty i zachowuje wszystkie zależności wygenerowane uruchamialnego pliku JAR zawierającego wszystkie niezbędne zasoby/biblioteki z poziomu Eclipse ogranicza się do kilku kliknięć.

Umieszczanie bibliotek w projekcie

Umieszczanie bibliotek w projekcie Tak umieszczone biblioteki eksportowane są wraz z całym projektem

Tworzenie wykonywalnego pliku JAR W Eclipse możliwe jest szybkie utworzenie uruchamialnego pliku JAR, zawierającego w razie konieczności wszystkie używane biblioteki: Export Runnable JAR file Runnable JAR file Można wybrać jedną z konfiguracji uruchamiania, na podstawie której generowany jest odpowiedni plik manifestu Można też wybrać sposób dodawania wymaganych bibliotek

Tworzenie wykonywalnego pliku JAR Tak utworzony plik JAR można uruchomić z linii poleceń: np.: java -jar test_java.jar albo też uruchomić inną (nie domyślną) klasę: java -jar nazwa_pliku.jar pakiet.nazwaklasy Np. dla biblioteki utworzonej wcześniej java -jar test_runnable.jar pw.java.wyk5.grafika.simplegraphics W zależności od konfiguracji systemu możliwe też może być uruchamianie aplikacji poprzez dwukrotne kliknięcie ikony pliku JAR lub poprzez menu kontekstowe.

Tworzenie plików EXE Na bazie wykonywalnych plików JAR możliwe jest utworzenie plików wykonywalnych dla Windows, które nie tylko pozwalałby na uruchomienie aplikacji, ale też sprawdzałyby czy zainstalowana jest odpowiednia wirtualna maszyna Javy, w razie konieczności proponowały ściągnięcie Javy Możliwe jest nawet stworzenie instalatora (np. programem Nullsoft Scriptable Install System http://nsis.sourceforge.net/ )

Tworzenie plików EXE - Launch4J Executable Wrapper http://sourceforge.net/projects/launch4j/

Tworzenie plików EXE - Launch4J Executable Wrapper http://sourceforge.net/projects/launch4j/ Program posiada sporo opcji i możliwości konfigurowania uruchomienia, ale do utworzenia pliku EXE z pliku wykonywalnego JAR wystarczy: 1. zdefiniowanie ścieżki pliku wyjściowego EXE 2. podanie ścieżki do pliku JAR () 3. podanie minimalnej wersji JRE (np. 1.0.0 lub 1.7.0) w zakładce JRE 4. zapisanie konfiguracji 5. Kliknięcie ikony Build Wrapper

Podanie nazw plików JAR i EXE

Ustawienie minimalnej wersji JRE

po czym można klikać ikonę BuildWrapper

Wynik udanego tworzenia pliku EXE

Wykorzystanie innych bibliotek Istnieje bardzo dużo różnych bibliotek stworzonych w Javie cześć jest odpłatna, ale jest też ogromny wybór darmowych bibliotek o rozmaitej funkcjonalności. Na stronie http://java-source.net/ zebrane są biblioteki open-source dla Javy

Biblioteka JFreeChart http://www.jfree.org/jfreechart/

Biblioteka JFreeChart Aby tworzyć proste wykesy do projektu należy dodać biblioteki JFreeChart i JCommon Należy pobrać biblioteke ze strony: http://www.jfree.org/jfreechart/download.html, rozpakować plik zip, a następnie dodać dwa pliki jfreechart*.jar jcommon*.jar do projektu. W archiwum z JFreeChart w katalogu lib jest więcej plików jar, m.in. biblioteka JUnit pozwalająca na przygotowywanie testów jednostkowych

Wykres PieChart PieChartDemo.java

Wykres PieChart PieChartDemo.java DefaultPieDataset dane = new DefaultPieDataset(); dane.setvalue("nazwa dane.setvalue("nazwa dane.setvalue("nazwa dane.setvalue("nazwa dane.setvalue("nazwa 1", 2", 3", 4", 5", 10); //wartosci 25); 80); 45); 45); //Tworzymy wykres JFreeChart typu PieChart JFreeChart chart = ChartFactory.createPieChart ("Wykres typu Pie ", // Tytul wykresu dane, // dane typu PieDataset true, // legenda true, // tooltips false // Configure chart to generate URLs ); ChartFrame frame=new ChartFrame("Pie Chart",chart); frame.setvisible(true); frame.setsize(400,400);

Wykres PieChart PieChartDemo.java PiePlot plot = (PiePlot) chart.getplot(); plot.setexplodepercent("section A", 0.30); // wycinek z wykresu

PieChartDemo3D.java

RingChartDemo.java

XYLineChartDemo.java XYSeries series = new XYSeries("Nazwa serii"); series.add(1, 1); series.add(1, 2); series.add(2, 4);... series.add(6, 10); XYSeriesCollection dataset = new XYSeriesCollection(); dataset.addseries(series); //Tworzymy wykres XY JFreeChart chart = ChartFactory.createXYLineChart( "Wykres XY",//Tytul "Opis osi X", // opisy osi "Opis osi Y", dataset, // Dane PlotOrientation.VERTICAL, // Orjentacja wykresu true, // legenda true, // tooltips false );

XYLineChartDemo.java

XYLineChartDemo2.java dwie serie //Tworzenie poszczegolnych serii XYSeries series = new XYSeries("Nazwa serii 1"); series.add(1, 1);... series.add(6, 10); XYSeries series2 = new XYSeries("Nazwa serii 2"); series2.add(1,0);... series2.add(6, 8); //Tworzenie kolekcji serii XYSeriesCollection dataset = new XYSeriesCollection(); //dodawanie kolejnych serii do kolekcji dataset.addseries(series); dataset.addseries(series2); // oczywiscie serie mozna usuwac: //dataset.removeseries(series2); // stosujac nazwe serii //dataset.removeseries(0); // stosujac numer serii //dataset.removeallseries(); // lub usunac wszystkie serie;

XYLineChartDemo2.java dwie serie

BarChartDemo.java DefaultCategoryDataset dataset = new DefaultCategoryDataset(); dataset.setvalue(6, "Seria1", "Kategoria1"); dataset.setvalue(7, "Seria1", "Kategoria2"); dataset.setvalue(8, "Seria1", "Kategoria3"); dataset.setvalue(5, "Seria1", "Kategoria4"); dataset.setvalue(12, "Seria1", "Kategoria5"); // Tworzy wykres typu Bar - słupkowy JFreeChart chart = ChartFactory.createBarChart( "Wykres typu Bar", "Opis osi X", "Opis osi Y", dataset, PlotOrientation.VERTICAL, false, true, false); //parametry podobnie jak w poprzednich przykladach ChartFrame frame1=new ChartFrame("Bar Chart",chart); frame1.setvisible(true); frame1.setsize(500,400);

BarChartDemo.java

BarChartDemo2.java dwie serie DefaultCategoryDataset dataset = new DefaultCategoryDataset(); dataset.setvalue(6, "Seria1", "Kategoria1"); dataset.setvalue(7, "Seria1", "Kategoria2"); dataset.setvalue(8, "Seria1", "Kategoria3"); dataset.setvalue(5, "Seria1", "Kategoria4"); dataset.setvalue(12, "Seria1", "Kategoria5"); dataset.setvalue(4, "Seria2", "Kategoria1"); dataset.setvalue(6, "Seria2", "Kategoria2"); dataset.setvalue(2, "Seria2", "Kategoria3"); dataset.setvalue(4, "Seria2", "Kategoria4"); dataset.setvalue(10, "Seria2", "Kategoria5");

BarChartDemo2.java dwie serie

BarChart3DDemo.java, jedyna różnica: JFreeChart chart = ChartFactory.createBarChart3D("Wykres typu Bar3D z dwoma seriami", "Opis osi X", "Opis osi Y", dataset, PlotOrientation.VERTICAL, false, true, false);

TimeSeriesChartDemo.java //tworzenie kolekcji serii TimeSeriesCollection dataset = new TimeSeriesCollection(); //tworzenie serii TimeSeries seria1 = new TimeSeries("Nazwa serii"); seria1.add(new Day(1, 1, 2018), 200); seria1.add(new Day(2, 1, 2018), 250); seria1.add(new Day(3, 1, 2018), 250); seria1.add(new Day(4, 1, 2018), 275); seria1.add(new Day(5, 1, 2018), 225); //dodawanie serii dataset.addseries(seria1); //Tworzenie wykresu typu TimeSeries JFreeChart chart = ChartFactory.createTimeSeriesChart ("Wykres","Data","Etykieta osi Y",dataset,true,true,false);

TimeSeriesChartDemo.java

TimeSeriesChartDemo2.java dwie serie TimeSeriesCollection dataset = new TimeSeriesCollection(); TimeSeries seria1 = new TimeSeries("Nazwa serii"); seria1.add(new Day(1, 1, 2013), 200); seria1.add(new Day(2, 1, 2013), 250);... seria1.add(new Day(5, 1, 2013), 225); TimeSeries seria2 = new TimeSeries("Nazwa serii2"); seria2.add(new Year(2012), 200); seria2.add(new Year(2013), 250);.. seria2.add(new Year(2016), 100); dataset.addseries(seria1); dataset.addseries(seria2);

TimeSeriesChartDemo2.java dwie serie

Wymuszanie określonego formatowania osi czasu XYPlot plot = chart.getxyplot(); DateAxis axis = (DateAxis) plot.getdomainaxis(); axis.setdateformatoverride(new SimpleDateFormat("dd-MMyyyy"));

WyswietlanieWykresow.java Kilka przykładów wyświetlania wykresów //szybkie wysswietlanie wykresu przy pomocy klasy ChartFrame ChartFrame frame = new ChartFrame("Szybkie wyswietlanie wykresu - klasa ChartFrame", linegraph); frame.pack(); frame.setvisible(true); // Zapisywanie wykresu do pliku JPG: try { ChartUtilities.saveChartAsJPEG(new File("LineGraph.jpg"), linegraph, 800, 600); } catch (Exception e) { System.out.println("Problem z zapisem wykresu do pliku"); }

WyswietlanieWykresow.java // WYSWIETLANIE WYKRESOW W OKNIE SWING // Tworzenie okienka Swing: JFrame jframe = new JFrame("Przeskaluj okno oraz kliknij prawym klawiszem myszy na obu wykresach..."); jframe.setdefaultcloseoperation(jframe.dispose_on_close); jframe.getcontentpane().setlayout(new GridLayout( 2,2)); jframe.setsize(640,480); // Dodawanie wykresu jako obraz - klasa BufferedImage BufferedImage image = linegraph.createbufferedimage(300,200); JLabel lblchart = new JLabel(); lblchart.seticon(new ImageIcon(image)); jframe.getcontentpane().add(lblchart); jframe.getcontentpane().add(new JLabel("<<< wykres dodany jako obraz (Image)")); // Dodawanie wykresu przy pomocy klasy ChartPanel ChartPanel chartpanel = new ChartPanel(lineGraph); jframe.getcontentpane().add(chartpanel); jframe.getcontentpane().add(new JLabel("<<< wykres dodany jako ChartPanel"));

PDFChartExample.java Przykład pokazujący jak zapisywać wykresy do pliku PDF wymagane dołączenie do projektu biblioteki Itext https://itextpdf.com/ https://developers.itextpdf.com

Na stronie biblioteki IText jest znacznie więcej przykładów jej użycia: https://developers.itextpdf.com/examples-itext5