NetBeans + Ecplise = ...

W sobotę (28.08.2008) miałem okazję uczestniczyć w Ecplise DemoCamps w Krakowie. Spotkanie zaliczam do udanych. W drodze powrotnej przypomniał mi się niedawny wpis na blogu Geertjan Wielengi opisujący jak uruchomić aplikację napisaną z wykorzystaniem NetBeans Platform z Eclipsa.
Jako, że ostatnio miałem trochę do czynienia z bardzo fajną biblioteką Visual Library, która wchodzi w skład platformy NetBeans, pomyślałem, że może by spróbować napisać prosty programik w Eclipsie wykorzystujący tą bibliotekę.
Ściągnąłem Visual Library, odpaliłem Eclipsa i zabrałem się do pracy. Okazało się, że tej pracy nie było dużo (wręcz prawie w ogóle).
Po pierwsze stworzyłem panel, na którym miał wylądować edytor graficzny.

package pl.marekklis.graph;

import java.awt.BorderLayout;
import java.awt.Dimension;

import javax.swing.JFrame;
import javax.swing.JPanel;
import javax.swing.JScrollPane;

import org.netbeans.api.visual.graph.GraphScene;

public class GraphTest extends JPanel{

 public static void main(String[] args) {
  JFrame frame = new JFrame("Graph test");
  frame.setMinimumSize(new Dimension(400,300));
  frame.setSize(400, 300);
  frame.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);
  frame.setContentPane(new GraphTest());
  frame.pack();
  frame.setVisible(true);
 }
 
 public GraphTest() {
  initComponents();
 }
 
 private void initComponents(){
  setLayout(new BorderLayout());
  JScrollPane scrollPane = new JScrollPane();
  add(scrollPane,BorderLayout.CENTER);
  GraphScene scene = new GraphSceneImpl();
  scrollPane.setViewportView(scene.createView());
  add(scene.createSatelliteView(),BorderLayout.WEST);
 }

}

Po drugie stworzyłem implementacje GraphScene.

package pl.marekklis.graph;

import java.awt.Point;

import org.netbeans.api.visual.action.ActionFactory;
import org.netbeans.api.visual.action.ConnectProvider;
import org.netbeans.api.visual.action.ConnectorState;
import org.netbeans.api.visual.anchor.AnchorFactory;
import org.netbeans.api.visual.anchor.AnchorShape;
import org.netbeans.api.visual.graph.GraphScene;
import org.netbeans.api.visual.widget.ConnectionWidget;
import org.netbeans.api.visual.widget.LayerWidget;
import org.netbeans.api.visual.widget.Scene;
import org.netbeans.api.visual.widget.Widget;
import org.netbeans.api.visual.widget.general.IconNodeWidget;
import org.openide.util.Utilities;

public class GraphSceneImpl extends GraphScene {
 
    private LayerWidget mainLayer;
    private LayerWidget connectionLayer;
    private LayerWidget interactionLayer;

    public GraphSceneImpl() {
        mainLayer = new LayerWidget(this);
        connectionLayer = new LayerWidget(this);
        interactionLayer = new LayerWidget(this);
        addChild(mainLayer);
        addChild(connectionLayer);
        addChild(interactionLayer);
        Widget w1 = addNode("1. węzeł");
        w1.setPreferredLocation(new Point(10, 100));
        Widget w2 = addNode("2. węzeł");
        w2.setPreferredLocation(new Point(100, 250));
        Widget w3 = addNode("Jakiś kolejny węzeł");
        w3.setPreferredLocation(new Point(250, 250));
        Widget w4 = addNode("Jakiś kolejny węzeł");
        w4.setPreferredLocation(new Point(250, 350));
        getActions().addAction(ActionFactory.createZoomAction());
    }

