Krzysztof Adamczyk - Java Developer's Diary

Przenosiny Bloga

2009-12-14T19:16:00.006+02:00

Blog został przeniesiony pod adres:

Configuring HermesJMS to work with Tibco

2009-09-03T16:07:00.014+03:00

I assume that you have Tibco installed in <TIBCOHOME>

1) Download & install HermesJMS. I assume that <HERMES_HOME> is the installation directory for Hermes.
2) Copy <TIBCOHOME>/ems/clients/java/*.* into <HERMES_HOME>/lib. There is no need to overwrite existing files.
3) For next steps, there is a presentation prepared here and we will follow it with the following note: See the first step of the presentation, then stop and come back here :) In the first step the presentation shows already prepared, long list of providers. To work with Tibco, we will only need one provider, which we have to add manually. To add a provider, go to Providers tab in Preferences dialog, right click under Classpath Groups, select Add Group and type the name (i.e. Tibco Ems). When the provider appears on the list, expand it's subtree to see the Library item. Right click on Library and select Add JAR(s). Add all JARs in <TIBCOHOME>/ems/clients/java directory. Click Apply, then OK to close Preferences window. Continue with step 2 of the presentation.

In Step 3, don't be surprised if just after selecting the Loader from the dropdown list, the list will disappear. It actually didn't dissapear, it's just behind the right edge of the dialog, and you can see it again, if you resize the dialog.

Good luck!

JDK5, Ubuntu i Summer Time

2009-08-31T16:18:00.003+03:00

Zacznijmy od tego że jestem właśnie w trakcie przesiadki na Linuksa, a konkretnie Kubuntu.

Pierwszy poważny problem który napotkałem dotyczy strefy czasowej widzianej przez Jave. Konfiguracja:

1) JRE6 zainstalowane "z paczki" (za pomocą aptitude), aby za jego pomocą uruchamiać Javowe narzędzia, aplety w przeglądarce itp.
2) JDK5 ściągnięte od Suna i rozpakowane. Służy do celów deweloperskich. Tutaj wskazuje JAVA_HOME.

Problem polegał na tym że Java w JDK nie uwzględniała przesunięcia czasu letniego (w zainstalowanym "z paczki" JRE jest OK). Po kilku godzinach rwania włosów z głowy znalazłem to zgłoszenie buga. W tytule mowa jest co prawda o JDK6, ale jak się okazuje pasuje również do wersji 5. Wykonałem z drobną zmianą to co tam jest opisane, czyli:


sudo cp /etc/localtime /etc/localtime.bak
sudo ln -s -f /usr/share/zoneinfo/Europe/Warsaw /etc/localtime

i po problemie. Weird...

P.S.
Jaki komunikator polecacie? Najlepsze by było coś co obsłuży zarówno GG jak i Jabbera.

Testowalny kod

2009-08-12T14:28:00.003+03:00

Mamy sezon ogórkowy, więc tylko krótki post o tym co niezwykle ważne, nawet w wakacje. Świetny artykuł Misko Hevery zatytułowany Writing Testable Code. Artykuł kieruje do mini-książki w formacie PDF zawierającej praktyczne przykłady jak istniejący, kiepski kod doprowadzić do sensownej i testowalnej postaci. Autorzy wykorzystują framework Guice, ale koncepcyjnie proponowane rozwiązania są uniwersalne.
Planuję również przyjrzeć się projektowi Testability Explorer, którego współautorem jest Misko, a który umożliwia analizowanie kodu pod względem testowalności (statyczna analiza bytecodu z tego co na szybko wyczytałem). Na razie ściągnąłem źródła i przekonałem się na własne oczy, że możliwości oferowane przez Guice są naprawdę bardzo ciekawe.

Miłej lektury!

Manifesto for Software Craftsmanship

2009-07-07T17:21:00.006+03:00

Nie ma już odwrotu :) Świadomy praw i obowiązków, pełen chęci ciągłego doskonalenia swego rzemiosła podpisałem dziś manifest. Do czego gorąco także i Ciebie zachęcam, jeśli nie jest Ci obca troska o jakość Twojej pracy.

Javarsovia 2009 za nami

2009-07-05T15:28:00.009+03:00

Największa bezpłatna konferencja polskiej społeczności javowej niestety już za nami. Piszę niestety, ponieważ to wydarzenie było niewątpliwym sukcesem i chciałoby się mieć takie konferencje co tydzień ;) Na Javarsovii nie zabrakło ciekawych prezentacji i niejednokrotnie ciężko było mi się zdecydować który wykład o danej godzinie wybrać. Szkoda mi kilku wykładów, które zmuszony byłem ominąć - mam nadzieję że organizatorzy szybko udostępnią filmy z konferencji i będzie można nadrobić tę stratę. Szczególnie żałuję wykładu Szczepana Fabra na temat testowania - ten temat od dłuższego czasu coraz bardziej mnie wciąga a wczoraj nie wiedzieć czemu poszedłem na Cloud Computing, który szczerze mówiąc trochę rozczarował... Uczestniczyłem już kiedyś w (rewelacyjnej zresztą) prezentacji Szczepana na temat Mockito (chyba było to na JDD) i tym razem pomyślałem że również będzie o Mockito - dlatego wybrałem inny wykład... Ominęła mnie także prezentacja Łukasza Lipki z naszego rodzimego Silesia JUG nt. Mule ESB. Łukasz mówił już kiedyś o Mule na spotkaniu JUGa, chociaż na Javarsovii na pewno rozszerzył jeszcze i tak ciekawą prezentację ;)

To może teraz coś o wykładach na których byłem :) Wymienię trzy, które zrobiły na mnie największe wrażenie, dostarczyły najwięcej nowej wiedzy - wybór oczywiście subiektywny.

Konrad Kamiński przedstawił Garbage First - nowy garbage collector w maszynie HotSpot. Szczerze przyznam, że przed tym wykładem nie miałem pojęcia jak działają wewnętrzne algorytmy GC a wykład Konrada dał dużo światła na ten jakże ważny temat. Nowy GC wygląda ciekawie, a możliwość określenia ile maksymalnie czasu może zajmować jego praca w danym odcinku czasu jest w aplikacjach serwerowych bardzo pożądana.

Kolejnym świetnym wykładem był wykład Jarosława Kijanowskiego na temat Drools Guvnor. Temat mi osobiście bliski, ponieważ używam Drools w projekcie nad którym obecnie pracuję. Jarek poprowadził prezentację w bardzo ciekawy, luźny sposób oraz - co należy podkreślić - pominął wiele niepotrzebnych detali technicznych które z punktu widzenia meritum tematu były nieistotne a jedynie zaciemniłyby obraz. Tej umiejętności niestety wciąż brakuje wielu polskim prelegentom, którzy potrafią zasypać słuchacza tonami XMLi wylewających się z projektora... Oprócz Guvnor'a Jarek zaprezentował również Drools CEP (Complex Event Processing) które pozwala na podejmowanie decyzji nie tylko na podstawie bieżących faktów, ale również "patrząc wstecz" (np 10 ostatnich zdarzeń, zdarzenia z ostatnich 20min) - ciekawa sprawa. Nie próbowałem jeszcze użyć Drools CEP, ale wygląda na to, że może być on darmową, opensource'ową konkurencją dla Oracle CEP.

Ostatnim wykładem na który się wybrałem był Spring TestContext Framework Jakuba Milkiewicza. Bardzo, bardzo ciekawy wykład poprowadzony w świetnym stylu. Publiczność wręcz domagała się przedłużenia prezentacji i przedstawienia jeszcze kilku przykładów. Do tej pory używałem małej części tego mini-frameworku, ale po tym wykładzie na pewno to się zmieni. Muszę się również przyjrzeć HamCrest'owi, którego Jakub używał do tworzenia asercji.

Na koniec dygresja na temat organizacji konferencji. To że organizatorzy DARMOWEJ konferencji zorganizowali DARMOWY lunch dla wszystkich uczestników - to jak dla mnie (jako głodomora) mistrzostwo świata!!! Poza tym ogólnie nie było rzeczy do której można by się przeczepić :) Wykłady ciekawe, żołądek pełny, sale dobre, miejsca dosyć, widoczność dobra itd itp. Podnieśliście poprzeczkę Panowie!

Pragmatyczny programista

2009-06-11T21:58:00.030+03:00

Właśnie skończyłem czytać książkę "Pragmatyczny programista. Od czeladnika do mistrza". Nie będę odosobniony, jeśli powiem, że każdy programista powinien tę książkę przeczytać. Ten post jest zgrupowaniem haseł i zasad, które dla mnie osobiście były najciekawszą nauką płynącą z tej lektury. Większość z nich to tematy znane, ale moim zdaniem na tyle ważne żeby jeszcze raz o nich powiedzieć i podkreślić ich znaczenie.

Wybite okno

Kiedy w bloku pojawi się wybite okno i nikt dostatecznie szybko tego nie naprawi, szybko pojawią się kolejne wybite okna i inne oznaki postępującego zniszczenia. Podobna zasada dotyczy kodu źródłowego - nie pozostawiaj w swoich systemach wybitych okien (zły kod, antywzorce, błędne decyzje projektowe, work-around'y). Nie dopuszczaj do powstania "ogniska rozkładu" Twojego systemu.

Ortogonalność

Poruszając się wzdłuż osi pionowej, rzut aktualnego położenia na oś poziomą nie zmienia się. Tak powinny być zaprojektowane systemy informatyczne: zmiany w module A nie powinny być zauważone przez moduł B. Oba moduły powinny komunikować się za pomocą dobrze zdefiniowanych interfejsów, a szczegóły implementacji powinny być ukryte tak, aby każdy z modułów mógł zostać zmieniony, a nawet zastąpiony bez konieczności zmian w pozostałych modułach.

Prawo Demeter (zasada minimalnej wiedzy)
W dużym skrócie: rozmawiaj tylko z obiektami z własnego otoczenia. Nie wyciągaj z nich innych obiektów ("wnętrzności") aby z nimi porozmawiać (byłoby to wnikanie w implementację). Niech obiekt nadrzędny odpowiednio oddeleguje wywołania, sam decydując jak chce zrealizować zadany cel. Zamiast:

car.getOnboardComputer().getGPS().getLocation();

napisz

car.getLocation()

pozostawiając klasie Car decyzję, jak zaimplementować określanie lokalizacji.

Pociski smugowe
Autorzy nazwali tak technikę podobną nieco do prototypowania, która zaleca stworzenie na początku rozwiązania bardzo ubogiego, ale przechodzącego przez wszystkie warstwy i stanowiącego bazę dla dalszego rozwoju systemu. W odróżnieniu od prototypu, rozwiązanie to nie trafia do kosza po sprawdzeniu że działa, lecz staje się integralną częścią systemu, wokół której tworzone są kolejne funkcjonalności aż do zakończenia projektu. Nazwa pociski smugowe wzięła się z tego, że stworzony kod pozwala stwierdzić, czy projekt "trafia do celu" czyli idzie w dobrym kierunku już na początku, posiadając zaimplementowaną jedynie najmniejszą możliwą część funkcjonalności. Dziś w dobie agile, chyba bardzo często stosowana technika ;)

Odwracalność
Podejmuj decyzje odwracalne. Przygotuj się na to, że klient zechce zmienić wersję, lub nawet producenta bazy danych, serwer aplikacyjny etc...

Programowanie przypadkowe
Fred nie wie dlaczego program nie działa, ponieważ wcześniej nie wiedział, dlaczego program działał.

Poznaj API
i technologie które używasz, aby nie tworzyć kodu na oślep, kodu który działa przez przypadek.

Testowanie jednostkowe
jest jak testowanie układów scalonych - sygnały podane na odpowiednie wejścia powodują odpowiednie stany na wyjściach.

DRY
Na temat tej zasady nie będę się powtarzał :)

JBoss Drools - działająca aplikacja w 10 minut

2009-05-21T16:57:00.064+03:00

Postanowiłem stworzyć minimalną aplikację JavaSE korzystającą z silnika reguł JBoss Drools oraz tablic decyzyjnych zapisanych w postaci arkuszy Excela. Poniżej przedstawiam moje wyniki. Najważniejszą wytyczną podczas tworzenia tej aplikacji była prostota, aby zobaczyć jakie minimalne kroki są konieczne aby uruchomić Drools. Dlatego też aplikacja jest pozbawiona kontroli błędów, walidacji parametrów itp - nie o to tu chodziło.

No to się wytłumaczyłem - teraz do dzieła :)

Zaczynamy od stworzenia tablicy decyzyjnej:
Podstawowym pojęciem w tematyce tablic decyzyjnych jest fakt - na nasze potrzeby możemy zdefiniować to pojęcie jako obiekt Javowy umieszczony w pamięci roboczej (working memory) silnika reguł w trakcie jego uruchamiania, lub też powstały "wewnątrz silnika" jako rezultat działania którejś reguły. W naszym przykładzie występują tylko fakty umieszczone w pamięci roboczej "z zewnątrz". Fakty posiadają atrybuty, czyli w naszym przypadku właściwości (properties) obiektów Javowych. Drools umożliwia tworzenie warunków na konkretną wartość pola obiektu - oczywiście musimy trzymać się konwencji JavaBeans.

Definicja tabeli zaczyna się w komórce oznaczonej tekstem RuleTable . W kolejnym wierszu wpisujemy nagłówki oznaczające rolę danej kolumny w tabeli - condition (warunek) lub action (konsekwencja, akcja). Kolejne dwa wiersze służą do definiowania szczegółów warunku lub akcji. Warunkiem może być np. istnienie jakiegoś faktu (komórka B9) lub konkretna wartość atrybutu faktu (komórki C8 i C9 - tutaj odnosimy się do wartości atrybutu name faktu typu Activity a kolejne wiersze są potencjalnymi wartościami tego pola). Tabela zawiera dwie reguły (wiersze 11 i 12):

Istnieje Student oraz istnieje Activity o nazwie fun
Istnieje Student oraz istnieje Activity o nazwie learning

Dla obu reguł istnieje wspólna akcja, zdefiniowana jako fragment kodu Javy - dodanie Stringa do listy. $param oznacza wartość z komórki wybranej jako przecięcie bieżącej kolumny (akcji) i wiersza uruchomionej reguły. Jeśli więc silnik reguł zostanie zasilony faktem Student oraz faktem Activity o atrybucie name równym learning - wówczas zostanie uruchomiona akcja pierwszej reguły. Jeśli dodatkowo pojawi się fakt Activity o atrybucie name=fun, zostanie również uruchomiona akcja drugiej reguły. Kilka faktów umieszczonych w pamięci roboczej (working memory) silnika reguł może spowodować uruchomienie wielu reguł. Bardziej szczegółowe informacje można znaleźć w dokumentacji. Na uwagę zasługuje jeszcze sekcja Variables, która umożliwia zdefiniowanie zmiennych. Pozwala to na bardzo proste zwracanie wyników działania reguł - uruchamiając silnik reguł można za pomocą metody setGlobal przekazać referencję do obiektu Javowego, który będzie reprezentował daną zmienną zdefiniowaną w regułach. W naszym przykładzie do zwrócenia listy jako rezultatu działania reguł stosujemy konstrukcję:

...
List rulesEvaluationResult = new ArrayList();
statelessDroolsSession.setGlobal("resultList", rulesEvaluationResult);
Uruchom_reguły

Po jej wykonaniu rulesEvaluationResult zawiera wynik działania reguł czyli to co wewnątrz tablicy decyzyjnej wkładamy do zmiennej resultList.

Mając już gotową tablicę decyzyjną możemy przystąpić do tworzenia aplikacji. Zaczynamy od stworzenia projektu wykorzystując Maven'a:

mvn archetype:create -DgroupId=pl.kadamczyk.droolssample -DartifactId=DroolsSample

Edytujemy plik pom.xml tak aby znajdowały się w nim następujące zależności:

<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd">
<modelVersion>4.0.0</modelVersion>
<groupId>pl.kadamczyk.droolssample</groupId>
<artifactId>DroolsSample</artifactId>
<packaging>jar</packaging>
<version>1.0-SNAPSHOT</version>
<name>DroolsSample</name>
<url>http://maven.apache.org</url>
<dependencies>
 <dependency>
  <groupId>junit</groupId>
  <artifactId>junit</artifactId>
  <version>3.8.1</version>
  <scope>test</scope>
 </dependency>
 <dependency>
  <groupId>org.drools</groupId>
  <artifactId>drools-core</artifactId>
  <version>4.0.7</version>
 </dependency>
 <dependency>
  <groupId>org.drools</groupId>
  <artifactId>drools-compiler</artifactId>
  <version>4.0.7</version>
 </dependency>
 <dependency>
  <groupId>org.drools</groupId>
  <artifactId>drools-decisiontables</artifactId>
  <version>4.0.7</version>
 </dependency>
</dependencies>
</project>

Jeszcze tylko

mvn install

oraz

mvn eclipse:eclipse

i importujemy projekt do Eclipse.

Dodajemy do projektu klasę, której zadaniem jest stworzenie bazy reguł (RuleBase) na podstawie dostarczonego do niej pliku XLS (jego nazwy):

package pl.kadamczyk.droolssample;

import java.io.IOException;
import java.io.InputStream;
import java.io.Reader;
import java.io.StringReader;
import java.util.Properties;

import org.drools.RuleBase;
import org.drools.RuleBaseFactory;
import org.drools.compiler.DroolsParserException;
import org.drools.compiler.PackageBuilder;
import org.drools.compiler.PackageBuilderConfiguration;
import org.drools.decisiontable.InputType;
import org.drools.decisiontable.SpreadsheetCompiler;
import org.drools.rule.Package;

public class DecisionTableXlsCompiler {

    public RuleBase compileToRuleBase(final String decisionTablesXlsFile) throws Exception {
        RuleBase result = RuleBaseFactory.newRuleBase();

        final InputStream resourceAsStream = DecisionTableXlsCompiler.class.getResourceAsStream(decisionTablesXlsFile);
        final String drl = compileXlsToDlr(resourceAsStream);
        Package rulePackage = this.buildPackageFromDrl(drl);
        result.addPackage(rulePackage);
        return result;
    }

    private Package buildPackageFromDrl(final String drlString) throws DroolsParserException, IOException {
        Properties properties = new Properties();
        properties.setProperty("drools.dialect.java.compiler", "JANINO");
        properties.setProperty("drools.dialect.java.lngLevel", "1.5");

        final PackageBuilderConfiguration pkgBuilderCfg = new PackageBuilderConfiguration(properties);
        final PackageBuilder builder = new PackageBuilder(pkgBuilderCfg);

        Reader drlReader = new StringReader(drlString);
        builder.addPackageFromDrl(drlReader);

        Package result = builder.getPackage();

        return result;
    }

    private String compileXlsToDlr(final InputStream xlsStream) {
        final SpreadsheetCompiler compiler = new SpreadsheetCompiler();
        final String drl = compiler.compile(xlsStream, InputType.XLS);
        return drl;
    }

}

Oraz klasę, która uruchamia silnik reguł ze skompilowaną wcześniej bazą reguł, zasilając go faktami:

package pl.kadamczyk.droolssample;

import java.util.List;

import org.drools.RuleBase;
import org.drools.StatelessSession;

public class DroolsEvaluator {

    public <T> void run(RuleBase ruleBase, final String outParamName, T outParamRef, final List<Object> facts) {
        final StatelessSession statelessDroolsSession = ruleBase.newStatelessSession();
        statelessDroolsSession.setGlobal(outParamName, outParamRef);
        statelessDroolsSession.execute(facts);
    }

}

I już możemy tą aplikację uruchomić:

package pl.kadamczyk.droolssample;

import java.util.ArrayList;
import java.util.List;

import org.drools.RuleBase;

import pl.kadamczyk.droolssample.model.Activity;
import pl.kadamczyk.droolssample.model.Student;

public class Runner {

    public static void main(String[] args) throws Exception {
        DecisionTableXlsCompiler compiler = new DecisionTableXlsCompiler();
        DroolsEvaluator evaluator = new DroolsEvaluator();

        List<Object> rulesResult = new ArrayList<Object>();

        RuleBase ruleBase = compiler.compileToRuleBase("decisiontable.xls");
        evaluator.run(ruleBase, "resultList", rulesResult, prepareFacts());

        for (Object obj : rulesResult) {
            System.out.println(obj);
        }
    }

    private static List<Object> prepareFacts() {
        List<Object> facts = new ArrayList<Object>();
        Activity learningActivity = new Activity();
        learningActivity.setName("learning");
        facts.add(learningActivity);
        Activity funActivity = new Activity();
        funActivity.setName("fun");
        facts.add(funActivity);
        facts.add(new Student());

        return facts;
    }
}

Uruchomienie powyższego przykładu spowoduje wypisanie na konsoli napisu:

Student is having fun
Student is learning

co jest zgodne z oczekiwaniami, ponieważ przekazane do silnika reguł fakty (obiekty utworzone w metodzie prepareFacts() ) spełniają obie reguły.

GeeCON 2009

2009-05-10T18:33:00.017+03:00

Miniony tydzień upłynął pod znakiem konferencji GeeCON - czas podsumować 2 dni spędzone w Krakowie.

Organizatorzy na miejsce konferencji wybrali kino (Multikino Kraków) co miało swoje plusy dodatnie i ujemne ;) Świetny efekt daje olbrzymi ekran za plecami prelegenta na którym wyświetlane są slajdy - i to jest krok we właściwym kierunku. Problemem jest jednak właściwe oświetlenie - aby na przyciemnionej sali kinowej widoczny był prelegent, a światło nie oświetlało ekranu. Niestety kompletnie nie udało się to podczas pierwszego wykładu Simona Rittera "JavaFX: The Platform for Rich Internet Applications". Z miejsca w którym siedziałem niektóre slajdy były praktycznie niewidoczne. Wspomniał o tym także sam prelegent, który niejednokrotnie musiał opisywać, co powinno być widoczne na ekranie.

From GeeCON

Problemy z oświetleniem zostały częściowo rozwiązane i później było już znacznie lepiej. Ciekawą i udaną prelekcję wygłosili panowie ze SpringSource: Alef Arendsen i Arjen Poutsma. Mówili o nowościach w Spring 3.0, a Arjen rozpoczął również drugi dzień konferencji ciekawym wykładem na temat Springa i RESTful WebServices.

From GeeCON

Dalej przyszedł czas na wykład Waldka Kota na temat wirtualizacji - ciekawy, ale chyba troszkę zbyt szczegółowy, oraz nieco stremowanego Jacka Laskowskiego który przedstawił temat OpenEJB. Jacek podszedł do prelekcji chyba trochę zachowawczo, nie przedstawiając na początku żadnego przykładu "live". Wydaje się, że trochę zjadła go trema związana z wystąpieniem po angielsku. Obawy były niepotrzebne, bo językowo było dobrze - przydałby się jednak jakiś ciekawszy temat, w którym Jacek mógłby bardziej rozwinąć skrzydła ;)

W pierwszym dniu uczestniczyłem jeszcze w świetnym wykładzie Vaclava Pecha "Practical Groovy" - sposób prowadzenia prezentacji, pokazane przykłady, kontakt z publicznością - wszystko na szóstkę. Vaclav pokazał jak bardzo Groovy ułatwia rozwiązanie niektórych problemów i jak łatwo zintegrować go z Javą.

Drugi dzień zapamiętam głównie ze względu na dwa bardzo dobre wykłady Antonio Goncalves'a oraz świetny, prowadzony na wesoło wykład Bruno Bossoli. Antonio poproszony o zastępstwo jednego z prelegentów przedstawił serwer aplikacyjny GlassFish, a drugi (planowy) wykład poświęcił nowościom w JavaEE6.
Bruno Bossola, członek Torino JUG, omawiał zasady projektowania oprogramowania w bardzo charyzmatyczny, okraszony sporą dawką humoru sposób. Co jakiś czas pojawiały się slajdy zawierające najzabawniejsze fragmenty komentarzy znalezionych w kodzie:

From GeeCON

Bardzo ważnymi elementami konferencji były "atrakcje dodatkowe", wśród których najciekawszą była Beer Certification Path, czyli rundka po krakowskich pubach w czwartkowy wieczór. W każdym z czterech pubów do odebrania było piwo od Sun'a :) oraz pieczątka - jedna z liter słowa JAVA:

From GeeCON

Świetny pomysł :D Przy okazji mamy kolejny argument wyższości Javy nad C# - Java ma więcej liter ;)

Podsumowując - kilka ciekawych wykładów, piwko w Krakowie wieczorem - to sprawiło że konferencje ogólnie uważam za udaną. Na pewno blask sukcesu przyćmiły problemy techniczne na początku ze światłem, później z podłączeniem laptopów, szczególnie "makówek" do projektorów, ale wszyscy uczymy się na błędach i jestem pewien że GeeCON 2010 będzie jeszcze lepszy - a im więcej takich wydarzeń, tym lepiej dla nas :)

O co chodzi w JavaFX

2009-04-17T15:46:00.027+03:00

Ostatnio mam okazję zapoznawać się z technologią JavaFX i chciałbym podzielić się z Wami moimi spostrzeżeniami na jej temat.

Statyczne typowanie
JavaFX jest językiem statycznie (silnie) typowanym, z rozwiniętym mechanizmem Type Inference, czyli - z angielskiego na nasze - "zgadywaniem typów". Jest to o tyle fajne, że oszczędzamy trochę pisania podczas deklaracji zmiennej, ponieważ zapis (poprawny)

var napis : String = "Hello World!"

możemy zastąpić równie poprawnym zapisem

var napis = "Hello World!"

i kompilator od tego momentu już wie (zgaduje), że napis jest Stringiem.

Bindowanie na poziomie języka
Na uwagę zasługuje mechanizm bindowania wprowadzony na poziomie języka. Jest to bardzo ciekawe i w wielu miejscach użyteczne. Np zapis:

var currentTextBoxValue = "";
....
TextBox {
   value: bind currentTextBoxValue with inverse
}

oznacza, że ilekroć użytkownik wpisze coś w pole tekstowe (TextBox), zawartość tego pola zostanie automatycznie przepisana do zmiennej currentTextBoxValue, oraz ilekroć zmieniona zostanie wartość zmiennej currentTextBoxValue, zaktualizowana zostanie zawartość pola tekstowego. Mechanizm ten oszczędza czasem pisania wielu listenerów, choć wydaje mi się, że źle użyty, może być również źródłem konsternacji kiedy zmienne zaczną "magicznie" zmieniać swoje wartości ;)

Domknięcia (closures)
Temat znany miłośnikom Javy chociażby z dyskusji czy wprowadzić ten mechanizm w kolejnej wersji czy nie :) W JavaFX dostępny:

var x = 1;
SwingButton {
   action: function (): Void {
     x++;
   }
   text: "Increment"
}

Koncepcyjnie polega to na przekazaniu funkcji (domknięcia, ang. closure) jako parametru "gdzieś dalej", przy czym kiedy odbiorca tej funkcji postanowi ją wykonać, jej wykonanie nastąpi w kontekście, w którym funkcja została utworzona. Również bardzo wygodne rozwiązanie pozwalające szybko uzyskać porządane efekty.

Modyfikatory dostępu
Twórcy JavaFX postanowili chyba odwieść programistów od stosowania jakże nam bliskich getterów i setterów, udostępniając kilka nowych modyfikatorów dostępu do pól np:
public-init - pozwala na modyfikację pola wyłącznie w trakcie tworzenia obiektu
public-read - pozwala na dostęp tylko do odczytu z zewnątrz

Brak konstruktorów, bloki init i postinit
Tak tak - w JavaFX zabrakło miejsca dla konstruktorów. Obiekty tworzymy używając specjalnego wyrażenia postaci:

var circle = Circle {
      fill: null
      stroke: Color.BLACK
      strokeWidth: 3
      centerX: 22,
      centerY: 33,
      radius: 44
}

W obrębie nawiasów klamrowych ustawiamy wartości pól klasy, przy czym nie panuje tutaj kompletna dowolność, ponieważ ograniczają nas modyfikatory dostępu tych pól.

Aby zagwarantować integralność obiektu możemy wewnątrz klasy stworzyć blok postinit, który będzie wykonany tuż po stworzeniu obiektu i ustawieniu wartości pól:


postinit {
  if( model == null) {
      throw new IllegalStateException("Model cannot be null!");
  }
}

Integracja z Javą
Bardzo ważna informacja - z poziomu JavaFx można korzystać z klas Javowych (widać to chociażby w przykładzie powyżej, kiedy rzucam stary dobry IllegalStateException). Ograniczenie dotyczy bindowania - nie można bindować do pól klas napisanych w Javie.

Dostępność gotowych rozwiązań
I tu jest moim zdaniem póki co krucho. Oczekiwałem np. dużo bogatszego zbioru widgetów. Gdy potrzebowałem DatePickera, zmuszony zostałem do wzięcia komponentu kalendarza z przykładów Suna i trochę go przerabiając stworzyć własną kontrolkę zawierającą pole tekstowe i przycisk wyświetlający kalendarz. Dobrze rokuje na przyszłość biblioteka JFXtras, ale jak na razie to i tak trochę za mało.

Wsparcie ze strony IDE
Od razu powiem że moim ulubionym środowiskiem jest Eclipse. Niestety - na obecnym etapie aby walka z JavaFX miała jakikolwiek sens, musiałem przesiąść się (tymczasowo! zaraz wracam!) na Netbeans 6.5. Nie chcę urazić fanów NB, więc nie będę się rozpisywał na temat oczywistych różnic tych środowisk, które z oczywistych powodów (oczywista oczywistość) utrudniały mi pracę ;) Netbeansowy plugin do JavaFX również nie jest pozbawiony błędów, a te najbardziej dokuczliwe dotyczą podpowiadania, organizacji importów i formatowania kodu. Nie działa również refaktoring (o zgrozo), oraz różne sposoby nawigacji w kodzie (np. call hierarchy, które akurat często używam).

Przyszłość
JavaFX jest wciąż nową technologią, wymagającą okrzepnięcia, ustabilizowania się i mocnego wsparcia ze strony community. Również Sun powinien położyć duży nacisk na stworzenie gotowych bibliotek komponentów, efektów itp. "gadżetów" które umożliwiałyby łatwiejsze rozpoczęcie tworzenia złożonych, dobrze wyglądających aplikacji internetowych.
JavaFX wciąż mocno się zmienia - widać to chociażby po przykładach znajdowanych w sieci, z których część po prostu już nie działa, z powodu zmian API. Idea jest jednak bez wątpienia ciekawa i obiecująca, dlatego trzymam kciuki za tą technologię :)

4Developers - wrażenia

2009-03-11T10:42:00.028+02:00

Ostatnio miałem przyjemność uczestniczyć w konferencji 4Developers, która bardzo pozytywnie mnie zaskoczyła pod względem merytorycznym. Cztery równoległe ścieżki sprawiły że naprawdę było w czym wybierać.

Na pierwszy ogień Adam Bien z wykładem zatytułowanym EJB 3.1 - Killing The Top Eleven Myths, Tales and Biases. Przez dość długi czas pracowałem w technologii EJB3, dlatego przyszedłem na ten wykład ze sporymi oczekiwaniami i - muszę przyznać - nie zawiodłem się. Adam poprowadził rzeczowy, przekonywujący wykład i ani przez moment nie przynudzał :) Tempo w sam raz, a i elementy humorystyczne się zdarzały. Celem Adama była walka z mitami, które mówią że EJB3.x są "ciężkie", trudne do testowania, implementacji etc. Adam położył duży nacisk na nadchodzące EJB3.1, gdzie będzie można np. "ręcznie" (w kodzie) wystartować kontener EJB (już teraz możliwe z OpenEJB, ale wejdzie do standardu). Ujednoliceniu ulegną też JNDI-names komponentów, co przyczyni się do osiągnięcia prawdziwej przenośności aplikacji pomiędzy serwerami aplikacyjnymi.

Jako drugi w sekcji Javy wystąpił Neal Ford z wykładem zatytułowanym The Productive Programmer: Mechanics. W tym przypadku również bez rozczarowań - Neal przedstawił ciekawy temat optymalizacji pracy developera, prezentując różne narzędzia wspomagające. Pokazał, że usprawniając najprostsze czynności, jak kopiowanie do schowka czy nawigowanie w drzewie katalogów, możemy zyskać naprawdę dużo czasu. Neal duży nacisk położył na konieczność dobrego poznania swojego IDE, a szczególnie jego obsługi za pomocą samej klawiatury.

Jako trzeci na ścieżce Javowej wystąpił Cornel Creanga prezentując możliwości Flexa w połączeniu z Javą. Niestety ten wykład nie zachwycił treścią, ani stylem prezentacji, choć byćmoże moja opinia jest po części spowodowana tym, że ten temat nieco mniej mnie interesuje. Prezentacja sprowadzała się do przeklikania aplikacji demonstracyjnej korzystającej z możliwości Flexa. Dość nieprzyjemną niespodzianką był jakiś element (chyba głośnik) który spadł z sufitu i zawisł na kablach nad głową jednego z uczestników wykładu - niewiele brakowało...

Następnie przeniosłem się do sali, w której odbywały się wykłady ze ścieżki Zarządzania projektami, aby posłuchać Adama Krosnego z firmy Alan Systems. Adam poprowadził bardzo ciekawy, obszerny wykład na temat praktyki wprowadzania metodologi SCRUM. Opisał proces wdrażania tej metodologii z punktu widzenia praktyka, przedstawiając również teoretyczne podstawy. Także w "kuluarach" słyszałem wiele pozytywnych opini na temat tej prelekcji (m.in. ktoś powiedział, że był to najbardziej merytoryczny wykład ze wszystkich wykładów sponsorowanych). Temat przedstawiony przez Adama spotkał się z dużym zainteresowaniem wypełnionej chyba w 100% sali - wiele osób zadawało pytania, przez co wykład nieco się przedłużył, ale było warto :)

Marcin Żuchowicz z e-point przedstawił problem prowadzenia dużych projektów informatycznych z praktycznego punktu widzenia. Wykład ciekawy, momentami zabawny (np. opis projektu Ajax z kilkoma pokojami wypełnionymi dokumentacją ;) ) Główny wniosek do którego zmierzał prelegent to konieczność mocnego zaangażowania managera po stronie klienta i jego umiejętność przekonania swoich mocodawców, że czasami warto zmienić wymagania w imię dobra projektu.

Następnie wybrałem się na wykład Teda Neward'a, który opowiadał o Scali. Ted, podobnie jak Neal Ford (obaj z ThoughtWorks) to konferencyjny "wyjadacz", tym razem również nie zawiódł. Przedstawił w skrócie podstawy Scali jako języka samodzielnego, jak również możliwego do wykorzystania z poziomu Javy. Niejednokrotnie podkreślał zalety kompilatora Scali w porównaniu z javac - np. w kwestii wymagalności średnika na końcu wyrażenia (Scala tego nie wymaga), czy konieczności określania typu zmiennej przy deklaracji (po lewej stronie).

Jako ostatni wystąpił Jacek Laskowski który rozbudził zmęczoną już nieco publiczność. Jacek mówił o Groovy i Grails i choć - jak to czasami bywa na prezentacjach- nie wszystko zadziałało, dowiedziałem się przynajmniej teoretycznie czegoś więcej na temat tych mechanizmów. Pomimo późnej pory Jackowi udało się zaangażować widownię w swój wykład i nawet drobne wpadki związane z działaniem przykładów zostały nagrodzone brawami ;)

Poziom merytoryczny konferencji był moim zdaniem wysoki. Powiedziałbym nawet że było lepiej niż na dwóch poprzednich JDD. Jedyne czego zabrakło to lunch i parking. Przerwa na lunch w której wszyscy wybiegają na miasto, a tam we wszystkich najbliższych restauracjach hordy developerów - to nie jest dobry pomysł ;)

Spring + Hibernate - migracja z XML do adnotacji

2009-01-07T09:27:00.009+02:00

Duuużo czasu minęło od mojego ostatniego posta :( Powód prozaiczny - miałem wolne :) Plany na grudzień były ogromne - rozwój bloga, dopieszczanie frameworku nad którym pracuję itp. itd... Jak widzicie w grudniu nie pojawił się ani jeden post, więc te chwalebne plany legły w gruzach. Udało mi się jednak załatwić parę innych pożytecznych rzeczy. Okazuje się że więcej czasu można wygospodarować prowadząc regularny tryb życia (praca itp.). Mam nadzieję że teraz uda mi się napisać częściej o moich zmaganiach z Javą ;)

Do rzeczy więc - dzisiaj modyfikujemy projekt napisany z użyciem Springa i Hibernate'a. Modyfikacja polegać będzie na stopniowym wycofywaniu plików .hbm i wprowadzaniu w ich miejsce adnotacji. Nie będę opisywał samego sposobu adnotowania encji, ponieważ uznaję że w tym nie ma nic szczególnie trudnego (no może za wyjątkiem jakichś specyficznych elementów XML'owego opisu mapowania). To co chcę opisać to kroki konfiguracyjne które pozwolą na działanie adnotacji w projekcie.

Krok 1 - dodanie wymaganych bibliotek
Do projektu należy dodać następujące plik JAR:

- hibernate-annotations.jar
- hibernate-commons-annotations.jar
- slf4j-api-1.5.6jar
- slf4j-log4j12-1.5.6.jar
- ejb3-persistence.jar

Ważne aby oba JARy slf4j były w tej samej wersji - w przeciwnym wypadku możemy spodziewać się ciekawych błędów :)

Krok 2 - modyfikacje w kontekście Springa
1) Zmieniamy klasę sessionFactory

<bean id="sessionFactory"
class="org.springframework.orm.hibernate3.LocalSessionFactoryBean">

<bean id="sessionFactory"
class="org.springframework.orm.hibernate3.annotation.AnnotationSessionFactoryBean">

2) Dodajemy następujący wpis:

<property name="configurationClass">
    <value>org.hibernate.cfg.AnnotationConfiguration</value>
</property>

3) Listujemy klasy opisane za pomocą adnotacji:

<property name="annotatedClasses">
   <list>
       <value>pl.kadamczyk.model.User</value>
   </list>
</property>

Co ważne część klas w projekcie może być opisana adnotacjami, a pozostała część XMLem, ponieważ obok właściwości annotatedClasses może występować także właściwość np. mappingDirectoryLocations pozwalająca wskazać katalog zawierający pliki .hbm

NetBeans Platform - wrażenia po 2. spotkaniu Silesia JUG

2008-11-20T15:26:00.000+02:00

Za nami drugie spotkanie Silesia JUG, którego tematem była Platforma NetBeans. Marek Kliś przez ponad 1,5 godziny prezentował możliwości tej platformy korzystając z nowiutkiego NetBeans 6.5, który (zapewne z racji swej nowości) miewał czasami dość długie momenty zawahania. Widownia tym razem była o wiele mniejsza niż na pierwszym spotkaniu, co moim zdaniem w dużej mierze spowodowane jest tematem spotkania - Eclipse wciąż ma się dobrze i to z niego korzysta zdecydowana większość developerów. Sam przyznam, że NetBeansa odpaliłem dosłownie kilka razy w życiu i to wyłącznie z chęci poeksperymentowania. Na prezentację wybrałem się aby dowiedzieć się czegoś na temat możliwości platformy NB i jej wykorzystania do tworzenia aplikacji desktopowych. Nie ukrywam, że moje podejście było na początku sceptyczne choć oczywiście miałem nadzieję, że Marek pokaże coś rewolucyjnego. Jako że od dawna tworzę aplikacje oparte o Eclipse RCP, chciałem porównać obie platformy/frameworki/szkielety..... etc.

Trzeba przyznać, że wizualnie wygląda to ładnie, choć mi osobiście bardziej podoba się UI aplikacji zbudowanych na Eclipse. Podstawową aplikację (bez funkcjonalności) da się stworzyć wpisując zero linii kodu ;) Dalej już bez znajomości API ani rusz, ale to zrozumiałe.

Marek starał się jak najlepiej przekazać temat i - biorąc pod uwagę obszerność zagadnienia i dość ograniczony czas - jego starania oceniam dobrze :) Nie obeszło się jednak w kilku momentach bez zbytniego wchodzenia w szczegóły, ale to chyba problem większości prelegentów. (Zobaczymy co będzie jak kiedyś mi przyjdzie stanąć przed publicznością ;) )

Netbeans Platform jest opcją do rozważenia jeśli jednym z wymagań jest to, aby aplikacja była oparta o Swing. W tym środowisku jego konkurentami są chyba tylko SpringRCP i Swing Application Framework, a spośród nich NB wydaje mi się opcją najdojrzalszą i dającą na dzień dzisiejszy największe możliwości. Jeżeli mamy dowolność Swing/SWT- ja zdecydowanie wybiorę Eclipse RCP, ale nie jestem w tym temacie obiektywny :) Niestety zbyt mało wiem na temat NB aby dokładniej porównać obie platformy. To co udało mi się zaobserwować podczas prezentacji to dość powolny start tworzonej aplikacji (ale Eclipse czasem też daje w kość).

Obie platformy już od dłuższego czasu rozwijają się dynamicznie. Bardzo dobrze że istnieje swoista konkurencja pomiędzy tymi produktami zarówno w sferze IDE jak i platformy tworzenia oprogramowania, ponieważ na takiej rywalizacji wszyscy zyskują, a najbardziej my - deweloperzy, otrzymując coraz ciekawsze narzędzia i rozwiązania.

Wstrzykiwanie zależności w aplikacji webowej

2008-11-18T13:37:00.000+02:00

Znasz to uczucie, gdy robisz coś po raz N-ty i za każdym razem działało a teraz za nic w świecie nie chce? No właśnie... Potrzebowałem do wykonania pewnego testu stworzyć malutki projekt EJB3 a w nim jeden SLSB. Obok tego stworzyłem projekt aplikacji webowej (Dynamic Web Project), w środku jedna klasa implementująca ServletContextListener, która będzie notyfikować wstrzykniętego beana podczas deployu EAR'a tudzież startu serwera aplikacyjnego:


public class MyStartupListener implements ServletContextListener {

   @EJB
   private LifecycleMonitorRemote lifeCycleMonitor

   public void contextDestroyed(final ServletContextEvent arg0) {
       lifeCycleMonitor.shutdown();
   }

   public void contextInitialized(final ServletContextEvent arg0) {
       lifeCycleMonitor.startup();
   }
}

Dodałem odpowiednie wpisy do web.xml:


<?xml version="1.0" encoding="UTF-8"?>
<web-app id="WebApp_ID" version="2.4" xmlns="http://java.sun.com/xml/ns/j2ee"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://java.sun.com/xml/ns/j2ee http://java.sun.com/xml/ns/j2ee/web-app_2_4.xsd">
 <display-name>test.startup.web</display-name>
 <welcome-file-list>
  <welcome-file>index.html</welcome-file>
  <welcome-file>index.htm</welcome-file>
  <welcome-file>index.jsp</welcome-file>
  <welcome-file>default.html</welcome-file>
  <welcome-file>default.htm</welcome-file>
  <welcome-file>default.jsp</welcome-file>
 </welcome-file-list>
 
<listener>
   <listener-class>listeners.MyStartupListener</listener-class>
</listener>

<servlet>
   <description></description>
   <display-name>MyStartupListener</display-name>
   <servlet-name>MyStartupListener</servlet-name>
   <servlet-class>listeners.MyStartupListener</servlet-class>
</servlet>
 
 <servlet-mapping>
   <servlet-name>MyStartupListener</servlet-name>
   <url-pattern>/MyStartupListener</url-pattern>
 </servlet-mapping>
</web-app>

Ruszamy... I co? I NullPointerException w linii

 lifeCycleMonitor.startup();

Znaczy dependency injection jakby nie zadziałało... Ale zawsze działało...
Kilkukrotne przejrzenie całego kodu i nic (!) W takich sytuacjach zwykle pomaga Google - wskazówkę znalazłem na JavaRanch, a błąd okazał się bardziej prozaiczny niż przypuszczałem. Jak widać powyższy plik web.xml odnosi się do specyfikacji Java Servlet w wersji 2.4, podczas gdy dependency injection działa w servletach od wersji 2.5. Po poprawce ten fragment web.xml wygląda tak:


<web-app xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://java.sun.com/xml/ns/javaee"
xmlns:web="http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd"
xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd"
id="WebApp_ID" version="2.5">

Uff...

Tworzymy plugin do Eclipse - Hello World

2008-11-14T18:32:00.000+02:00

Jak pewnie większość z Was wie, Eclipse nie jest tylko środowiskiem programistycznym (IDE), ale również - a może przede wszystkim - platformą tworzenia oprogramowania, na której "przy okazji" powstało świetne IDE. U podstaw tego wszystkiego leży OSGi, o które będziemy się ocierać tworząc aplikacje na platformie Eclipse. Chociażby podstawowy byt w rozumieniu środowiska Eclipse - plugin - jest w istocie pakunkiem (bundle) OSGi.

Postanowiłem przybliżyć trochę tematykę tworzenia aplikacji na bazie Eclipse, a dzisiejszy artykuł, jak nakazuje tradycja, przedstawia podstawowe Hello World w świecie Eclipse Platform.

Do stworzenia najprostszego projektu nie potrzeba wiele - wystarczy Eclipse z zainstalowanym PDE (Plugin Development Environment). Ja skorzystam z wersji 3.3 na której akurat mam dograne PDE.

Zanim zaczniemy, potrzebny jest krótki wstęp teoretyczny. Jednym z podstawowych pojęć platformy Eclipse jest punkt rozszerzeń (Extension point). Za pomocą punktów rozszerzeń nasze pluginy mogą wzbogacać w funkcje już istniejące pluginy (w tym te rdzennie Eclipsowe), a zarazem pozwalać innym pluginom rozszerzać swoją funkcjonalność. Przykładowo Eclipse udostępnia Extension point za pomocą którego możemy dodać kolejne menu do menu górnego (co za chwilkę pokażę).

Z drugiej strony wyobraźmy sobie aplikację, która służy np. konwersji bitmapy na różne formaty graficzne. Otwieramy plik BMP i w okienku widzimy combo box z dostępnymi docelowymi formatami graficznymi. Z platformą Eclipse projekt takiej aplikacji może zyskać na modularności i rozszerzalności, jeśli każdy konwerter wykonamy jako rozszerzenie (extension) udostepnionego przez siebie punktu rozszerzeń (Extension point'a). Platforma umożliwia pobranie wszystkich rozszerzeń, które "wpinają się" w dany punkt, więc bardzo prosto stworzyć listę dostępnych docelowych formatów konwersji. Jeśli postanowimy dopisać konwerter do nowego formatu pliku, wystarczy zadeklarować (poprzez XML), że on również wpina się w dany punkt rozszerzeń i bez modyfikacji istniejącego kodu stanie się on dostępny w aplikacji.

Punkt rozszerzeń ma nazwę (np. pl.kadamczyk.bmpconverter) oraz definicję w postaci schematu XSD. W tworzenie punktów rozszerzeń nie będziemy narazie wchodzić, ale mam nadzieję że uda mi się napisać o tym w przyszłości. Najważniejsze na teraz, aby zapamiętać że punkt rozszerzeń jest miejscem styku w którym moduły mogą dostarczać swoją funkcjonalność innym modułom.

Ok, po tym przydługawym wstępie stwórzmy wreszcie pierwszy, bardzo prosty projekt:

Określamy nazwę projektu, nie zmieniając pozostałych opcji:

Na kolejnych ekranach nie zmieniamy żadnych opcji i kończymy kreatora, który po zakończeniu swojej pracy otwiera graficzny edytor pliku plugin.xml.

Będziemy chcieli do naszego Eclipse'a dodać nowe menu, a w nim opcję, po wybraniu której wyświetli się okno informacyjne.

W tym celu otwieramy zakładkę Extensions. Na tej zakładce definiujemy w jaki sposób nasz plugin ma rozszerzać "otoczenie" (czyli pluginy tworzące Eclipse w tym przypadku). Chcemy dodać element do górnego menu Eclipse'a, a do tego służy punkt rozszerzeń org.eclipse.ui.actionSets. Na zakładce Extensions wybieramy Add, i w dostępne pole tekstowe Extension point filter wpisujemy org.eclipse.ui.actionSets. Zamykamy okno, co powoduje dodanie rozszerzenia. Teraz należy to rozszerzenie skonfigurować.
Extension point actionSets zawiera już jeden element który konfigurujemy jak na rysunku:
Następnie dodajmy menu do skonfigurowanego właśnie Action Seta. Klikamy prawym przyciskiem na "Pierwszy action set", wybieramy New->Menu.
Jako label wpisujemy np. "Menu Hello World" - to będzie widoczne w pasku menu Eclipse po uruchomieniu. Zostawmy wygenerowane automatycznie ID (PluginHelloWorld.menu1)
Następnie analogicznie do menu dodajemy separator, nie zmieniając mu właściwości (wygenerowany ID: "PluginHelloWorld.separator1").
Na końcu tym samym sposobem do action seta dodajemy akcję (action) i konfigurujemy ją jak na rysunku:
Pozostało jeszcze zdefiniowanie najważniejszego, czyli tego, co akcja ma robić. Edytor umożliwia wprowadzenie nazwy klasy która jest odpowiedzialna za działanie akcji jako parametr class w dolnej części rysunku. Można również kliknąć na link class co spowoduje uruchomienie mini-kreatora. Wystarczy wybrać pakiet i wpisać nazwę klasy, a kreator sam "zmajstruje" klasę z odpowiednimi metodami, które my musimy "tylko" wypełnić:
Definiujemy klasę akcji jak poniżej:


package sampleeclipseplugin;

import org.eclipse.jface.action.IAction;
import org.eclipse.jface.dialogs.MessageDialog;
import org.eclipse.jface.viewers.ISelection;
import org.eclipse.ui.IWorkbenchWindow;
import org.eclipse.ui.IWorkbenchWindowActionDelegate;

public class SayHelloAction implements IWorkbenchWindowActionDelegate {

  private IWorkbenchWindow window;

  public void dispose() {
      // empty
  }

  public void init(final IWorkbenchWindow window) {
      this.window = window;
  }

  public void run(final IAction action) {
      MessageDialog.openInformation(window.getShell(), "Hello!",
              "Jestem pierwszym pluginem do Eclipse'a");
  }

  public void selectionChanged(final IAction action,
          final ISelection selection) {
      // empty
  }
}

W tym momencie plik plugin.xml wygląda tak:


<?xml version="1.0" encoding="UTF-8"?>
<?eclipse version="3.2"?>
<plugin>
<extension
     id="myActionSet"
     point="org.eclipse.ui.actionSets">
  <actionSet
        id="PluginHelloWorld.actionSet1"
        label="Mój prosty plugin"
        visible="true">
     <menu
           id="PluginHelloWorld.menu1"
           label="Moje proste menu">
        <separator
              name="PluginHelloWorld.separator1">
        </separator>
     </menu>
     <action
           class="sampleeclipseplugin.SayHelloAction"
           id="PluginHelloWorld.action1"
           label="Przedstaw siê"
           menubarPath="PluginHelloWorld.menu1/PluginHelloWorld.separator1">
     </action>
  </actionSet>
</extension>
</plugin>

Aby uruchomić plugin przenosimy się na pierwszą zakładkę edytora pliku plugin.xml, a tam w sekcji Testing wybieramy Launch an Eclipse application. Uruchomiona zostaje nowa instancja Eclipse'a z dołączonym naszym pluginem. W górnym menu jest już widoczne zdefiniowane przez nas rozszerzenie (nowa pozycja menu).

Tym sposobem ukończyliśmy pierwszy, najprostszy plugin do Eclipse - może nie dysponuje on zaawansowanymi "ficzerami", ale jest to pierwszy krok do stworzenia czegoś ciekawszego. Postaram się w jednym z kolejnych postów rozszerzyć funkcjonalność pluginu i - kto wie - może przy okazji uda się stworzyć coś pożytecznego ;)

PropertyChangeSupport - wywołanie za pomocą Spring AOP

2008-11-12T09:45:00.000+02:00

W poprzednim tekście opisałem jak poradzić sobie z problemem opisanym na pl.comp.lang.java w poście zatytułowanym JavaBeans - zła koncepcja używając czystego AspectJ. Dziś pokażę jak zrobić to samo wykorzystując Spring AOP (przypomnę - chodzi o notyfikację obiektu PropertyChangeSupport przy każdym wywołaniu settera na JavaBean'ie).

Najważniejszym elementem rozwiązania jest interceptor, który przechwytuje wywołania setterów:


package pl.kadamczyk.springpropertychange.interceptors;

import java.lang.reflect.Field;

import org.aopalliance.intercept.MethodInterceptor;
import org.aopalliance.intercept.MethodInvocation;

import pl.kadamczyk.springpropertychange.model.BaseModelObject;

public class SetterMethodInterceptor implements MethodInterceptor {

 /**
  * Otacza faktyczne wywołanie metody
  */
 public Object invoke(final MethodInvocation method) throws Throwable {
     String jointPoint = method.getMethod().getName();

     // wyznaczamy nazwe pola na podstawie nazwy wywolanego settera
     String fieldName = jointPoint.replaceFirst("set", "");
     fieldName = Character.toLowerCase(fieldName.charAt(0))
             + fieldName.substring(1);

     try {
         Object target = method.getThis();

         Class clazz = target.getClass();
         // pobieramy pole klasy o wyznaczonej wczesniej nazwie
         Field field = clazz.getDeclaredField(fieldName);
         field.setAccessible(true);

         // pobieramy stara wartosc pola
         Object oldValue = field.get(target);
         // zezwalamy na wywolanie settera
         Object result = method.proceed();
         if (method.getArguments().length == 1) {
             triggerPropertyChange(target, method.getArguments()[0],
                     oldValue, fieldName);
         }

         return result;
     } catch (NoSuchFieldException e) {
         throw new RuntimeException(e);
     } catch (IllegalArgumentException e) {
         throw new RuntimeException(e);
     } catch (IllegalAccessException e) {
         throw new RuntimeException(e);
     } catch (Throwable e) {
         throw new RuntimeException(e);
     }
 }

 /**
  * Sprawdza, czy metoda została wykonana na obiekcie klasy dziedziczącej
  * po BaseModelObject, a jeśli tak, wywołuje na nim firePropertyChange
  */
 private void triggerPropertyChange(final Object target,
         final Object newVal, final Object oldValue, final String fieldName) {
     System.out.println("MethodInterceptor: Zmieniamy wartosc pola "
             + fieldName);

     if (target instanceof BaseModelObject) {
         // wywolujemy metode z klasy bazowej
         ((BaseModelObject) target).firePropertyChange(fieldName, oldValue,
                 newVal);
     }
 }
}

