Keďže už niaky čas používam Ubuntu Linux, rozhodol som sa poobzerať sa po niakom “tooliku” vo vodách deb balíčkov. A nemusel som hladať dlho… Utilitka iconv (už defaultne nainštalovaná) ma veľmi príjemne prekvapila. Po peripetiách, ktoré som každokrát zažíval pri zmene encodingu pod Windows, predstavuje iconv viac ako vítanú zmenu. Takže encodujte s iconv:

iconv --from-code=ISO-8859-1 --to-code=UTF-8 iso.txt > utf.txt

A navyše iconv podporuje nespočetné množstvo formátov:

iconv --list

Tento sa snaží riešiť problematiku obmedzenia resp. umožnenia prístupu k zvolenej časti kódu. Autor nastolil problém, v ktorom chceme umožniť prístup k danej časti kódu iba určitému, tzv. “spriatelenému” kódu, ktorý sa nachádza v inom java balíčku. Tradičný prístup využívajúci prístupové modifikátory, ktoré poskytuje Java (public, protected, package private, private) nepostačuje. Ako to teda môžme zariadiť?

Trieda Item, ktorá je súčasťou API a ktorej zvolené metódy chceme umožniť volať iba priateľskému kódu sa nachádza v balíčku apipkg. Cheme umožniť volať tieto metódy z balíčku implpkg, ktorý obsahuje implementáciu daného API, a zo žiadneho iného miesta. Ako to teda spravíme? Pozrime sa na Tulachovo riešenie:

Trieda Item je súčasťou balíčku, ktorý reprezentuje naše API:

package apipkg;

import implpkg.Accessor;
import javax.swing.event.ChangeEvent;
import javax.swing.event.ChangeListener;

/**
* Class in API that everyone can use.
* @author Jaroslav Tulach
*/
public final class Item {
    private int value;
    private ChangeListener listener;

    static {
        Accessor.setDefault(new AccessorImpl());
    }

    /**
     * Only friends can create instances.
     */
    Item() {
    }

    /**
     * Anyone can change value of the item.
     */
    public void setValue(int newValue) {
        value = newValue;
        ChangeListener l = listener;
        if (l != null) {
            l.stateChanged(new ChangeEvent(this));
        }
    }

    /**
     * Anyone can get the value of the item.
     */
    public int getValue() {
        return value;
    }

   /**
    * Only friends can listen to changes.
    */ 
    void addChangeListener(ChangeListener l) {
        assert listener == null;
        listener = l;
    }
}

Rovnako je súčasťou API balíčku trieda AccessorImpl:

package apipkg;

import implpkg.Accessor;
import javax.swing.event.ChangeListener;

/**
* The bridge between api and impl package.
* @author Jaroslav Tulach
*/
final class AccessorImpl extends Accessor {
    protected Item newItem() {
        return new Item();
    }

    protected void addChangeListener(Item item, ChangeListener l) {
        item.addChangeListener(l);
    }
}

A na záver trieda Accessor, ktorá je súčasťou implementácie:

package implpkg;

import apipkg.Item;
import javax.swing.event.ChangeListener;

/**
* @author Jaroslav Tulach
*/
public abstract class Accessor {

    private static volatile Accessor DEFAULT;

    public Accessor() {
    }

    public static Accessor getDefault() {
        Accessor a = DEFAULT;
        if (a != null) {
            return a;
        }

        try {
            Class.forName(Item.class.getName(), true, Item.class.getClassLoader());
        } catch (Exception ex) {
            ex.printStackTrace();
        }

        return DEFAULT;
    }

    public static void setDefault(Accessor accessor) {
        if (DEFAULT != null) {
            throw new IllegalStateException();
        }
        DEFAULT = accessor;
    }

    protected abstract Item newItem();

    protected abstract void addChangeListener(Item item, ChangeListener l);
}

Týmto spôsobom umožníme volať zvolené metódy triedy Item prostredníctvom abstraktnej triedy Accessor aj v iných balíčkoch. Vytvoríme takto akýsi “teleinterface”:

    Item item = Accessor.getDefault().newItem();
    Accessor.getDefault().addChangeListener(item, this);

Hotovo! Komplikované? Nepochopili ste? Ak nie, nič si z toho nerobte, ja som to potreboval čítať dvakrát, aby som pochopil ako tento kúsok kódu funguje. Čo sme vlastne dosiahli? Umožnili sme každému, kto má prístup k implementačnému balíčku a triede Accessor, volať metódu API triedy Item, ktorá bola pôvodne iba package private. Zaujímavé? Možno!

Čo sa mi nepozdáva je závislosť, ktorá vznikla medzi implementáciou a API, t.j. medzi apikkg a implpkg. Pozorní si isto všimli, ze je cyklická! Problém je hlavne v tom, že trieda Item závisí na triede Accessor. Ak by sme chceli byť dôsledný, čo isto všetci chceme byť, oddelíme API od implementácie aj na úrovni nasaditeľných artefaktov (jar, war, atď.) a získame problém, ktorý nám môže veľmi znepríjemniť život. Druhý problém je komplexita tohto riešenia, nie je veľmi rukolapné! Osobne by som asi dvakrát zauvažoval či použiť takýto prístup, nazývaný aj friendly accessor alebo len jednoducho urobil metódu addChangeListener public, ponechal všetky dôsledky na používateľov API a stavil na ich um a zručnosť.

Všetky zdrojáky uvedené v tomto blogu sú verejné prístupné na sprievodných stránkach knihy.

V Eclipse Ganymeda release je Subversive plugin implicitne zaradený v kategórií Collaboration Tools ako SVN Team Provider (Incubation), okrem toho je potrebné stiahnuť Subversive SVN Connectors, ktoré sú prístupné z update stránky Polarionu (zoznam update stránok). Celý postup inštalácie je dostatočne prehľadne popísaný tu.

Menší problém nastane, ak sme na non-Windows platforme a chceme z ľubovolných dôvodov používať JavaHL (JNI wrapper nad C kódom SVN) namiesto SVNkitu (pure Java toolkit pre prácu s SVN). Polarion v rámci svojej update stránky poskytuje iba binárky pre Windows. Riešenie je jednoduché. Potrebujeme manuálne nainštalovať JavaHL knižnice a povedať Eclipse kde ich má hladať. Podrobnejší postup ako na to v Ubuntu, je možné nájsť tu.

Ahojte všetci známi (aj neznámi), všetkých Vás zdravím a vítam na mojom novom blogu. Dúfam, že si každý z Vás nájde niečo čo ho zaujme a poteší.