#Updater jPalio

###Zaoenia
Aplikacja Updater opiera si na elastycznym mechanimie budowania [http://gradle.org/](Gradle), dlatego te dziki wykorzystaniu mechanizmu gradle wrapper, wystarczy aby w systemie bya zainstalowana java.
Aplikacja aktualizuje tylko pliki jar i zip znajdujce si w katalogu lib.
Gdy aktualna wersja jPalio <=7.4.93 ze strony http://jpalio.torn.com.pl/lib odczytywane s wszystkie pliki jar i zip dostyczce akutalnej wersji, a nastpnie s one "usuwane". W kolejnym kroku z repozytorium zostaj pobrane wszystkie pliki dotyczce wersji do ktrej jPalio zostanie zaktualizowane.
Gdy aktualna wersja jPalio > 7.4.93 na podstawie repozytorium zostaje ustalone jakie pliki naley "usun", a jakie doda.

Od wersji 1.1.0 aplikacja aktualizuje rwnie zalenoci zapisane w plikach instancji.

###Opis dziaania
Aplikacj znajduje si w katalogu updater. Po wejciu do katalogu uruchamia si j poleceniem gradlew nazwaZadania.
Przykad:

	gradlew update

###Zapis zalenoci
Pliku _xml_ konfiguracji instancji naley midzy znacznikami `<dependencies></dependencies>` doda znaczniki `<dependency></dependency>`, ktre z koleji zawieraj:

* znacznik `<group></group>` oznaczajcy nazw grupy artefaktu
* znacznik `<module></module>` oznaczajcy nazw moduu/artefaktu/biblioteki
* znacznik `<version></version>` oznaczajcy numer wersji 

Przykad:

	<dependencies>
	    <dependency>
	    	<group>org.antlr</group>
	    	<module>antlr4</module>
	    	<version>4.5</version>	
	    </dependency>
	    <dependency>
		    <group>org.apache.tomcat</group>
		    <module>tomcat</module>
		    <version>8.0.21</version>
		</dependency>
	</dependencies>
	
###Konfiguracje
Aplikacja tworzy 5 wasnych konfiguracji gradle:

* _instances_ - zalenoci pochodzce od wszystkich instancji z podziaem na instancj
* _currentPalio_ - zalenoci pochodzce od aktutalnej wersji jPalio
* _newJpalio_ - zalenoci pochodzce od wersji jPalio do ktrej zamierzamy zaktualizowa(wersj okrela parametr _newVersion_, domylnie _latest_ - najnowsza)
* _instancesWithCurrentPalio_ - suma zalenoci z _instances_ i _currentPalio_ 
* _instancesWithNewJpalio_ - suma zalenoci z _instances_ i _newJpalio_

###Polecenie _gradlew dependencies_
Zadanie dependencies wywietla wszystkie konfiguracje.
Zadanie to jest standardowym zadaniem gradle. Wicej informacji: [http://gradle.org/docs/current/userguide/tutorial_gradle_command_line.html#sec:listing_dependencies](11.6.4. Listing project dependencies)
Kada konfiguracja zawiera list zalenoci uoon hierarchicznie. 
Przykadowy wynik dla konfiguracji instances:

	instances
	+--- jpalioInstance:cms:000
	|    \--- org.jsoup:jsoup:1.8.2
	\--- jpalioInstance:nzoz:000
	     +--- org.apache.tomcat:tomcat:8.0.21
	     \--- org.antlr:antlr4:4.5
	          +--- org.antlr:antlr4-runtime:4.5
	          |    \--- org.abego.treelayout:org.abego.treelayout.core:1.0.1
	          +--- org.antlr:antlr-runtime:3.5.2
	          \--- org.antlr:ST4:4.0.8
	               \--- org.antlr:antlr-runtime:3.5.2
               
Konfiguracja _instances_ zawiera zalenoci pochodzce od instancji jPalio.
Pierwszy poziom zawiera zapisy typu:jpalioInstance:nazwa_instancji:000.
Prefix _jpalioInstance:_ oraz suffix _:000_ s sztucznie nadanymi nazwami grupy oraz wersj, zapewniajcymi zgodno z interfejsem aplikacji.

###Polecenie _gradlew update_
Znajduje najnowsz wersj jPalio w repozytorium oraz odczytuje zalenoci z plikw instancji. Tak uzyskane inforamcje skadaj sie na konfiguracj: _instancesWithNewJpalio_.
Na podstawie konfiguracji _instancesWithNewJpalio_ uaktualniane s pliki w folderze _lib_ zawierajcym biblioteki aplikacji.

###Polecenie _gradlew updateOnlyJpalio_
Znajduje aktualn wersj jPalio oraz najnowsz wersj jPalio w repozytorium, umieszcza zalenoci odpowiednio w configuracjach: _currentPalio_ oraz _newPalio_.
Wyznaczane s rnice midzy konfiguracjami _currentPalio_ oraz _newPalio_, a nastpnie stare biblioteki s "usuwane", a nowe s dodawane.

###Polecenie _gradlew updateDependencies_
Znajduje aktualn wersj oraz odczytuje zalenoci z plikw instancji. Tak uzyskane inforamcje skadaj sie na konfiguracj: _instancesWithCurrentPalio_.
Na podstawie konfiguracji _instancesWithNewJpalio_ uaktualniane s pliki w folderze _lib_ zawierajcym biblioteki aplikacji. 

###Backup
Pliki "usunit" zostaj przeniesione do katalogu oldLib, gdzie na podstawie daty zostaje utworzony nowy katalog oraz plik raportu.
     
###Wymagania
Katalog updater musi znajdowa si w katalogu WEB-INF aplikacji jPalio

###Parametry konfiguracyjne
Domylnie jpalio zostanie zaktualizaowane do wersji najnowszej, opcjonalnie mona w pliku _gradle.properties_ zmieni parametr _new_version oznaczajcy_ numer wersji, mona te polecenie _gradlew_ wywoa z parametrem _-Pnew_version=7.4.93_

* new_version - docelowa wersja jPalio do ktrej ma zosta zaktualizowane rodowisko jPalio wraz z zalenymi bibliotekami
	+ domylnie: latest
	+ moliwe wartoci: 
		- numer wersji, np. 1.4.5, 1.5.6-SNAPSHOT
		- _latest_, najnowsza dostpna w repozytorium
		- moliwe s inne warto, np. zawierajce znak +, wicej na temat numerowania zalenoci mona uzyska w dokumentacji Ivy, ktrego konfiguracja jest wzorem dla mechanizmu Gradle. [http://ant.apache.org/ivy/history/latest-milestone/ivyfile/dependency.html](http://ant.apache.org/ivy/history/latest-milestone/ivyfile/dependency.html)
* redownload_libs - jeli true to w czasie procesu aktualizacji, pobierane s wszystkie biblioteki, nie tylko te co si zmieniy
	+ domylnie: false
* full_lib_directory_backup - jeli true to w czasie procesu aktualizacji cay obecny folder _lib_ jest kopiowany do katalogu z kopiami zapasowymi 
	+ domylnie: true