Jest to częściowo zmieniona wersja aspektu z poprzedniego posta, dostosowana do Springowego API.

Drugim krokiem jest odpowiednie skonfigurowanie interceptora:


<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:aop="http://www.springframework.org/schema/aop"
xmlns:context="http://www.springframework.org/schema/context"
xsi:schemaLocation="
http://www.springframework.org/schema/aop http://www.springframework.org/schema/aop/spring-aop-2.5.xsd
http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans-2.5.xsd
http://www.springframework.org/schema/context http://www.springframework.org/schema/context/spring-context-2.5.xsd">

<aop:aspectj-autoproxy />

<bean id="someModelObject"
class="pl.kadamczyk.springpropertychange.model.SomeModelObject"
scope="prototype" />

<bean name="setterInterceptor"
class="pl.kadamczyk.springpropertychange.interceptors.SetterMethodInterceptor" />

<bean name="pointcut.setterAdvisor"
  class="org.springframework.aop.support.NameMatchMethodPointcutAdvisor">
  <property name="advice" ref="setterInterceptor" />
  <property name="mappedName" value="set*" />
 </bean>

</beans>

Na uwagę zasługuje bean pointcut.setterAdvisor który odpowiada za powiązanie interceptora z pointcut'ami w których ma być zaaplikowany.

