SA Checker - Kontrola volných míst v autobusech Student Agency

Program SA Checker 2011 v pravidelných intervalech kontroluje počet volných míst ve vybraných spojích (autobusech) společnosti Student Agency a v případě, že je ve spoji volné místo, upozorní opakovaným zvukovým signálem.

Protože se zatím jedná o zkušební verzi, má program několik omezení a můžou se v něm vyskytovat chyby. Pokud na nějakou takovou chybu narazíte, informujte mě prosím popsáním situace, při které k chybě došlo, do diskuze na mém blogu tady.

Omezení:

• Volná místa je možné vyhledávat jen na přímých linkách.
• Program kontroluje vždy maximálně 10 spojů. (Z důvodu přetížení serveru.)
• Pokud odjíždí více spojů ve stejný den a současně ve stejný čas, prohledává se pouze poslední spoj.
• Volná místa se kontrolují každé 3 minuty. (Z důvodu přetížení serveru.)

Rozšíření cest, spojů na kterých program kontroluje volná místa:

V základní verzi je k dispozici jen pět stanic, mezi kterými je možné kontrolovat volná místa (Zlín, Brno, Kroměříž, Uherské Hradiště a Praha).
Oznámení výše už od verze 1.2 neplatí, nicméně popis jak přidávat spoje zde nechám, protože názvy se mohou postupem času měnit a pokud nebudu schopen dostatečně rychle reagovat, můžete si podle návodu program sami upravit ;-)

Ve verzi 1.1 jsou přidány stanice Praha, Černý Most a Liberec, AN. Taky jsem rozšířil program o vetší množství chybových výpisů a tak by snad mělo být jednodušší nalézt chyby.
Posledními většími změnami jsou nový zvuk při nalezení volných míst a automatické odstraňování již neaktuálních spojů.

Ve verzi 1.2 byly přidány všechny stanice na trasách ČR. Není v mé moci je všechny otestovat, takže pokud někdo narazíte na chybu, opět mě informujte v dikuzi na mém blogu a já se pokusím chybu opravit. Blog.
Abych nezapomněl, instalace je již kompletně v češtině.

Pokud si chcete sami přidat další stanice, musíte udělat dvě základní věci:

1. upravit soubor "seznamStanic.xml"

Jeho struktura je jednoduchá, stačí jen když doplníte na konec souboru před </seznamstanic> vámi zvolenou stanici, přesně jak je to na obrázcích níže.

Jak je vidět, doplnit se musí struktura, která je označena na obrázku vpravo. Skládá se z textu umístěného mezi tagy <text>, <value> a celá je ještě obalena v tagu <stanice>.
Název stanice v tagu <text> se bude zobrazovat ve výběrových boxech "Odkud" a "Kam" programu. Název stanice umístěný v tagu <value> je potřeba získat z URL na stránkách společnosti Student Agency. Vše se dá jednoduše pochopit z obrázku níže. Pozor na to, že se nejedná vždy o název města bez diakritiky psaný velkým písmem. Skutečně se to musí opsat z URL, jinak může docházet k chybám.
Pokud se vše povedlo, když teď zapnete program, uvidíte, že se Vámi přidané stanice přidaly do boxů. To ale stále nezaručí správnou funkci programu, k tomu se musí dokončit i úprava souboru níže.

2. upravit soubor "jizdniRad.xml"

Tady je to podobné jako u bodu 1. Jen vezmete hodnoty, které jsou v tagu <value> souboru seznamStanic.xml a zkopírujete do struktury tvořící jízdní řád v souboru jizdniRad.xml.
Vše se dá jednoduše pochopit z obrázků níže.

V atributu "id" u tagu <spoje id="VYCHOZI_STANICE"> je umístěna výchozí stanice. Uvnitř atributů <cíl> jsou pak stanice, do kterých se dá z výchozí stanice dostat přímým spojením.
Vždy by mělo platit, že všechny hodnoty co jsou umístěny v tagu <value> souboru seznamStanic.xml, musí být obsaženy i v atributu tagu <spoje> v souboru jizdniRad.xml.

Co je potřeba pro správný chod programu:

V první řadě si stáhnout instalaci z odkazu nahoře. Od verze 1.1 jsem již zip archiv nahradil "exe" souborem, který vás krok za krokem provede instalací, jak jste na to zvyklí.
Po instalaci musí složka obsahovat:

StudenAgencyChecker.jar

Tímto souborem se program spouští.

seznamStanic.xml

Konfigurační soubor se seznamem stanic odjezdu.

jizdniRad.xml

Konfigurační soubor pro kontrolu přímých spojů.

alarm.wav

Soubor se zvukem pro upozornění při nalezení volných míst.

dom4j-1.6.1.jar

Umístěn ve složce lib, nutný pro běh aplikace.

jaxen-1.1.3.jar

Umístěn ve složce lib, nutný pro běh aplikace.

Důležitá poznámka, celý program je napsán v jazyce Java. Velmi pravděpodobně máte na svém počítači nainstalováno vše, co je potřeba. Pokud však nemůžete program spustit, stáhněte si a nainstalujte Java Virtual Machine z odkazu tady