Egg Framework w pięciu krokach - uruchamianie Newbie Kit

Najlepszy sposób na poznanie API to zapoznanie się z przykładami kodu. Jednak jeszcze lepszy efekt przynieść może uruchomienie kodu na swoim komputerze i oglądanie efektów wprowadzanych zmian. Aby to umożliwić stworzyłem specjalny zestaw dla początkujących, który w szybki i prosty sposób możesz zaimportować do Twojego środowiska programistycznego IDE. Bez skomplikowanych procedur instalacyjnych i długiego procesu konfigurowania.

Zestaw egg2-newbie-kit jest także bardzo dobry dla tych, którzy chcieliby najpierw stworzyć prototyp swojej aplikacji w relatywnie krótkim czasie a dopiero później implementować produkcyjny kod. Może się także przydać wszystkim, którzy chcieliby poćwiczyć i przetestować nieznane im wcześniej funkcjonalności.

1) Instalacja niezbędnych narzędzi

1. JDK 5.0 lub nowsze - można ściągnąć z http://java.sun.com/javase/downloads/
2. środowisko programistyczne IDE - masz do wyboru Eclipse, Netbeans albo Idea:
   • Eclipse - sugeruję ściągnięcie wersji Eclipse IDE for Java EE Developers ze strony http://www.eclipse.org/downloads/ . Ściągnięte archiwum rozpakuj w dowolne miejsce.
   • Netbeans - sugeruję ściągnięcie wersji Netbeans Web & Java EE ze strony http://netbeans.org . Gdy instalka zapyta się czy chcesz zainstalować serwery aplikacyjne to możesz odznaczyć wszystkie opcje - Egg Framework wymaga jedynie kontenera serwletów, który na dodatek jest dostarczany razem z nim.
   • Idea - sugeruję ściągnięcie wersji 7.0 lub nowszej ze strony http://www.jetbrains.com/idea/download/index.html

2) Ściągnięcie egg2-newbie-kit

Archiwum ZIP możesz ściągnąć spod adresu http://eggframework.org/downloads/egg2-newbie-kit.zip. Jeśli używasz Eclipse nie rozpakowuj go - IDE zrobi to za Ciebie. W przypadku Netbeans lub IDEA musisz jednak ten plik rozpakować. Najlepiej stwórz katalog egg2-newbie-kit i rozpakuj do niego zawartość archiwum.

3) Import projektu do środowiska programistycznego IDE

Teraz możesz już uruchomić wybrane IDE. Następnie będziesz musiał zaimportować wsześniej ściągnięty zestaw (projekt).

1. Jeśli wykorzystujesz Eclipse to:
   • Wybierz menu File/Import...
   • Następnie General/Existing projects into workspace
   • Zaznacz przycisk radio Select archive file: i wybierz po kliknięciu przycisku Browse ściągnięty plik egg2-newbie-kit.zip
   • Kliknij Finish
   • Projekt powinien być widoczny w widoku Package Explorer
   • Teraz jeszcze zmień ustawienia IDE, żeby używał on kodowania znaków UTF-8. Pliki źródłowe projektu zostały zapisane właśnie w takim kodowaniu, więc dobrze żeby po Twoich modyfikacjach ciągle miały to kodowanie. Aby zmienić kodowanie wybierz menu Window/Preferences. Następnie z drzewa wybierz General/Workspace i zmień Text file encoding na UTF-8.
2. Jeśli wykorzystujesz Netbeans to:
   • Wybierz menu File/Open Project...
   • zaznacz katalog, do którego rozpakowałe(a)ś archiwum zip i wciśnij Open
3. Jeśli wykorzysujesz IDEĘ to:
   • Jeśli pierwszy raz uruchomiłeś IDEĘ to musisz wybrać zainstalowane JDK
   • Zmień kodowanie plików na UTF-8. Pliki projektu zostały zapisane właśnie w tym formacie, więc aby uniknąć oglądania "krzaków" w przeglądarce zmień te ustawienia. W tym celu wybierz menu File/Settings/General i w grupie File Encoding zmień domyślne kodowanie na UTF-8. Po zmianach zrestartuj IDE.
   • Wybierz menu Open project i następnie w otwartym oknie wyboru ścieżki zaznacz plik .project znajdujący się w rozpakowanym katalogu

4) Uruchomienie serwera wraz z aplikacją

Aby uruchomić serwer wraz z wdrożoną na nim aplikacją wystarczy odpalić klasę StartServer z domyślnego pakietu (źródła znajdują się w katalogu src). Po uruchomieniu możesz już wejść na stronę http://localhost:8080/blog i rozkoszować się możliwościami Egg Framework :)

5) Wprowadzanie modyfikacji

Gdy zapoznasz się z aplikacją i jej kodem źródłowym możesz zacząć wprowadzać w niej modyfikacje. Zmień którąś z klas i zapisz ją. Eclipse sam wykona kompilację klasy (o ile masz włączoną opcję Project/Build automatically). Przejdź do przeglądarki www i odśwież stronę za pomocą CTRL+F5. Efekty powinieneś zobaczyć od razu (restart serwera nie jest wymagany!). W przypadku Netbeans musisz ręcznie skompilować zmienioną klasę (F9) lub cały projekt (F11). Jeśli chodzi o IDEĘ to wciśnij CTRL+SHIFT+F9 aby skomplikować pojedyńczy plik. Aby przebudować cały projekt wybierz menu Build/Rebuild Project.