W odróżnieniu od pierwszego rozwiązania w którym zastosowałem czysty AspectJ oraz compile-time-weaving, tutaj aplikowanie porady wykonywane jest w trakcie działania.
Konsekwencją tego jest zmiana sposobu korzystania z klas modelu. Aby Spring AOP mógł wygenerować odpowiednie proxy w runtime, konieczne jest pobranie obiektu z fabryki - w naszym przypadku będzie to ClassPathXmlApplicationContext:


 public static void main(final String[] args) {
     AbstractApplicationContext context = new ClassPathXmlApplicationContext(
             "beans.xml");

     SomeModelObject modelObject = (SomeModelObject) context
             .getBean("someModelObject");

     modelObject.setSomeIntProperty(23);
     modelObject.setSomeStringProperty("ala");
 }

Zwróćmy uwagę, że bean someModelObject w pliku konfiguracyjnym Spring'a zdefiniowany jest z atrybutem scope="prototype" aby wywołanie context.getBean zwracało za każdym razem nową instancję.

Podobnie jak poprzednio, wynikiem działania metody main jest napis na konsoli:

MethodInterceptor: Zmieniamy wartosc pola someIntProperty
MethodInterceptor: Zmieniamy wartosc pola someStringProperty

PropertyChangeSupport - wywołanie za pomocą AspectJ