    @Override
    protected Widget attachNodeWidget(String arg0) {
        IconNodeWidget widget = new IconNodeWidget(this);
        if (arg0.startsWith("1")) {
            widget.setImage(Utilities.loadImage("pl/marekklis/graph/
                  resources/gr01.png"));
        } else if (arg0.startsWith("2")) {
            widget.setImage(Utilities.loadImage("pl/marekklis/graph/
                  resources/gr02.png"));
        } else {
            widget.setImage(Utilities.loadImage("pl/marekklis/graph/
                  resources/gr03.png"));
        } 
        widget.getActions().addAction(
               ActionFactory.createExtendedConnectAction(
               connectionLayer,new MyConnectProvider()));
        widget.getActions().addAction(
               ActionFactory.createAlignWithMoveAction(
               mainLayer, interactionLayer,            
               ActionFactory.createDefaultAlignWithMoveDecorator()));
        widget.setLabel(arg0);
        mainLayer.addChild(widget);
        return widget;
    }

    @Override
    protected Widget attachEdgeWidget(String arg0) {
        return null;
    }

    @Override
    protected void attachEdgeSourceAnchor(
        String arg0, String arg1, String arg2) {
    }

    @Override
    protected void attachEdgeTargetAnchor(
        String arg0, String arg1, String arg2) {
    }

    private class MyConnectProvider implements ConnectProvider {

        public boolean isSourceWidget(Widget source) {
            return source instanceof IconNodeWidget && source != null 
                  ? true : false;
        }

        public ConnectorState isTargetWidget(Widget src, Widget trg) {
            return src != trg && trg instanceof IconNodeWidget ? 
                ConnectorState.ACCEPT : ConnectorState.REJECT;
        }

        public boolean hasCustomTargetWidgetResolver(Scene arg0) {
            return false;
        }

        public Widget resolveTargetWidget(Scene arg0, Point arg1) {
            return null;
        }

        public void createConnection(Widget source, Widget target) {
            ConnectionWidget conn = new ConnectionWidget(
                  GraphSceneImpl.this);
            conn.setTargetAnchorShape(AnchorShape.TRIANGLE_FILLED);
            conn.setTargetAnchor(AnchorFactory.
                  createRectangularAnchor(target));
            conn.setSourceAnchor(AnchorFactory.
                  createRectangularAnchor(source));
            connectionLayer.addChild(conn);
        }
    }
}

I oto efekt:


W naszym okienku mamy działający przykład wykorzystujący Visual Library.

PS. Biblioteki Visual Library nie musimy ściągać gdyż jest ona częścią Netbeansa i znajduje się w katalog_Netbeansa/platform8/modules/.

Mechanizm aktualizacji w NetBeans Platform

Przyjrzyjmy się dzisiaj w jaki sposób możemy wykorzystać Auto Update Service do rozprowadzania aktualizacji modułów w aplikacji opartej o platformę NetBeans.
W tym celu załóżmy nowy projekt typu NetBeans Platform Application



oraz projekt modułu o nazwie np UpdateModule



Po założeniu modułu okno projektów wygląda u mnie następująco:



Dodajmy do naszego modułu jakiś element, który zmieniając będzie wymagał utworzenie nowej wersji. Niech będzie to okno na którym umieścimy komponent tekstowy, którego tekst będzie się zmieniał w zależności od wersji.





Następnym krokiem jest dodanie do naszego modułu pliku typu Update Center.





W tym przykładzie jako serwer przechowujący uaktualnienia wybrałem localhost. Dokładny adres serwera z aktualizacjami (a konkretnie do pliku updates.xml opisującego aktualne moduły) znajduje się w pliku Bundle.properties w pakiecie, do którego dodaliśmy Update Center.
Ponieważ szablon projektu NetBeans Platform Application nie posiada zaznaczonych bibliotek Auto Update musimy to zrobić ręcznie.



Teraz możemy już opublikować naszą "aplikację" (Build ZIP Distibution). Rozpakujmy gdzieś archiwum i uruchommy aplikację. W menu Help powinna być pozycja Check for updates. Po wybraniu dostaniemy komunikat, że nasza aplikacja jest aktualna.



Zmieńmy więc tekst w oknie aplikacji (np z "1.0.0" na "1.0.1") i "wypuśćmy" aktualizację. W tym celu zmieniamy we właściwościach modułu Specification version na wyższy numer.



Budujemy moduły poprzez Create NBMs. Moduły (w naszym przypadku będzie to tylko jeden moduł) zostaną utworzone w podkatalogu projektu (build/updates). Wystarczy zawartość tego katalogu przekopiować do katalogu, który jest głównym katalogiem naszego serwera www. Ja wykorzystałem serwer Apache.



Jeśli uruchomimy ponownie aplikację (nie ze środowiska IDE ale wersję z wcześniej utworzonego archiwum ZIP) naszym oczom powinien po chwili ukazać się komunikat o dostępności aktualizacji.



Po zakończeniu procesu aktualizacji mamy już świeżą wersję aplikacji.

Materiały z prelekcji

Jeśli ktoś jest zainteresowany, to materiały z mojej prelekcji nt NetBeans Platform są dostępne na stronie PJUGu. Na stronie tej znajdują się również materiały z poprzednich spotkań.

PJUG - prelekcja nt. NetBeans Platform

W najbliższy czwartek (15 maja 2008) o godzinie 19:00 będę miał zaszczyt poprowadzić prelekcję na temat platformy NetBeans w ramach czwartkowych spotkań PJUGu.
Podczas prelekcji powstanie od podstaw prosta aplikacja, która będzie mogła działać samodzielnie bądź jako rozszerzenie NetBeans IDE.
Jeśli czas i słuchacze pozwolą ;) to postaram się zaprezentować także bibliotekę Visual Library, która jest częścią platformy.
Istnieje możliwość wcześniejszej rejestracji na to spotkanie.

Serdecznie zapraszam.

NetBeans 6.1 oficjalnie już jest

Dzisiaj ukazała się nowa, świeża wersja środowiska NetBeans oznaczona numerkiem 6.1.

Jeśli chodzi o platformę to nowością (to chyba zbyt szumne słowo) jest nowy szablon projektu NetBeans Platform Application.



Szablon ten posiada już zaznaczone najpopularniejsze moduły wykorzystywane przy tworzeniu typowej aplikacji opartej o platformę.

Netbeans Platform - materiały z prelekcji

Jeśli ktoś ma ochotę to można się zapoznać z przykładowym projektem aplikacji zbudowanej na platformie NetBeans, który przedstawiałem w ramach NetBeans Day w Krakowie i Wrocławiu. Dostępna jest także prezentacja.
Przykładowy program został troszkę zmieniony - zdjęcia prelegentów zostały zamienione gdyż używałem ich bez zgody prowadzących.

NetBeans RoadShow to już historia

Dzisiaj zakończyła się polska edycja NetBeans World Tour 2007-2008. Czy impreza była udana? Wg mnie tak. Choćby dlatego, że zdobyłem szlify jako prelegent ;) A czy mój wykład na temat platformy NetBeans można zaliczyć do udanych to już nie mnie oceniać. Sądząc po ilości ziewających to jeszcze dużo przede mną do nauki - ale jak to powiedział Jacek Laskowski "ziewający słuchacze to wina poprzednich prelegentów, którzy ich wynudzili" ;)
Chciałbym jeszcze zauważyć, że niedawno ukazała sie kolejna odsłona NetBeans - 6.1 Release Candidate. Moja prelekcja we Wrocławiu zawierała już przykład stworzony właśnie na tym wydaniu. Z ciekawostek jakie zauważyłem to choćby nowy szablon projektu aplikacji opartej na platformie.