Większość projektów jest tworzona za pomocą zintegrowanych środowisk programistycznych wspierających korzystanie z różnych bibliotek i frameworków.
Frameworki i biblioteki wykorzystane w artykule:
- Framework JavaServer Faces 2.
- Framework RichFaces 4 - wspierany przez firmę JBoss.
- Sterowniki JDBC łączące z bazą danych MySQL - Connector/J.
Obecnie Framework JSF 2 jest dołączony do środowiska Eclipse. Strona projektu znajduje się pod adresem http://javaserverfaces.java.net/. Framework RichFaces (wersja stabilna) jest dostępny na stronie projektu pod adresem http://www.jboss.org/richfaces/download/stable.html. Sterowniki JDBC odpowiedzialne za komunikację z baza danych można znaleźć na stronie http://www.mysql.com/downloads/connector/j/.
Wymagane pliki:
JSF 2.0
- Pobieramy za pośrednictwem środowiska programistycznego Eclipse.
RichFaces 4
- richfaces-components-api-4.2.2.Final.jar
- richfaces-components-ui-4.2.2.Final.jar
- richfaces-core-api-4.2.2.Final.jar
- richfaces-core-impl-4.2.2.Final.jar
Pliki obowiązkowe osób trzecich (RichFaces 4):
- CSS Parser (cssparser-0.9.7.jar), można pobrać pod adresem www.
- Google Guava (guava-13.0.1.jar), można pobrać pod adresem www.
- Simple API for CSS (sac-1.3.jar), można pobrać pod adresem www.
Pliki cssparser.jar, guava.jar, sac.jar nie są dołączone do frameworka - należy pobrać osobno, są wymagane. Więcej na stronie w rozdziale 2 dokumentacji „Getting started with RichFaces”.
MySQL Connector/J
- mysql-connector-java-5.1.21-bin.jar
Numeracja plików z czasem ulegnie zmianie.
Przed dołączeniem bibliotek oraz frameworków należy uruchomić kreator tworzenia projektu JSF („New>Project…”, wybrać z listy „Web>Dynamic Web Project”) (rys. 1.). Formularze kreatora projektu JSF wypełniono zgodnie z informacjami na rysunku 2, 3 i 4, przycisk „Next”.
Rys. 1. Wybieranie kreatora Dynamic Web Project
Rys. 4. Ustawienia nazwy katalogu głównego projektu i nazwy katalogu zawartości strony internetowej
Po zatwierdzeniu ustawień (rys. 4.) zostanie uruchomione okno „JSF Capabilities” umożliwiające dodanie do projektu wszystkich wymaganych bibliotek. Pod przyciskiem dyskietki „Download library” należy dodać framework JSF 2.0 (rys. 6.). Ikona książek „User Libraries” umożliwia wgranie do Eclipse bibliotek, frameworków spoza środowiska IDE. Należy wskazać rzeczywistą ścieżkę do bibliotek (rys. 7.), kiedy podczas pracy z projektem ścieżka zostanie zmieniona należy ją w tym oknie uaktualnić. W menu kontekstowym projektu „Properties”, wybrać z listy „Project Facets>Java Server Faces”.
Po powrocie do okna „JSF Capabilities” należy zaznaczyć wszystkie dodane biblioteki. W polu „URL Mapping Patterns” należy usunąć „/faces/*” a dodać „.jsf” (rys. 8.). Po zatwierdzeniu ustawień w oknie „JSF Capabilities” zostanie wygenerowany pusty projekt (rys. 9.).
Rys. 9. Nowo utworzony projekt JSF
Pierwszy program
Po utworzeniu projektu programista musi wygenerować pierwszy plik w technologii JSF i RichFaces. Należy wybrać katalog projektu WebContent (rys. 9.) a następnie w menu kontekstowym „New>Other” i „JBoss Tools Web>XHTML Page” (rys. 10.). Należy podać nazwę pliku np.: wiedza.xhtml, a następnie przycisk „Next” (rys. 11.). Dzięki temu istnieje szansa wygenerowania szablonu strony JSF. Aby tworzone pliki były zgodne z JSF 2 wybrano „Blank RichFaces Page” (rys. 12.). Po zatwierdzeniu utworzenia pliku, zostanie on automatycznie otwarty w głównym oknie środowiska Eclipse (rys. 13.). Po lewej stronie znajduje się przestrzeń robocza projektu. Po prawej stronie znajduje się paleta, która została dograna w czasie instalacji JBoss Tools. Podczas przeciągnięcia z palety wybranego komponentu, środowisko Eclipse automatycznie utworzy odpowiednie dyrektywy taglib potrzebne do prawidłowego działania pliku. Przed uruchomieniem pliku w przeglądarce (rys. 14.) należy skonfigurować środowisko programistyczne z serwerem np.: Tomcat, a następnie wybrać plik wiedza.xhtml i w menu kontekstowym „Run As>Run on Server”. Następnie w oknie „Run on Server” (rys. 15.) wybrać „Tomcat v7.0 Server at localhost” i zatwierdzić przyciskiem „Finish”. Aby plik wiedza.xhtml był uruchamiany bezpośrednio pod adresem http://localhost:8080/wiedzanaplus/ należy utworzyć plik index.xhtml (Listing 1) w katalog projektu WebContent i powiadomić serwer o tej decyzji w pliku web.xml (Listing 2).
Rys. 10. Wybieranie kreatora XHTML Page
Rys. 11. Tworzenie pierwszego pliku XHTML dla projektu w technologii JSF 2.0
Rys. 12. Wybieranie gotowego szablonu przygotowanego dla JSF 2.0 i RichFaces
Rys. 13. Tworzenie strony przy wykorzystaniu technologii RichFaces
Rys. 14. Uruchomienie przykładowego kodu z wybranego szablonu w przeglądarce internetowej
Rys. 15. Uruchomienie wybranego pliku na serwerze Tomcat 7.0
Listing 1. Zawartość pliku index.xhtml
<html><head><meta http-equiv="Refresh" content="0; URL=wiedza.jsf"/></head></html>
Listing 2. Fragment pliku web.xml
...
<welcome-file-list>
<welcome-file>index.html</welcome-file>
<welcome-file>index.htm</welcome-file>
<welcome-file>index.jsp</welcome-file>
<welcome-file>default.html</welcome-file>
<welcome-file>default.htm</welcome-file>
<welcome-file>default.jsp</welcome-file>
</welcome-file-list>
...
Warto przeczytać również:
- Instalacja serwera Tomcat.
- Integracja serwera Tomcat z Eclipse.
- Instalacja JBoss Tools w środowisku programistycznym Eclipse.
- JSF 1.2 - wprowadzenie.
- Wprowadzenie do RichFaces, który rozszerza funkcjonalność JavaServer Faces.
Wybrane książki:
- Anghel Leonard: JavaServer Faces 2.2. Mistrzowskie programowanie, Wydawnictwo Helion, 2016.
- Vishal Layka: Java. Projektowanie aplikacji WWW, Wydawnictwo Helion, 2015.