2008-11-06T15:43:00.000+02:00

Zainspirowany postem Krzyśka (aka Kolszew) zatytułowanym JavaBeans - zła koncepcja na pl.comp.lang.java postanowiłem przygotować przykład demonstrujący użycie Aspect Oriented Programming (konkretnie AspectJ) do rozwiązania przedstawionego przez Krzyśka problemu.
Interesuje mnie uzyskanie zachowania setterów wybranych klas identycznego z poniższym zapisem:


void setText(String txt) {
    String oldValue = this.text;
    this.text = txt;
    propertyChangeSupport.firePropertyChange("text", oldValue, txt);
}

bez konieczności dodawania w każdym setterze pierwszej i trzeciej z powyższych linii kodu.

Pierwszy krok to stworzenie projektu. Plugin AJDT (AspectJ Development Tools) do Eclipse umożliwia stworzenie projektu AspectJ (New->AspectJ Project) zawierającego od razu podpięte bilbioteki AJ.

Tworzę klasę bazową dla klas modelu, udostępniającą metodę firePropertyChange która po prostu deleguje wywołanie do prywatnego pola typu PropertyChangeSupport.


import java.beans.PropertyChangeSupport;

public class BaseModelObject {

    private PropertyChangeSupport propertyChangeSupport = new PropertyChangeSupport(
            this);

