Navrhli jste API, chcete v něm provést změny a děsí vás, co to způsobí s programy, které toto API používají? V tomto článku si na jednoduchém příkladu ukážeme, jak vám může pomoci RefactoringNG.

Mějme třídu Ship s metodou dock:

public class Ship {
    public void dock() { ... }
    ...
 }

V rámci evoluce API metodu dock přesuneme do třídy Harbour a uděláme ji statickou:

public class Harbour {
    public static void dock(Ship s) { ... }
    ...
 }

Po této změně je potřeba všechna volání metody dock na instancích třídy Ship nahradit voláním statické metody dock ze třídy Harbour. Např., je-li s proměnná typu Ship, musíme

s.dock();

změnit na

Harbour.dock(s);

Běžný postup je, že metodu dock ve třídě Ship označíme @Deprecated a počkáme, až programátoři začnou používat novou metodu ve třídě Harbour. Pomocí RefactoringNG lze přechod k nové metodě zautomatizovat. Stačí, když definujeme pravidlo, které nahradí volání s.dock() voláním Harbour.dock(s):

 MethodInvocation {
    List<Tree> { },
    MemberSelect [identifier: "dock"] {
       Identifier [id: s, instanceof: "navy.Ship"]
    },
    List<Expression> { }
 } ->
 MethodInvocation {
    List<Tree> { },
    MemberSelect [identifier: "dock"] {
       Identifier [name: "Harbour"]
    },
    List<Expression> {
       Identifier [ref: s]
    }
 }

Pomocí tohoto skriptu pak programátoři mohou snadno upgradovat svůj kód na novou verzi API.

Chcete-li se o použití RefactoringNG při evoluci API dozvědět více, podívejte se na tento článek.