EBook2Go - prohlížení textů pro J2ME

EBook2Go je aplikace pro čtení elektronických textů na zařízeních s podporou technologie J2ME s profilem MIDP 1.0 a vyšším.

Aplikace umožňuje prohlížení elektronických textů i na zařízeních, na kterých kvůli absenci dostupného souborového systému (hlavně v případě mobilních telefonů) není možné realizovat prohlížeč jako samostatnou aplikaci oddělenou od datových souborů.

Aplikace proto využívá vlastnosti midlet suites (balíčků aplikací pro mobilní javu), umožňující v jednom aplikačním archivu udržovat jak samotnou prohlížecí aplikaci tak i její textová data.

Pro vytváření takovýchto archivů spustitelných v mobilním zařízení je určena aplikace pro prostředí desktopové javy (JRE verze 1.1 a vyšší), která je popsána zde.

Downloads

Aplikaci můžete stáhnout zde: ebookpackager.zip .

Zdrojové kódy pod licencí GPL jsou ke stažení zde ebook2go_1.1.zip .

Popis J2ME aplikace

aplikace je určena pro off-line čtení - veškerá data elektronického textu jsou součástí archivu aplikace, tj. při čtení není potřeba jakékoliv připojení k síti.

platformová nezávislost - nevyužívá žádné proprietární rozšíření API některého výrobce mobilních telefonů ani žádné další nestandardní vlastnosti jako například závislost na přítomnosti filesystému. Jedinou podmínkou je podpora J2ME s profilem MIDP verze alespoň 1.0.

od určité velikosti textu lepší komprese než obvyklé PDB - textová data jsou součástí JAR archivu aplikace, takže jsou komprimována běžnou ZIPovou kompresí, která na běžných textových datech dosahuje lepší komprimační poměr něž komprese použitá v PDB archivech. Samotná aplikace zabírá okolo 19kB JAR archivu.

podpora libovolné 8-bitové znakové sady

aplikace může obsahovat několik různých elektronických textů

aplikace umožňuje:

pohyb v textu o jeden obsah displeje dopředu/zpět

pohyb v textu o jeden řádek dopředu/zpět

nastavení použitého fontu:

malý/střední/velký

proporcionální/neproporcionální

obyčejný/tučný

nastavení barvy textu a pozadí z několika předdefinovaných variant

nastavení aktuální pozice v textu (v procentech celkové velikosti textu)

zobrazení informací o textu, autorovi aplikace a nápovědy pro ovládání aplikace

ukončení s uložením aktuální pozice v textu načtené při dalším spuštění a s uložením aktuálně nastaveného fontu a barev

aplikaci je možné ovládat jak pomocí běžných numerických tlačítek (mobilní telefony) tak i pomocí dotykového displeje (PDA, smartphones)

Popis aplikace pro vytváření JAR/JAD balíčků

Aplikace k zadanému vstupnímu souboru s elektronickým textem vygeneruje dvojici JAR+JAD souborů obsahujících zadaný text společně s aplikací na jeho čtení.

Aplikace je určena pro prostředí JRE 1.1 (desktopová Java). Pro spuštění je možné využít libovolný Java Runtime Enviroment od firmy Sun verze 1.1 a vyšší, popř. implementaci Javy od Microsoftu, která je součástí starších verzí Windows (příkaz "jview").

Aplikaci je možné spustit s grafickým uživatelským rozhraním pro manuální generování jednotlivých textových balíčků i s rozhraním pro příkazovou řádku, umožňující např. hromadné generování většího množství textů.

Použití přes grafické rozhraní

Syntaxe

Sun Java:

java -classpath ebookpackager.jar tom.ebook.PackagerGUIApplic

java -jar ebookpackager.jar

MS Java:

jview -cp ebookpackager.jar tom.ebook.PackagerGUIApplic

Provede spuštění aplikace s grafickým uživatelským rozhraním.

Generování přes GUI probíhá v následujících třech krocích:

První záložka

Do první záložky zadejte umístění vstupního textového souboru, popřípadě zadejte i jeho kódování (v případě, že není totožné s implicitním kódováním pro použitou platformu). Dále můžete v první záložce také zadat název a popis elektronického textu. Po stisku tlačítka "Přidej" je zadaný text zařazen do seznamu textů ve druhé záložce.

Druhá záložka

Druhá záložka obsahuje seznam vložených textů pro vytvoření výsledného balíčku. Stiskem tlačítka "Odstraň vybraný" můžete odstraňovat chybně zadané texty ze seznamu. Stiskem tlačítka "Další" přejdete k následující záložce.

Třetí záložka