    public void firePropertyChange(final String propertyName,
            final Object oldValue, final Object newValue) {
        propertyChangeSupport.firePropertyChange(propertyName, oldValue,
                newValue);
    }

}

Stwórzmy testową klasę, która dziedziczy po BaseModelObject:


package pl.kadamczyk.ajpropertychange.model;

public class SomeModelObject extends BaseModelObject {

    private String someStringProperty;
    private int someIntProperty;

    public String getSomeStringProperty() {
        return someStringProperty;
    }

    public void setSomeStringProperty(final String someStringProperty) {
        this.someStringProperty = someStringProperty;
    }

    public int getSomeIntProperty() {
        return someIntProperty;
    }

    public void setSomeIntProperty(final int someIntProperty) {
        this.someIntProperty = someIntProperty;
    }
}

Nadszedł najciekawszy moment: tworzymy aspekt który będzie odpowiedzialny za wywoływanie metody firePropertyChange z klasy BaseModelObject:


package pl.kadamczyk.ajpropertychange.aspects;

import pl.kadamczyk.ajpropertychange.model.BaseModelObject;

public aspect PropertyChangeAspect {

    
    /**
     * Określamy "miejsca", gdzie aplikowana będzie Porada
     */
    pointcut callSetter(Object target, Object param): target(target) && args(param) &&  
             execution(void pl.kadamczyk.ajpropertychange.model.*.set*(..));

    /**
     * Porada typu around - pozwala wykonać kod przed i po właściwym
     * wywołaniu metody.
     * 
     */
    Object around(Object target, Object newVal) : callSetter(target, newVal)  {
        String jointPoint = thisJoinPoint.getSignature().getName();
        // wyznaczamy nazwe pola na podstawie nazwy wywolanego settera
        String fieldName = jointPoint.replaceFirst("set", "");
        fieldName = Character.toLowerCase(fieldName.charAt(0))
                + fieldName.substring(1);

        try {
            Class clazz = target.getClass();
            // pobieramy pole klasy o wyznaczonej wczesniej nazwie
            java.lang.reflect.Field field = clazz.getDeclaredField(fieldName);
            field.setAccessible(true);

            // pobieramy stara wartosc pola
            Object oldValue = field.get(target);
            // zezwalamy na wywolanie settera
            Object result = proceed(target, newVal);
            triggerPropertyChange(target, newVal, oldValue, fieldName);
            return result;
        } catch (NoSuchFieldException e) {
            throw new RuntimeException(e);
        } catch (IllegalArgumentException e) {
            throw new RuntimeException(e);
        } catch (IllegalAccessException e) {
            throw new RuntimeException(e);
        }
    }

    /**
     * Sprawdza, czy metoda została wykonana na obiekcie klasy dziedziczącej
     * po BaseModelObject, a jeśli tak, wywołuje na nim firePropertyChange
     */
    private void triggerPropertyChange(final Object target,
            final Object newVal, final Object oldValue, final String fieldName) {
        System.out.println("Zmieniamy wartosc pola " + fieldName);
        if (target instanceof BaseModelObject) {
            // wywolujemy metode z klasy bazowej
            ((BaseModelObject) target).firePropertyChange(fieldName, oldValue,
                    newVal);
        }
    }

}

