Ta strona jest tylko do odczytu. Możesz wyświetlić źródła tej strony ale nie możesz ich zmienić.

<h1>1. Instalacja i konfiguracja Eclipse</h1> <div class="level1"> <p> Do tworzenia produktu WebFirmatic wykorzystywane jest środowisko Eclipse. Jest to narzędzie darmowe, do działania wymaga zainstalowanego środowiska Java (jeśli nie ma w systemie, można pobrać i zainstalować ze strony: <a href="http://www.oracle.com/technetwork/java/javaee/downloads/java" class="urlextern" title="http://www.oracle.com/technetwork/java/javaee/downloads/java" rel="nofollow">http://www.oracle.com/technetwork/java/javaee/downloads/java</a>¬ee-sdk-6u3-jdk-7u1-downloads-523391.html). </p> <p> Eclipse pobieramy ze strony: <a href="http://www.eclipse.org/downloads/packages/eclipse-ide-java-ee-developers/indigosr2" class="urlextern" title="http://www.eclipse.org/downloads/packages/eclipse-ide-java-ee-developers/indigosr2" rel="nofollow">http://www.eclipse.org/downloads/packages/eclipse-ide-java-ee-developers/indigosr2</a> </p> <p> Wybieramy wesję odpowiednią dla używanego systemu operacyjnego, na potrzeby tej instrukcji przyjmiemy Windows 64-bit. </p> <p> <img src="/dokuwiki/lib/exe/fetch.php?media=eclipse.jpg" class="media" title="eclipse.jpg" alt="eclipse.jpg" /> </p> <p> Instalacja polega na rozpakowaniu pobranego archiwum. Nastepnie uruchamiamy eclipse.exe (dla wersji Windows). Przy pierwszym uruchomieniu należy wskazać workspace – katalog gdzie przechowywane są projekty. Wybrany katalog oznaczamy jako domyślny: </p> <p> <img src="/dokuwiki/lib/exe/fetch.php?media=workspace.jpg" class="media" title="workspace.jpg" alt="workspace.jpg" /> </p> <p> Kolejnym krokiem jest instalacja wtyczki do wykorzytywanej w projekcie technologii GWT. Najpierw pobieramy ją z adresu <a href="http://dl.google.com/eclipse/plugin/3.7/zips/gpe-e37-latest-updatesite.zip" class="urlextern" title="http://dl.google.com/eclipse/plugin/3.7/zips/gpe-e37-latest-updatesite.zip" rel="nofollow">http://dl.google.com/eclipse/plugin/3.7/zips/gpe-e37-latest-updatesite.zip</a> . Rozpakowujemy archiuwm, w Eclipse wybieramy opcję Help → Install New Software: </p> <p> <img src="/dokuwiki/lib/exe/fetch.php?media=javaee.jpg" class="media" title="javaee.jpg" alt="javaee.jpg" /> </p> <p> W następnym oknie wybieramy Add: </p> <p> <img src="/dokuwiki/lib/exe/fetch.php?media=add.jpg" class="media" title="add.jpg" alt="add.jpg" /> </p> <p> Następnie wybieramy katalog z rozpakowanym archiwum: </p> <p> Zazanczamy komponenty do instalacji ustawiając odpowiednie opcje zgodnie z ekranem poniżej: </p> <p> <img src="/dokuwiki/lib/exe/fetch.php?media=install.jpg" class="media" title="install.jpg" alt="install.jpg" /> </p> <p> Klikamy Next, Next i Finish pamiętając o akceptacji licencji. Rozpoczyna się instalacja, na pytanie instalatora odpowiadamy OK. Po zakończonej instalacji restartujemy Eclipse zgodnie z prośbą: </p> <p> <img src="/dokuwiki/lib/exe/fetch.php?media=restart.jpg" class="media" title="restart.jpg" alt="restart.jpg" /> </p> </div> <h1>2. Import projektu</h1> <div class="level1"> <p> Aby zaimportować projekt w środowisku Eclipse należy kliknąć prawym przyciskiem w puste pole Project Explorer i wybrać z menu Import: </p> <p> <img src="/dokuwiki/lib/exe/fetch.php?media=import.jpg" class="media" title="import.jpg" alt="import.jpg" /> </p> <p> Następnie wybieramy: </p> <p> <img src="/dokuwiki/lib/exe/fetch.php?media=import1.jpg" class="media" title="import1.jpg" alt="import1.jpg" /> </p> <p> Na następnym ekranie wybieramy katalog z plikami źródłowymi projektu i ustawiamy opcje: </p> <p> <em>brak tabelki</em> </p> </div> <h1>3. Edycja ustawień produktu</h1> <div class="level1"> <p> Następną czynnością jest edycja ustawień, które mają wpływ na produkt. Ustawienia te znajdują się w pliku web.xml, wybieramy go ze struktury projektu i klikamy dwukrotnie przechodząc do edycji: </p> <p> <img src="/dokuwiki/lib/exe/fetch.php?media=config.jpg" class="media" title="config.jpg" alt="config.jpg" /> </p> <p> Znacznienie poszczególnych ustawień przedstawia tabela: </p> <p> Nazwa (<em><</em>param-name>) Znaczenie wartości (<em><</em>param-value>) FirmPHPUrl Adres url do skryptu firm.php ProxyPHPUrl Adres url do skryptu proxy.php XMLpath Ścieżka do katalogu z testowymi xml-ami Iconpath Ścieżka do katalogu z ikonami debugMode Zmienna logiczna włączająca debug mode refreshMs Czas w milisekundach po którym połączenie do Firmatica jest ponawiane </p> </div> <h1>4. Kompilacja i wdrożenie</h1> <div class="level1"> <p> Następnym krokiem po zapisaniu ustawień jest kompilacja projektu: </p> <p> <img src="/dokuwiki/lib/exe/fetch.php?media=kompilacja.jpg" class="media" title="kompilacja.jpg" alt="kompilacja.jpg" /> </p> <p> Proces kompilacji może trwać parę minut, pomyślne zakończenie oznajmia komunikat: </p> <p> <img src="/dokuwiki/lib/exe/fetch.php?media=kompilacja1.jpg" class="media" title="kompilacja1.jpg" alt="kompilacja1.jpg" /> </p> <p> Kolejną czynnością jest wytworzenie archiwum, które jest finalną postacią produktu. Służy do tego plik build_war.xml, po jego otwarciu zwracamy uwagę na prawą część okna, która zawiera wykonywalne zadania. Sposób użycia tych zadań: menu kontekstowe, Run As → Ant Build. Na poniższym ekranie zaznaczone jest także ustawienie ścieżki serwera Apache Tomcat,o którym za chwilę. </p> <p> <img src="/dokuwiki/lib/exe/fetch.php?media=kompilacja2.jpg" class="media" title="kompilacja2.jpg" alt="kompilacja2.jpg" /> </p> <p> Zadanie buildwar tworzy archiwum WebFirmatic.war. Gotowy produkt możemy od razu wdrozyć na serwerze Tomcat, za pomocą zadania deploy jeśli ustawiliśmy jego ścieżkę. Wdrożenie polega na skopiowaniu archiwum do katalogu webapps na serwerze. Można to zrobić w dowolnym terminie i bez użycia dodatkowych narzędzi, wszczególności Eclipse. Po wdrożeniu należy pamiętać o restarcie serwera. Poprawne uruchomienie obserwujemy wpisując w przeglądarce serwera adres serwera i nazwę produktu: </p> <p> <img src="/dokuwiki/lib/exe/fetch.php?media=localhost.jpg" class="media" title="localhost.jpg" alt="localhost.jpg" /> </p> <p> Na serwerze Orion po zalogowaniu się na użytkownika tomcat w katalogu domowych znajdziemy podkatalog webapps do którego należy skopiować plik war. Następnie za pomocą polecenia sudo service tomcat restart zostanie zrestartowany serwer. Jednym z problemów które mogą wystąpić przy deployu jest niezgodność wersji pomiędzy Javą na środowisku developerskim i tej na serwerze tomcat. Zawsze należy sprawdzić jakie są wersje i w przypadku niezgodności, dostosować wersję na jednym ze środowisk. Najprościej jest ustawić wersję Javy, która ma być używana klikając prawym klawiszem w Eclipse na projekcie i wybierając Properties. Następnie przejść do zakładki Java Compiler i ustawić odpowiednią opcję w Java Compliance. W przypadku serwera Orion w tym miejsciu powinna być wybrana wartość 1.6 dla Compiler compilance level. Innym problemem może być nieodświerzenie wersji aplikacji po restarcie serwera. Wówczas można skasować podkatalog WebFirmatic w webapps i spróbować ponownie. </p> </div> <h1>5. Uruchomienie w trybie developerskim</h1> <div class="level1"> <p> Jeśli zależy nam na szybkiej obserwacji wprowadzanych zmian lub nie chcemy używać zewnętrznego serwera, to istnieje alternatywna ścieżka uruchomienia produktu. Wywołujemy menu kontekstowe projektu, Run As → Web Application: </p> <p> <img src="/dokuwiki/lib/exe/fetch.php?media=webapp.jpg" class="media" title="webapp.jpg" alt="webapp.jpg" /> </p> <p> Następnie klikamy dwukrotnie na utworzony link w dolnej części ekranu, co uruchamia projekt w przeglądarce internetowej: </p> </div>