Materiały oryginalne: ZAWWW-2st1.2-l11.tresc-1.0kolor.pdf Materiały poprawione Rozwiązanie zadania w NetBeans IDE 8.1, opracowanie materiału: Piotr Nierebiński, Mateusz Turski (na podstawie materiału oryginalnego oraz wersji poprawionej autorstwa J.Ksybek i A.Miazio.) Celem ćwiczenia jest przygotowanie prostej aplikacji internetowej wykorzystującej architekturę Spring. Aplikacja składa się z jednego zarządcy (ang. dispatcher) i jednego kontrolera wyświetlającego stronę JSP. Dodatkowo, aplikacja wykorzystuje mechanizm fabryki komponentów do połączenia się z bazą danych i wyświetlenia listy klientów. Do wykonania ćwiczenia potrzebne jest zintegrowane środowisko programistyczne NetBeans IDE 8.1 (do pobrania z http://www.netbeans.org) oraz środowisko JAVA EE 7.0 Web. 1. Uruchom narzędzie NetBeans IDE 8.1 2. Z menu głównego wybierz File New Project. Wybierz kategorię Java Web i typ projektu Web Application. Rezultat: Kliknij przycisk NEXT > S t r o n a 1 10
3. Podaj nazwę projektu, np. Spring oraz określ ścieżkę projektu. Kliknij przycisk NEXT >. 4. Kliknij przycisk NEXT > 5. Pozostaw ustawienia bez zmian, naciśnij przycisk NEXT > S t r o n a 2 10
6. Zaznacz opcję Spring Web MVC. W tym momencie uaktywnią się nowe opcje. W zakładce Configuration w polu Dispatcher Name wpisz SimpleMVC. Pozostałe wpisy pozostaw bez zmian. Kliknij przycisk FINISH. Rezultat: 9. Utworzyła się aplikacja, którą można już uruchomić. W tym celu: Kliknij prawym przyciskiem myszy na nazwę projektu ( Spring ) w zakładce Projects i z menu kontekstowego wybierz opcję Run. GlassFish Server 4.1.1 oraz DB Java Database Process uruchomi się automatycznie. Obserwuj komunikaty pojawiające się podczas uruchomiania projektu. Po kilku sekundach powinno otworzyć się okno przeglądarki wyświetlające rezultat podobny do tego: S t r o n a 3 10
10. Dwukrotnie kliknij lewym przyciskiem myszy na plik SimpleMVC-servlet.xml w celu jego edycji. Plik powinien wyglądać następująco: <?xml version='1.0' encoding='utf-8'?> <!-- was: <?xml version="1.0" encoding="utf-8"?> --> <beans xmlns="http://www.springframework.org/schema/beans" xmlns:xsi="http://www.w3.org/2001/xmlschema-instance" xmlns:p="http://www.springframework.org/schema/p" xmlns:aop="http://www.springframework.org/schema/aop" xmlns:tx="http://www.springframework.org/schema/tx" xsi:schemalocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans-4.0.xsd http://www.springframework.org/schema/aop http://www.springframework.org/schema/aop/spring-aop-4.0.xsd http://www.springframework.org/schema/tx http://www.springframework.org/schema/tx/spring-tx-4.0.xsd"> <bean class="org.springframework.web.servlet.mvc.support.controllerclassnamehandlermapping"/> <!-- Most controllers will use the ControllerClassNameHandlerMapping above, but for the index controller we are using ParameterizableViewController, so we must define an explicit mapping for it. --> <bean id="urlmapping" class="org.springframework.web.servlet.handler.simpleurlhandlermapping"> <property name="mappings"> <props> <prop key="index.htm">indexcontroller</prop> </props> </property> </bean> <bean id="viewresolver" class="org.springframework.web.servlet.view.internalresourceviewresolver" p:prefix="/web-inf/jsp/" p:suffix=".jsp" p:viewclass="org.springframework.web.servlet.view.jstlview"/> <!-- The index controller. --> <bean name="indexcontroller" class="controller.simplecontroller" /> </beans> S t r o n a 4 10
11. Powyższa konfiguracja zleca kierowanie żądań o URL index.html do kontrolera o nazwie controller.simplecontroller. Kolejnym krokiem jest implementacja tego kontrolera. Kliknij prawym przyciskiem myszy na ikonie projektu Spring i z menu kontekstowego wybierz New Java Class. Wprowadź nazwę klasy: SimpleController i nazwę pakietu: controller. Kliknij przycisk FINISH. 12. Plik SimpleController.java powinien mieć następujący kod: package controller; import java.util.date; import javax.servlet.http.httpservletrequest; import javax.servlet.http.httpservletresponse; import org.springframework.web.servlet.modelandview; import org.springframework.web.servlet.mvc.abstractcontroller; public class SimpleController extends AbstractController{ @Override protected ModelAndView handlerequestinternal (HttpServletRequest arg0, HttpServletResponse arg1) throws Exception { ModelAndView mav = new ModelAndView("welcome"); mav.addobject("date", new Date()); return mav; } } Kontroler otrzymuje żądanie, tworzy nowy obiekt wynikowy ModelAndView, dodaje do modelu obiekt biznesowy (w tym przypadku prosty obiekt java.util.date) i zwraca obiekt wynikowy. Nazwa obiektu wynikowego welcome" jest tłumaczona na /WEBINF/jsp/welcome.jsp. S t r o n a 5 10
13. Kolejny krok to zbudowanie strony JSP wywoływanej przez kontroler. Kliknij prawym przyciskiem myszy na folderze jsp i z menu kontekstowego wybierz New JSP. Podaj nazwę dokumentu: welcome (nie podawaj rozszerzenia, zostanie dodane automatycznie). Naciśnij przycisk FINISH. 14. Plik welcome.jsp zostanie otwarty w edytorze. Wprowadź następujący kod: <%@ taglib prefix="c" uri="http://java.sun.com/jsp/jstl/core" %> <%@page contenttype="text/html" pageencoding="utf-8"%> <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/tr/html4/loose.dtd"> <html> <head> <meta http-equiv="content-type" content="text/html; charset=utf-8"> <title>jsp Page</title> </head> <body> <h1>gratulacje</h1> Teraz jest <c:out value="${date}" /> </body> </html> Zapisz wszystkie pliki i uruchom aplikację klikając prawym przyciskiem myszy na projekcie Spring wybierając z menu kontekstowego opcję Run. Powinna się pojawić strona internetowa z aktualną datą i godziną jak poniżej: S t r o n a 6 10
Skopiuj adres URL (http://localhost:8080/spring/index.htm) i przetestuj działanie aplikacji w innych przeglądarkach. 15. Kolejny krok to dodanie do projektu komponentu odpowiedzialnego za nawiązanie połączenia z bazą danych. Kliknij dwukrotnie na pliku SimpleMVC-servlet.xml i wewnątrz znaczników wprowadź następującą definicję komponentu dbbean, podając prawidłowe parametry połączenia (host, port, sid, username, password): <bean id="dbbean" class="org.springframework.jdbc.datasource.drivermanagerdatasource" p:driverclassname="org.apache.derby.jdbc.clientdriver" p:url="jdbc:derby://localhost:1527/sample" p:username="app" p:password="app" /> 16. Nawiązanie połączenia z bazą danych wymaga dołączenia do projektu właściwego sterownika JDBC. Kliknij prawym przyciskiem myszy na ikonie projektu Spring, z menu kontekstowego wybierz Properies, wyświetli się okno właściwości projektu. Wybierz zakładkę Libraries i z menu po prawej stronie wybierz Add Library. S t r o n a 7 10
Wybierz z listy sterownik Java DB Driver i kliknij Add Library. 17. Nawiązanie połączenia, wykonanie zapytania i odczytanie wyników zapytania jest realizowane w kontrolerze. Kliknij dwukrotnie plik SimpleController.java w celu jego edycji i dodaj kod obsługi połączenia z bazą danych. S t r o n a 8 10
package controller; import java.util.list; import org.springframework.context.applicationcontext; import org.springframework.jdbc.core.jdbctemplate; import org.springframework.jdbc.datasource.drivermanagerdatasource; protected ModelAndView handlerequestinternal (HttpServletRequest arg0, HttpServletResponse arg1) throws Exception { ApplicationContext ctx = this.getapplicationcontext(); DriverManagerDataSource dbbean = (DriverManagerDataSource) ctx.getbean("dbbean"); JdbcTemplate template = new JdbcTemplate(dbBean); List clients = template.queryforlist("select * FROM customer"); ModelAndView mav = new ModelAndView("welcome"); mav.addobject("date", new Date()); mav.addobject("clients", clients); return mav; } 18. Zmodyfikuj wynikową stronę JSP w taki sposób, aby wyświetlała wynik zapytania przesłany przez kontroler w obiekcie employees. Kliknij dwukrotnie plik welcome.jsp i przejdź do jego edycji. Plik powinien wyglądać następująco: <%@ taglib prefix="c" uri="http://java.sun.com/jsp/jstl/core" %> <%@ taglib prefix="fmt" uri="http://java.sun.com/jsp/jstl/fmt" %> <%@page contenttype="text/html" pageencoding="utf-8"%> <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/tr/html4/loose.dtd"> <html> <head> <meta http-equiv="content-type" content="text/html; charset=utf-8"> <title>jsp Page</title> </head> <body> <h1>gratulacje</h1> <fmt:setlocale value="pl_pl" /> Teraz jest <fmt:formatdate value="${date}" pattern="dd-mm-yyyy HH:mm" /> <h1>lista klientów</h1> <table border="1"> <tr><th>nazwa</th><th>miasto</th><th>email</th><th>fax</th></tr> <c:foreach var="emp" items="${clients}"> <tr> <td> <c:out value="${emp['name']}" /> </td> <td> <c:out value="${emp['city']}" /> </td> <td> <c:out value="${emp['email']}" /> </td> <td> <c:out value="${emp['fax']}" /> </td> </tr> </c:foreach> </table> </body> </html> S t r o n a 9 10
19. Przed uruchomieniem aplikacji należy zmienić serwer bazy danych. W tym celu przejdź do zakładki Services. Rozwiń drzewo Database. Kliknij prawym przyciskiem myszy na JavaDB -> wybierz Properties. Pojawi się okno jak poniżej: Odszukaj ścieżkę instalacji javadb serwera GlassFish i podmień istniejącą ścieżkę w polu Java DB Installation. Naciśnij OK. 20. Ustanów połączenie z bazą danych. W tym celu kliknij prawym przyciskiem myszy na JavaDB i z menu kontekstowego wybierz opcję Start Server. Kiedy serwer się uruchomi (obserwuj komunikaty w oknie Output - JavaDB Database Process ), powtórz czynność wybierając Connect z menu kontekstowego jdbc:derby://localhost:1527/sample [app on APP]. 21. Przejdź do zakładki Projects i uruchom aplikację (Run -> Run Project (Spring)). S t r o n a 10 10