Zdefiniowany pointcut określa wywołanie wszystkich metod we wszystkich klasach w pakiecie pl.kadamczyk.ajpropertychange.model o nazwie rozpoczynającej się od "set" oraz typie zwracanym "void".

Zdefiniowanie Porady (advice) typu around umożliwia wykonanie czynności zarówno przed jak i po wykonaniu właściwej metody, którą wyzwalamy wywołując proceed().

Na uwagę zasługuje również użycie zmiennej specjalnej thisJoinPoint - jest to analogia do standardowego Javowego this - zmienna ta może być używana jedynie w kontekście Porady (advice). Zawiera ona wiele przydatnich informacji na temat bieżącego Join Pointa, czyli w naszym przypadku konkretnego wywołanego settera. W szczególności wywołanie:

thisJoinPoint.getSignature().getName()

zwraca nazwę aktualnie wywoływanej metody set*.

Aby zobaczyć rezultat działania powyższego aspektu uruchomimy prostą klasę z metodą main():


package pl.kadamczyk.ajpropertychange.launcher;

import pl.kadamczyk.ajpropertychange.model.SomeModelObject;

public class Launcher {

public static void main(final String[] args) {
    SomeModelObject mo = new SomeModelObject();
    mo.setSomeIntProperty(23);
    mo.setSomeStringProperty("ala ma kota");
}

}