V této záložce mužete nejdříve vyplnit maximální přípustnou velikost vygenerovaného JAR souboru. V případě větších textů bude text rozdělen do více souborů. Dále zadejte prefix výstupních souborů generovaného(-ných) balíčku(-ů) (JAR+JAD) s úplnou cestou. Poté stiskem tlačítka "Generuj J2ME aplikaci" spustíte vytváření balíčků. V textovém okénku mužete sledovat průběh generování včetně popisu případných chyb.

Čtvrtá záložka

Poslední záložka obsahuje informace o aplikaci.

Použití přes rozhraní příkazového řádku

Syntaxe

Sun Java

java -classpath ebookpackager.jar tom.ebook.Packager [VOLBY] <file> [[VOLBY] <file> ...]

java -jar ebookpackager.jar [VOLBY] <file> [[VOLBY] <file> ...]

MS Java

jview -cp ebookpackager.jar tom.ebook.Packager [VOLBY] <file> [[VOLBY] <file> ...]

Parametry

<file> Název vstupního textového souboru. Vstupních textů může být uvedeno několik, ke každému z nich se vztahují volby uvedené před ním.

Volby:

-H Zobrazí nápovědu (anglicky).

-E<kódování> Název kódování znaků vstupního souboru (např. Cp1250, windows-1250, ISO-8859-2, 8859_1, atd.). Implicitní hodnota je závislá na platformě.

-N<název knihy> Název elektronického textu.

-D<popis knihy> Popis elektronického textu.

-S<velikost části> Textová data musí být v JAR archivu rozdělena do menších částí, hodnota udává velikost každé této části v bajtech. Implicitní (a doporučená) hodnota je 5000 bajtů.

-O<prefix výstupu> Prefix výstupních JAR a JAD souborů. Implicitní hodnota je vytvořena z názvu vstupního textového souboru. Tato volba se vztahuje ke všem zadaným elektronickým textům.

-A<velikost_v_kB> Maximální (približná) velikost vytvorených JAR souboru. Pokud jsou textová data príliš velká, je generováno více dvojic JAR+JAD obsahujících v názvu index.

-T Pri výskytu chyby provede kompletní výpis zásobníku

Příklady použití

% java -classpath ebookpackager.jar tom.ebook.PackagerGUIApplic

Spustí grafické uživatelské rozhraní aplikace v prostředí Javy od firmy Sun.

% java -jar ebookpackager.jar

Totéž jako předchozí. Tuto syntaxi (volbu -jar) lze použít až od Javy verze 1.2. V případě, že by za tímto příkazem byly uvedeny jakékoliv parametry, spustí se aplikace s rozhraním příkazového řádku.

C:\> jview -cp ebookpackager.jar tom.ebook.PackagerGUIApplic

Spustí grafické uživatelské rozhraní aplikace v prostředí Javy od MS.

% java -classpath ebookpackager.jar tom.ebook.Packager kniha.txt

Vytvoří v aktuálním adresáři soubory "kniha.jad" a "kniha.jar" obsahující text ze souboru "kniha.txt" v implicitním kódování použitého operačního systému. Text je v archivu rozdělený do částí o velikosti 5000B.

% java -jar ebookpackager.jar kniha.txt

Totéž jako předchozí. Tuto syntaxi (volbu -jar) lze použít až od Javy verze 1.2.

C:\> jview -cp ebookpackager.jar tom.ebook.Packager kniha.txt

Totéž jako předchozí, aplikace je spuštěna v prostředí Javy od Microsoftu, standardně dodávané společně se staršími verzemi Windows.

% java -jar ebookpackager.jar -Opohadky -S10000 -Ewindows-1250 prvni.txt druha.txt -EISO-8859-2 posledni.txt

Vytvoří v aktuálním adresáři soubory "pohadky.jad" a "pohadky.jar" obsahující tři texty ze souborů "prvni.txt", "druha.txt" a "posledni.txt". První dva vstupní soubory jsou v kódování windows-1250, poslední je v kódování ISO-8859-2. Velikost datových částí je explicitně nastavena na 10000 bajtů.

Ukázkové texty

Zde si můžete vyzkoušet několik vygenerovaných J2ME aplikací s ukázkovými texty získanými ze serveru www.palmknihy.cz .

Následující soubory stačí nahrát do Vašeho mobilního zařízení s podporou Javy:

Ukázka č. 1 - část povídky Starobylí I. - Zbyněk Čáp:

JAR - Java Archive (31 kB)

JAD - Java Descriptor s lokálním URL (1 kB)

JAD - Java Descriptor s globálním URL (1 kB)

Ukázka č. 2 - povídka Krysař - Jiří X. Brossmann:

JAR - Java Archive (29 kB)

JAD - Java Descriptor s lokálním URL (1 kB)

JAD - Java Descriptor s globálním URL (1 kB)