W projekcie, wszystkie encje implementują interfejs Identifiable, który określa metodę zwracającą identyfikator. Interfejs był mi potrzebny w jednym miejscu, żeby uprościć logikę. Kod interfejsu wygląda następująco:

public interface Identifiable {

    Object getId();
}

Encja, która z niego korzysta, ma identyfikator typu java.lang.Long oraz metody getter i setter, wygenerowane za pomocą lomboka. Kod encji:

import lombok.Getter
import lombok.Setter

public class Entity implements Identifiable {

    @Getter
    @Setter
    private Long id;
}

Na pierwszy rzut oka wszystko jest w porządku. Jednak co się stanie, gdy zaczniemy operować na metodach takiej klasy, za pomocą mechanizmu Java Reflection?

for (Method method : new Entity().getClass().getMethods()) {
    System.out.println(method);
}

Istotne elementy wyjścia, wygenerowanego przez taki kawałek kodu, to:

Object getId();
Long getId();
void setId(Long);

Kolejność, w jakiej zwracane są metody, jest stała w obrębie klasy (chociaż nikt o tym nie zapewnia i Java 7 ma to zmienić). Jednak nie jest stała w przypadku różnych klas. W związku z czym, dla jednej klasy, refleksja zwróci najpierw getter z typem Object, dla innej z Long.

Przyjrzyjmy się teraz bibliotece commons-beanutils. Jest to biblioteka, którą wykorzystuję do wpisywania wartości właściwości obiektu, po jego inicjalizacji. Przykładowy kod, obrazujący tę funkcjonalność, wygląda tak:

Entity e = new Entity();
Long id = 10L;

if (PropertyUtils.isWriteable(e, "id")) {
    PropertyUtils.setProperty(e, "id", id);
}

Jest to bardzo pomocne, w przypadku generycznego kodu, który ma za zadanie utworzyć obiekt z XML-a, JSON-a czy zserializowanego obiektu PHP. Jednak właściwość id to nie to samo co atrybut id. Właściwość beana, jest przez bibliotekę określana na podstawie getterów zawartych w klasie definiującej bean i odpowiadających im setterów.

Czy już widać w czym tkwi problem? W zależności od kolejności, w której refleksja zwróci metody, PropertyUtils znajdzie właściwość Object id, która jest tylko do odczytu; lub Long id, która jest zapisywalna.

Rozwiązanie problemu jest dość proste. Wystarczyło, do interfejsu Identifiable, dodać setter (a w konsekwencji także i szablon) i jak ręką odjął wszystkie właściwości stały się na powrót zapisywalne:

public interface Identifiable<T> {

    T getId();

    void setId(T id);
}

public class Entity implements Identifiable<Long> {

    @Getter
    @Setter
    private Long id;
}

Lekcja na przyszłość: minimalizm nie zawsze jest dobry i może prowadzić do dość nieoczekiwanych skutków. Oraz do brainf*cka, przy debugowaniu czegokolwiek z Apache Commons ;-)