na konsoli otrzymujemy wynik:

Zmieniamy wartosc pola someIntProperty
Zmieniamy wartosc pola someStringProperty

Jeszcze uwaga na koniec - ten kod nie zadziała odpalony z odpowiednim menadżerem bezpieczeństwa, ponieważ nie dopuści on do wywołania metody setAccesible(true) na polach.
Biorąc to pod uwagę należy w inny sposób pobrać wartość pola - ja tutaj zastosowałem 'hack' z metodą setAccesible ponieważ było to najszybsze rozwiązanie ;)

JPA, transakcje rozproszone i MS SQL Server

2008-11-06T10:43:00.000+02:00

Po raz pierwszy przyszło mi zmierzyć się z tematem transakcji rozproszonych, i to od razu w styczności z MS SQL Serverem, który - moim zdaniem - jest średnio przyjazny Javie.
Sama konieczność zastosowania transakcji rozproszonych wynikła z wymagania eksportowania danych z jednej bazy (baza A - PostgreSQL) do drugiej (baza B - MS SQL). W trakcie tegoż eksportu dane z bazy A muszą być oznaczane jako pomyślnie wyeksportowane. W przypadku, gdy w trakcie zapisu do bazy B coś pójdzie nie tak transakcja jest rollbackowana i dane w bazie A nie otrzymują flagi "wyeksportowane".
W założeniu wszystko pięknie - gorzej w praktyce. Okazało się że włączenie obsługi transakcji XA w MS SQL tymaga wykonania sporej liczby kroków, które opiszę poniżej:

