Aleksander Adamowski (s1869)

Projekt z MPRO – biuro podróży

Funkcjonalność

Aplikacja składa się z 2 części:

Klient GUI

• zrealizowany w Swing + JDBC

• pozwala na przeglądanie i edycję bazy ofert, eksport/import XML, import z plików tekstowych

• jest zaprojektowany z oddzieleniem modelu danych od prezentacji (korzysta z tego samego modelu bazy ofert, co aplikacja WEB)

• jest w pełni zinternacjonalizowany

Aplikacja WEB

• pozwala na przeglądanie bazy ofert przez klientów (przeglądarka Web)

• zrealizowany w JSP + Struts

• jest w pełni zinternacjonalizowana (użytkownicy widzą teksty w języku ustawionym w swojej przeglądarce, jeśli tylko teksty dla tego języka zostały przygotowane)

• Rozszerzalny system szablonów pozwala na łatwe przeprojektowywanie wyglądu serwisu

Model danych

Aplikacja korzysta z przedstawionego na rysunku modelu danych:

Instalacja

Aplikacja korzysta z bazy MySQL. Należy:

• skonfigurować serwer MySQL z obsługą tabel InnoDB (dla wymuszania integralności referencyjnej),

• zaimportować bazę z załączonego pliku biuropodr.sql, zakodowanego w UTF-8 (jeśli pojawią się błedy, można spróbować synchronizacji bazy z modelu DBDesigner-a z załączonego pliku biuro_podrozy-1.7.xml),

• Założyć użytkownika bazy załączonym skryptem biuro_user.sql,

• Zainstalować w dostępnym dla aplikacji Swing (klient) i serwera Tomcat (serwer) sterownik MySQL-ConnectorJ. Server Tomcat musi obsługiwać udostępnianie puli połączeń jako zasobu zarządzanego przez Jakarta Tyrex (n.p. Tomcat 4.0)

Konfiguracja

Klient GUI

Klient GUI ma zakodowany “na twardo” domyślny adres serwera, do którego się łączy, nazwę użytkownika i hasło. Można je zmienić podając w wierszu poleceń 3 argumenty odpowiadające URL-owi bazy, nazwie użytkownika i haśle.

Aplikacja WEB

W Przypadku instalacji na serwerze Tomcat 4, należy zarejestrować w pliku server.xml obsługiwany przez Tyrex zasób źródła danych realizujący dynamiczną pulę połączeń.

Należy dodać następujące wiersze:

<!-- Dodawane do server.xml dla udostepnienia puli polaczen aplikacjom -->
<DefaultContext>
    <Resource name="jdbc/biuropodr" auth="Container"
        type="javax.sql.DataSource"/>
    <ResourceParams name="jdbc/biuropodr">
        <parameter>
            <name>user</name>
            <value>biuro_user</value>
        </parameter>
        <parameter>
            <name>password</name>
            <value></value>
        </parameter>
        <parameter>
            <name>driverClassName</name>
            <value>com.mysql.jdbc.Driver</value>
        </parameter>
        <parameter>
            <name>driverName</name>
            <value>jdbc:mysql://localhost/biuropodr?useUnicode=true&amp;characterEncoding=UTF8</value>
        </parameter>
    </ResourceParams>
</DefaultContext>

Następnie należy zrobić deployment z załączonego pliku WAR do wybranego kontekstu serwera.

Uruchomienie i wykorzystanie

Klient GUI

Wystarczy uruchomić plik JAR poleceniem:

java -jar AA_1869_MPRO_Projekt.jar [url_do_bazy_MySQL nazwa_uzytkownika haslo]

Praca z klientem pozwala na dodawanie nowych ofert w 3 zdefiniowanych językach (łatwo rozszerzyć aplikację o nowe), wybieranych z menu “Wersja językowa ofert”:

Przy uruchomieniu w systemie o innych ustawieniach językowych (na przykład u kontrahenta) aplikacja prezentuje użytkownikowi interfejs w jego języku, jeśli tylko odpowiednie tłumaczenie zostało opracowane (obsługiwane w tej chwili języki: polski, angielski, rosyjski):

Edycja ofert polega na wprowazdaniu dat wyjazdu, powrotu, wybieraniu zakwaterowania (który z dostępnych hoteli), wpisywaniu tekstowych opisów, ustalania ceny i waluty.

Aplikacja WEB

Należy w przeglądarce wpisać adres serwera. Oferty wprowadzone klientem GUI stają się od razu widoczne na stronie WWW przeglądarki ofert:

Strona jest również zinternacjonalizowana i prezentuje użytkownikowi napisy w jego języku:

Uwaga! Na stronie WWW użytkownik widzi tylko oferty przygotowane dla jego języka! Oferty dla obywateli różnych państw należy tworzyć osobno.