Włącz obsługę transakcji rozproszonych w systemie Windows, na którym jest zainstalowany SQL Server - zostało to opisane tutaj.
Skonfiguruj usługę systemowego Koordynatora Transakcji Rozproszonych (Distributed Transactions Coordinator) aby uruchamiałą się automatycznie podczas startu systemu
Pobierz sterownik JDBC.
W pobranej paczce sterowników znajdź plik sqljdbc_xa.dll (odpowiedni dla danej architektury) i umieść go w strukturze katalogów SQL Servera.
Plik ten zawiera implementacje procedur składowanych odpowiedzialnych za transakcje rozproszone.
Wskaż systemowi operacyjnemu lokalizację powyższego pliku. Aby to zrobić, należy dodać do rejestru w kluczu
HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\MSDTC\XADLL
wpis typu "wartość ciągu" (REG_SZ) o nazwie będącej nazwą pliku DLL oraz o wartości będącej ścieżką do tego pliku (wraz z samą nazwą). W moim przypadku było to :
nazwa: sqljdbc_xa.dll
wartość: C:\Program Files\Microsoft SQL Server\100\Shared\sqljdbc_xa.dll
Na zainstalowanej instancji SQL Servera uruchom skrypt SQL instalujący potrzebne procedury składowane. Skrypt ten może być następującej postaci:
use master
go
exec sp_addextendedproc 'xp_sqljdbc_xa_init', 'SQLJDBC_XA.dll'
exec sp_addextendedproc 'xp_sqljdbc_xa_start', 'SQLJDBC_XA.dll'
exec sp_addextendedproc 'xp_sqljdbc_xa_end', 'SQLJDBC_XA.dll'
exec sp_addextendedproc 'xp_sqljdbc_xa_prepare', 'SQLJDBC_XA.dll'
exec sp_addextendedproc 'xp_sqljdbc_xa_commit', 'SQLJDBC_XA.dll'
exec sp_addextendedproc 'xp_sqljdbc_xa_rollback', 'SQLJDBC_XA.dll'
exec sp_addextendedproc 'xp_sqljdbc_xa_forget', 'SQLJDBC_XA.dll'
exec sp_addextendedproc 'xp_sqljdbc_xa_recover', 'SQLJDBC_XA.dll'
exec sp_addextendedproc 'xp_sqljdbc_xa_rollback_ex', 'SQLJDBC_XA.dll'
exec sp_addextendedproc 'xp_sqljdbc_xa_forget_ex', 'SQLJDBC_XA.dll'
exec sp_addextendedproc 'xp_sqljdbc_xa_prepare_ex', 'SQLJDBC_XA.dll'
go

grant execute on xp_sqljdbc_xa_init to public
grant execute on xp_sqljdbc_xa_start to public
grant execute on xp_sqljdbc_xa_end to public
grant execute on xp_sqljdbc_xa_prepare to public
grant execute on xp_sqljdbc_xa_commit to public
grant execute on xp_sqljdbc_xa_rollback to public
grant execute on xp_sqljdbc_xa_recover to public
grant execute on xp_sqljdbc_xa_forget to public
grant execute on xp_sqljdbc_xa_rollback_ex to public
grant execute on xp_sqljdbc_xa_forget_ex to public
grant execute on xp_sqljdbc_xa_prepare_ex to public
go
Konfiguracja Connection Pool:
DataSource classname = com.microsoft.sqlserver.jdbc.SQLServerXADataSource
Resource type = javax.sql.XADataSource

Należy pamiętać o wyborze właściwej wersji sterownika JDBC:

plik sqljdbc.jar dla Javy 5
plik sqljdbc4.jar- dla Javy 6

W przypadku problemów z połączeniem z SQL Serverem sprawdź artykuł Six Possible Solutions For JDBC - SQL Server Connection Problems.

Aha! I uwaga na SQL Server 2008 (nie wiem czy wcześniejsze wersje też) - standardowo włączona jest jedynie opcja logowania użytkownika z Autoryzacją Windows, a więc nie da się
zalogować poprzez JDBC na użytkownika bazodanowego. Dopiero ręczne włączenie tej opcji pomaga ;)

Ruszamy :)

2008-11-06T10:28:00.000+02:00

Witam na moim "świeżo upieczonym" blogu :) Postaram się (w miarę wolnego czasu, którego jest niewiele a będzie coraz mniej ;)) opisywać na tych stronach problemy z którymi borykam się w codziennej pracy. Mam nadzieję, że stanie się on w przyszłości miejscem, w którym będzie można znaleźć ciekawe informacje, a także przedyskutować problemy o których piszę i rozwiązania które proponuję. Blog ten traktuję jako pewnego rodzaju wyzwanie, i - oczywiście - oczekuję na słowa konstruktywnej krytyki. No to startujemy! :)