Kiwiki - Príspevky používateľa [sk]

Základy informatiky - jazyk Java

2010-04-27T19:31:47Z

Pokoraczki1:

[[Category:Java]]

<properties>
Názov=Základy informatiky - programovanie v jazyku Java
Forma=Podklady k prednáškam a cvičeniam
Abstrakt= Úvod do programovania, operačný systém, aplikácia, zdrojový kód, kompilovanie a spustenie programu. Syntax jazyka Java. Elementy programovacieho jazyka, identifikátory, klúčové slová, operátory. Dátové typy a ich rozdelenie. Výrazy a poradie vyhodnocovania výrazov. Deklarácie premenných a polí. Riadenie toku, bloky, podmienkové a logické výrazy. Triedy a objekty tried. Výnimky spracovanie výnimiek. Java API, aplikácie a applety.
Rozvrh=3/0/2
Hodnotenie=Skúška
Poznámky=Prvú verziu tohoto kurzu vyvoril [http://www.facebook.com/Peter.Pazak RNDr. Peter Pažák] ako podklady k cvičeniam z predmetu Základy programovania na FMFI UK . Pretože pôvodý text svojim rozsahom a kvalitou spracovania vysoko prevyšoval požiadavky na štandardné podklady ku cvičeniam, po konverzii do wiki je základným učebným textom k prednáške. Pokiaľ by ste chceli pôvodný text rozširovať, doplňovať o vlastné príklady a úlohy, stante sa redaktorom serveru kiwiki.
</properties>
{{Draft}}

== Obsah prednášky ==
* [[Uvod do programovania v jazyku Java]]
** Základné pojmy
** Zdrojový kód
** Kompilácia a spustenie programu
* [[Syntax jazyka Java]]
** Elementy programovacieho jazyka Java
** Kľúčové slová jazyka Java
** Primitívne dátové typy a operátory
** Bloky, vetvenie toku programu a cykly
* [[Triedy a objekty]]
** Deklarácia triedy
** Vytváranie objektov
** Hodnoty a referencie
** Polia
* [[Vytváranie vlastných tried]]
** Trieda Ratio
* [[Dedičnosť a vzťahy medzi triedami]]
*[[Základy práce s NetBeans IDE a vývoj modulov]]

== Doporučená literatúra a odkazy ==

'''WWW'''
* [http://java.sun.com/ Java] - Domáca stránka, dokumentácia, tútoriály ... všetko na jednej kope
* [http://www.particle.kth.se/~lindsey/JavaCourse/Book/courseMap.html JavaTech] - Interaktívny kurz Javy

'''Voľne dostupné učebnice a knihy'''
*[http://www.root.cz/knihy/thinking-in-java/ Thinking in Java]
* [http://www.freeprogrammingresources.com/javabook.html Zoznam voľne dostupnej literatúry]

'''Pomôcky, programy'''
* [http://netbeans.org/ NetBeans IDE] - Domáca stránka komplexného vývojového prostredia
* [http://www.scintilla.org/SciTE.html SciTe] - Jednoduchý multiplatformový programátorský editor
* [http://www.geany.org/ Geany] - Jednoduché multiplatformové vývojové prostredie

Základy práce s NetBeans IDE a vývoj modulov

2010-04-27T19:29:32Z

Pokoraczki1: /* Pridanie funkcinality pre IconNodeWidget */

== NetBeans IDE ==
NetBeans je krásne vývojové prostredie, ktorého hlavnou výhodou je jeho modulárna architektúra. Ďalším skvelým prvkom je, že sa spolieha na toolkit SWING UI, čo nám dokopy dáva obrovské výhody.

V tomto článku sa posnažím ukázať, ako možno vytvoriť jednoduchý modul pre NetBeans, ktorý bude iba strohá ukážka toho, čo sa s NetBeans dá robit.

== Požiadavky na postup článkom ==
1. NetBeans IDE ( použitá verzia 6.8 ) 
2. Java_jdk ( použitá verzia 1.6.0.18 ) 
3. Základné znalosti jazyka JAVA

== Vytvorenie a spustenie projektu ==
1. Začneme spustením Netbeans a zvolíme '''File--New Project--NetBeans Modules--Module''' 
<center>
{|class="wikitable"
| align="center" width=450 | [[Súbor:Ytb prvy.png | 400px]]
|}
</center>

2. Klikneme na tlačítko "NEXT", pomenujeme si náš projekt napr. "ShapeSample", nastavíme ho ako "'''main project'''" a vyberieme si umiestnenie, kde ho chceme uložiť a ponecháme '''Standalone Module'''
<center>
{|class="wikitable"
| align="center" width=450 | [[Súbor:Ytb druhy.png | 400px]]
|}
</center>

3. Klikneme "NEXT", zadáme do "Code Name Base" '''org.netbeans.shapesample''', a dôležité, klikneme na '''Generate XML Layer'''. Následne klikneme na tlačítko finish, a vytvorí sa nám projekt.
<center>
{|class="wikitable"
| align="center" width=450 | [[Súbor:Ytb treti.png | 400px]]
|}
</center>

4. V okne "Project" , '''klikneme pravým na "ShapeSample"--Properties--Libraries'''. Module Dependencies klikneme na tlačítko "ADD" a pridáme: 
''a/ Visual Library API 
b/ Utilities API ''
Klikneme na tlačítko OK, čo nám pridá odkazy. 

5. Znova v "Project" window '''klikneme pravým na "ShapeSample"--New--Other--Module Development--Window Component''' , klikneme "NEXT" 

6. Ako Windows Position dáme '''editor''' a zaškrtneme '''Open on application start''' a klikneme "NEXT" 

7.Do políčka "Class Name Prefix" dopíšeme '''Shape''', klikneme na tlačítko "FINISH" 

8. Vygeneruje sa nám viacero súbor, jedným z nich je '''ShapeTopComponent''', 2krát naň klikneme a otvoríme ho v design view. 

9. V design view, pravým klikneme na okno akoby a dáme '''Set Layout--Border Layout''' 
<center>
{|class="wikitable"
| align="center" width=450 | [[Súbor:Ytb stvrty.png | 400px]]
|}
</center>

== Vytvorenie scény ==
1. Využijeme okno "'''Palette'''" (ak nie je zobrazené dáme window---palette) a vložíme na náš layout '''ScrollPane'''. V okne "Inspector" klikneme pravým na jScrollPane1--Change Variable Name a nastavíme hodnotu na "shapePane".

2.V "Project" window na zložku''' org--netbeans--shapesample''' klikneme pravým a dáme '''new--Java Class''', pomenujme ju "'''GraphSceneImpl'''", a po vytvorení dopíšme do triedy '''extends GraphScene'''

3. Žltá žiarovka s červeným výkričníkom sa nám objaví naľavo v editore, klikneme na ňu, a dáme "'''add Import...'''" 
Následne sa nám objaví ďalšia žltá žiarovka, klikneme na ňu a dáme "'''Implement all abstract methods'''" 
<center>
{|class="wikitable"
| align="center" width=450 | [[Súbor:Ytb piaty.png | 400px]]
|}
</center>

4. Pre lepšiu orientáciu zmeníme názvy parametrov vygenerovaných NetBeans, a po úprave bude naša trieda vypadať takto: 

public class GraphSceneImpl extends GraphScene
{

public GraphSceneImpl() {
}

protected Widget attachNodeWidget(Object node) {
return null;
}

protected Widget attachEdgeWidget(Object edge) {
return null;
}

protected void attachEdgeSourceAnchor(Object edge, Object oldSourceNode, Object newSourceNode) {

}

protected void attachEdgeTargetAnchor(Object edge, Object oldTargetNode, Object newTargetNode) {

}
}

5.Vrátime sa k ShapeTopComponent, kde sa budeme starať o instanciu GraphSceneImpl , prepneme Design View na SourceView, a nájdeme jeho konštruktor. Do tela konštruktora doplníme nasledujúce riadky:
GraphSceneImpl scene = new GraphSceneImpl();
myView = scene.createView();
shapePane.setViewportView(myView);
add(scene.createSatelliteView(), BorderLayout.WEST);

Týmto sme vytvorili 2 náhľady, jeden veľký, a jeden akoby informačný na ľavej strane, ktorý pomôže používateľovi rýchlejšie sa pohybovať po väčšom rozpätí.

6. Na '''úrovni triedy ShapeTopComponent''' deklarujeme (doplníme napr. hneď nad konštruktor)
private JComponent myView;

Ostanú nám ešte 2 žlté žiarovky, klikneme na každú z nich, a dáme "'''Add Import...'''"

7. Teraz musíme ošetriť, že ak sa NetBeans IDE reštartuje, nemáme žiadny dôvod aby ShapeTopComponent pretrvával, čiže nájdeme metódu '''getPersistenceType()''' v tele triedy, a zmeníme ju nasledovne:
public int getPersistenceType() {
return TopComponent.PERSISTENCE_NEVER;
}

8. Klikneme v "Project" window na náš projekt '''ShapeSample pravým--run'''

9. Nezľaknite sa, spustí sa nová inštancia NetBeans IDE(ak nie je náš projekt už otvorený kliknite na '''window---Shape''') a zobrazí sa Vám niečo takéto: 
<center>
{|class="wikitable"
| align="center" width=450 | [[Súbor:Ytb siesty.png | 400px]]
|}
</center>

== Vytváranie Palety pre našu scénu ==

Teraz aby sme pokračovali niečím užitočným, vytvoríme si palettu, na čo využijeme Palette API, ktorá bude obsahovať komponenty, ktoré môžeme použiť a pridať na našu scénu pretiahnutím.
Pre ďalšie pokračovanie budeme potrebovať 3 obrázky našich komponentov, použime tieto(kliknite pravým---uložiť ako, nemente názvy):
[[Súbor:Image1.png]][[Súbor:Image2.png]][[Súbor:Image3.png]]

'''Keďže náš návod sa zaoberá s Visual Library API, a nie s Palette API(info tu:[http://netbeans.org/kb/trails/platform.html] ), na funkcionalitu Paletty použijeme už hotové knižnice, ktoré stiahnete tu''':
[http://www.sendspace.com/file/dqtnbi] (v prípade, že je link nefunkčný, na konci článku je hotový plugin pre tento modul, knižnice vytiahnite z neho)

1. Klikneme na náš projekt pravým--new--Java Package a pomenujeme ho '''org.netbeans.shapesample.palette'''
2. Teraz otvorme zložku, kde sme nás projekt uložili, konkrétne '''násProjekt/src/org/netbeans/shapesample/pallete'''. A do tejto''' zložky nakopírujeme stiahnuté obrázky a následne aj knižnice''', čiže tieto súbory: 
a/ Category 
b/ CategoryChildren 
c/ CategoryNode 
d/ PaletteSupport 
e/ Shape 
f/ ShapeChildren 
g/ ShapeNode 
h/ image1, image2, image3 
po zobrazení NetBeans sa nám novo vytvorený package obnoví, a budeme tam mať načítané všetky vložené súbory, pričom niekde sa znovu objavia červené krúžky so žiarovkou, to si nevšímajme chvíľku

3. Klikneme '''pravým na projekt--Properties--Libraries--Add''' a pridáme nasledujúce knižnice: 
a/ Actions APIs 
b/ Nodes API 
c/ Common Palette 
Teraz by sme mali spozorovať, že všetky žlté žiarov nám zmiznú, a bude nám to vypadať nasledovne: 
<center>
{|class="wikitable"
| align="center" width=450 | [[Súbor:Ytb siedmy.png | 400px]]
|}
</center>

4. Teraz pridáme našu Palettu do ShapeTopComponentovho náhľadu, a to tak, že do konštruktoru ShapeTopComponent kód
associateLookup( Lookups.fixed( new Object[] { PaletteSupport.createPalette() } ) );

5. Znova sa nám objaví žltá žiarovka, klikneme na ňu dáme "Add import...", následne sa tam objaví znova, čiže znova klikneme a dáme "Add import..."

6. Spustite modul znova(pravým--run), teraz by to už malo vypadať takto, no zatiaľ bez funkcionality, pretože potrebujeme Layer Widget: 
<center>
{|class="wikitable"
| align="center" width=450 | [[Súbor:Ytb osmy.png | 400px]]
|}
</center>

== Pridanie LayerWidget ==

Pod pojmom LayerWidget si predstavte niečo priesvitné, na ktoré budeme môcť ukladať naše komponenty s paletty.

1. Ná úrovni triedy GraphSceneImpl deklarujte náš LayerWidget
private LayerWidget mainLayer;

2. Do konštruktoru GraphSceneImpl pridajte LayerWidget ako dieťa našej scény:
mainLayer = new LayerWidget (this);
addChild (mainLayer);

Teraz keď pridáme na scénu nejaký komponent s našej paletty , pridajú sa ako deti do našej mainLayer.

== Pridanie IconNodeWidget (komponentu) cez funkcionalitu Drag and Drop (chyť a hoď) ==

Doposiaľ, naša scéna existuje, ale nemá žiadnu funkcionalitu. Túto funkcionalitu pridáme pomocou '''"actions"'''. Action, ktorá nám umožňuje Drag & Drop funkcionalitu je '''AcceptAction''' . Táto action môže byť aplikovaná buď na náš komponent alebo na našu scénu. My ju budeme aplikovať na našu scénu. Využijeme '''createAcceptAction''' na to, aby sme definovali čo sa má stať po tom, ako je komponent pretiahnutý nad našu scénu.

1. Najprv pridajte '''createAcceptAction''' spolu s jeho dvomi metódami do GraphSceneImpl konštruktoru:
getActions().addAction(ActionFactory.createAcceptAction(new AcceptProvider() {
public ConnectorState isAcceptable(Widget widget, Point point, Transferable transferable) {
Image dragImage = getImageFromTransferable(transferable);
JComponent view = getView();
Graphics2D g2 = (Graphics2D) view.getGraphics();
Rectangle visRect = view.getVisibleRect();
view.paintImmediately(visRect.x, visRect.y, visRect.width, visRect.height);
g2.drawImage(dragImage,
AffineTransform.getTranslateInstance(point.getLocation().getX(),
point.getLocation().getY()),
null);
return ConnectorState.ACCEPT;
}
public void accept(Widget widget, Point point, Transferable transferable) {
Image image = getImageFromTransferable(transferable);
Widget w = GraphSceneImpl.this.addNode(new MyNode(image));
w.setPreferredLocation(widget.convertLocalToScene(point));
}
}));

Objaví sa nám viacero chýb, a to z toho dôvodu, že sme použili aj metódy, ktoré zatiaľ nie sú definované, čiže si chvíľku nevšímajme tieto errory.

2. Teraz do triedy '''GraphSceneImpl''' pridáme pomocnú metódu na získavanie obrázkov:
private Image getImageFromTransferable(Transferable transferable) {
Object o = null;
try {
o = transferable.getTransferData(DataFlavor.imageFlavor);
} catch (IOException ex) {
ex.printStackTrace();
} catch (UnsupportedFlavorException ex) {
ex.printStackTrace();
}
return o instanceof Image ? (Image) o : ImageUtilities.loadImage("org/netbeans/shapesample/palette/shape1.png");
}
Ako vidíme, je tu ošetrená chyba, čiže môžete do org.netbeans.shapesample.palette doplniť obrázok, ktorý sa má objaviť pri chybe, dajte mu meno shape1.png

3. Z dôvodu toho, že máme len 3 obrázky, mohli by sme vytvoriť akoby len 3 prvky, preto si vytvoríme novú triedu s názvom '''MyNode'''. Klikneme na náš '''package shapesample pravým--new---java class''' a bude vypadať takto:
public class MyNode {
private Image image;

public MyNode(Image image) {
this.image = image;
}
public Image getImage() {
return image;
}
}

Klikneme na žltú žiarovku v tejto triede a dáme '''"Add import..."'''

4. Zmeníme teraz v triede '''GraphSceneImpl''' rodiča, od ktorého dedí, čiže jeden z prvý riadkov bude vypadať takto:
public class GraphSceneImpl extends GraphScene<MyNode, String>{...telo triedy...}
čím sme zabezpečili, že naša Node je prijatá cez Visual Library. Teraz sa nám objaví žltá žiarovka aj pri tomto riadku, lebo teraz musíme dediť iné abstraktné metódy, '''čiže klikneme na ňu --implement all abstract methods'''
5. Keďže používame generics, tak klikneme '''pravým na náš projekt--properties--sources''' a presvedčíme sa, že tam máme hodnotu '''Source level = 1.5'''

6. Následne definujeme náš nový Widget (komponent) v triede '''GraphSceneImpl''' a to tak, že tam nájdeme metódu '''protected Widget attachNodeWidget(MyNode node)''' a upravíme ju nasledovne:
protected Widget attachNodeWidget(MyNode node) {
IconNodeWidget widget = new IconNodeWidget(this);
widget.setImage(node.getImage());
widget.setLabel(Long.toString(node.hashCode()));
widget.getActions().addAction(ActionFactory.createMoveAction());
mainLayer.addChild(widget);
return widget;
}
Týmto nášmu Widgetu nastavíme obrázok, a priradíme mu veľké náhodné číslo, a ešte možnosť posúvať ho po našej scéne, a následne po zastavení ho pridať znova ako child.

7. Ešte stále nám ostáva pár žltých žiaroviek, takže klikneme na každú z nich, ktorá tam bude a dáme '''"Add import..."'''

8. Spustíme náš projekt, a už uvidíme, že je možné presúvať komponenty (Widgety) z našej paletty na našu scénku:

== Pridanie funkcionality pre našu scénu ==
1.Teraz pridáme najprv ZOOMaction na našu scénku a to tak, že na koniec '''GraphSceneImpl''' konštruktoru pridáme:
getActions().addAction(ActionFactory.createZoomAction());

Keď spustíme teraz náš projekt, tak pri pridržaní ctrl+ kolieško myši sa nám bude zoomovať naša plocha

2. Pridaním riadku za predošlým :
getActions().addAction(ActionFactory.createPanAction());
Pridáme funkcionalitu, že keď user potlačí kolečko myši, tak potom môže hýbať do hociktorého smeru.

== Pridanie funkcionality pre IconNodeWidget ==
Pre IconNodeWidget sme už pridali funcionalitu pre hýbanie '''MoveAction'''. Tak isto sme schopný pridať aj funkcionalitu pre '''HoverAction, SelectAction, a InplaceEditorAction''', v poradí (nadídenie, vybranie, premenovanie)
1. Najprv na úrovni triedy definujte
private WidgetAction editorAction = ActionFactory.createInplaceEditorAction(new LabelTextFieldEditor());
Následne sa objaví znova žltá žiarovka, najprv dajte '''"Add import..."''', následne dajte '''"Create class LabelTextFieldEditor..."''' , čo nám pridá do nášho package triedu.
2.Telo tejto triedy '''LabelTextFieldEditor''' zmeníme nasledovne:
class LabelTextFieldEditor implements TextFieldInplaceEditor {
public boolean isEnabled(Widget widget) {
return true;
}
public String getText(Widget widget) {
return ((LabelWidget) widget).getLabel();
}
public void setText(Widget widget, String text) {
((LabelWidget) widget).setLabel(text);
}
}
Znovu sa v tejto triede objaví zopár žltých žiaroviek, poklikajte na '''"add import..."'''

3. Následne priradíme editorAction nášmu IconNodeWidget, a to tak, že na koniec metódy '''protected Widget attachNodeWidget(MyNode node)''' triedy '''GraphSceneImpl''' vložíme tesne nad riadok ''' mainLayer.addChild(widget);''' nasledujúci kód:
widget.getLabelWidget().getActions().addAction(editorAction);

4. Následne Hower, Clicked action dolníme tak, že po vyššie doplnenom riadku dáme tieto dva:
widget.getActions().addAction(createSelectAction());
widget.getActions().addAction(createObjectHoverAction());

5. Teraz musíme trochu premyslieť poradie, v ktorom sme akcie pridali, info tu [http://bits.netbeans.org/dev/javadoc/org-netbeans-api-visual/org/netbeans/api/visual/widget/doc-files/documentation.html#OrderOfActions]
A následne bude naša metóda '''protected Widget attachNodeWidget''' vypadať nasledovne
protected Widget attachNodeWidget(MyNode node) {
IconNodeWidget widget = new IconNodeWidget(this);
widget.setImage(node.getImage());
widget.setLabel(Long.toString(node.hashCode()));
//double-click, event sa spustí len pri doubleclicku:
widget.getLabelWidget().getActions().addAction(editorAction);
//single-click, event sa spustí pri single clicku
widget.getActions().addAction(createSelectAction());
//mouse-dragged
widget.getActions().addAction(ActionFactory.createMoveAction());
//mouse-over,
widget.getActions().addAction(createObjectHoverAction());
mainLayer.addChild(widget);
return widget;
}

6. Po spustení to bude môcť vypadať takto napr. 
<center>
{|class="wikitable"
| align="center" width=450 | [[Súbor:Ytb desat.png | 400px]]
|}
</center>

== Záver a riešenie problémov ==

Ukázali sme v skutku len veľmi strohú ukážku, čo by sa s NetBeans dalo spraviť, ale keďže je to problematika, ktorou by sa mali zaoberať knihy pre pokročilejších programátorov, tak tu skončíme.

V prípade nejasností je vždy dobré sa obráti na stránku NetBeans tutorials [http://netbeans.org/kb/trails/platform.html]

V prípade problémov, resp. riešenia chýb uvedeného návodu, '''odporúčam použiť VYTVORENY FUNKCNY MODUL''' 
'''Download:''' [http://plugins.netbeans.org/PluginPortal/faces/PluginDetailPage.jsp?pluginid=14027] 
'''Inštalácia:''' Spustite '''NetBeans--Tools--Plugins--kliknite Downloaded--Add Plugins...--nájdite stiahnutý--install''' 
'''Spustenie pluginu:''' '''Spustite NetBeans--File--New Project--Samples--NetBeansModule--Visual Library Demo''' 
 
V prípade nejasností, je tam všetko štruktúrované ako v našom návode, čiže by ste tam mali nájsť svoju chybu dosť rýchlo a prehľadne. 
 

Zdroj:[http://platform.netbeans.org/tutorials/nbm-visual_library.html]

Základy práce s NetBeans IDE a vývoj modulov

2010-04-27T19:28:30Z

Pokoraczki1: /* Pridanie IconNodeWidget (komponentu) cez funkcionalitu Drag and Drop (chyť a hoď) */

== NetBeans IDE ==
NetBeans je krásne vývojové prostredie, ktorého hlavnou výhodou je jeho modulárna architektúra. Ďalším skvelým prvkom je, že sa spolieha na toolkit SWING UI, čo nám dokopy dáva obrovské výhody.

V tomto článku sa posnažím ukázať, ako možno vytvoriť jednoduchý modul pre NetBeans, ktorý bude iba strohá ukážka toho, čo sa s NetBeans dá robit.

== Požiadavky na postup článkom ==
1. NetBeans IDE ( použitá verzia 6.8 ) 
2. Java_jdk ( použitá verzia 1.6.0.18 ) 
3. Základné znalosti jazyka JAVA

== Vytvorenie a spustenie projektu ==
1. Začneme spustením Netbeans a zvolíme '''File--New Project--NetBeans Modules--Module''' 
<center>
{|class="wikitable"
| align="center" width=450 | [[Súbor:Ytb prvy.png | 400px]]
|}
</center>

2. Klikneme na tlačítko "NEXT", pomenujeme si náš projekt napr. "ShapeSample", nastavíme ho ako "'''main project'''" a vyberieme si umiestnenie, kde ho chceme uložiť a ponecháme '''Standalone Module'''
<center>
{|class="wikitable"
| align="center" width=450 | [[Súbor:Ytb druhy.png | 400px]]
|}
</center>

3. Klikneme "NEXT", zadáme do "Code Name Base" '''org.netbeans.shapesample''', a dôležité, klikneme na '''Generate XML Layer'''. Následne klikneme na tlačítko finish, a vytvorí sa nám projekt.
<center>
{|class="wikitable"
| align="center" width=450 | [[Súbor:Ytb treti.png | 400px]]
|}
</center>

4. V okne "Project" , '''klikneme pravým na "ShapeSample"--Properties--Libraries'''. Module Dependencies klikneme na tlačítko "ADD" a pridáme: 
''a/ Visual Library API 
b/ Utilities API ''
Klikneme na tlačítko OK, čo nám pridá odkazy. 

5. Znova v "Project" window '''klikneme pravým na "ShapeSample"--New--Other--Module Development--Window Component''' , klikneme "NEXT" 

6. Ako Windows Position dáme '''editor''' a zaškrtneme '''Open on application start''' a klikneme "NEXT" 

7.Do políčka "Class Name Prefix" dopíšeme '''Shape''', klikneme na tlačítko "FINISH" 

8. Vygeneruje sa nám viacero súbor, jedným z nich je '''ShapeTopComponent''', 2krát naň klikneme a otvoríme ho v design view. 

9. V design view, pravým klikneme na okno akoby a dáme '''Set Layout--Border Layout''' 
<center>
{|class="wikitable"
| align="center" width=450 | [[Súbor:Ytb stvrty.png | 400px]]
|}
</center>

== Vytvorenie scény ==
1. Využijeme okno "'''Palette'''" (ak nie je zobrazené dáme window---palette) a vložíme na náš layout '''ScrollPane'''. V okne "Inspector" klikneme pravým na jScrollPane1--Change Variable Name a nastavíme hodnotu na "shapePane".

2.V "Project" window na zložku''' org--netbeans--shapesample''' klikneme pravým a dáme '''new--Java Class''', pomenujme ju "'''GraphSceneImpl'''", a po vytvorení dopíšme do triedy '''extends GraphScene'''

3. Žltá žiarovka s červeným výkričníkom sa nám objaví naľavo v editore, klikneme na ňu, a dáme "'''add Import...'''" 
Následne sa nám objaví ďalšia žltá žiarovka, klikneme na ňu a dáme "'''Implement all abstract methods'''" 
<center>
{|class="wikitable"
| align="center" width=450 | [[Súbor:Ytb piaty.png | 400px]]
|}
</center>

4. Pre lepšiu orientáciu zmeníme názvy parametrov vygenerovaných NetBeans, a po úprave bude naša trieda vypadať takto: 

public class GraphSceneImpl extends GraphScene
{

public GraphSceneImpl() {
}

protected Widget attachNodeWidget(Object node) {
return null;
}

protected Widget attachEdgeWidget(Object edge) {
return null;
}

protected void attachEdgeSourceAnchor(Object edge, Object oldSourceNode, Object newSourceNode) {

}

protected void attachEdgeTargetAnchor(Object edge, Object oldTargetNode, Object newTargetNode) {

}
}

5.Vrátime sa k ShapeTopComponent, kde sa budeme starať o instanciu GraphSceneImpl , prepneme Design View na SourceView, a nájdeme jeho konštruktor. Do tela konštruktora doplníme nasledujúce riadky:
GraphSceneImpl scene = new GraphSceneImpl();
myView = scene.createView();
shapePane.setViewportView(myView);
add(scene.createSatelliteView(), BorderLayout.WEST);

Týmto sme vytvorili 2 náhľady, jeden veľký, a jeden akoby informačný na ľavej strane, ktorý pomôže používateľovi rýchlejšie sa pohybovať po väčšom rozpätí.

6. Na '''úrovni triedy ShapeTopComponent''' deklarujeme (doplníme napr. hneď nad konštruktor)
private JComponent myView;

Ostanú nám ešte 2 žlté žiarovky, klikneme na každú z nich, a dáme "'''Add Import...'''"

7. Teraz musíme ošetriť, že ak sa NetBeans IDE reštartuje, nemáme žiadny dôvod aby ShapeTopComponent pretrvával, čiže nájdeme metódu '''getPersistenceType()''' v tele triedy, a zmeníme ju nasledovne:
public int getPersistenceType() {
return TopComponent.PERSISTENCE_NEVER;
}

8. Klikneme v "Project" window na náš projekt '''ShapeSample pravým--run'''

9. Nezľaknite sa, spustí sa nová inštancia NetBeans IDE(ak nie je náš projekt už otvorený kliknite na '''window---Shape''') a zobrazí sa Vám niečo takéto: 
<center>
{|class="wikitable"
| align="center" width=450 | [[Súbor:Ytb siesty.png | 400px]]
|}
</center>

== Vytváranie Palety pre našu scénu ==

Teraz aby sme pokračovali niečím užitočným, vytvoríme si palettu, na čo využijeme Palette API, ktorá bude obsahovať komponenty, ktoré môžeme použiť a pridať na našu scénu pretiahnutím.
Pre ďalšie pokračovanie budeme potrebovať 3 obrázky našich komponentov, použime tieto(kliknite pravým---uložiť ako, nemente názvy):
[[Súbor:Image1.png]][[Súbor:Image2.png]][[Súbor:Image3.png]]

'''Keďže náš návod sa zaoberá s Visual Library API, a nie s Palette API(info tu:[http://netbeans.org/kb/trails/platform.html] ), na funkcionalitu Paletty použijeme už hotové knižnice, ktoré stiahnete tu''':
[http://www.sendspace.com/file/dqtnbi] (v prípade, že je link nefunkčný, na konci článku je hotový plugin pre tento modul, knižnice vytiahnite z neho)

1. Klikneme na náš projekt pravým--new--Java Package a pomenujeme ho '''org.netbeans.shapesample.palette'''
2. Teraz otvorme zložku, kde sme nás projekt uložili, konkrétne '''násProjekt/src/org/netbeans/shapesample/pallete'''. A do tejto''' zložky nakopírujeme stiahnuté obrázky a následne aj knižnice''', čiže tieto súbory: 
a/ Category 
b/ CategoryChildren 
c/ CategoryNode 
d/ PaletteSupport 
e/ Shape 
f/ ShapeChildren 
g/ ShapeNode 
h/ image1, image2, image3 
po zobrazení NetBeans sa nám novo vytvorený package obnoví, a budeme tam mať načítané všetky vložené súbory, pričom niekde sa znovu objavia červené krúžky so žiarovkou, to si nevšímajme chvíľku

3. Klikneme '''pravým na projekt--Properties--Libraries--Add''' a pridáme nasledujúce knižnice: 
a/ Actions APIs 
b/ Nodes API 
c/ Common Palette 
Teraz by sme mali spozorovať, že všetky žlté žiarov nám zmiznú, a bude nám to vypadať nasledovne: 
<center>
{|class="wikitable"
| align="center" width=450 | [[Súbor:Ytb siedmy.png | 400px]]
|}
</center>

4. Teraz pridáme našu Palettu do ShapeTopComponentovho náhľadu, a to tak, že do konštruktoru ShapeTopComponent kód
associateLookup( Lookups.fixed( new Object[] { PaletteSupport.createPalette() } ) );

5. Znova sa nám objaví žltá žiarovka, klikneme na ňu dáme "Add import...", následne sa tam objaví znova, čiže znova klikneme a dáme "Add import..."

6. Spustite modul znova(pravým--run), teraz by to už malo vypadať takto, no zatiaľ bez funkcionality, pretože potrebujeme Layer Widget: 
<center>
{|class="wikitable"
| align="center" width=450 | [[Súbor:Ytb osmy.png | 400px]]
|}
</center>

== Pridanie LayerWidget ==

Pod pojmom LayerWidget si predstavte niečo priesvitné, na ktoré budeme môcť ukladať naše komponenty s paletty.

1. Ná úrovni triedy GraphSceneImpl deklarujte náš LayerWidget
private LayerWidget mainLayer;

2. Do konštruktoru GraphSceneImpl pridajte LayerWidget ako dieťa našej scény:
mainLayer = new LayerWidget (this);
addChild (mainLayer);

Teraz keď pridáme na scénu nejaký komponent s našej paletty , pridajú sa ako deti do našej mainLayer.

== Pridanie IconNodeWidget (komponentu) cez funkcionalitu Drag and Drop (chyť a hoď) ==

Doposiaľ, naša scéna existuje, ale nemá žiadnu funkcionalitu. Túto funkcionalitu pridáme pomocou '''"actions"'''. Action, ktorá nám umožňuje Drag & Drop funkcionalitu je '''AcceptAction''' . Táto action môže byť aplikovaná buď na náš komponent alebo na našu scénu. My ju budeme aplikovať na našu scénu. Využijeme '''createAcceptAction''' na to, aby sme definovali čo sa má stať po tom, ako je komponent pretiahnutý nad našu scénu.

1. Najprv pridajte '''createAcceptAction''' spolu s jeho dvomi metódami do GraphSceneImpl konštruktoru:
getActions().addAction(ActionFactory.createAcceptAction(new AcceptProvider() {
public ConnectorState isAcceptable(Widget widget, Point point, Transferable transferable) {
Image dragImage = getImageFromTransferable(transferable);
JComponent view = getView();
Graphics2D g2 = (Graphics2D) view.getGraphics();
Rectangle visRect = view.getVisibleRect();
view.paintImmediately(visRect.x, visRect.y, visRect.width, visRect.height);
g2.drawImage(dragImage,
AffineTransform.getTranslateInstance(point.getLocation().getX(),
point.getLocation().getY()),
null);
return ConnectorState.ACCEPT;
}
public void accept(Widget widget, Point point, Transferable transferable) {
Image image = getImageFromTransferable(transferable);
Widget w = GraphSceneImpl.this.addNode(new MyNode(image));
w.setPreferredLocation(widget.convertLocalToScene(point));
}
}));

Objaví sa nám viacero chýb, a to z toho dôvodu, že sme použili aj metódy, ktoré zatiaľ nie sú definované, čiže si chvíľku nevšímajme tieto errory.

2. Teraz do triedy '''GraphSceneImpl''' pridáme pomocnú metódu na získavanie obrázkov:
private Image getImageFromTransferable(Transferable transferable) {
Object o = null;
try {
o = transferable.getTransferData(DataFlavor.imageFlavor);
} catch (IOException ex) {
ex.printStackTrace();
} catch (UnsupportedFlavorException ex) {
ex.printStackTrace();
}
return o instanceof Image ? (Image) o : ImageUtilities.loadImage("org/netbeans/shapesample/palette/shape1.png");
}
Ako vidíme, je tu ošetrená chyba, čiže môžete do org.netbeans.shapesample.palette doplniť obrázok, ktorý sa má objaviť pri chybe, dajte mu meno shape1.png

3. Z dôvodu toho, že máme len 3 obrázky, mohli by sme vytvoriť akoby len 3 prvky, preto si vytvoríme novú triedu s názvom '''MyNode'''. Klikneme na náš '''package shapesample pravým--new---java class''' a bude vypadať takto:
public class MyNode {
private Image image;

public MyNode(Image image) {
this.image = image;
}
public Image getImage() {
return image;
}
}

Klikneme na žltú žiarovku v tejto triede a dáme '''"Add import..."'''

4. Zmeníme teraz v triede '''GraphSceneImpl''' rodiča, od ktorého dedí, čiže jeden z prvý riadkov bude vypadať takto:
public class GraphSceneImpl extends GraphScene<MyNode, String>{...telo triedy...}
čím sme zabezpečili, že naša Node je prijatá cez Visual Library. Teraz sa nám objaví žltá žiarovka aj pri tomto riadku, lebo teraz musíme dediť iné abstraktné metódy, '''čiže klikneme na ňu --implement all abstract methods'''
5. Keďže používame generics, tak klikneme '''pravým na náš projekt--properties--sources''' a presvedčíme sa, že tam máme hodnotu '''Source level = 1.5'''

6. Následne definujeme náš nový Widget (komponent) v triede '''GraphSceneImpl''' a to tak, že tam nájdeme metódu '''protected Widget attachNodeWidget(MyNode node)''' a upravíme ju nasledovne:
protected Widget attachNodeWidget(MyNode node) {
IconNodeWidget widget = new IconNodeWidget(this);
widget.setImage(node.getImage());
widget.setLabel(Long.toString(node.hashCode()));
widget.getActions().addAction(ActionFactory.createMoveAction());
mainLayer.addChild(widget);
return widget;
}
Týmto nášmu Widgetu nastavíme obrázok, a priradíme mu veľké náhodné číslo, a ešte možnosť posúvať ho po našej scéne, a následne po zastavení ho pridať znova ako child.

7. Ešte stále nám ostáva pár žltých žiaroviek, takže klikneme na každú z nich, ktorá tam bude a dáme '''"Add import..."'''

8. Spustíme náš projekt, a už uvidíme, že je možné presúvať komponenty (Widgety) z našej paletty na našu scénku:

== Pridanie funkcionality pre našu scénu ==
1.Teraz pridáme najprv ZOOMaction na našu scénku a to tak, že na koniec '''GraphSceneImpl''' konštruktoru pridáme:
getActions().addAction(ActionFactory.createZoomAction());

Keď spustíme teraz náš projekt, tak pri pridržaní ctrl+ kolieško myši sa nám bude zoomovať naša plocha

2. Pridaním riadku za predošlým :
getActions().addAction(ActionFactory.createPanAction());
Pridáme funkcionalitu, že keď user potlačí kolečko myši, tak potom môže hýbať do hociktorého smeru.

== Pridanie funkcinality pre IconNodeWidget ==
Pre IconNodeWidget sme už pridali funcionalitu pre hýbanie '''MoveAction'''. Tak isto sme schopný pridať aj funkcionalitu pre '''HoverAction, SelectAction, a InplaceEditorAction''', v poradí (nadídenie, vybranie, premenovanie)
1. Najprv na úrovni triedy definujte
private WidgetAction editorAction = ActionFactory.createInplaceEditorAction(new LabelTextFieldEditor());
Následne sa objaví znova žltá žiarovka, najprv dajte '''"Add import..."''', následne dajte '''"Create class LabelTextFieldEditor..."''' , čo nám pridá do nášho package triedu.
2.Telo tejto triedy '''LabelTextFieldEditor''' zmeníme nasledovne:
class LabelTextFieldEditor implements TextFieldInplaceEditor {
public boolean isEnabled(Widget widget) {
return true;
}
public String getText(Widget widget) {
return ((LabelWidget) widget).getLabel();
}
public void setText(Widget widget, String text) {
((LabelWidget) widget).setLabel(text);
}
}
Znovu sa v tejto triede objaví zopár žltých žiaroviek, poklikajte na '''"add import..."'''

3. Následne priradíme editorAction nášmu IconNodeWidget, a to tak, že na koniec metódy '''protected Widget attachNodeWidget(MyNode node)''' triedy '''GraphSceneImpl''' vložíme tesne nad riadok ''' mainLayer.addChild(widget);''' nasledujúci kód:
widget.getLabelWidget().getActions().addAction(editorAction);

4. Následne Hower, Clicked action dolníme tak, že po vyššie doplnenom riadku dáme tieto dva:
widget.getActions().addAction(createSelectAction());
widget.getActions().addAction(createObjectHoverAction());

5. Teraz musíme trochu premyslieť poradie, v ktorom sme akcie pridali, info tu [http://bits.netbeans.org/dev/javadoc/org-netbeans-api-visual/org/netbeans/api/visual/widget/doc-files/documentation.html#OrderOfActions]
A následne bude naša metóda '''protected Widget attachNodeWidget''' vypadať nasledovne
protected Widget attachNodeWidget(MyNode node) {
IconNodeWidget widget = new IconNodeWidget(this);
widget.setImage(node.getImage());
widget.setLabel(Long.toString(node.hashCode()));
//double-click, event sa spustí len pri doubleclicku:
widget.getLabelWidget().getActions().addAction(editorAction);
//single-click, event sa spustí pri single clicku
widget.getActions().addAction(createSelectAction());
//mouse-dragged
widget.getActions().addAction(ActionFactory.createMoveAction());
//mouse-over,
widget.getActions().addAction(createObjectHoverAction());
mainLayer.addChild(widget);
return widget;
}

6. Po spustení to bude môcť vypadať takto napr. 
<center>
{|class="wikitable"
| align="center" width=450 | [[Súbor:Ytb desat.png | 400px]]
|}
</center>

== Záver a riešenie problémov ==

Ukázali sme v skutku len veľmi strohú ukážku, čo by sa s NetBeans dalo spraviť, ale keďže je to problematika, ktorou by sa mali zaoberať knihy pre pokročilejších programátorov, tak tu skončíme.

V prípade nejasností je vždy dobré sa obráti na stránku NetBeans tutorials [http://netbeans.org/kb/trails/platform.html]

V prípade problémov, resp. riešenia chýb uvedeného návodu, '''odporúčam použiť VYTVORENY FUNKCNY MODUL''' 
'''Download:''' [http://plugins.netbeans.org/PluginPortal/faces/PluginDetailPage.jsp?pluginid=14027] 
'''Inštalácia:''' Spustite '''NetBeans--Tools--Plugins--kliknite Downloaded--Add Plugins...--nájdite stiahnutý--install''' 
'''Spustenie pluginu:''' '''Spustite NetBeans--File--New Project--Samples--NetBeansModule--Visual Library Demo''' 
 
V prípade nejasností, je tam všetko štruktúrované ako v našom návode, čiže by ste tam mali nájsť svoju chybu dosť rýchlo a prehľadne. 
 

Zdroj:[http://platform.netbeans.org/tutorials/nbm-visual_library.html]

Základy práce s NetBeans IDE a vývoj modulov

2010-04-27T19:25:43Z

Pokoraczki1: /* Pridanie LayerWidget */

== NetBeans IDE ==
NetBeans je krásne vývojové prostredie, ktorého hlavnou výhodou je jeho modulárna architektúra. Ďalším skvelým prvkom je, že sa spolieha na toolkit SWING UI, čo nám dokopy dáva obrovské výhody.

V tomto článku sa posnažím ukázať, ako možno vytvoriť jednoduchý modul pre NetBeans, ktorý bude iba strohá ukážka toho, čo sa s NetBeans dá robit.

== Požiadavky na postup článkom ==
1. NetBeans IDE ( použitá verzia 6.8 ) 
2. Java_jdk ( použitá verzia 1.6.0.18 ) 
3. Základné znalosti jazyka JAVA

== Vytvorenie a spustenie projektu ==
1. Začneme spustením Netbeans a zvolíme '''File--New Project--NetBeans Modules--Module''' 
<center>
{|class="wikitable"
| align="center" width=450 | [[Súbor:Ytb prvy.png | 400px]]
|}
</center>

2. Klikneme na tlačítko "NEXT", pomenujeme si náš projekt napr. "ShapeSample", nastavíme ho ako "'''main project'''" a vyberieme si umiestnenie, kde ho chceme uložiť a ponecháme '''Standalone Module'''
<center>
{|class="wikitable"
| align="center" width=450 | [[Súbor:Ytb druhy.png | 400px]]
|}
</center>

3. Klikneme "NEXT", zadáme do "Code Name Base" '''org.netbeans.shapesample''', a dôležité, klikneme na '''Generate XML Layer'''. Následne klikneme na tlačítko finish, a vytvorí sa nám projekt.
<center>
{|class="wikitable"
| align="center" width=450 | [[Súbor:Ytb treti.png | 400px]]
|}
</center>

4. V okne "Project" , '''klikneme pravým na "ShapeSample"--Properties--Libraries'''. Module Dependencies klikneme na tlačítko "ADD" a pridáme: 
''a/ Visual Library API 
b/ Utilities API ''
Klikneme na tlačítko OK, čo nám pridá odkazy. 

5. Znova v "Project" window '''klikneme pravým na "ShapeSample"--New--Other--Module Development--Window Component''' , klikneme "NEXT" 

6. Ako Windows Position dáme '''editor''' a zaškrtneme '''Open on application start''' a klikneme "NEXT" 

7.Do políčka "Class Name Prefix" dopíšeme '''Shape''', klikneme na tlačítko "FINISH" 

8. Vygeneruje sa nám viacero súbor, jedným z nich je '''ShapeTopComponent''', 2krát naň klikneme a otvoríme ho v design view. 

9. V design view, pravým klikneme na okno akoby a dáme '''Set Layout--Border Layout''' 
<center>
{|class="wikitable"
| align="center" width=450 | [[Súbor:Ytb stvrty.png | 400px]]
|}
</center>

== Vytvorenie scény ==
1. Využijeme okno "'''Palette'''" (ak nie je zobrazené dáme window---palette) a vložíme na náš layout '''ScrollPane'''. V okne "Inspector" klikneme pravým na jScrollPane1--Change Variable Name a nastavíme hodnotu na "shapePane".

2.V "Project" window na zložku''' org--netbeans--shapesample''' klikneme pravým a dáme '''new--Java Class''', pomenujme ju "'''GraphSceneImpl'''", a po vytvorení dopíšme do triedy '''extends GraphScene'''

3. Žltá žiarovka s červeným výkričníkom sa nám objaví naľavo v editore, klikneme na ňu, a dáme "'''add Import...'''" 
Následne sa nám objaví ďalšia žltá žiarovka, klikneme na ňu a dáme "'''Implement all abstract methods'''" 
<center>
{|class="wikitable"
| align="center" width=450 | [[Súbor:Ytb piaty.png | 400px]]
|}
</center>

4. Pre lepšiu orientáciu zmeníme názvy parametrov vygenerovaných NetBeans, a po úprave bude naša trieda vypadať takto: 

public class GraphSceneImpl extends GraphScene
{

public GraphSceneImpl() {
}

protected Widget attachNodeWidget(Object node) {
return null;
}

protected Widget attachEdgeWidget(Object edge) {
return null;
}

protected void attachEdgeSourceAnchor(Object edge, Object oldSourceNode, Object newSourceNode) {

}

protected void attachEdgeTargetAnchor(Object edge, Object oldTargetNode, Object newTargetNode) {

}
}

5.Vrátime sa k ShapeTopComponent, kde sa budeme starať o instanciu GraphSceneImpl , prepneme Design View na SourceView, a nájdeme jeho konštruktor. Do tela konštruktora doplníme nasledujúce riadky:
GraphSceneImpl scene = new GraphSceneImpl();
myView = scene.createView();
shapePane.setViewportView(myView);
add(scene.createSatelliteView(), BorderLayout.WEST);

Týmto sme vytvorili 2 náhľady, jeden veľký, a jeden akoby informačný na ľavej strane, ktorý pomôže používateľovi rýchlejšie sa pohybovať po väčšom rozpätí.

6. Na '''úrovni triedy ShapeTopComponent''' deklarujeme (doplníme napr. hneď nad konštruktor)
private JComponent myView;

Ostanú nám ešte 2 žlté žiarovky, klikneme na každú z nich, a dáme "'''Add Import...'''"

7. Teraz musíme ošetriť, že ak sa NetBeans IDE reštartuje, nemáme žiadny dôvod aby ShapeTopComponent pretrvával, čiže nájdeme metódu '''getPersistenceType()''' v tele triedy, a zmeníme ju nasledovne:
public int getPersistenceType() {
return TopComponent.PERSISTENCE_NEVER;
}

8. Klikneme v "Project" window na náš projekt '''ShapeSample pravým--run'''

9. Nezľaknite sa, spustí sa nová inštancia NetBeans IDE(ak nie je náš projekt už otvorený kliknite na '''window---Shape''') a zobrazí sa Vám niečo takéto: 
<center>
{|class="wikitable"
| align="center" width=450 | [[Súbor:Ytb siesty.png | 400px]]
|}
</center>

== Vytváranie Palety pre našu scénu ==

Teraz aby sme pokračovali niečím užitočným, vytvoríme si palettu, na čo využijeme Palette API, ktorá bude obsahovať komponenty, ktoré môžeme použiť a pridať na našu scénu pretiahnutím.
Pre ďalšie pokračovanie budeme potrebovať 3 obrázky našich komponentov, použime tieto(kliknite pravým---uložiť ako, nemente názvy):
[[Súbor:Image1.png]][[Súbor:Image2.png]][[Súbor:Image3.png]]

'''Keďže náš návod sa zaoberá s Visual Library API, a nie s Palette API(info tu:[http://netbeans.org/kb/trails/platform.html] ), na funkcionalitu Paletty použijeme už hotové knižnice, ktoré stiahnete tu''':
[http://www.sendspace.com/file/dqtnbi] (v prípade, že je link nefunkčný, na konci článku je hotový plugin pre tento modul, knižnice vytiahnite z neho)

1. Klikneme na náš projekt pravým--new--Java Package a pomenujeme ho '''org.netbeans.shapesample.palette'''
2. Teraz otvorme zložku, kde sme nás projekt uložili, konkrétne '''násProjekt/src/org/netbeans/shapesample/pallete'''. A do tejto''' zložky nakopírujeme stiahnuté obrázky a následne aj knižnice''', čiže tieto súbory: 
a/ Category 
b/ CategoryChildren 
c/ CategoryNode 
d/ PaletteSupport 
e/ Shape 
f/ ShapeChildren 
g/ ShapeNode 
h/ image1, image2, image3 
po zobrazení NetBeans sa nám novo vytvorený package obnoví, a budeme tam mať načítané všetky vložené súbory, pričom niekde sa znovu objavia červené krúžky so žiarovkou, to si nevšímajme chvíľku

3. Klikneme '''pravým na projekt--Properties--Libraries--Add''' a pridáme nasledujúce knižnice: 
a/ Actions APIs 
b/ Nodes API 
c/ Common Palette 
Teraz by sme mali spozorovať, že všetky žlté žiarov nám zmiznú, a bude nám to vypadať nasledovne: 
<center>
{|class="wikitable"
| align="center" width=450 | [[Súbor:Ytb siedmy.png | 400px]]
|}
</center>

4. Teraz pridáme našu Palettu do ShapeTopComponentovho náhľadu, a to tak, že do konštruktoru ShapeTopComponent kód
associateLookup( Lookups.fixed( new Object[] { PaletteSupport.createPalette() } ) );

5. Znova sa nám objaví žltá žiarovka, klikneme na ňu dáme "Add import...", následne sa tam objaví znova, čiže znova klikneme a dáme "Add import..."

6. Spustite modul znova(pravým--run), teraz by to už malo vypadať takto, no zatiaľ bez funkcionality, pretože potrebujeme Layer Widget: 
<center>
{|class="wikitable"
| align="center" width=450 | [[Súbor:Ytb osmy.png | 400px]]
|}
</center>

== Pridanie LayerWidget ==

Pod pojmom LayerWidget si predstavte niečo priesvitné, na ktoré budeme môcť ukladať naše komponenty s paletty.

1. Ná úrovni triedy GraphSceneImpl deklarujte náš LayerWidget
private LayerWidget mainLayer;

2. Do konštruktoru GraphSceneImpl pridajte LayerWidget ako dieťa našej scény:
mainLayer = new LayerWidget (this);
addChild (mainLayer);

Teraz keď pridáme na scénu nejaký komponent s našej paletty , pridajú sa ako deti do našej mainLayer.

== Pridanie IconNodeWidget (komponentu) cez funkcionalitu Drag and Drop (chyť a hoď) ==

Doposiaľ, naša scéna existuje, ale nemá žiadnu funkcionalitu. Túto funkcionalitu pridáme pomocou '''"actions"'''. Action, ktorá nám umožnuje Drag & Drop funkcionalitu je '''AcceptAction''' . Táto action môže byť aplikovaná buď na náš komponent alebo na našu scénu. My ju budeme aplikovať na našu scénu. Využijeme '''createAcceptAction''' na to, aby sme definovali čo sa má stať po tom, ako je komponent pretiahnutý nad našu scénu.

1. Najprv pridajte '''createAcceptAction''' spolu s jeho dvomi metódami do GraphSceneImpl konštruktoru:
getActions().addAction(ActionFactory.createAcceptAction(new AcceptProvider() {
public ConnectorState isAcceptable(Widget widget, Point point, Transferable transferable) {
Image dragImage = getImageFromTransferable(transferable);
JComponent view = getView();
Graphics2D g2 = (Graphics2D) view.getGraphics();
Rectangle visRect = view.getVisibleRect();
view.paintImmediately(visRect.x, visRect.y, visRect.width, visRect.height);
g2.drawImage(dragImage,
AffineTransform.getTranslateInstance(point.getLocation().getX(),
point.getLocation().getY()),
null);
return ConnectorState.ACCEPT;
}
public void accept(Widget widget, Point point, Transferable transferable) {
Image image = getImageFromTransferable(transferable);
Widget w = GraphSceneImpl.this.addNode(new MyNode(image));
w.setPreferredLocation(widget.convertLocalToScene(point));
}
}));

Objaví sa nám viacero chýb, a to z toho dôvodu, že sme použili aj metody, ktoré zatiaľ nie sú definované, čiže si chvíľku nevšímajme tieto errory.

2. Teraz do triedy '''GraphSceneImpl''' pridáme pomocnú metódu na získavanie obrázkov:
private Image getImageFromTransferable(Transferable transferable) {
Object o = null;
try {
o = transferable.getTransferData(DataFlavor.imageFlavor);
} catch (IOException ex) {
ex.printStackTrace();
} catch (UnsupportedFlavorException ex) {
ex.printStackTrace();
}
return o instanceof Image ? (Image) o : ImageUtilities.loadImage("org/netbeans/shapesample/palette/shape1.png");
}
Ako vidíme, je tu ošetrená chyba, čiže môžete do org.netbeans.shapesample.palette doplniť obrázok, ktorý sa má objaviť pri chybe, dajte mu meno shape1.png

3. Z dôvodu toho, že máme len 3 obrázky, mohli by sme vytvoriť akoby len 3 prvky, preto si vytvoríme novú triedu s názvom '''MyNode'''. Klikneme na náš '''package shapesample pravým--new---java class''' a bude vypadať takto:
public class MyNode {
private Image image;

public MyNode(Image image) {
this.image = image;
}
public Image getImage() {
return image;
}
}

Klikneme na žltú žiarovku v tejto triede a dáme '''"Add import..."'''

4. Zmeníme teraz v triede '''GraphSceneImpl''' rodiča, od ktorého dedí, čiže jeden z prvý riadkov bude vypadať takto:
public class GraphSceneImpl extends GraphScene<MyNode, String>{...telo triedy...}
čím sme zabezpečili, že naša Node je prijatá cez Visual Library. Teraz sa nám objaví žltá žiarovka aj pri tomto riadku, lebo teraz musíme dediť iné abstraktné metódy, '''čiže klikneme na ňu --implement all abstract methods'''
5. Kedže používame generics, tak klikneme '''pravým na náš projekt--properties--sources''' a presvedčíme sa, že tam máme hodnotu '''Source level = 1.5'''

6. Následne definujeme náš nový Widget (komponent) v triede '''GraphSceneImpl''' a to tak, že tam nájdeme metódu '''protected Widget attachNodeWidget(MyNode node)''' a upravíme ju nasledovne:
protected Widget attachNodeWidget(MyNode node) {
IconNodeWidget widget = new IconNodeWidget(this);
widget.setImage(node.getImage());
widget.setLabel(Long.toString(node.hashCode()));
widget.getActions().addAction(ActionFactory.createMoveAction());
mainLayer.addChild(widget);
return widget;
}
Týmto nášmu Widgetu nastavíme obrázok, a priradíme mu veľké náhodné číslo, a ešte možnosť posúvať ho po našej scéne, a následne po zastavení ho pridať znova ako child.

7. Ešte stále nám ostáva pár žltých žiaroviek, takže klikneme na každú z nich, ktorá tam bude a dáme '''"Add import..."'''

8. Spustíme náš projekt, a už uvidíme, že je možné presúvať komponenty (Widgety) z našej paletty na našu scénku:

== Pridanie funkcionality pre našu scénu ==
1.Teraz pridáme najprv ZOOMaction na našu scénku a to tak, že na koniec '''GraphSceneImpl''' konštruktoru pridáme:
getActions().addAction(ActionFactory.createZoomAction());

Keď spustíme teraz náš projekt, tak pri pridržaní ctrl+ kolieško myši sa nám bude zoomovať naša plocha

2. Pridaním riadku za predošlým :
getActions().addAction(ActionFactory.createPanAction());
Pridáme funkcionalitu, že keď user potlačí kolečko myši, tak potom môže hýbať do hociktorého smeru.

== Pridanie funkcinality pre IconNodeWidget ==
Pre IconNodeWidget sme už pridali funcionalitu pre hýbanie '''MoveAction'''. Tak isto sme schopný pridať aj funkcionalitu pre '''HoverAction, SelectAction, a InplaceEditorAction''', v poradí (nadídenie, vybranie, premenovanie)
1. Najprv na úrovni triedy definujte
private WidgetAction editorAction = ActionFactory.createInplaceEditorAction(new LabelTextFieldEditor());
Následne sa objaví znova žltá žiarovka, najprv dajte '''"Add import..."''', následne dajte '''"Create class LabelTextFieldEditor..."''' , čo nám pridá do nášho package triedu.
2.Telo tejto triedy '''LabelTextFieldEditor''' zmeníme nasledovne:
class LabelTextFieldEditor implements TextFieldInplaceEditor {
public boolean isEnabled(Widget widget) {
return true;
}
public String getText(Widget widget) {
return ((LabelWidget) widget).getLabel();
}
public void setText(Widget widget, String text) {
((LabelWidget) widget).setLabel(text);
}
}
Znovu sa v tejto triede objaví zopár žltých žiaroviek, poklikajte na '''"add import..."'''

3. Následne priradíme editorAction nášmu IconNodeWidget, a to tak, že na koniec metódy '''protected Widget attachNodeWidget(MyNode node)''' triedy '''GraphSceneImpl''' vložíme tesne nad riadok ''' mainLayer.addChild(widget);''' nasledujúci kód:
widget.getLabelWidget().getActions().addAction(editorAction);

4. Následne Hower, Clicked action dolníme tak, že po vyššie doplnenom riadku dáme tieto dva:
widget.getActions().addAction(createSelectAction());
widget.getActions().addAction(createObjectHoverAction());

5. Teraz musíme trochu premyslieť poradie, v ktorom sme akcie pridali, info tu [http://bits.netbeans.org/dev/javadoc/org-netbeans-api-visual/org/netbeans/api/visual/widget/doc-files/documentation.html#OrderOfActions]
A následne bude naša metóda '''protected Widget attachNodeWidget''' vypadať nasledovne
protected Widget attachNodeWidget(MyNode node) {
IconNodeWidget widget = new IconNodeWidget(this);
widget.setImage(node.getImage());
widget.setLabel(Long.toString(node.hashCode()));
//double-click, event sa spustí len pri doubleclicku:
widget.getLabelWidget().getActions().addAction(editorAction);
//single-click, event sa spustí pri single clicku
widget.getActions().addAction(createSelectAction());
//mouse-dragged
widget.getActions().addAction(ActionFactory.createMoveAction());
//mouse-over,
widget.getActions().addAction(createObjectHoverAction());
mainLayer.addChild(widget);
return widget;
}

6. Po spustení to bude môcť vypadať takto napr. 
<center>
{|class="wikitable"
| align="center" width=450 | [[Súbor:Ytb desat.png | 400px]]
|}
</center>

== Záver a riešenie problémov ==

Ukázali sme v skutku len veľmi strohú ukážku, čo by sa s NetBeans dalo spraviť, ale keďže je to problematika, ktorou by sa mali zaoberať knihy pre pokročilejších programátorov, tak tu skončíme.

V prípade nejasností je vždy dobré sa obráti na stránku NetBeans tutorials [http://netbeans.org/kb/trails/platform.html]

V prípade problémov, resp. riešenia chýb uvedeného návodu, '''odporúčam použiť VYTVORENY FUNKCNY MODUL''' 
'''Download:''' [http://plugins.netbeans.org/PluginPortal/faces/PluginDetailPage.jsp?pluginid=14027] 
'''Inštalácia:''' Spustite '''NetBeans--Tools--Plugins--kliknite Downloaded--Add Plugins...--nájdite stiahnutý--install''' 
'''Spustenie pluginu:''' '''Spustite NetBeans--File--New Project--Samples--NetBeansModule--Visual Library Demo''' 
 
V prípade nejasností, je tam všetko štruktúrované ako v našom návode, čiže by ste tam mali nájsť svoju chybu dosť rýchlo a prehľadne. 
 

Zdroj:[http://platform.netbeans.org/tutorials/nbm-visual_library.html]

Základy práce s NetBeans IDE a vývoj modulov

2010-04-27T19:25:17Z

Pokoraczki1: /* Vytváranie Palety pre našu scénu */

== NetBeans IDE ==
NetBeans je krásne vývojové prostredie, ktorého hlavnou výhodou je jeho modulárna architektúra. Ďalším skvelým prvkom je, že sa spolieha na toolkit SWING UI, čo nám dokopy dáva obrovské výhody.

V tomto článku sa posnažím ukázať, ako možno vytvoriť jednoduchý modul pre NetBeans, ktorý bude iba strohá ukážka toho, čo sa s NetBeans dá robit.

== Požiadavky na postup článkom ==
1. NetBeans IDE ( použitá verzia 6.8 ) 
2. Java_jdk ( použitá verzia 1.6.0.18 ) 
3. Základné znalosti jazyka JAVA

== Vytvorenie a spustenie projektu ==
1. Začneme spustením Netbeans a zvolíme '''File--New Project--NetBeans Modules--Module''' 
<center>
{|class="wikitable"
| align="center" width=450 | [[Súbor:Ytb prvy.png | 400px]]
|}
</center>

2. Klikneme na tlačítko "NEXT", pomenujeme si náš projekt napr. "ShapeSample", nastavíme ho ako "'''main project'''" a vyberieme si umiestnenie, kde ho chceme uložiť a ponecháme '''Standalone Module'''
<center>
{|class="wikitable"
| align="center" width=450 | [[Súbor:Ytb druhy.png | 400px]]
|}
</center>

3. Klikneme "NEXT", zadáme do "Code Name Base" '''org.netbeans.shapesample''', a dôležité, klikneme na '''Generate XML Layer'''. Následne klikneme na tlačítko finish, a vytvorí sa nám projekt.
<center>
{|class="wikitable"
| align="center" width=450 | [[Súbor:Ytb treti.png | 400px]]
|}
</center>

4. V okne "Project" , '''klikneme pravým na "ShapeSample"--Properties--Libraries'''. Module Dependencies klikneme na tlačítko "ADD" a pridáme: 
''a/ Visual Library API 
b/ Utilities API ''
Klikneme na tlačítko OK, čo nám pridá odkazy. 

5. Znova v "Project" window '''klikneme pravým na "ShapeSample"--New--Other--Module Development--Window Component''' , klikneme "NEXT" 

6. Ako Windows Position dáme '''editor''' a zaškrtneme '''Open on application start''' a klikneme "NEXT" 

7.Do políčka "Class Name Prefix" dopíšeme '''Shape''', klikneme na tlačítko "FINISH" 

8. Vygeneruje sa nám viacero súbor, jedným z nich je '''ShapeTopComponent''', 2krát naň klikneme a otvoríme ho v design view. 

9. V design view, pravým klikneme na okno akoby a dáme '''Set Layout--Border Layout''' 
<center>
{|class="wikitable"
| align="center" width=450 | [[Súbor:Ytb stvrty.png | 400px]]
|}
</center>

== Vytvorenie scény ==
1. Využijeme okno "'''Palette'''" (ak nie je zobrazené dáme window---palette) a vložíme na náš layout '''ScrollPane'''. V okne "Inspector" klikneme pravým na jScrollPane1--Change Variable Name a nastavíme hodnotu na "shapePane".

2.V "Project" window na zložku''' org--netbeans--shapesample''' klikneme pravým a dáme '''new--Java Class''', pomenujme ju "'''GraphSceneImpl'''", a po vytvorení dopíšme do triedy '''extends GraphScene'''

3. Žltá žiarovka s červeným výkričníkom sa nám objaví naľavo v editore, klikneme na ňu, a dáme "'''add Import...'''" 
Následne sa nám objaví ďalšia žltá žiarovka, klikneme na ňu a dáme "'''Implement all abstract methods'''" 
<center>
{|class="wikitable"
| align="center" width=450 | [[Súbor:Ytb piaty.png | 400px]]
|}
</center>

4. Pre lepšiu orientáciu zmeníme názvy parametrov vygenerovaných NetBeans, a po úprave bude naša trieda vypadať takto: 

public class GraphSceneImpl extends GraphScene
{

public GraphSceneImpl() {
}

protected Widget attachNodeWidget(Object node) {
return null;
}

protected Widget attachEdgeWidget(Object edge) {
return null;
}

protected void attachEdgeSourceAnchor(Object edge, Object oldSourceNode, Object newSourceNode) {

}

protected void attachEdgeTargetAnchor(Object edge, Object oldTargetNode, Object newTargetNode) {

}
}

5.Vrátime sa k ShapeTopComponent, kde sa budeme starať o instanciu GraphSceneImpl , prepneme Design View na SourceView, a nájdeme jeho konštruktor. Do tela konštruktora doplníme nasledujúce riadky:
GraphSceneImpl scene = new GraphSceneImpl();
myView = scene.createView();
shapePane.setViewportView(myView);
add(scene.createSatelliteView(), BorderLayout.WEST);

Týmto sme vytvorili 2 náhľady, jeden veľký, a jeden akoby informačný na ľavej strane, ktorý pomôže používateľovi rýchlejšie sa pohybovať po väčšom rozpätí.

6. Na '''úrovni triedy ShapeTopComponent''' deklarujeme (doplníme napr. hneď nad konštruktor)
private JComponent myView;

Ostanú nám ešte 2 žlté žiarovky, klikneme na každú z nich, a dáme "'''Add Import...'''"

7. Teraz musíme ošetriť, že ak sa NetBeans IDE reštartuje, nemáme žiadny dôvod aby ShapeTopComponent pretrvával, čiže nájdeme metódu '''getPersistenceType()''' v tele triedy, a zmeníme ju nasledovne:
public int getPersistenceType() {
return TopComponent.PERSISTENCE_NEVER;
}

8. Klikneme v "Project" window na náš projekt '''ShapeSample pravým--run'''

9. Nezľaknite sa, spustí sa nová inštancia NetBeans IDE(ak nie je náš projekt už otvorený kliknite na '''window---Shape''') a zobrazí sa Vám niečo takéto: 
<center>
{|class="wikitable"
| align="center" width=450 | [[Súbor:Ytb siesty.png | 400px]]
|}
</center>

== Vytváranie Palety pre našu scénu ==

Teraz aby sme pokračovali niečím užitočným, vytvoríme si palettu, na čo využijeme Palette API, ktorá bude obsahovať komponenty, ktoré môžeme použiť a pridať na našu scénu pretiahnutím.
Pre ďalšie pokračovanie budeme potrebovať 3 obrázky našich komponentov, použime tieto(kliknite pravým---uložiť ako, nemente názvy):
[[Súbor:Image1.png]][[Súbor:Image2.png]][[Súbor:Image3.png]]

'''Keďže náš návod sa zaoberá s Visual Library API, a nie s Palette API(info tu:[http://netbeans.org/kb/trails/platform.html] ), na funkcionalitu Paletty použijeme už hotové knižnice, ktoré stiahnete tu''':
[http://www.sendspace.com/file/dqtnbi] (v prípade, že je link nefunkčný, na konci článku je hotový plugin pre tento modul, knižnice vytiahnite z neho)

1. Klikneme na náš projekt pravým--new--Java Package a pomenujeme ho '''org.netbeans.shapesample.palette'''
2. Teraz otvorme zložku, kde sme nás projekt uložili, konkrétne '''násProjekt/src/org/netbeans/shapesample/pallete'''. A do tejto''' zložky nakopírujeme stiahnuté obrázky a následne aj knižnice''', čiže tieto súbory: 
a/ Category 
b/ CategoryChildren 
c/ CategoryNode 
d/ PaletteSupport 
e/ Shape 
f/ ShapeChildren 
g/ ShapeNode 
h/ image1, image2, image3 
po zobrazení NetBeans sa nám novo vytvorený package obnoví, a budeme tam mať načítané všetky vložené súbory, pričom niekde sa znovu objavia červené krúžky so žiarovkou, to si nevšímajme chvíľku

3. Klikneme '''pravým na projekt--Properties--Libraries--Add''' a pridáme nasledujúce knižnice: 
a/ Actions APIs 
b/ Nodes API 
c/ Common Palette 
Teraz by sme mali spozorovať, že všetky žlté žiarov nám zmiznú, a bude nám to vypadať nasledovne: 
<center>
{|class="wikitable"
| align="center" width=450 | [[Súbor:Ytb siedmy.png | 400px]]
|}
</center>

4. Teraz pridáme našu Palettu do ShapeTopComponentovho náhľadu, a to tak, že do konštruktoru ShapeTopComponent kód
associateLookup( Lookups.fixed( new Object[] { PaletteSupport.createPalette() } ) );

5. Znova sa nám objaví žltá žiarovka, klikneme na ňu dáme "Add import...", následne sa tam objaví znova, čiže znova klikneme a dáme "Add import..."

6. Spustite modul znova(pravým--run), teraz by to už malo vypadať takto, no zatiaľ bez funkcionality, pretože potrebujeme Layer Widget: 
<center>
{|class="wikitable"
| align="center" width=450 | [[Súbor:Ytb osmy.png | 400px]]
|}
</center>

== Pridanie LayerWidget ==

Pod pojmom LayerWidget si predstavte niečo priesvitné, na ktoré budeme môcť ukladať naše komponenty s paletty.

1. Ná úrovni triedy GraphSceneImpl deklarujte náš LayerWidget
private LayerWidget mainLayer;

2. Do konštruktoru GraphSceneImpl pridajte LayerWidget ako dieťa našej scény:
mainLayer = new LayerWidget (this);
addChild (mainLayer);

Teraz keď pridáme na scénu nejaký komponent s našej paletty , pridajú sa ako deti do našel mainLayer.

== Pridanie IconNodeWidget (komponentu) cez funkcionalitu Drag and Drop (chyť a hoď) ==

Doposiaľ, naša scéna existuje, ale nemá žiadnu funkcionalitu. Túto funkcionalitu pridáme pomocou '''"actions"'''. Action, ktorá nám umožnuje Drag & Drop funkcionalitu je '''AcceptAction''' . Táto action môže byť aplikovaná buď na náš komponent alebo na našu scénu. My ju budeme aplikovať na našu scénu. Využijeme '''createAcceptAction''' na to, aby sme definovali čo sa má stať po tom, ako je komponent pretiahnutý nad našu scénu.

1. Najprv pridajte '''createAcceptAction''' spolu s jeho dvomi metódami do GraphSceneImpl konštruktoru:
getActions().addAction(ActionFactory.createAcceptAction(new AcceptProvider() {
public ConnectorState isAcceptable(Widget widget, Point point, Transferable transferable) {
Image dragImage = getImageFromTransferable(transferable);
JComponent view = getView();
Graphics2D g2 = (Graphics2D) view.getGraphics();
Rectangle visRect = view.getVisibleRect();
view.paintImmediately(visRect.x, visRect.y, visRect.width, visRect.height);
g2.drawImage(dragImage,
AffineTransform.getTranslateInstance(point.getLocation().getX(),
point.getLocation().getY()),
null);
return ConnectorState.ACCEPT;
}
public void accept(Widget widget, Point point, Transferable transferable) {
Image image = getImageFromTransferable(transferable);
Widget w = GraphSceneImpl.this.addNode(new MyNode(image));
w.setPreferredLocation(widget.convertLocalToScene(point));
}
}));

Objaví sa nám viacero chýb, a to z toho dôvodu, že sme použili aj metody, ktoré zatiaľ nie sú definované, čiže si chvíľku nevšímajme tieto errory.

2. Teraz do triedy '''GraphSceneImpl''' pridáme pomocnú metódu na získavanie obrázkov:
private Image getImageFromTransferable(Transferable transferable) {
Object o = null;
try {
o = transferable.getTransferData(DataFlavor.imageFlavor);
} catch (IOException ex) {
ex.printStackTrace();
} catch (UnsupportedFlavorException ex) {
ex.printStackTrace();
}
return o instanceof Image ? (Image) o : ImageUtilities.loadImage("org/netbeans/shapesample/palette/shape1.png");
}
Ako vidíme, je tu ošetrená chyba, čiže môžete do org.netbeans.shapesample.palette doplniť obrázok, ktorý sa má objaviť pri chybe, dajte mu meno shape1.png

3. Z dôvodu toho, že máme len 3 obrázky, mohli by sme vytvoriť akoby len 3 prvky, preto si vytvoríme novú triedu s názvom '''MyNode'''. Klikneme na náš '''package shapesample pravým--new---java class''' a bude vypadať takto:
public class MyNode {
private Image image;

public MyNode(Image image) {
this.image = image;
}
public Image getImage() {
return image;
}
}

Klikneme na žltú žiarovku v tejto triede a dáme '''"Add import..."'''

4. Zmeníme teraz v triede '''GraphSceneImpl''' rodiča, od ktorého dedí, čiže jeden z prvý riadkov bude vypadať takto:
public class GraphSceneImpl extends GraphScene<MyNode, String>{...telo triedy...}
čím sme zabezpečili, že naša Node je prijatá cez Visual Library. Teraz sa nám objaví žltá žiarovka aj pri tomto riadku, lebo teraz musíme dediť iné abstraktné metódy, '''čiže klikneme na ňu --implement all abstract methods'''
5. Kedže používame generics, tak klikneme '''pravým na náš projekt--properties--sources''' a presvedčíme sa, že tam máme hodnotu '''Source level = 1.5'''

6. Následne definujeme náš nový Widget (komponent) v triede '''GraphSceneImpl''' a to tak, že tam nájdeme metódu '''protected Widget attachNodeWidget(MyNode node)''' a upravíme ju nasledovne:
protected Widget attachNodeWidget(MyNode node) {
IconNodeWidget widget = new IconNodeWidget(this);
widget.setImage(node.getImage());
widget.setLabel(Long.toString(node.hashCode()));
widget.getActions().addAction(ActionFactory.createMoveAction());
mainLayer.addChild(widget);
return widget;
}
Týmto nášmu Widgetu nastavíme obrázok, a priradíme mu veľké náhodné číslo, a ešte možnosť posúvať ho po našej scéne, a následne po zastavení ho pridať znova ako child.

7. Ešte stále nám ostáva pár žltých žiaroviek, takže klikneme na každú z nich, ktorá tam bude a dáme '''"Add import..."'''

8. Spustíme náš projekt, a už uvidíme, že je možné presúvať komponenty (Widgety) z našej paletty na našu scénku:

== Pridanie funkcionality pre našu scénu ==
1.Teraz pridáme najprv ZOOMaction na našu scénku a to tak, že na koniec '''GraphSceneImpl''' konštruktoru pridáme:
getActions().addAction(ActionFactory.createZoomAction());

Keď spustíme teraz náš projekt, tak pri pridržaní ctrl+ kolieško myši sa nám bude zoomovať naša plocha

2. Pridaním riadku za predošlým :
getActions().addAction(ActionFactory.createPanAction());
Pridáme funkcionalitu, že keď user potlačí kolečko myši, tak potom môže hýbať do hociktorého smeru.

== Pridanie funkcinality pre IconNodeWidget ==
Pre IconNodeWidget sme už pridali funcionalitu pre hýbanie '''MoveAction'''. Tak isto sme schopný pridať aj funkcionalitu pre '''HoverAction, SelectAction, a InplaceEditorAction''', v poradí (nadídenie, vybranie, premenovanie)
1. Najprv na úrovni triedy definujte
private WidgetAction editorAction = ActionFactory.createInplaceEditorAction(new LabelTextFieldEditor());
Následne sa objaví znova žltá žiarovka, najprv dajte '''"Add import..."''', následne dajte '''"Create class LabelTextFieldEditor..."''' , čo nám pridá do nášho package triedu.
2.Telo tejto triedy '''LabelTextFieldEditor''' zmeníme nasledovne:
class LabelTextFieldEditor implements TextFieldInplaceEditor {
public boolean isEnabled(Widget widget) {
return true;
}
public String getText(Widget widget) {
return ((LabelWidget) widget).getLabel();
}
public void setText(Widget widget, String text) {
((LabelWidget) widget).setLabel(text);
}
}
Znovu sa v tejto triede objaví zopár žltých žiaroviek, poklikajte na '''"add import..."'''

3. Následne priradíme editorAction nášmu IconNodeWidget, a to tak, že na koniec metódy '''protected Widget attachNodeWidget(MyNode node)''' triedy '''GraphSceneImpl''' vložíme tesne nad riadok ''' mainLayer.addChild(widget);''' nasledujúci kód:
widget.getLabelWidget().getActions().addAction(editorAction);

4. Následne Hower, Clicked action dolníme tak, že po vyššie doplnenom riadku dáme tieto dva:
widget.getActions().addAction(createSelectAction());
widget.getActions().addAction(createObjectHoverAction());

5. Teraz musíme trochu premyslieť poradie, v ktorom sme akcie pridali, info tu [http://bits.netbeans.org/dev/javadoc/org-netbeans-api-visual/org/netbeans/api/visual/widget/doc-files/documentation.html#OrderOfActions]
A následne bude naša metóda '''protected Widget attachNodeWidget''' vypadať nasledovne
protected Widget attachNodeWidget(MyNode node) {
IconNodeWidget widget = new IconNodeWidget(this);
widget.setImage(node.getImage());
widget.setLabel(Long.toString(node.hashCode()));
//double-click, event sa spustí len pri doubleclicku:
widget.getLabelWidget().getActions().addAction(editorAction);
//single-click, event sa spustí pri single clicku
widget.getActions().addAction(createSelectAction());
//mouse-dragged
widget.getActions().addAction(ActionFactory.createMoveAction());
//mouse-over,
widget.getActions().addAction(createObjectHoverAction());
mainLayer.addChild(widget);
return widget;
}

6. Po spustení to bude môcť vypadať takto napr. 
<center>
{|class="wikitable"
| align="center" width=450 | [[Súbor:Ytb desat.png | 400px]]
|}
</center>

== Záver a riešenie problémov ==

Ukázali sme v skutku len veľmi strohú ukážku, čo by sa s NetBeans dalo spraviť, ale keďže je to problematika, ktorou by sa mali zaoberať knihy pre pokročilejších programátorov, tak tu skončíme.

V prípade nejasností je vždy dobré sa obráti na stránku NetBeans tutorials [http://netbeans.org/kb/trails/platform.html]

V prípade problémov, resp. riešenia chýb uvedeného návodu, '''odporúčam použiť VYTVORENY FUNKCNY MODUL''' 
'''Download:''' [http://plugins.netbeans.org/PluginPortal/faces/PluginDetailPage.jsp?pluginid=14027] 
'''Inštalácia:''' Spustite '''NetBeans--Tools--Plugins--kliknite Downloaded--Add Plugins...--nájdite stiahnutý--install''' 
'''Spustenie pluginu:''' '''Spustite NetBeans--File--New Project--Samples--NetBeansModule--Visual Library Demo''' 
 
V prípade nejasností, je tam všetko štruktúrované ako v našom návode, čiže by ste tam mali nájsť svoju chybu dosť rýchlo a prehľadne. 
 

Zdroj:[http://platform.netbeans.org/tutorials/nbm-visual_library.html]

Základy práce s NetBeans IDE a vývoj modulov

2010-04-27T19:22:15Z

Pokoraczki1: /* Vytvorenie scény */

== NetBeans IDE ==
NetBeans je krásne vývojové prostredie, ktorého hlavnou výhodou je jeho modulárna architektúra. Ďalším skvelým prvkom je, že sa spolieha na toolkit SWING UI, čo nám dokopy dáva obrovské výhody.

V tomto článku sa posnažím ukázať, ako možno vytvoriť jednoduchý modul pre NetBeans, ktorý bude iba strohá ukážka toho, čo sa s NetBeans dá robit.

== Požiadavky na postup článkom ==
1. NetBeans IDE ( použitá verzia 6.8 ) 
2. Java_jdk ( použitá verzia 1.6.0.18 ) 
3. Základné znalosti jazyka JAVA

== Vytvorenie a spustenie projektu ==
1. Začneme spustením Netbeans a zvolíme '''File--New Project--NetBeans Modules--Module''' 
<center>
{|class="wikitable"
| align="center" width=450 | [[Súbor:Ytb prvy.png | 400px]]
|}
</center>

2. Klikneme na tlačítko "NEXT", pomenujeme si náš projekt napr. "ShapeSample", nastavíme ho ako "'''main project'''" a vyberieme si umiestnenie, kde ho chceme uložiť a ponecháme '''Standalone Module'''
<center>
{|class="wikitable"
| align="center" width=450 | [[Súbor:Ytb druhy.png | 400px]]
|}
</center>

3. Klikneme "NEXT", zadáme do "Code Name Base" '''org.netbeans.shapesample''', a dôležité, klikneme na '''Generate XML Layer'''. Následne klikneme na tlačítko finish, a vytvorí sa nám projekt.
<center>
{|class="wikitable"
| align="center" width=450 | [[Súbor:Ytb treti.png | 400px]]
|}
</center>

4. V okne "Project" , '''klikneme pravým na "ShapeSample"--Properties--Libraries'''. Module Dependencies klikneme na tlačítko "ADD" a pridáme: 
''a/ Visual Library API 
b/ Utilities API ''
Klikneme na tlačítko OK, čo nám pridá odkazy. 

5. Znova v "Project" window '''klikneme pravým na "ShapeSample"--New--Other--Module Development--Window Component''' , klikneme "NEXT" 

6. Ako Windows Position dáme '''editor''' a zaškrtneme '''Open on application start''' a klikneme "NEXT" 

7.Do políčka "Class Name Prefix" dopíšeme '''Shape''', klikneme na tlačítko "FINISH" 

8. Vygeneruje sa nám viacero súbor, jedným z nich je '''ShapeTopComponent''', 2krát naň klikneme a otvoríme ho v design view. 

9. V design view, pravým klikneme na okno akoby a dáme '''Set Layout--Border Layout''' 
<center>
{|class="wikitable"
| align="center" width=450 | [[Súbor:Ytb stvrty.png | 400px]]
|}
</center>

== Vytvorenie scény ==
1. Využijeme okno "'''Palette'''" (ak nie je zobrazené dáme window---palette) a vložíme na náš layout '''ScrollPane'''. V okne "Inspector" klikneme pravým na jScrollPane1--Change Variable Name a nastavíme hodnotu na "shapePane".

2.V "Project" window na zložku''' org--netbeans--shapesample''' klikneme pravým a dáme '''new--Java Class''', pomenujme ju "'''GraphSceneImpl'''", a po vytvorení dopíšme do triedy '''extends GraphScene'''

3. Žltá žiarovka s červeným výkričníkom sa nám objaví naľavo v editore, klikneme na ňu, a dáme "'''add Import...'''" 
Následne sa nám objaví ďalšia žltá žiarovka, klikneme na ňu a dáme "'''Implement all abstract methods'''" 
<center>
{|class="wikitable"
| align="center" width=450 | [[Súbor:Ytb piaty.png | 400px]]
|}
</center>

4. Pre lepšiu orientáciu zmeníme názvy parametrov vygenerovaných NetBeans, a po úprave bude naša trieda vypadať takto: 

public class GraphSceneImpl extends GraphScene
{

public GraphSceneImpl() {
}

protected Widget attachNodeWidget(Object node) {
return null;
}

protected Widget attachEdgeWidget(Object edge) {
return null;
}

protected void attachEdgeSourceAnchor(Object edge, Object oldSourceNode, Object newSourceNode) {

}

protected void attachEdgeTargetAnchor(Object edge, Object oldTargetNode, Object newTargetNode) {

}
}

5.Vrátime sa k ShapeTopComponent, kde sa budeme starať o instanciu GraphSceneImpl , prepneme Design View na SourceView, a nájdeme jeho konštruktor. Do tela konštruktora doplníme nasledujúce riadky:
GraphSceneImpl scene = new GraphSceneImpl();
myView = scene.createView();
shapePane.setViewportView(myView);
add(scene.createSatelliteView(), BorderLayout.WEST);

Týmto sme vytvorili 2 náhľady, jeden veľký, a jeden akoby informačný na ľavej strane, ktorý pomôže používateľovi rýchlejšie sa pohybovať po väčšom rozpätí.

6. Na '''úrovni triedy ShapeTopComponent''' deklarujeme (doplníme napr. hneď nad konštruktor)
private JComponent myView;

Ostanú nám ešte 2 žlté žiarovky, klikneme na každú z nich, a dáme "'''Add Import...'''"

7. Teraz musíme ošetriť, že ak sa NetBeans IDE reštartuje, nemáme žiadny dôvod aby ShapeTopComponent pretrvával, čiže nájdeme metódu '''getPersistenceType()''' v tele triedy, a zmeníme ju nasledovne:
public int getPersistenceType() {
return TopComponent.PERSISTENCE_NEVER;
}

8. Klikneme v "Project" window na náš projekt '''ShapeSample pravým--run'''

9. Nezľaknite sa, spustí sa nová inštancia NetBeans IDE(ak nie je náš projekt už otvorený kliknite na '''window---Shape''') a zobrazí sa Vám niečo takéto: 
<center>
{|class="wikitable"
| align="center" width=450 | [[Súbor:Ytb siesty.png | 400px]]
|}
</center>

== Vytváranie Palety pre našu scénu ==

Teraz aby sme pokračovali niečím užitočným, vytvoríme si palletu, na čo využijeme Pallete API, ktorá bude obsahovať komponenty, ktoré môžeme použiť a pridať na našu scénu pretiahnutím.
Pre ďalšie pokračovanie budeme potrebovať 3 obrázky našich komponentov, použime tieto(kliknite pravým---uložiť ako, nemente názvy):
[[Súbor:Image1.png]][[Súbor:Image2.png]][[Súbor:Image3.png]]

'''Keďže náš tutoriál sa zaoberá s Visual Library API, a nie s Palette API(info tu:[http://netbeans.org/kb/trails/platform.html] ), na funkcionalitu Paletty použijeme už hotové knižnice, ktoré stiahnete tu''':
[http://www.sendspace.com/file/dqtnbi] (v prípade, že je link nefunkčný, na konci článku je hotový plugin pre tento modul, knižnice vytiahnite z neho)

1. Klikneme na náš projekt pravým--new--Java Package a pomenujeme ho '''org.netbeans.shapesample.palette'''
2. Teraz podme do zložky, kde sme nás projekt uložili, konkrétne '''násProjekt/src/org/netbeans/shapesample/pallete'''. A do tejto''' zložky nakopírujeme stiahnuté obrázky a následne aj knižnice''', čiže tieto súbory: 
a/ Category 
b/ CategoryChildren 
c/ CategoryNode 
d/ PaletteSupport 
e/ Shape 
f/ ShapeChildren 
g/ ShapeNode 
h/ image1, image2, image3 
po zobrazení NetBeans sa nám novo vytvorený package obnoví, a budeme tam mať načítané všetky vložené súbory, pričom niekde sa znovu objavia červené krúžky so žiarovkou, to si nevšímajme chvíľku

3. Klikneme '''pravým na projekt--Properties--Libraries--Add''' a pridáme nasledujúce knižnice: 
a/ Actions APIs 
b/ Nodes API 
c/ Common Palette 
Teraz by sme mali spozorovať, že všetky červené guličky nám zmiznú, a bude nám to vypadať nasledovne: 
<center>
{|class="wikitable"
| align="center" width=450 | [[Súbor:Ytb siedmy.png | 400px]]
|}
</center>

4. Teraz pridáme našu Palettu do ShapeTopComponentovho náhľadu, a to tak, že do konštruktoru ShapeTopComponent kod
associateLookup( Lookups.fixed( new Object[] { PaletteSupport.createPalette() } ) );

5. Znova sa nám objaví žltá žiarovka, klikneme na ňu dáme "Add import...", následne sa tam objaví znova, čiže znova klikneme a dáme "Add import..."

6. Spustite modul znova(pravým--run), teraz by to už malo vypadať takto, no zatiaľ bez funkcionality, pretože potrebujeme Layer Widget: 
<center>
{|class="wikitable"
| align="center" width=450 | [[Súbor:Ytb osmy.png | 400px]]
|}
</center>

== Pridanie LayerWidget ==

Pod pojmom LayerWidget si predstavte niečo priesvitné, na ktoré budeme môcť ukladať naše komponenty s paletty.

1. Ná úrovni triedy GraphSceneImpl deklarujte náš LayerWidget
private LayerWidget mainLayer;

2. Do konštruktoru GraphSceneImpl pridajte LayerWidget ako dieťa našej scény:
mainLayer = new LayerWidget (this);
addChild (mainLayer);

Teraz keď pridáme na scénu nejaký komponent s našej paletty , pridajú sa ako deti do našel mainLayer.

== Pridanie IconNodeWidget (komponentu) cez funkcionalitu Drag and Drop (chyť a hoď) ==

Doposiaľ, naša scéna existuje, ale nemá žiadnu funkcionalitu. Túto funkcionalitu pridáme pomocou '''"actions"'''. Action, ktorá nám umožnuje Drag & Drop funkcionalitu je '''AcceptAction''' . Táto action môže byť aplikovaná buď na náš komponent alebo na našu scénu. My ju budeme aplikovať na našu scénu. Využijeme '''createAcceptAction''' na to, aby sme definovali čo sa má stať po tom, ako je komponent pretiahnutý nad našu scénu.

1. Najprv pridajte '''createAcceptAction''' spolu s jeho dvomi metódami do GraphSceneImpl konštruktoru:
getActions().addAction(ActionFactory.createAcceptAction(new AcceptProvider() {
public ConnectorState isAcceptable(Widget widget, Point point, Transferable transferable) {
Image dragImage = getImageFromTransferable(transferable);
JComponent view = getView();
Graphics2D g2 = (Graphics2D) view.getGraphics();
Rectangle visRect = view.getVisibleRect();
view.paintImmediately(visRect.x, visRect.y, visRect.width, visRect.height);
g2.drawImage(dragImage,
AffineTransform.getTranslateInstance(point.getLocation().getX(),
point.getLocation().getY()),
null);
return ConnectorState.ACCEPT;
}
public void accept(Widget widget, Point point, Transferable transferable) {
Image image = getImageFromTransferable(transferable);
Widget w = GraphSceneImpl.this.addNode(new MyNode(image));
w.setPreferredLocation(widget.convertLocalToScene(point));
}
}));

Objaví sa nám viacero chýb, a to z toho dôvodu, že sme použili aj metody, ktoré zatiaľ nie sú definované, čiže si chvíľku nevšímajme tieto errory.

2. Teraz do triedy '''GraphSceneImpl''' pridáme pomocnú metódu na získavanie obrázkov:
private Image getImageFromTransferable(Transferable transferable) {
Object o = null;
try {
o = transferable.getTransferData(DataFlavor.imageFlavor);
} catch (IOException ex) {
ex.printStackTrace();
} catch (UnsupportedFlavorException ex) {
ex.printStackTrace();
}
return o instanceof Image ? (Image) o : ImageUtilities.loadImage("org/netbeans/shapesample/palette/shape1.png");
}
Ako vidíme, je tu ošetrená chyba, čiže môžete do org.netbeans.shapesample.palette doplniť obrázok, ktorý sa má objaviť pri chybe, dajte mu meno shape1.png

3. Z dôvodu toho, že máme len 3 obrázky, mohli by sme vytvoriť akoby len 3 prvky, preto si vytvoríme novú triedu s názvom '''MyNode'''. Klikneme na náš '''package shapesample pravým--new---java class''' a bude vypadať takto:
public class MyNode {
private Image image;

public MyNode(Image image) {
this.image = image;
}
public Image getImage() {
return image;
}
}

Klikneme na žltú žiarovku v tejto triede a dáme '''"Add import..."'''

4. Zmeníme teraz v triede '''GraphSceneImpl''' rodiča, od ktorého dedí, čiže jeden z prvý riadkov bude vypadať takto:
public class GraphSceneImpl extends GraphScene<MyNode, String>{...telo triedy...}
čím sme zabezpečili, že naša Node je prijatá cez Visual Library. Teraz sa nám objaví žltá žiarovka aj pri tomto riadku, lebo teraz musíme dediť iné abstraktné metódy, '''čiže klikneme na ňu --implement all abstract methods'''
5. Kedže používame generics, tak klikneme '''pravým na náš projekt--properties--sources''' a presvedčíme sa, že tam máme hodnotu '''Source level = 1.5'''

6. Následne definujeme náš nový Widget (komponent) v triede '''GraphSceneImpl''' a to tak, že tam nájdeme metódu '''protected Widget attachNodeWidget(MyNode node)''' a upravíme ju nasledovne:
protected Widget attachNodeWidget(MyNode node) {
IconNodeWidget widget = new IconNodeWidget(this);
widget.setImage(node.getImage());
widget.setLabel(Long.toString(node.hashCode()));
widget.getActions().addAction(ActionFactory.createMoveAction());
mainLayer.addChild(widget);
return widget;
}
Týmto nášmu Widgetu nastavíme obrázok, a priradíme mu veľké náhodné číslo, a ešte možnosť posúvať ho po našej scéne, a následne po zastavení ho pridať znova ako child.

7. Ešte stále nám ostáva pár žltých žiaroviek, takže klikneme na každú z nich, ktorá tam bude a dáme '''"Add import..."'''

8. Spustíme náš projekt, a už uvidíme, že je možné presúvať komponenty (Widgety) z našej paletty na našu scénku:

== Pridanie funkcionality pre našu scénu ==
1.Teraz pridáme najprv ZOOMaction na našu scénku a to tak, že na koniec '''GraphSceneImpl''' konštruktoru pridáme:
getActions().addAction(ActionFactory.createZoomAction());

Keď spustíme teraz náš projekt, tak pri pridržaní ctrl+ kolieško myši sa nám bude zoomovať naša plocha

2. Pridaním riadku za predošlým :
getActions().addAction(ActionFactory.createPanAction());
Pridáme funkcionalitu, že keď user potlačí kolečko myši, tak potom môže hýbať do hociktorého smeru.

== Pridanie funkcinality pre IconNodeWidget ==
Pre IconNodeWidget sme už pridali funcionalitu pre hýbanie '''MoveAction'''. Tak isto sme schopný pridať aj funkcionalitu pre '''HoverAction, SelectAction, a InplaceEditorAction''', v poradí (nadídenie, vybranie, premenovanie)
1. Najprv na úrovni triedy definujte
private WidgetAction editorAction = ActionFactory.createInplaceEditorAction(new LabelTextFieldEditor());
Následne sa objaví znova žltá žiarovka, najprv dajte '''"Add import..."''', následne dajte '''"Create class LabelTextFieldEditor..."''' , čo nám pridá do nášho package triedu.
2.Telo tejto triedy '''LabelTextFieldEditor''' zmeníme nasledovne:
class LabelTextFieldEditor implements TextFieldInplaceEditor {
public boolean isEnabled(Widget widget) {
return true;
}
public String getText(Widget widget) {
return ((LabelWidget) widget).getLabel();
}
public void setText(Widget widget, String text) {
((LabelWidget) widget).setLabel(text);
}
}
Znovu sa v tejto triede objaví zopár žltých žiaroviek, poklikajte na '''"add import..."'''

3. Následne priradíme editorAction nášmu IconNodeWidget, a to tak, že na koniec metódy '''protected Widget attachNodeWidget(MyNode node)''' triedy '''GraphSceneImpl''' vložíme tesne nad riadok ''' mainLayer.addChild(widget);''' nasledujúci kód:
widget.getLabelWidget().getActions().addAction(editorAction);

4. Následne Hower, Clicked action dolníme tak, že po vyššie doplnenom riadku dáme tieto dva:
widget.getActions().addAction(createSelectAction());
widget.getActions().addAction(createObjectHoverAction());

5. Teraz musíme trochu premyslieť poradie, v ktorom sme akcie pridali, info tu [http://bits.netbeans.org/dev/javadoc/org-netbeans-api-visual/org/netbeans/api/visual/widget/doc-files/documentation.html#OrderOfActions]
A následne bude naša metóda '''protected Widget attachNodeWidget''' vypadať nasledovne
protected Widget attachNodeWidget(MyNode node) {
IconNodeWidget widget = new IconNodeWidget(this);
widget.setImage(node.getImage());
widget.setLabel(Long.toString(node.hashCode()));
//double-click, event sa spustí len pri doubleclicku:
widget.getLabelWidget().getActions().addAction(editorAction);
//single-click, event sa spustí pri single clicku
widget.getActions().addAction(createSelectAction());
//mouse-dragged
widget.getActions().addAction(ActionFactory.createMoveAction());
//mouse-over,
widget.getActions().addAction(createObjectHoverAction());
mainLayer.addChild(widget);
return widget;
}

6. Po spustení to bude môcť vypadať takto napr. 
<center>
{|class="wikitable"
| align="center" width=450 | [[Súbor:Ytb desat.png | 400px]]
|}
</center>

== Záver a riešenie problémov ==

Ukázali sme v skutku len veľmi strohú ukážku, čo by sa s NetBeans dalo spraviť, ale keďže je to problematika, ktorou by sa mali zaoberať knihy pre pokročilejších programátorov, tak tu skončíme.

V prípade nejasností je vždy dobré sa obráti na stránku NetBeans tutorials [http://netbeans.org/kb/trails/platform.html]

V prípade problémov, resp. riešenia chýb uvedeného návodu, '''odporúčam použiť VYTVORENY FUNKCNY MODUL''' 
'''Download:''' [http://plugins.netbeans.org/PluginPortal/faces/PluginDetailPage.jsp?pluginid=14027] 
'''Inštalácia:''' Spustite '''NetBeans--Tools--Plugins--kliknite Downloaded--Add Plugins...--nájdite stiahnutý--install''' 
'''Spustenie pluginu:''' '''Spustite NetBeans--File--New Project--Samples--NetBeansModule--Visual Library Demo''' 
 
V prípade nejasností, je tam všetko štruktúrované ako v našom návode, čiže by ste tam mali nájsť svoju chybu dosť rýchlo a prehľadne. 
 

Zdroj:[http://platform.netbeans.org/tutorials/nbm-visual_library.html]

Základy práce s NetBeans IDE a vývoj modulov

2010-04-27T19:19:43Z

Pokoraczki1: /* Vytvorenie scény */

== NetBeans IDE ==
NetBeans je krásne vývojové prostredie, ktorého hlavnou výhodou je jeho modulárna architektúra. Ďalším skvelým prvkom je, že sa spolieha na toolkit SWING UI, čo nám dokopy dáva obrovské výhody.

V tomto článku sa posnažím ukázať, ako možno vytvoriť jednoduchý modul pre NetBeans, ktorý bude iba strohá ukážka toho, čo sa s NetBeans dá robit.

== Požiadavky na postup článkom ==
1. NetBeans IDE ( použitá verzia 6.8 ) 
2. Java_jdk ( použitá verzia 1.6.0.18 ) 
3. Základné znalosti jazyka JAVA

== Vytvorenie a spustenie projektu ==
1. Začneme spustením Netbeans a zvolíme '''File--New Project--NetBeans Modules--Module''' 
<center>
{|class="wikitable"
| align="center" width=450 | [[Súbor:Ytb prvy.png | 400px]]
|}
</center>

2. Klikneme na tlačítko "NEXT", pomenujeme si náš projekt napr. "ShapeSample", nastavíme ho ako "'''main project'''" a vyberieme si umiestnenie, kde ho chceme uložiť a ponecháme '''Standalone Module'''
<center>
{|class="wikitable"
| align="center" width=450 | [[Súbor:Ytb druhy.png | 400px]]
|}
</center>

3. Klikneme "NEXT", zadáme do "Code Name Base" '''org.netbeans.shapesample''', a dôležité, klikneme na '''Generate XML Layer'''. Následne klikneme na tlačítko finish, a vytvorí sa nám projekt.
<center>
{|class="wikitable"
| align="center" width=450 | [[Súbor:Ytb treti.png | 400px]]
|}
</center>

4. V okne "Project" , '''klikneme pravým na "ShapeSample"--Properties--Libraries'''. Module Dependencies klikneme na tlačítko "ADD" a pridáme: 
''a/ Visual Library API 
b/ Utilities API ''
Klikneme na tlačítko OK, čo nám pridá odkazy. 

5. Znova v "Project" window '''klikneme pravým na "ShapeSample"--New--Other--Module Development--Window Component''' , klikneme "NEXT" 

6. Ako Windows Position dáme '''editor''' a zaškrtneme '''Open on application start''' a klikneme "NEXT" 

7.Do políčka "Class Name Prefix" dopíšeme '''Shape''', klikneme na tlačítko "FINISH" 

8. Vygeneruje sa nám viacero súbor, jedným z nich je '''ShapeTopComponent''', 2krát naň klikneme a otvoríme ho v design view. 

9. V design view, pravým klikneme na okno akoby a dáme '''Set Layout--Border Layout''' 
<center>
{|class="wikitable"
| align="center" width=450 | [[Súbor:Ytb stvrty.png | 400px]]
|}
</center>

== Vytvorenie scény ==
1. Využijeme okno "'''Palette'''" (ak nie je zobrazené dáme window---pallete) a vložíme na naš layout '''ScrollPane'''. V okne "Inspector" klikneme pravým na jScrollPane1--Change Variable Name a nastavíme hodnotu na "shapePane".

2.V "Project" windows na zložku''' org--netbeans--shapesample''' klikneme pravým a dáme '''new--Java Class''', pomenujme ju "'''GraphSceneImpl'''", a po vytvorení dopíšme do triedy '''extends GraphScene'''

3. Žltá žiarovka s červeným výkričníkom sa nám objaví naľavo v editore, klikneme na ňu, a dáme "'''add Import...'''" 
Následne sa dám objaví ďalšia žltá žiarovka, klikneme na ňu a dáme "'''Implement all abstract methods'''" 
<center>
{|class="wikitable"
| align="center" width=450 | [[Súbor:Ytb piaty.png | 400px]]
|}
</center>

4. Pre lepšiu orientáciu zmeníme názvy parametrov vygenerovaných NetBeans, a po úprave bude naša trieda vypadať takto: 

public class GraphSceneImpl extends GraphScene
{

public GraphSceneImpl() {
}

protected Widget attachNodeWidget(Object node) {
return null;
}

protected Widget attachEdgeWidget(Object edge) {
return null;
}

protected void attachEdgeSourceAnchor(Object edge, Object oldSourceNode, Object newSourceNode) {

}

protected void attachEdgeTargetAnchor(Object edge, Object oldTargetNode, Object newTargetNode) {

}
}

5.Vrátime sa k ShapeTopComponent, kde sa budeme starať o instanciu GraphSceneImpl , prepneme Design View na SourceView, a nájdeme jeho konštruktor. Do tela konštruktora doplnime nasledujúce riadky:
GraphSceneImpl scene = new GraphSceneImpl();
myView = scene.createView();
shapePane.setViewportView(myView);
add(scene.createSatelliteView(), BorderLayout.WEST);

Týmto sme vytvorili 2 náhľady, jeden veľký, a jeden akoby informačný na ľavej strane, ktorý pomôže používateľovi rýchlejšie sa pohybovať po väčšom rozpätí.

6. Na '''úrovni triedy ShapeTopComponent''' deklarujeme (doplníme napr. hneď nad konštruktor)
private JComponent myView;

Ostanú nám ešte 2 žlté žiarovky, klikneme na každú z nich, a dáme "'''Add Import...'''"

7. Teraz musíme ošetriť, že ak sa NetBeans IDE reštartuje, nemáme žiadny dôvod aby ShapeTopComponent pretrvával, čiže nájdeme metódu '''getPersistenceType()''' v tele triedy, a zmeníme ju nasledovne:
public int getPersistenceType() {
return TopComponent.PERSISTENCE_NEVER;
}

8. Klikneme v "Project" window na náš projekt '''ShapeSample pravým--run'''

9. Nezlaknite sa, spustí sa nová inštancia NetBeans IDE(ak nie je náš projekt už otvorený kliknite na '''window---Shape''') a zobrazí sa Vám niečo takéto: 
<center>
{|class="wikitable"
| align="center" width=450 | [[Súbor:Ytb siesty.png | 400px]]
|}
</center>

== Vytváranie Palety pre našu scénu ==

Teraz aby sme pokračovali niečím užitočným, vytvoríme si palletu, na čo využijeme Pallete API, ktorá bude obsahovať komponenty, ktoré môžeme použiť a pridať na našu scénu pretiahnutím.
Pre ďalšie pokračovanie budeme potrebovať 3 obrázky našich komponentov, použime tieto(kliknite pravým---uložiť ako, nemente názvy):
[[Súbor:Image1.png]][[Súbor:Image2.png]][[Súbor:Image3.png]]

'''Keďže náš tutoriál sa zaoberá s Visual Library API, a nie s Palette API(info tu:[http://netbeans.org/kb/trails/platform.html] ), na funkcionalitu Paletty použijeme už hotové knižnice, ktoré stiahnete tu''':
[http://www.sendspace.com/file/dqtnbi] (v prípade, že je link nefunkčný, na konci článku je hotový plugin pre tento modul, knižnice vytiahnite z neho)

1. Klikneme na náš projekt pravým--new--Java Package a pomenujeme ho '''org.netbeans.shapesample.palette'''
2. Teraz podme do zložky, kde sme nás projekt uložili, konkrétne '''násProjekt/src/org/netbeans/shapesample/pallete'''. A do tejto''' zložky nakopírujeme stiahnuté obrázky a následne aj knižnice''', čiže tieto súbory: 
a/ Category 
b/ CategoryChildren 
c/ CategoryNode 
d/ PaletteSupport 
e/ Shape 
f/ ShapeChildren 
g/ ShapeNode 
h/ image1, image2, image3 
po zobrazení NetBeans sa nám novo vytvorený package obnoví, a budeme tam mať načítané všetky vložené súbory, pričom niekde sa znovu objavia červené krúžky so žiarovkou, to si nevšímajme chvíľku

3. Klikneme '''pravým na projekt--Properties--Libraries--Add''' a pridáme nasledujúce knižnice: 
a/ Actions APIs 
b/ Nodes API 
c/ Common Palette 
Teraz by sme mali spozorovať, že všetky červené guličky nám zmiznú, a bude nám to vypadať nasledovne: 
<center>
{|class="wikitable"
| align="center" width=450 | [[Súbor:Ytb siedmy.png | 400px]]
|}
</center>

4. Teraz pridáme našu Palettu do ShapeTopComponentovho náhľadu, a to tak, že do konštruktoru ShapeTopComponent kod
associateLookup( Lookups.fixed( new Object[] { PaletteSupport.createPalette() } ) );

5. Znova sa nám objaví žltá žiarovka, klikneme na ňu dáme "Add import...", následne sa tam objaví znova, čiže znova klikneme a dáme "Add import..."

6. Spustite modul znova(pravým--run), teraz by to už malo vypadať takto, no zatiaľ bez funkcionality, pretože potrebujeme Layer Widget: 
<center>
{|class="wikitable"
| align="center" width=450 | [[Súbor:Ytb osmy.png | 400px]]
|}
</center>

== Pridanie LayerWidget ==

Pod pojmom LayerWidget si predstavte niečo priesvitné, na ktoré budeme môcť ukladať naše komponenty s paletty.

1. Ná úrovni triedy GraphSceneImpl deklarujte náš LayerWidget
private LayerWidget mainLayer;

2. Do konštruktoru GraphSceneImpl pridajte LayerWidget ako dieťa našej scény:
mainLayer = new LayerWidget (this);
addChild (mainLayer);

Teraz keď pridáme na scénu nejaký komponent s našej paletty , pridajú sa ako deti do našel mainLayer.

== Pridanie IconNodeWidget (komponentu) cez funkcionalitu Drag and Drop (chyť a hoď) ==

Doposiaľ, naša scéna existuje, ale nemá žiadnu funkcionalitu. Túto funkcionalitu pridáme pomocou '''"actions"'''. Action, ktorá nám umožnuje Drag & Drop funkcionalitu je '''AcceptAction''' . Táto action môže byť aplikovaná buď na náš komponent alebo na našu scénu. My ju budeme aplikovať na našu scénu. Využijeme '''createAcceptAction''' na to, aby sme definovali čo sa má stať po tom, ako je komponent pretiahnutý nad našu scénu.

1. Najprv pridajte '''createAcceptAction''' spolu s jeho dvomi metódami do GraphSceneImpl konštruktoru:
getActions().addAction(ActionFactory.createAcceptAction(new AcceptProvider() {
public ConnectorState isAcceptable(Widget widget, Point point, Transferable transferable) {
Image dragImage = getImageFromTransferable(transferable);
JComponent view = getView();
Graphics2D g2 = (Graphics2D) view.getGraphics();
Rectangle visRect = view.getVisibleRect();
view.paintImmediately(visRect.x, visRect.y, visRect.width, visRect.height);
g2.drawImage(dragImage,
AffineTransform.getTranslateInstance(point.getLocation().getX(),
point.getLocation().getY()),
null);
return ConnectorState.ACCEPT;
}
public void accept(Widget widget, Point point, Transferable transferable) {
Image image = getImageFromTransferable(transferable);
Widget w = GraphSceneImpl.this.addNode(new MyNode(image));
w.setPreferredLocation(widget.convertLocalToScene(point));
}
}));

Objaví sa nám viacero chýb, a to z toho dôvodu, že sme použili aj metody, ktoré zatiaľ nie sú definované, čiže si chvíľku nevšímajme tieto errory.

2. Teraz do triedy '''GraphSceneImpl''' pridáme pomocnú metódu na získavanie obrázkov:
private Image getImageFromTransferable(Transferable transferable) {
Object o = null;
try {
o = transferable.getTransferData(DataFlavor.imageFlavor);
} catch (IOException ex) {
ex.printStackTrace();
} catch (UnsupportedFlavorException ex) {
ex.printStackTrace();
}
return o instanceof Image ? (Image) o : ImageUtilities.loadImage("org/netbeans/shapesample/palette/shape1.png");
}
Ako vidíme, je tu ošetrená chyba, čiže môžete do org.netbeans.shapesample.palette doplniť obrázok, ktorý sa má objaviť pri chybe, dajte mu meno shape1.png

3. Z dôvodu toho, že máme len 3 obrázky, mohli by sme vytvoriť akoby len 3 prvky, preto si vytvoríme novú triedu s názvom '''MyNode'''. Klikneme na náš '''package shapesample pravým--new---java class''' a bude vypadať takto:
public class MyNode {
private Image image;

public MyNode(Image image) {
this.image = image;
}
public Image getImage() {
return image;
}
}

Klikneme na žltú žiarovku v tejto triede a dáme '''"Add import..."'''

4. Zmeníme teraz v triede '''GraphSceneImpl''' rodiča, od ktorého dedí, čiže jeden z prvý riadkov bude vypadať takto:
public class GraphSceneImpl extends GraphScene<MyNode, String>{...telo triedy...}
čím sme zabezpečili, že naša Node je prijatá cez Visual Library. Teraz sa nám objaví žltá žiarovka aj pri tomto riadku, lebo teraz musíme dediť iné abstraktné metódy, '''čiže klikneme na ňu --implement all abstract methods'''
5. Kedže používame generics, tak klikneme '''pravým na náš projekt--properties--sources''' a presvedčíme sa, že tam máme hodnotu '''Source level = 1.5'''

6. Následne definujeme náš nový Widget (komponent) v triede '''GraphSceneImpl''' a to tak, že tam nájdeme metódu '''protected Widget attachNodeWidget(MyNode node)''' a upravíme ju nasledovne:
protected Widget attachNodeWidget(MyNode node) {
IconNodeWidget widget = new IconNodeWidget(this);
widget.setImage(node.getImage());
widget.setLabel(Long.toString(node.hashCode()));
widget.getActions().addAction(ActionFactory.createMoveAction());
mainLayer.addChild(widget);
return widget;
}
Týmto nášmu Widgetu nastavíme obrázok, a priradíme mu veľké náhodné číslo, a ešte možnosť posúvať ho po našej scéne, a následne po zastavení ho pridať znova ako child.

7. Ešte stále nám ostáva pár žltých žiaroviek, takže klikneme na každú z nich, ktorá tam bude a dáme '''"Add import..."'''

8. Spustíme náš projekt, a už uvidíme, že je možné presúvať komponenty (Widgety) z našej paletty na našu scénku:

== Pridanie funkcionality pre našu scénu ==
1.Teraz pridáme najprv ZOOMaction na našu scénku a to tak, že na koniec '''GraphSceneImpl''' konštruktoru pridáme:
getActions().addAction(ActionFactory.createZoomAction());

Keď spustíme teraz náš projekt, tak pri pridržaní ctrl+ kolieško myši sa nám bude zoomovať naša plocha

2. Pridaním riadku za predošlým :
getActions().addAction(ActionFactory.createPanAction());
Pridáme funkcionalitu, že keď user potlačí kolečko myši, tak potom môže hýbať do hociktorého smeru.

== Pridanie funkcinality pre IconNodeWidget ==
Pre IconNodeWidget sme už pridali funcionalitu pre hýbanie '''MoveAction'''. Tak isto sme schopný pridať aj funkcionalitu pre '''HoverAction, SelectAction, a InplaceEditorAction''', v poradí (nadídenie, vybranie, premenovanie)
1. Najprv na úrovni triedy definujte
private WidgetAction editorAction = ActionFactory.createInplaceEditorAction(new LabelTextFieldEditor());
Následne sa objaví znova žltá žiarovka, najprv dajte '''"Add import..."''', následne dajte '''"Create class LabelTextFieldEditor..."''' , čo nám pridá do nášho package triedu.
2.Telo tejto triedy '''LabelTextFieldEditor''' zmeníme nasledovne:
class LabelTextFieldEditor implements TextFieldInplaceEditor {
public boolean isEnabled(Widget widget) {
return true;
}
public String getText(Widget widget) {
return ((LabelWidget) widget).getLabel();
}
public void setText(Widget widget, String text) {
((LabelWidget) widget).setLabel(text);
}
}
Znovu sa v tejto triede objaví zopár žltých žiaroviek, poklikajte na '''"add import..."'''

3. Následne priradíme editorAction nášmu IconNodeWidget, a to tak, že na koniec metódy '''protected Widget attachNodeWidget(MyNode node)''' triedy '''GraphSceneImpl''' vložíme tesne nad riadok ''' mainLayer.addChild(widget);''' nasledujúci kód:
widget.getLabelWidget().getActions().addAction(editorAction);

4. Následne Hower, Clicked action dolníme tak, že po vyššie doplnenom riadku dáme tieto dva:
widget.getActions().addAction(createSelectAction());
widget.getActions().addAction(createObjectHoverAction());

5. Teraz musíme trochu premyslieť poradie, v ktorom sme akcie pridali, info tu [http://bits.netbeans.org/dev/javadoc/org-netbeans-api-visual/org/netbeans/api/visual/widget/doc-files/documentation.html#OrderOfActions]
A následne bude naša metóda '''protected Widget attachNodeWidget''' vypadať nasledovne
protected Widget attachNodeWidget(MyNode node) {
IconNodeWidget widget = new IconNodeWidget(this);
widget.setImage(node.getImage());
widget.setLabel(Long.toString(node.hashCode()));
//double-click, event sa spustí len pri doubleclicku:
widget.getLabelWidget().getActions().addAction(editorAction);
//single-click, event sa spustí pri single clicku
widget.getActions().addAction(createSelectAction());
//mouse-dragged
widget.getActions().addAction(ActionFactory.createMoveAction());
//mouse-over,
widget.getActions().addAction(createObjectHoverAction());
mainLayer.addChild(widget);
return widget;
}

6. Po spustení to bude môcť vypadať takto napr. 
<center>
{|class="wikitable"
| align="center" width=450 | [[Súbor:Ytb desat.png | 400px]]
|}
</center>

== Záver a riešenie problémov ==

Ukázali sme v skutku len veľmi strohú ukážku, čo by sa s NetBeans dalo spraviť, ale keďže je to problematika, ktorou by sa mali zaoberať knihy pre pokročilejších programátorov, tak tu skončíme.

V prípade nejasností je vždy dobré sa obráti na stránku NetBeans tutorials [http://netbeans.org/kb/trails/platform.html]

V prípade problémov, resp. riešenia chýb uvedeného návodu, '''odporúčam použiť VYTVORENY FUNKCNY MODUL''' 
'''Download:''' [http://plugins.netbeans.org/PluginPortal/faces/PluginDetailPage.jsp?pluginid=14027] 
'''Inštalácia:''' Spustite '''NetBeans--Tools--Plugins--kliknite Downloaded--Add Plugins...--nájdite stiahnutý--install''' 
'''Spustenie pluginu:''' '''Spustite NetBeans--File--New Project--Samples--NetBeansModule--Visual Library Demo''' 
 
V prípade nejasností, je tam všetko štruktúrované ako v našom návode, čiže by ste tam mali nájsť svoju chybu dosť rýchlo a prehľadne. 
 

Zdroj:[http://platform.netbeans.org/tutorials/nbm-visual_library.html]

Základy práce s NetBeans IDE a vývoj modulov

2010-04-27T19:17:01Z

Pokoraczki1: /* Pridanie funkcinality pre IconNodeWidget */

== NetBeans IDE ==
NetBeans je krásne vývojové prostredie, ktorého hlavnou výhodou je jeho modulárna architektúra. Ďalším skvelým prvkom je, že sa spolieha na toolkit SWING UI, čo nám dokopy dáva obrovské výhody.

V tomto článku sa posnažím ukázať, ako možno vytvoriť jednoduchý modul pre NetBeans, ktorý bude iba strohá ukážka toho, čo sa s NetBeans dá robit.

== Požiadavky na postup článkom ==
1. NetBeans IDE ( použitá verzia 6.8 ) 
2. Java_jdk ( použitá verzia 1.6.0.18 ) 
3. Základné znalosti jazyka JAVA

== Vytvorenie a spustenie projektu ==
1. Začneme spustením Netbeans a zvolíme '''File--New Project--NetBeans Modules--Module''' 
<center>
{|class="wikitable"
| align="center" width=450 | [[Súbor:Ytb prvy.png | 400px]]
|}
</center>

2. Klikneme na tlačítko "NEXT", pomenujeme si náš projekt napr. "ShapeSample", nastavíme ho ako "'''main project'''" a vyberieme si umiestnenie, kde ho chceme uložiť a ponecháme '''Standalone Module'''
<center>
{|class="wikitable"
| align="center" width=450 | [[Súbor:Ytb druhy.png | 400px]]
|}
</center>

3. Klikneme "NEXT", zadáme do "Code Name Base" '''org.netbeans.shapesample''', a dôležité, klikneme na '''Generate XML Layer'''. Následne klikneme na tlačítko finish, a vytvorí sa nám projekt.
<center>
{|class="wikitable"
| align="center" width=450 | [[Súbor:Ytb treti.png | 400px]]
|}
</center>

4. V okne "Project" , '''klikneme pravým na "ShapeSample"--Properties--Libraries'''. Module Dependencies klikneme na tlačítko "ADD" a pridáme: 
''a/ Visual Library API 
b/ Utilities API ''
Klikneme na tlačítko OK, čo nám pridá odkazy. 

5. Znova v "Project" window '''klikneme pravým na "ShapeSample"--New--Other--Module Development--Window Component''' , klikneme "NEXT" 

6. Ako Windows Position dáme '''editor''' a zaškrtneme '''Open on application start''' a klikneme "NEXT" 

7.Do políčka "Class Name Prefix" dopíšeme '''Shape''', klikneme na tlačítko "FINISH" 

8. Vygeneruje sa nám viacero súbor, jedným z nich je '''ShapeTopComponent''', 2krát naň klikneme a otvoríme ho v design view. 

9. V design view, pravým klikneme na okno akoby a dáme '''Set Layout--Border Layout''' 
<center>
{|class="wikitable"
| align="center" width=450 | [[Súbor:Ytb stvrty.png | 400px]]
|}
</center>

== Vytvorenie scény ==
1. Využijeme okno "'''Pallete'''" (ak nie je zobrazené dáme window---pallete) a vložíme na naš layout '''ScrollPane'''. V okne "Inspector" klikneme pravým na jScrollPane1--Change Variable Name a nastavíme hodnotu na "shapePane".

2.V "Project" windows na zložku''' org--netbeans--shapesample''' klikneme pravým a dáme '''new--Java Class''', pomenujme ju "'''GraphSceneImpl'''", a po vytvorení dopíšme do triedy '''extends GraphScene'''

3. Žltá žiarovka s červeným výkričníkom sa nám objaví naľavo v editore, klikneme na ňu, a dáme "'''add Import...'''" 
Následne sa dám objaví ďalšia žltá žiarovka, klikneme na ňu a dáme "'''Implement all abstract methods'''" 
<center>
{|class="wikitable"
| align="center" width=450 | [[Súbor:Ytb piaty.png | 400px]]
|}
</center>

4. Pre lepšiu orientáciu zmeníme názvy parametrov vygenerovaných NetBeans, a po úprave bude naša trieda vypadať takto: 

public class GraphSceneImpl extends GraphScene
{

public GraphSceneImpl() {
}

protected Widget attachNodeWidget(Object node) {
return null;
}

protected Widget attachEdgeWidget(Object edge) {
return null;
}

protected void attachEdgeSourceAnchor(Object edge, Object oldSourceNode, Object newSourceNode) {

}

protected void attachEdgeTargetAnchor(Object edge, Object oldTargetNode, Object newTargetNode) {

}
}

5.Vrátime sa k ShapeTopComponent, kde sa budeme starať o instanciu GraphSceneImpl , prepneme Design View na SourceView, a nájdeme jeho konštruktor. Do tela konštruktora doplnime nasledujúce riadky:
GraphSceneImpl scene = new GraphSceneImpl();
myView = scene.createView();
shapePane.setViewportView(myView);
add(scene.createSatelliteView(), BorderLayout.WEST);

Týmto sme vytvorili 2 náhľady, jeden veľký, a jeden akoby informačný na ľavej strane, ktorý pomôže používateľovi rýchlejšie sa pohybovať po väčšom rozpätí.

6. Na '''úrovni triedy ShapeTopComponent''' deklarujeme (doplníme napr. hneď nad konštruktor)
private JComponent myView;

Ostanú nám ešte 2 žlté žiarovky, klikneme na každú z nich, a dáme "'''Add Import...'''"

7. Teraz musíme ošetriť, že ak sa NetBeans IDE reštartuje, nemáme žiadny dôvod aby ShapeTopComponent pretrvával, čiže nájdeme metódu '''getPersistenceType()''' v tele triedy, a zmeníme ju nasledovne:
public int getPersistenceType() {
return TopComponent.PERSISTENCE_NEVER;
}

8. Klikneme v "Project" window na náš projekt '''ShapeSample pravým--run'''

9. Nezlaknite sa, spustí sa nová inštancia NetBeans IDE(ak nie je náš projekt už otvorený kliknite na '''window---Shape''') a zobrazí sa Vám niečo takéto: 
<center>
{|class="wikitable"
| align="center" width=450 | [[Súbor:Ytb siesty.png | 400px]]
|}
</center>

== Vytváranie Palety pre našu scénu ==

Teraz aby sme pokračovali niečím užitočným, vytvoríme si palletu, na čo využijeme Pallete API, ktorá bude obsahovať komponenty, ktoré môžeme použiť a pridať na našu scénu pretiahnutím.
Pre ďalšie pokračovanie budeme potrebovať 3 obrázky našich komponentov, použime tieto(kliknite pravým---uložiť ako, nemente názvy):
[[Súbor:Image1.png]][[Súbor:Image2.png]][[Súbor:Image3.png]]

'''Keďže náš tutoriál sa zaoberá s Visual Library API, a nie s Palette API(info tu:[http://netbeans.org/kb/trails/platform.html] ), na funkcionalitu Paletty použijeme už hotové knižnice, ktoré stiahnete tu''':
[http://www.sendspace.com/file/dqtnbi] (v prípade, že je link nefunkčný, na konci článku je hotový plugin pre tento modul, knižnice vytiahnite z neho)

1. Klikneme na náš projekt pravým--new--Java Package a pomenujeme ho '''org.netbeans.shapesample.palette'''
2. Teraz podme do zložky, kde sme nás projekt uložili, konkrétne '''násProjekt/src/org/netbeans/shapesample/pallete'''. A do tejto''' zložky nakopírujeme stiahnuté obrázky a následne aj knižnice''', čiže tieto súbory: 
a/ Category 
b/ CategoryChildren 
c/ CategoryNode 
d/ PaletteSupport 
e/ Shape 
f/ ShapeChildren 
g/ ShapeNode 
h/ image1, image2, image3 
po zobrazení NetBeans sa nám novo vytvorený package obnoví, a budeme tam mať načítané všetky vložené súbory, pričom niekde sa znovu objavia červené krúžky so žiarovkou, to si nevšímajme chvíľku

3. Klikneme '''pravým na projekt--Properties--Libraries--Add''' a pridáme nasledujúce knižnice: 
a/ Actions APIs 
b/ Nodes API 
c/ Common Palette 
Teraz by sme mali spozorovať, že všetky červené guličky nám zmiznú, a bude nám to vypadať nasledovne: 
<center>
{|class="wikitable"
| align="center" width=450 | [[Súbor:Ytb siedmy.png | 400px]]
|}
</center>

4. Teraz pridáme našu Palettu do ShapeTopComponentovho náhľadu, a to tak, že do konštruktoru ShapeTopComponent kod
associateLookup( Lookups.fixed( new Object[] { PaletteSupport.createPalette() } ) );

5. Znova sa nám objaví žltá žiarovka, klikneme na ňu dáme "Add import...", následne sa tam objaví znova, čiže znova klikneme a dáme "Add import..."

6. Spustite modul znova(pravým--run), teraz by to už malo vypadať takto, no zatiaľ bez funkcionality, pretože potrebujeme Layer Widget: 
<center>
{|class="wikitable"
| align="center" width=450 | [[Súbor:Ytb osmy.png | 400px]]
|}
</center>

== Pridanie LayerWidget ==

Pod pojmom LayerWidget si predstavte niečo priesvitné, na ktoré budeme môcť ukladať naše komponenty s paletty.

1. Ná úrovni triedy GraphSceneImpl deklarujte náš LayerWidget
private LayerWidget mainLayer;

2. Do konštruktoru GraphSceneImpl pridajte LayerWidget ako dieťa našej scény:
mainLayer = new LayerWidget (this);
addChild (mainLayer);

Teraz keď pridáme na scénu nejaký komponent s našej paletty , pridajú sa ako deti do našel mainLayer.

== Pridanie IconNodeWidget (komponentu) cez funkcionalitu Drag and Drop (chyť a hoď) ==

Doposiaľ, naša scéna existuje, ale nemá žiadnu funkcionalitu. Túto funkcionalitu pridáme pomocou '''"actions"'''. Action, ktorá nám umožnuje Drag & Drop funkcionalitu je '''AcceptAction''' . Táto action môže byť aplikovaná buď na náš komponent alebo na našu scénu. My ju budeme aplikovať na našu scénu. Využijeme '''createAcceptAction''' na to, aby sme definovali čo sa má stať po tom, ako je komponent pretiahnutý nad našu scénu.

1. Najprv pridajte '''createAcceptAction''' spolu s jeho dvomi metódami do GraphSceneImpl konštruktoru:
getActions().addAction(ActionFactory.createAcceptAction(new AcceptProvider() {
public ConnectorState isAcceptable(Widget widget, Point point, Transferable transferable) {
Image dragImage = getImageFromTransferable(transferable);
JComponent view = getView();
Graphics2D g2 = (Graphics2D) view.getGraphics();
Rectangle visRect = view.getVisibleRect();
view.paintImmediately(visRect.x, visRect.y, visRect.width, visRect.height);
g2.drawImage(dragImage,
AffineTransform.getTranslateInstance(point.getLocation().getX(),
point.getLocation().getY()),
null);
return ConnectorState.ACCEPT;
}
public void accept(Widget widget, Point point, Transferable transferable) {
Image image = getImageFromTransferable(transferable);
Widget w = GraphSceneImpl.this.addNode(new MyNode(image));
w.setPreferredLocation(widget.convertLocalToScene(point));
}
}));

Objaví sa nám viacero chýb, a to z toho dôvodu, že sme použili aj metody, ktoré zatiaľ nie sú definované, čiže si chvíľku nevšímajme tieto errory.

2. Teraz do triedy '''GraphSceneImpl''' pridáme pomocnú metódu na získavanie obrázkov:
private Image getImageFromTransferable(Transferable transferable) {
Object o = null;
try {
o = transferable.getTransferData(DataFlavor.imageFlavor);
} catch (IOException ex) {
ex.printStackTrace();
} catch (UnsupportedFlavorException ex) {
ex.printStackTrace();
}
return o instanceof Image ? (Image) o : ImageUtilities.loadImage("org/netbeans/shapesample/palette/shape1.png");
}
Ako vidíme, je tu ošetrená chyba, čiže môžete do org.netbeans.shapesample.palette doplniť obrázok, ktorý sa má objaviť pri chybe, dajte mu meno shape1.png

3. Z dôvodu toho, že máme len 3 obrázky, mohli by sme vytvoriť akoby len 3 prvky, preto si vytvoríme novú triedu s názvom '''MyNode'''. Klikneme na náš '''package shapesample pravým--new---java class''' a bude vypadať takto:
public class MyNode {
private Image image;

public MyNode(Image image) {
this.image = image;
}
public Image getImage() {
return image;
}
}

Klikneme na žltú žiarovku v tejto triede a dáme '''"Add import..."'''

4. Zmeníme teraz v triede '''GraphSceneImpl''' rodiča, od ktorého dedí, čiže jeden z prvý riadkov bude vypadať takto:
public class GraphSceneImpl extends GraphScene<MyNode, String>{...telo triedy...}
čím sme zabezpečili, že naša Node je prijatá cez Visual Library. Teraz sa nám objaví žltá žiarovka aj pri tomto riadku, lebo teraz musíme dediť iné abstraktné metódy, '''čiže klikneme na ňu --implement all abstract methods'''
5. Kedže používame generics, tak klikneme '''pravým na náš projekt--properties--sources''' a presvedčíme sa, že tam máme hodnotu '''Source level = 1.5'''

6. Následne definujeme náš nový Widget (komponent) v triede '''GraphSceneImpl''' a to tak, že tam nájdeme metódu '''protected Widget attachNodeWidget(MyNode node)''' a upravíme ju nasledovne:
protected Widget attachNodeWidget(MyNode node) {
IconNodeWidget widget = new IconNodeWidget(this);
widget.setImage(node.getImage());
widget.setLabel(Long.toString(node.hashCode()));
widget.getActions().addAction(ActionFactory.createMoveAction());
mainLayer.addChild(widget);
return widget;
}
Týmto nášmu Widgetu nastavíme obrázok, a priradíme mu veľké náhodné číslo, a ešte možnosť posúvať ho po našej scéne, a následne po zastavení ho pridať znova ako child.

7. Ešte stále nám ostáva pár žltých žiaroviek, takže klikneme na každú z nich, ktorá tam bude a dáme '''"Add import..."'''

8. Spustíme náš projekt, a už uvidíme, že je možné presúvať komponenty (Widgety) z našej paletty na našu scénku:

== Pridanie funkcionality pre našu scénu ==
1.Teraz pridáme najprv ZOOMaction na našu scénku a to tak, že na koniec '''GraphSceneImpl''' konštruktoru pridáme:
getActions().addAction(ActionFactory.createZoomAction());

Keď spustíme teraz náš projekt, tak pri pridržaní ctrl+ kolieško myši sa nám bude zoomovať naša plocha

2. Pridaním riadku za predošlým :
getActions().addAction(ActionFactory.createPanAction());
Pridáme funkcionalitu, že keď user potlačí kolečko myši, tak potom môže hýbať do hociktorého smeru.

== Pridanie funkcinality pre IconNodeWidget ==
Pre IconNodeWidget sme už pridali funcionalitu pre hýbanie '''MoveAction'''. Tak isto sme schopný pridať aj funkcionalitu pre '''HoverAction, SelectAction, a InplaceEditorAction''', v poradí (nadídenie, vybranie, premenovanie)
1. Najprv na úrovni triedy definujte
private WidgetAction editorAction = ActionFactory.createInplaceEditorAction(new LabelTextFieldEditor());
Následne sa objaví znova žltá žiarovka, najprv dajte '''"Add import..."''', následne dajte '''"Create class LabelTextFieldEditor..."''' , čo nám pridá do nášho package triedu.
2.Telo tejto triedy '''LabelTextFieldEditor''' zmeníme nasledovne:
class LabelTextFieldEditor implements TextFieldInplaceEditor {
public boolean isEnabled(Widget widget) {
return true;
}
public String getText(Widget widget) {
return ((LabelWidget) widget).getLabel();
}
public void setText(Widget widget, String text) {
((LabelWidget) widget).setLabel(text);
}
}
Znovu sa v tejto triede objaví zopár žltých žiaroviek, poklikajte na '''"add import..."'''

3. Následne priradíme editorAction nášmu IconNodeWidget, a to tak, že na koniec metódy '''protected Widget attachNodeWidget(MyNode node)''' triedy '''GraphSceneImpl''' vložíme tesne nad riadok ''' mainLayer.addChild(widget);''' nasledujúci kód:
widget.getLabelWidget().getActions().addAction(editorAction);

4. Následne Hower, Clicked action dolníme tak, že po vyššie doplnenom riadku dáme tieto dva:
widget.getActions().addAction(createSelectAction());
widget.getActions().addAction(createObjectHoverAction());

5. Teraz musíme trochu premyslieť poradie, v ktorom sme akcie pridali, info tu [http://bits.netbeans.org/dev/javadoc/org-netbeans-api-visual/org/netbeans/api/visual/widget/doc-files/documentation.html#OrderOfActions]
A následne bude naša metóda '''protected Widget attachNodeWidget''' vypadať nasledovne
protected Widget attachNodeWidget(MyNode node) {
IconNodeWidget widget = new IconNodeWidget(this);
widget.setImage(node.getImage());
widget.setLabel(Long.toString(node.hashCode()));
//double-click, event sa spustí len pri doubleclicku:
widget.getLabelWidget().getActions().addAction(editorAction);
//single-click, event sa spustí pri single clicku
widget.getActions().addAction(createSelectAction());
//mouse-dragged
widget.getActions().addAction(ActionFactory.createMoveAction());
//mouse-over,
widget.getActions().addAction(createObjectHoverAction());
mainLayer.addChild(widget);
return widget;
}

6. Po spustení to bude môcť vypadať takto napr. 
<center>
{|class="wikitable"
| align="center" width=450 | [[Súbor:Ytb desat.png | 400px]]
|}
</center>

== Záver a riešenie problémov ==

Ukázali sme v skutku len veľmi strohú ukážku, čo by sa s NetBeans dalo spraviť, ale keďže je to problematika, ktorou by sa mali zaoberať knihy pre pokročilejších programátorov, tak tu skončíme.

V prípade nejasností je vždy dobré sa obráti na stránku NetBeans tutorials [http://netbeans.org/kb/trails/platform.html]

V prípade problémov, resp. riešenia chýb uvedeného návodu, '''odporúčam použiť VYTVORENY FUNKCNY MODUL''' 
'''Download:''' [http://plugins.netbeans.org/PluginPortal/faces/PluginDetailPage.jsp?pluginid=14027] 
'''Inštalácia:''' Spustite '''NetBeans--Tools--Plugins--kliknite Downloaded--Add Plugins...--nájdite stiahnutý--install''' 
'''Spustenie pluginu:''' '''Spustite NetBeans--File--New Project--Samples--NetBeansModule--Visual Library Demo''' 
 
V prípade nejasností, je tam všetko štruktúrované ako v našom návode, čiže by ste tam mali nájsť svoju chybu dosť rýchlo a prehľadne. 
 

Zdroj:[http://platform.netbeans.org/tutorials/nbm-visual_library.html]

Základy práce s NetBeans IDE a vývoj modulov

2010-04-27T19:16:02Z

Pokoraczki1: /* Vytváranie Palety pre našu scénu */

== NetBeans IDE ==
NetBeans je krásne vývojové prostredie, ktorého hlavnou výhodou je jeho modulárna architektúra. Ďalším skvelým prvkom je, že sa spolieha na toolkit SWING UI, čo nám dokopy dáva obrovské výhody.

V tomto článku sa posnažím ukázať, ako možno vytvoriť jednoduchý modul pre NetBeans, ktorý bude iba strohá ukážka toho, čo sa s NetBeans dá robit.

== Požiadavky na postup článkom ==
1. NetBeans IDE ( použitá verzia 6.8 ) 
2. Java_jdk ( použitá verzia 1.6.0.18 ) 
3. Základné znalosti jazyka JAVA

== Vytvorenie a spustenie projektu ==
1. Začneme spustením Netbeans a zvolíme '''File--New Project--NetBeans Modules--Module''' 
<center>
{|class="wikitable"
| align="center" width=450 | [[Súbor:Ytb prvy.png | 400px]]
|}
</center>

2. Klikneme na tlačítko "NEXT", pomenujeme si náš projekt napr. "ShapeSample", nastavíme ho ako "'''main project'''" a vyberieme si umiestnenie, kde ho chceme uložiť a ponecháme '''Standalone Module'''
<center>
{|class="wikitable"
| align="center" width=450 | [[Súbor:Ytb druhy.png | 400px]]
|}
</center>

3. Klikneme "NEXT", zadáme do "Code Name Base" '''org.netbeans.shapesample''', a dôležité, klikneme na '''Generate XML Layer'''. Následne klikneme na tlačítko finish, a vytvorí sa nám projekt.
<center>
{|class="wikitable"
| align="center" width=450 | [[Súbor:Ytb treti.png | 400px]]
|}
</center>

4. V okne "Project" , '''klikneme pravým na "ShapeSample"--Properties--Libraries'''. Module Dependencies klikneme na tlačítko "ADD" a pridáme: 
''a/ Visual Library API 
b/ Utilities API ''
Klikneme na tlačítko OK, čo nám pridá odkazy. 

5. Znova v "Project" window '''klikneme pravým na "ShapeSample"--New--Other--Module Development--Window Component''' , klikneme "NEXT" 

6. Ako Windows Position dáme '''editor''' a zaškrtneme '''Open on application start''' a klikneme "NEXT" 

7.Do políčka "Class Name Prefix" dopíšeme '''Shape''', klikneme na tlačítko "FINISH" 

8. Vygeneruje sa nám viacero súbor, jedným z nich je '''ShapeTopComponent''', 2krát naň klikneme a otvoríme ho v design view. 

9. V design view, pravým klikneme na okno akoby a dáme '''Set Layout--Border Layout''' 
<center>
{|class="wikitable"
| align="center" width=450 | [[Súbor:Ytb stvrty.png | 400px]]
|}
</center>

== Vytvorenie scény ==
1. Využijeme okno "'''Pallete'''" (ak nie je zobrazené dáme window---pallete) a vložíme na naš layout '''ScrollPane'''. V okne "Inspector" klikneme pravým na jScrollPane1--Change Variable Name a nastavíme hodnotu na "shapePane".

2.V "Project" windows na zložku''' org--netbeans--shapesample''' klikneme pravým a dáme '''new--Java Class''', pomenujme ju "'''GraphSceneImpl'''", a po vytvorení dopíšme do triedy '''extends GraphScene'''

3. Žltá žiarovka s červeným výkričníkom sa nám objaví naľavo v editore, klikneme na ňu, a dáme "'''add Import...'''" 
Následne sa dám objaví ďalšia žltá žiarovka, klikneme na ňu a dáme "'''Implement all abstract methods'''" 
<center>
{|class="wikitable"
| align="center" width=450 | [[Súbor:Ytb piaty.png | 400px]]
|}
</center>

4. Pre lepšiu orientáciu zmeníme názvy parametrov vygenerovaných NetBeans, a po úprave bude naša trieda vypadať takto: 

public class GraphSceneImpl extends GraphScene
{

public GraphSceneImpl() {
}

protected Widget attachNodeWidget(Object node) {
return null;
}

protected Widget attachEdgeWidget(Object edge) {
return null;
}

protected void attachEdgeSourceAnchor(Object edge, Object oldSourceNode, Object newSourceNode) {

}

protected void attachEdgeTargetAnchor(Object edge, Object oldTargetNode, Object newTargetNode) {

}
}

5.Vrátime sa k ShapeTopComponent, kde sa budeme starať o instanciu GraphSceneImpl , prepneme Design View na SourceView, a nájdeme jeho konštruktor. Do tela konštruktora doplnime nasledujúce riadky:
GraphSceneImpl scene = new GraphSceneImpl();
myView = scene.createView();
shapePane.setViewportView(myView);
add(scene.createSatelliteView(), BorderLayout.WEST);

Týmto sme vytvorili 2 náhľady, jeden veľký, a jeden akoby informačný na ľavej strane, ktorý pomôže používateľovi rýchlejšie sa pohybovať po väčšom rozpätí.

6. Na '''úrovni triedy ShapeTopComponent''' deklarujeme (doplníme napr. hneď nad konštruktor)
private JComponent myView;

Ostanú nám ešte 2 žlté žiarovky, klikneme na každú z nich, a dáme "'''Add Import...'''"

7. Teraz musíme ošetriť, že ak sa NetBeans IDE reštartuje, nemáme žiadny dôvod aby ShapeTopComponent pretrvával, čiže nájdeme metódu '''getPersistenceType()''' v tele triedy, a zmeníme ju nasledovne:
public int getPersistenceType() {
return TopComponent.PERSISTENCE_NEVER;
}

8. Klikneme v "Project" window na náš projekt '''ShapeSample pravým--run'''

9. Nezlaknite sa, spustí sa nová inštancia NetBeans IDE(ak nie je náš projekt už otvorený kliknite na '''window---Shape''') a zobrazí sa Vám niečo takéto: 
<center>
{|class="wikitable"
| align="center" width=450 | [[Súbor:Ytb siesty.png | 400px]]
|}
</center>

== Vytváranie Palety pre našu scénu ==

Teraz aby sme pokračovali niečím užitočným, vytvoríme si palletu, na čo využijeme Pallete API, ktorá bude obsahovať komponenty, ktoré môžeme použiť a pridať na našu scénu pretiahnutím.
Pre ďalšie pokračovanie budeme potrebovať 3 obrázky našich komponentov, použime tieto(kliknite pravým---uložiť ako, nemente názvy):
[[Súbor:Image1.png]][[Súbor:Image2.png]][[Súbor:Image3.png]]

'''Keďže náš tutoriál sa zaoberá s Visual Library API, a nie s Palette API(info tu:[http://netbeans.org/kb/trails/platform.html] ), na funkcionalitu Paletty použijeme už hotové knižnice, ktoré stiahnete tu''':
[http://www.sendspace.com/file/dqtnbi] (v prípade, že je link nefunkčný, na konci článku je hotový plugin pre tento modul, knižnice vytiahnite z neho)

1. Klikneme na náš projekt pravým--new--Java Package a pomenujeme ho '''org.netbeans.shapesample.palette'''
2. Teraz podme do zložky, kde sme nás projekt uložili, konkrétne '''násProjekt/src/org/netbeans/shapesample/pallete'''. A do tejto''' zložky nakopírujeme stiahnuté obrázky a následne aj knižnice''', čiže tieto súbory: 
a/ Category 
b/ CategoryChildren 
c/ CategoryNode 
d/ PaletteSupport 
e/ Shape 
f/ ShapeChildren 
g/ ShapeNode 
h/ image1, image2, image3 
po zobrazení NetBeans sa nám novo vytvorený package obnoví, a budeme tam mať načítané všetky vložené súbory, pričom niekde sa znovu objavia červené krúžky so žiarovkou, to si nevšímajme chvíľku

3. Klikneme '''pravým na projekt--Properties--Libraries--Add''' a pridáme nasledujúce knižnice: 
a/ Actions APIs 
b/ Nodes API 
c/ Common Palette 
Teraz by sme mali spozorovať, že všetky červené guličky nám zmiznú, a bude nám to vypadať nasledovne: 
<center>
{|class="wikitable"
| align="center" width=450 | [[Súbor:Ytb siedmy.png | 400px]]
|}
</center>

4. Teraz pridáme našu Palettu do ShapeTopComponentovho náhľadu, a to tak, že do konštruktoru ShapeTopComponent kod
associateLookup( Lookups.fixed( new Object[] { PaletteSupport.createPalette() } ) );

5. Znova sa nám objaví žltá žiarovka, klikneme na ňu dáme "Add import...", následne sa tam objaví znova, čiže znova klikneme a dáme "Add import..."

6. Spustite modul znova(pravým--run), teraz by to už malo vypadať takto, no zatiaľ bez funkcionality, pretože potrebujeme Layer Widget: 
<center>
{|class="wikitable"
| align="center" width=450 | [[Súbor:Ytb osmy.png | 400px]]
|}
</center>

== Pridanie LayerWidget ==

Pod pojmom LayerWidget si predstavte niečo priesvitné, na ktoré budeme môcť ukladať naše komponenty s paletty.

1. Ná úrovni triedy GraphSceneImpl deklarujte náš LayerWidget
private LayerWidget mainLayer;

2. Do konštruktoru GraphSceneImpl pridajte LayerWidget ako dieťa našej scény:
mainLayer = new LayerWidget (this);
addChild (mainLayer);

Teraz keď pridáme na scénu nejaký komponent s našej paletty , pridajú sa ako deti do našel mainLayer.

== Pridanie IconNodeWidget (komponentu) cez funkcionalitu Drag and Drop (chyť a hoď) ==

Doposiaľ, naša scéna existuje, ale nemá žiadnu funkcionalitu. Túto funkcionalitu pridáme pomocou '''"actions"'''. Action, ktorá nám umožnuje Drag & Drop funkcionalitu je '''AcceptAction''' . Táto action môže byť aplikovaná buď na náš komponent alebo na našu scénu. My ju budeme aplikovať na našu scénu. Využijeme '''createAcceptAction''' na to, aby sme definovali čo sa má stať po tom, ako je komponent pretiahnutý nad našu scénu.

1. Najprv pridajte '''createAcceptAction''' spolu s jeho dvomi metódami do GraphSceneImpl konštruktoru:
getActions().addAction(ActionFactory.createAcceptAction(new AcceptProvider() {
public ConnectorState isAcceptable(Widget widget, Point point, Transferable transferable) {
Image dragImage = getImageFromTransferable(transferable);
JComponent view = getView();
Graphics2D g2 = (Graphics2D) view.getGraphics();
Rectangle visRect = view.getVisibleRect();
view.paintImmediately(visRect.x, visRect.y, visRect.width, visRect.height);
g2.drawImage(dragImage,
AffineTransform.getTranslateInstance(point.getLocation().getX(),
point.getLocation().getY()),
null);
return ConnectorState.ACCEPT;
}
public void accept(Widget widget, Point point, Transferable transferable) {
Image image = getImageFromTransferable(transferable);
Widget w = GraphSceneImpl.this.addNode(new MyNode(image));
w.setPreferredLocation(widget.convertLocalToScene(point));
}
}));

Objaví sa nám viacero chýb, a to z toho dôvodu, že sme použili aj metody, ktoré zatiaľ nie sú definované, čiže si chvíľku nevšímajme tieto errory.

2. Teraz do triedy '''GraphSceneImpl''' pridáme pomocnú metódu na získavanie obrázkov:
private Image getImageFromTransferable(Transferable transferable) {
Object o = null;
try {
o = transferable.getTransferData(DataFlavor.imageFlavor);
} catch (IOException ex) {
ex.printStackTrace();
} catch (UnsupportedFlavorException ex) {
ex.printStackTrace();
}
return o instanceof Image ? (Image) o : ImageUtilities.loadImage("org/netbeans/shapesample/palette/shape1.png");
}
Ako vidíme, je tu ošetrená chyba, čiže môžete do org.netbeans.shapesample.palette doplniť obrázok, ktorý sa má objaviť pri chybe, dajte mu meno shape1.png

3. Z dôvodu toho, že máme len 3 obrázky, mohli by sme vytvoriť akoby len 3 prvky, preto si vytvoríme novú triedu s názvom '''MyNode'''. Klikneme na náš '''package shapesample pravým--new---java class''' a bude vypadať takto:
public class MyNode {
private Image image;

public MyNode(Image image) {
this.image = image;
}
public Image getImage() {
return image;
}
}

Klikneme na žltú žiarovku v tejto triede a dáme '''"Add import..."'''

4. Zmeníme teraz v triede '''GraphSceneImpl''' rodiča, od ktorého dedí, čiže jeden z prvý riadkov bude vypadať takto:
public class GraphSceneImpl extends GraphScene<MyNode, String>{...telo triedy...}
čím sme zabezpečili, že naša Node je prijatá cez Visual Library. Teraz sa nám objaví žltá žiarovka aj pri tomto riadku, lebo teraz musíme dediť iné abstraktné metódy, '''čiže klikneme na ňu --implement all abstract methods'''
5. Kedže používame generics, tak klikneme '''pravým na náš projekt--properties--sources''' a presvedčíme sa, že tam máme hodnotu '''Source level = 1.5'''

6. Následne definujeme náš nový Widget (komponent) v triede '''GraphSceneImpl''' a to tak, že tam nájdeme metódu '''protected Widget attachNodeWidget(MyNode node)''' a upravíme ju nasledovne:
protected Widget attachNodeWidget(MyNode node) {
IconNodeWidget widget = new IconNodeWidget(this);
widget.setImage(node.getImage());
widget.setLabel(Long.toString(node.hashCode()));
widget.getActions().addAction(ActionFactory.createMoveAction());
mainLayer.addChild(widget);
return widget;
}
Týmto nášmu Widgetu nastavíme obrázok, a priradíme mu veľké náhodné číslo, a ešte možnosť posúvať ho po našej scéne, a následne po zastavení ho pridať znova ako child.

7. Ešte stále nám ostáva pár žltých žiaroviek, takže klikneme na každú z nich, ktorá tam bude a dáme '''"Add import..."'''

8. Spustíme náš projekt, a už uvidíme, že je možné presúvať komponenty (Widgety) z našej paletty na našu scénku:

== Pridanie funkcionality pre našu scénu ==
1.Teraz pridáme najprv ZOOMaction na našu scénku a to tak, že na koniec '''GraphSceneImpl''' konštruktoru pridáme:
getActions().addAction(ActionFactory.createZoomAction());

Keď spustíme teraz náš projekt, tak pri pridržaní ctrl+ kolieško myši sa nám bude zoomovať naša plocha

2. Pridaním riadku za predošlým :
getActions().addAction(ActionFactory.createPanAction());
Pridáme funkcionalitu, že keď user potlačí kolečko myši, tak potom môže hýbať do hociktorého smeru.

== Pridanie funkcinality pre IconNodeWidget ==
Pre IconNodeWidget sme už pridali funcionalitu pre hýbanie '''MoveAction'''. Tak isto sme schopný pridať aj funkcionalitu pre '''HoverAction, SelectAction, a InplaceEditorAction''', v poradí (nadídenie, vybranie, premenovanie)
1. Najprv na úrovni triedy definujte
private WidgetAction editorAction = ActionFactory.createInplaceEditorAction(new LabelTextFieldEditor());
Následne sa objaví znova žltá žiarovka, najprv dajte '''"Add import..."''', následne dajte '''"Create class LabelTextFieldEditor..."''' , čo nám pridá do nášho package triedu.
2.Telo tejto triedy '''LabelTextFieldEditor''' zmeníme nasledovne:
class LabelTextFieldEditor implements TextFieldInplaceEditor {
public boolean isEnabled(Widget widget) {
return true;
}
public String getText(Widget widget) {
return ((LabelWidget) widget).getLabel();
}
public void setText(Widget widget, String text) {
((LabelWidget) widget).setLabel(text);
}
}
Znovu sa v tejto triede objaví zopár žltých žiaroviek, poklikajte na '''"add import..."'''

3. Následne priradíme editorAction nášmu IconNodeWidget, a to tak, že na koniec metódy '''protected Widget attachNodeWidget(MyNode node)''' triedy '''GraphSceneImpl''' vložíme tesne nad riadok ''' mainLayer.addChild(widget);''' nasledujúci kód:
widget.getLabelWidget().getActions().addAction(editorAction);

4. Následne Hower, Clicked action dolníme tak, že po vyššie doplnenom riadku dáme tieto dva:
widget.getActions().addAction(createSelectAction());
widget.getActions().addAction(createObjectHoverAction());

5. Teraz musíme trochu premyslieť poradie, v ktorom sme akcie pridali, info tu [http://bits.netbeans.org/dev/javadoc/org-netbeans-api-visual/org/netbeans/api/visual/widget/doc-files/documentation.html#OrderOfActions]
A následne bude naša metóda '''protected Widget attachNodeWidget''' vypadať nasledovne
protected Widget attachNodeWidget(MyNode node) {
IconNodeWidget widget = new IconNodeWidget(this);
widget.setImage(node.getImage());
widget.setLabel(Long.toString(node.hashCode()));
//double-click, event sa spustí len pri doubleclicku:
widget.getLabelWidget().getActions().addAction(editorAction);
//single-click, event sa spustí pri single clicku
widget.getActions().addAction(createSelectAction());
//mouse-dragged
widget.getActions().addAction(ActionFactory.createMoveAction());
//mouse-over,
widget.getActions().addAction(createObjectHoverAction());
mainLayer.addChild(widget);
return widget;
}

6. Po spustení to bude môcť vypadať takto napr. 
[[Súbor:Ytb desat.png]]

== Záver a riešenie problémov ==

Ukázali sme v skutku len veľmi strohú ukážku, čo by sa s NetBeans dalo spraviť, ale keďže je to problematika, ktorou by sa mali zaoberať knihy pre pokročilejších programátorov, tak tu skončíme.

V prípade nejasností je vždy dobré sa obráti na stránku NetBeans tutorials [http://netbeans.org/kb/trails/platform.html]

V prípade problémov, resp. riešenia chýb uvedeného návodu, '''odporúčam použiť VYTVORENY FUNKCNY MODUL''' 
'''Download:''' [http://plugins.netbeans.org/PluginPortal/faces/PluginDetailPage.jsp?pluginid=14027] 
'''Inštalácia:''' Spustite '''NetBeans--Tools--Plugins--kliknite Downloaded--Add Plugins...--nájdite stiahnutý--install''' 
'''Spustenie pluginu:''' '''Spustite NetBeans--File--New Project--Samples--NetBeansModule--Visual Library Demo''' 
 
V prípade nejasností, je tam všetko štruktúrované ako v našom návode, čiže by ste tam mali nájsť svoju chybu dosť rýchlo a prehľadne. 
 

Zdroj:[http://platform.netbeans.org/tutorials/nbm-visual_library.html]

Základy práce s NetBeans IDE a vývoj modulov

2010-04-27T19:15:00Z

Pokoraczki1: /* Vytvorenie scény */

== NetBeans IDE ==
NetBeans je krásne vývojové prostredie, ktorého hlavnou výhodou je jeho modulárna architektúra. Ďalším skvelým prvkom je, že sa spolieha na toolkit SWING UI, čo nám dokopy dáva obrovské výhody.

V tomto článku sa posnažím ukázať, ako možno vytvoriť jednoduchý modul pre NetBeans, ktorý bude iba strohá ukážka toho, čo sa s NetBeans dá robit.

== Požiadavky na postup článkom ==
1. NetBeans IDE ( použitá verzia 6.8 ) 
2. Java_jdk ( použitá verzia 1.6.0.18 ) 
3. Základné znalosti jazyka JAVA

== Vytvorenie a spustenie projektu ==
1. Začneme spustením Netbeans a zvolíme '''File--New Project--NetBeans Modules--Module''' 
<center>
{|class="wikitable"
| align="center" width=450 | [[Súbor:Ytb prvy.png | 400px]]
|}
</center>

2. Klikneme na tlačítko "NEXT", pomenujeme si náš projekt napr. "ShapeSample", nastavíme ho ako "'''main project'''" a vyberieme si umiestnenie, kde ho chceme uložiť a ponecháme '''Standalone Module'''
<center>
{|class="wikitable"
| align="center" width=450 | [[Súbor:Ytb druhy.png | 400px]]
|}
</center>

3. Klikneme "NEXT", zadáme do "Code Name Base" '''org.netbeans.shapesample''', a dôležité, klikneme na '''Generate XML Layer'''. Následne klikneme na tlačítko finish, a vytvorí sa nám projekt.
<center>
{|class="wikitable"
| align="center" width=450 | [[Súbor:Ytb treti.png | 400px]]
|}
</center>

4. V okne "Project" , '''klikneme pravým na "ShapeSample"--Properties--Libraries'''. Module Dependencies klikneme na tlačítko "ADD" a pridáme: 
''a/ Visual Library API 
b/ Utilities API ''
Klikneme na tlačítko OK, čo nám pridá odkazy. 

5. Znova v "Project" window '''klikneme pravým na "ShapeSample"--New--Other--Module Development--Window Component''' , klikneme "NEXT" 

6. Ako Windows Position dáme '''editor''' a zaškrtneme '''Open on application start''' a klikneme "NEXT" 

7.Do políčka "Class Name Prefix" dopíšeme '''Shape''', klikneme na tlačítko "FINISH" 

8. Vygeneruje sa nám viacero súbor, jedným z nich je '''ShapeTopComponent''', 2krát naň klikneme a otvoríme ho v design view. 

9. V design view, pravým klikneme na okno akoby a dáme '''Set Layout--Border Layout''' 
<center>
{|class="wikitable"
| align="center" width=450 | [[Súbor:Ytb stvrty.png | 400px]]
|}
</center>

== Vytvorenie scény ==
1. Využijeme okno "'''Pallete'''" (ak nie je zobrazené dáme window---pallete) a vložíme na naš layout '''ScrollPane'''. V okne "Inspector" klikneme pravým na jScrollPane1--Change Variable Name a nastavíme hodnotu na "shapePane".

2.V "Project" windows na zložku''' org--netbeans--shapesample''' klikneme pravým a dáme '''new--Java Class''', pomenujme ju "'''GraphSceneImpl'''", a po vytvorení dopíšme do triedy '''extends GraphScene'''

3. Žltá žiarovka s červeným výkričníkom sa nám objaví naľavo v editore, klikneme na ňu, a dáme "'''add Import...'''" 
Následne sa dám objaví ďalšia žltá žiarovka, klikneme na ňu a dáme "'''Implement all abstract methods'''" 
<center>
{|class="wikitable"
| align="center" width=450 | [[Súbor:Ytb piaty.png | 400px]]
|}
</center>

4. Pre lepšiu orientáciu zmeníme názvy parametrov vygenerovaných NetBeans, a po úprave bude naša trieda vypadať takto: 

public class GraphSceneImpl extends GraphScene
{

public GraphSceneImpl() {
}

protected Widget attachNodeWidget(Object node) {
return null;
}

protected Widget attachEdgeWidget(Object edge) {
return null;
}

protected void attachEdgeSourceAnchor(Object edge, Object oldSourceNode, Object newSourceNode) {

}

protected void attachEdgeTargetAnchor(Object edge, Object oldTargetNode, Object newTargetNode) {

}
}

5.Vrátime sa k ShapeTopComponent, kde sa budeme starať o instanciu GraphSceneImpl , prepneme Design View na SourceView, a nájdeme jeho konštruktor. Do tela konštruktora doplnime nasledujúce riadky:
GraphSceneImpl scene = new GraphSceneImpl();
myView = scene.createView();
shapePane.setViewportView(myView);
add(scene.createSatelliteView(), BorderLayout.WEST);

Týmto sme vytvorili 2 náhľady, jeden veľký, a jeden akoby informačný na ľavej strane, ktorý pomôže používateľovi rýchlejšie sa pohybovať po väčšom rozpätí.

6. Na '''úrovni triedy ShapeTopComponent''' deklarujeme (doplníme napr. hneď nad konštruktor)
private JComponent myView;

Ostanú nám ešte 2 žlté žiarovky, klikneme na každú z nich, a dáme "'''Add Import...'''"

7. Teraz musíme ošetriť, že ak sa NetBeans IDE reštartuje, nemáme žiadny dôvod aby ShapeTopComponent pretrvával, čiže nájdeme metódu '''getPersistenceType()''' v tele triedy, a zmeníme ju nasledovne:
public int getPersistenceType() {
return TopComponent.PERSISTENCE_NEVER;
}

8. Klikneme v "Project" window na náš projekt '''ShapeSample pravým--run'''

9. Nezlaknite sa, spustí sa nová inštancia NetBeans IDE(ak nie je náš projekt už otvorený kliknite na '''window---Shape''') a zobrazí sa Vám niečo takéto: 
<center>
{|class="wikitable"
| align="center" width=450 | [[Súbor:Ytb siesty.png | 400px]]
|}
</center>

== Vytváranie Palety pre našu scénu ==

Teraz aby sme pokračovali niečím užitočným, vytvoríme si palletu, na čo využijeme Pallete API, ktorá bude obsahovať komponenty, ktoré môžeme použiť a pridať na našu scénu pretiahnutím.
Pre ďalšie pokračovanie budeme potrebovať 3 obrázky našich komponentov, použime tieto(kliknite pravým---uložiť ako, nemente názvy):
[[Súbor:Image1.png]][[Súbor:Image2.png]][[Súbor:Image3.png]]

'''Keďže náš tutoriál sa zaoberá s Visual Library API, a nie s Palette API(info tu:[http://netbeans.org/kb/trails/platform.html] ), na funkcionalitu Paletty použijeme už hotové knižnice, ktoré stiahnete tu''':
[http://www.sendspace.com/file/dqtnbi] (v prípade, že je link nefunkčný, na konci článku je hotový plugin pre tento modul, knižnice vytiahnite z neho)

1. Klikneme na náš projekt pravým--new--Java Package a pomenujeme ho '''org.netbeans.shapesample.palette'''
2. Teraz podme do zložky, kde sme nás projekt uložili, konkrétne '''násProjekt/src/org/netbeans/shapesample/pallete'''. A do tejto''' zložky nakopírujeme stiahnuté obrázky a následne aj knižnice''', čiže tieto súbory: 
a/ Category 
b/ CategoryChildren 
c/ CategoryNode 
d/ PaletteSupport 
e/ Shape 
f/ ShapeChildren 
g/ ShapeNode 
h/ image1, image2, image3 
po zobrazení NetBeans sa nám novo vytvorený package obnoví, a budeme tam mať načítané všetky vložené súbory, pričom niekde sa znovu objavia červené krúžky so žiarovkou, to si nevšímajme chvíľku

3. Klikneme '''pravým na projekt--Properties--Libraries--Add''' a pridáme nasledujúce knižnice: 
a/ Actions APIs 
b/ Nodes API 
c/ Common Palette 
Teraz by sme mali spozorovať, že všetky červené guličky nám zmiznú, a bude nám to vypadať nasledovne: 
[[Súbor:Ytb siedmy.png]]

4. Teraz pridáme našu Palettu do ShapeTopComponentovho náhľadu, a to tak, že do konštruktoru ShapeTopComponent kod
associateLookup( Lookups.fixed( new Object[] { PaletteSupport.createPalette() } ) );

5. Znova sa nám objaví žltá žiarovka, klikneme na ňu dáme "Add import...", následne sa tam objaví znova, čiže znova klikneme a dáme "Add import..."

6. Spustite modul znova(pravým--run), teraz by to už malo vypadať takto, no zatiaľ bez funkcionality, pretože potrebujeme Layer Widget: 
[[Súbor:Ytb osmy.png]]

== Pridanie LayerWidget ==

Pod pojmom LayerWidget si predstavte niečo priesvitné, na ktoré budeme môcť ukladať naše komponenty s paletty.

1. Ná úrovni triedy GraphSceneImpl deklarujte náš LayerWidget
private LayerWidget mainLayer;

2. Do konštruktoru GraphSceneImpl pridajte LayerWidget ako dieťa našej scény:
mainLayer = new LayerWidget (this);
addChild (mainLayer);

Teraz keď pridáme na scénu nejaký komponent s našej paletty , pridajú sa ako deti do našel mainLayer.

== Pridanie IconNodeWidget (komponentu) cez funkcionalitu Drag and Drop (chyť a hoď) ==

Doposiaľ, naša scéna existuje, ale nemá žiadnu funkcionalitu. Túto funkcionalitu pridáme pomocou '''"actions"'''. Action, ktorá nám umožnuje Drag & Drop funkcionalitu je '''AcceptAction''' . Táto action môže byť aplikovaná buď na náš komponent alebo na našu scénu. My ju budeme aplikovať na našu scénu. Využijeme '''createAcceptAction''' na to, aby sme definovali čo sa má stať po tom, ako je komponent pretiahnutý nad našu scénu.

1. Najprv pridajte '''createAcceptAction''' spolu s jeho dvomi metódami do GraphSceneImpl konštruktoru:
getActions().addAction(ActionFactory.createAcceptAction(new AcceptProvider() {
public ConnectorState isAcceptable(Widget widget, Point point, Transferable transferable) {
Image dragImage = getImageFromTransferable(transferable);
JComponent view = getView();
Graphics2D g2 = (Graphics2D) view.getGraphics();
Rectangle visRect = view.getVisibleRect();
view.paintImmediately(visRect.x, visRect.y, visRect.width, visRect.height);
g2.drawImage(dragImage,
AffineTransform.getTranslateInstance(point.getLocation().getX(),
point.getLocation().getY()),
null);
return ConnectorState.ACCEPT;
}
public void accept(Widget widget, Point point, Transferable transferable) {
Image image = getImageFromTransferable(transferable);
Widget w = GraphSceneImpl.this.addNode(new MyNode(image));
w.setPreferredLocation(widget.convertLocalToScene(point));
}
}));

Objaví sa nám viacero chýb, a to z toho dôvodu, že sme použili aj metody, ktoré zatiaľ nie sú definované, čiže si chvíľku nevšímajme tieto errory.

2. Teraz do triedy '''GraphSceneImpl''' pridáme pomocnú metódu na získavanie obrázkov:
private Image getImageFromTransferable(Transferable transferable) {
Object o = null;
try {
o = transferable.getTransferData(DataFlavor.imageFlavor);
} catch (IOException ex) {
ex.printStackTrace();
} catch (UnsupportedFlavorException ex) {
ex.printStackTrace();
}
return o instanceof Image ? (Image) o : ImageUtilities.loadImage("org/netbeans/shapesample/palette/shape1.png");
}
Ako vidíme, je tu ošetrená chyba, čiže môžete do org.netbeans.shapesample.palette doplniť obrázok, ktorý sa má objaviť pri chybe, dajte mu meno shape1.png

3. Z dôvodu toho, že máme len 3 obrázky, mohli by sme vytvoriť akoby len 3 prvky, preto si vytvoríme novú triedu s názvom '''MyNode'''. Klikneme na náš '''package shapesample pravým--new---java class''' a bude vypadať takto:
public class MyNode {
private Image image;

public MyNode(Image image) {
this.image = image;
}
public Image getImage() {
return image;
}
}

Klikneme na žltú žiarovku v tejto triede a dáme '''"Add import..."'''

4. Zmeníme teraz v triede '''GraphSceneImpl''' rodiča, od ktorého dedí, čiže jeden z prvý riadkov bude vypadať takto:
public class GraphSceneImpl extends GraphScene<MyNode, String>{...telo triedy...}
čím sme zabezpečili, že naša Node je prijatá cez Visual Library. Teraz sa nám objaví žltá žiarovka aj pri tomto riadku, lebo teraz musíme dediť iné abstraktné metódy, '''čiže klikneme na ňu --implement all abstract methods'''
5. Kedže používame generics, tak klikneme '''pravým na náš projekt--properties--sources''' a presvedčíme sa, že tam máme hodnotu '''Source level = 1.5'''

6. Následne definujeme náš nový Widget (komponent) v triede '''GraphSceneImpl''' a to tak, že tam nájdeme metódu '''protected Widget attachNodeWidget(MyNode node)''' a upravíme ju nasledovne:
protected Widget attachNodeWidget(MyNode node) {
IconNodeWidget widget = new IconNodeWidget(this);
widget.setImage(node.getImage());
widget.setLabel(Long.toString(node.hashCode()));
widget.getActions().addAction(ActionFactory.createMoveAction());
mainLayer.addChild(widget);
return widget;
}
Týmto nášmu Widgetu nastavíme obrázok, a priradíme mu veľké náhodné číslo, a ešte možnosť posúvať ho po našej scéne, a následne po zastavení ho pridať znova ako child.

7. Ešte stále nám ostáva pár žltých žiaroviek, takže klikneme na každú z nich, ktorá tam bude a dáme '''"Add import..."'''

8. Spustíme náš projekt, a už uvidíme, že je možné presúvať komponenty (Widgety) z našej paletty na našu scénku:

== Pridanie funkcionality pre našu scénu ==
1.Teraz pridáme najprv ZOOMaction na našu scénku a to tak, že na koniec '''GraphSceneImpl''' konštruktoru pridáme:
getActions().addAction(ActionFactory.createZoomAction());

Keď spustíme teraz náš projekt, tak pri pridržaní ctrl+ kolieško myši sa nám bude zoomovať naša plocha

2. Pridaním riadku za predošlým :
getActions().addAction(ActionFactory.createPanAction());
Pridáme funkcionalitu, že keď user potlačí kolečko myši, tak potom môže hýbať do hociktorého smeru.

== Pridanie funkcinality pre IconNodeWidget ==
Pre IconNodeWidget sme už pridali funcionalitu pre hýbanie '''MoveAction'''. Tak isto sme schopný pridať aj funkcionalitu pre '''HoverAction, SelectAction, a InplaceEditorAction''', v poradí (nadídenie, vybranie, premenovanie)
1. Najprv na úrovni triedy definujte
private WidgetAction editorAction = ActionFactory.createInplaceEditorAction(new LabelTextFieldEditor());
Následne sa objaví znova žltá žiarovka, najprv dajte '''"Add import..."''', následne dajte '''"Create class LabelTextFieldEditor..."''' , čo nám pridá do nášho package triedu.
2.Telo tejto triedy '''LabelTextFieldEditor''' zmeníme nasledovne:
class LabelTextFieldEditor implements TextFieldInplaceEditor {
public boolean isEnabled(Widget widget) {
return true;
}
public String getText(Widget widget) {
return ((LabelWidget) widget).getLabel();
}
public void setText(Widget widget, String text) {
((LabelWidget) widget).setLabel(text);
}
}
Znovu sa v tejto triede objaví zopár žltých žiaroviek, poklikajte na '''"add import..."'''

3. Následne priradíme editorAction nášmu IconNodeWidget, a to tak, že na koniec metódy '''protected Widget attachNodeWidget(MyNode node)''' triedy '''GraphSceneImpl''' vložíme tesne nad riadok ''' mainLayer.addChild(widget);''' nasledujúci kód:
widget.getLabelWidget().getActions().addAction(editorAction);

4. Následne Hower, Clicked action dolníme tak, že po vyššie doplnenom riadku dáme tieto dva:
widget.getActions().addAction(createSelectAction());
widget.getActions().addAction(createObjectHoverAction());

5. Teraz musíme trochu premyslieť poradie, v ktorom sme akcie pridali, info tu [http://bits.netbeans.org/dev/javadoc/org-netbeans-api-visual/org/netbeans/api/visual/widget/doc-files/documentation.html#OrderOfActions]
A následne bude naša metóda '''protected Widget attachNodeWidget''' vypadať nasledovne
protected Widget attachNodeWidget(MyNode node) {
IconNodeWidget widget = new IconNodeWidget(this);
widget.setImage(node.getImage());
widget.setLabel(Long.toString(node.hashCode()));
//double-click, event sa spustí len pri doubleclicku:
widget.getLabelWidget().getActions().addAction(editorAction);
//single-click, event sa spustí pri single clicku
widget.getActions().addAction(createSelectAction());
//mouse-dragged
widget.getActions().addAction(ActionFactory.createMoveAction());
//mouse-over,
widget.getActions().addAction(createObjectHoverAction());
mainLayer.addChild(widget);
return widget;
}

6. Po spustení to bude môcť vypadať takto napr. 
[[Súbor:Ytb desat.png]]

== Záver a riešenie problémov ==

Ukázali sme v skutku len veľmi strohú ukážku, čo by sa s NetBeans dalo spraviť, ale keďže je to problematika, ktorou by sa mali zaoberať knihy pre pokročilejších programátorov, tak tu skončíme.

V prípade nejasností je vždy dobré sa obráti na stránku NetBeans tutorials [http://netbeans.org/kb/trails/platform.html]

V prípade problémov, resp. riešenia chýb uvedeného návodu, '''odporúčam použiť VYTVORENY FUNKCNY MODUL''' 
'''Download:''' [http://plugins.netbeans.org/PluginPortal/faces/PluginDetailPage.jsp?pluginid=14027] 
'''Inštalácia:''' Spustite '''NetBeans--Tools--Plugins--kliknite Downloaded--Add Plugins...--nájdite stiahnutý--install''' 
'''Spustenie pluginu:''' '''Spustite NetBeans--File--New Project--Samples--NetBeansModule--Visual Library Demo''' 
 
V prípade nejasností, je tam všetko štruktúrované ako v našom návode, čiže by ste tam mali nájsť svoju chybu dosť rýchlo a prehľadne. 
 

Zdroj:[http://platform.netbeans.org/tutorials/nbm-visual_library.html]

Základy práce s NetBeans IDE a vývoj modulov

2010-04-27T19:13:51Z

Pokoraczki1: /* Vytvorenie a spustenie projektu */

== NetBeans IDE ==
NetBeans je krásne vývojové prostredie, ktorého hlavnou výhodou je jeho modulárna architektúra. Ďalším skvelým prvkom je, že sa spolieha na toolkit SWING UI, čo nám dokopy dáva obrovské výhody.

V tomto článku sa posnažím ukázať, ako možno vytvoriť jednoduchý modul pre NetBeans, ktorý bude iba strohá ukážka toho, čo sa s NetBeans dá robit.

== Požiadavky na postup článkom ==
1. NetBeans IDE ( použitá verzia 6.8 ) 
2. Java_jdk ( použitá verzia 1.6.0.18 ) 
3. Základné znalosti jazyka JAVA

== Vytvorenie a spustenie projektu ==
1. Začneme spustením Netbeans a zvolíme '''File--New Project--NetBeans Modules--Module''' 
<center>
{|class="wikitable"
| align="center" width=450 | [[Súbor:Ytb prvy.png | 400px]]
|}
</center>

2. Klikneme na tlačítko "NEXT", pomenujeme si náš projekt napr. "ShapeSample", nastavíme ho ako "'''main project'''" a vyberieme si umiestnenie, kde ho chceme uložiť a ponecháme '''Standalone Module'''
<center>
{|class="wikitable"
| align="center" width=450 | [[Súbor:Ytb druhy.png | 400px]]
|}
</center>

3. Klikneme "NEXT", zadáme do "Code Name Base" '''org.netbeans.shapesample''', a dôležité, klikneme na '''Generate XML Layer'''. Následne klikneme na tlačítko finish, a vytvorí sa nám projekt.
<center>
{|class="wikitable"
| align="center" width=450 | [[Súbor:Ytb treti.png | 400px]]
|}
</center>

4. V okne "Project" , '''klikneme pravým na "ShapeSample"--Properties--Libraries'''. Module Dependencies klikneme na tlačítko "ADD" a pridáme: 
''a/ Visual Library API 
b/ Utilities API ''
Klikneme na tlačítko OK, čo nám pridá odkazy. 

5. Znova v "Project" window '''klikneme pravým na "ShapeSample"--New--Other--Module Development--Window Component''' , klikneme "NEXT" 

6. Ako Windows Position dáme '''editor''' a zaškrtneme '''Open on application start''' a klikneme "NEXT" 

7.Do políčka "Class Name Prefix" dopíšeme '''Shape''', klikneme na tlačítko "FINISH" 

8. Vygeneruje sa nám viacero súbor, jedným z nich je '''ShapeTopComponent''', 2krát naň klikneme a otvoríme ho v design view. 

9. V design view, pravým klikneme na okno akoby a dáme '''Set Layout--Border Layout''' 
<center>
{|class="wikitable"
| align="center" width=450 | [[Súbor:Ytb stvrty.png | 400px]]
|}
</center>

== Vytvorenie scény ==
1. Využijeme okno "'''Pallete'''" (ak nie je zobrazené dáme window---pallete) a vložíme na naš layout '''ScrollPane'''. V okne "Inspector" klikneme pravým na jScrollPane1--Change Variable Name a nastavíme hodnotu na "shapePane".

2.V "Project" windows na zložku''' org--netbeans--shapesample''' klikneme pravým a dáme '''new--Java Class''', pomenujme ju "'''GraphSceneImpl'''", a po vytvorení dopíšme do triedy '''extends GraphScene'''

3. Žltá žiarovka s červeným výkričníkom sa nám objaví naľavo v editore, klikneme na ňu, a dáme "'''add Import...'''" 
Následne sa dám objaví ďalšia žltá žiarovka, klikneme na ňu a dáme "'''Implement all abstract methods'''" 
[[Súbor:Ytb piaty.png]]

4. Pre lepšiu orientáciu zmeníme názvy parametrov vygenerovaných NetBeans, a po úprave bude naša trieda vypadať takto: 

public class GraphSceneImpl extends GraphScene
{

public GraphSceneImpl() {
}

protected Widget attachNodeWidget(Object node) {
return null;
}

protected Widget attachEdgeWidget(Object edge) {
return null;
}

protected void attachEdgeSourceAnchor(Object edge, Object oldSourceNode, Object newSourceNode) {

}

protected void attachEdgeTargetAnchor(Object edge, Object oldTargetNode, Object newTargetNode) {

}
}

5.Vrátime sa k ShapeTopComponent, kde sa budeme starať o instanciu GraphSceneImpl , prepneme Design View na SourceView, a nájdeme jeho konštruktor. Do tela konštruktora doplnime nasledujúce riadky:
GraphSceneImpl scene = new GraphSceneImpl();
myView = scene.createView();
shapePane.setViewportView(myView);
add(scene.createSatelliteView(), BorderLayout.WEST);

Týmto sme vytvorili 2 náhľady, jeden veľký, a jeden akoby informačný na ľavej strane, ktorý pomôže používateľovi rýchlejšie sa pohybovať po väčšom rozpätí.

6. Na '''úrovni triedy ShapeTopComponent''' deklarujeme (doplníme napr. hneď nad konštruktor)
private JComponent myView;

Ostanú nám ešte 2 žlté žiarovky, klikneme na každú z nich, a dáme "'''Add Import...'''"

7. Teraz musíme ošetriť, že ak sa NetBeans IDE reštartuje, nemáme žiadny dôvod aby ShapeTopComponent pretrvával, čiže nájdeme metódu '''getPersistenceType()''' v tele triedy, a zmeníme ju nasledovne:
public int getPersistenceType() {
return TopComponent.PERSISTENCE_NEVER;
}

8. Klikneme v "Project" window na náš projekt '''ShapeSample pravým--run'''

9. Nezlaknite sa, spustí sa nová inštancia NetBeans IDE(ak nie je náš projekt už otvorený kliknite na '''window---Shape''') a zobrazí sa Vám niečo takéto: 
[[Súbor:Ytb siesty.png]]

== Vytváranie Palety pre našu scénu ==

Teraz aby sme pokračovali niečím užitočným, vytvoríme si palletu, na čo využijeme Pallete API, ktorá bude obsahovať komponenty, ktoré môžeme použiť a pridať na našu scénu pretiahnutím.
Pre ďalšie pokračovanie budeme potrebovať 3 obrázky našich komponentov, použime tieto(kliknite pravým---uložiť ako, nemente názvy):
[[Súbor:Image1.png]][[Súbor:Image2.png]][[Súbor:Image3.png]]

'''Keďže náš tutoriál sa zaoberá s Visual Library API, a nie s Palette API(info tu:[http://netbeans.org/kb/trails/platform.html] ), na funkcionalitu Paletty použijeme už hotové knižnice, ktoré stiahnete tu''':
[http://www.sendspace.com/file/dqtnbi] (v prípade, že je link nefunkčný, na konci článku je hotový plugin pre tento modul, knižnice vytiahnite z neho)

1. Klikneme na náš projekt pravým--new--Java Package a pomenujeme ho '''org.netbeans.shapesample.palette'''
2. Teraz podme do zložky, kde sme nás projekt uložili, konkrétne '''násProjekt/src/org/netbeans/shapesample/pallete'''. A do tejto''' zložky nakopírujeme stiahnuté obrázky a následne aj knižnice''', čiže tieto súbory: 
a/ Category 
b/ CategoryChildren 
c/ CategoryNode 
d/ PaletteSupport 
e/ Shape 
f/ ShapeChildren 
g/ ShapeNode 
h/ image1, image2, image3 
po zobrazení NetBeans sa nám novo vytvorený package obnoví, a budeme tam mať načítané všetky vložené súbory, pričom niekde sa znovu objavia červené krúžky so žiarovkou, to si nevšímajme chvíľku

3. Klikneme '''pravým na projekt--Properties--Libraries--Add''' a pridáme nasledujúce knižnice: 
a/ Actions APIs 
b/ Nodes API 
c/ Common Palette 
Teraz by sme mali spozorovať, že všetky červené guličky nám zmiznú, a bude nám to vypadať nasledovne: 
[[Súbor:Ytb siedmy.png]]

4. Teraz pridáme našu Palettu do ShapeTopComponentovho náhľadu, a to tak, že do konštruktoru ShapeTopComponent kod
associateLookup( Lookups.fixed( new Object[] { PaletteSupport.createPalette() } ) );

5. Znova sa nám objaví žltá žiarovka, klikneme na ňu dáme "Add import...", následne sa tam objaví znova, čiže znova klikneme a dáme "Add import..."

6. Spustite modul znova(pravým--run), teraz by to už malo vypadať takto, no zatiaľ bez funkcionality, pretože potrebujeme Layer Widget: 
[[Súbor:Ytb osmy.png]]

== Pridanie LayerWidget ==

Pod pojmom LayerWidget si predstavte niečo priesvitné, na ktoré budeme môcť ukladať naše komponenty s paletty.

1. Ná úrovni triedy GraphSceneImpl deklarujte náš LayerWidget
private LayerWidget mainLayer;

2. Do konštruktoru GraphSceneImpl pridajte LayerWidget ako dieťa našej scény:
mainLayer = new LayerWidget (this);
addChild (mainLayer);

Teraz keď pridáme na scénu nejaký komponent s našej paletty , pridajú sa ako deti do našel mainLayer.

== Pridanie IconNodeWidget (komponentu) cez funkcionalitu Drag and Drop (chyť a hoď) ==

Doposiaľ, naša scéna existuje, ale nemá žiadnu funkcionalitu. Túto funkcionalitu pridáme pomocou '''"actions"'''. Action, ktorá nám umožnuje Drag & Drop funkcionalitu je '''AcceptAction''' . Táto action môže byť aplikovaná buď na náš komponent alebo na našu scénu. My ju budeme aplikovať na našu scénu. Využijeme '''createAcceptAction''' na to, aby sme definovali čo sa má stať po tom, ako je komponent pretiahnutý nad našu scénu.

1. Najprv pridajte '''createAcceptAction''' spolu s jeho dvomi metódami do GraphSceneImpl konštruktoru:
getActions().addAction(ActionFactory.createAcceptAction(new AcceptProvider() {
public ConnectorState isAcceptable(Widget widget, Point point, Transferable transferable) {
Image dragImage = getImageFromTransferable(transferable);
JComponent view = getView();
Graphics2D g2 = (Graphics2D) view.getGraphics();
Rectangle visRect = view.getVisibleRect();
view.paintImmediately(visRect.x, visRect.y, visRect.width, visRect.height);
g2.drawImage(dragImage,
AffineTransform.getTranslateInstance(point.getLocation().getX(),
point.getLocation().getY()),
null);
return ConnectorState.ACCEPT;
}
public void accept(Widget widget, Point point, Transferable transferable) {
Image image = getImageFromTransferable(transferable);
Widget w = GraphSceneImpl.this.addNode(new MyNode(image));
w.setPreferredLocation(widget.convertLocalToScene(point));
}
}));

Objaví sa nám viacero chýb, a to z toho dôvodu, že sme použili aj metody, ktoré zatiaľ nie sú definované, čiže si chvíľku nevšímajme tieto errory.

2. Teraz do triedy '''GraphSceneImpl''' pridáme pomocnú metódu na získavanie obrázkov:
private Image getImageFromTransferable(Transferable transferable) {
Object o = null;
try {
o = transferable.getTransferData(DataFlavor.imageFlavor);
} catch (IOException ex) {
ex.printStackTrace();
} catch (UnsupportedFlavorException ex) {
ex.printStackTrace();
}
return o instanceof Image ? (Image) o : ImageUtilities.loadImage("org/netbeans/shapesample/palette/shape1.png");
}
Ako vidíme, je tu ošetrená chyba, čiže môžete do org.netbeans.shapesample.palette doplniť obrázok, ktorý sa má objaviť pri chybe, dajte mu meno shape1.png

3. Z dôvodu toho, že máme len 3 obrázky, mohli by sme vytvoriť akoby len 3 prvky, preto si vytvoríme novú triedu s názvom '''MyNode'''. Klikneme na náš '''package shapesample pravým--new---java class''' a bude vypadať takto:
public class MyNode {
private Image image;

public MyNode(Image image) {
this.image = image;
}
public Image getImage() {
return image;
}
}

Klikneme na žltú žiarovku v tejto triede a dáme '''"Add import..."'''

4. Zmeníme teraz v triede '''GraphSceneImpl''' rodiča, od ktorého dedí, čiže jeden z prvý riadkov bude vypadať takto:
public class GraphSceneImpl extends GraphScene<MyNode, String>{...telo triedy...}
čím sme zabezpečili, že naša Node je prijatá cez Visual Library. Teraz sa nám objaví žltá žiarovka aj pri tomto riadku, lebo teraz musíme dediť iné abstraktné metódy, '''čiže klikneme na ňu --implement all abstract methods'''
5. Kedže používame generics, tak klikneme '''pravým na náš projekt--properties--sources''' a presvedčíme sa, že tam máme hodnotu '''Source level = 1.5'''

6. Následne definujeme náš nový Widget (komponent) v triede '''GraphSceneImpl''' a to tak, že tam nájdeme metódu '''protected Widget attachNodeWidget(MyNode node)''' a upravíme ju nasledovne:
protected Widget attachNodeWidget(MyNode node) {
IconNodeWidget widget = new IconNodeWidget(this);
widget.setImage(node.getImage());
widget.setLabel(Long.toString(node.hashCode()));
widget.getActions().addAction(ActionFactory.createMoveAction());
mainLayer.addChild(widget);
return widget;
}
Týmto nášmu Widgetu nastavíme obrázok, a priradíme mu veľké náhodné číslo, a ešte možnosť posúvať ho po našej scéne, a následne po zastavení ho pridať znova ako child.

7. Ešte stále nám ostáva pár žltých žiaroviek, takže klikneme na každú z nich, ktorá tam bude a dáme '''"Add import..."'''

8. Spustíme náš projekt, a už uvidíme, že je možné presúvať komponenty (Widgety) z našej paletty na našu scénku:

== Pridanie funkcionality pre našu scénu ==
1.Teraz pridáme najprv ZOOMaction na našu scénku a to tak, že na koniec '''GraphSceneImpl''' konštruktoru pridáme:
getActions().addAction(ActionFactory.createZoomAction());

Keď spustíme teraz náš projekt, tak pri pridržaní ctrl+ kolieško myši sa nám bude zoomovať naša plocha

2. Pridaním riadku za predošlým :
getActions().addAction(ActionFactory.createPanAction());
Pridáme funkcionalitu, že keď user potlačí kolečko myši, tak potom môže hýbať do hociktorého smeru.

== Pridanie funkcinality pre IconNodeWidget ==
Pre IconNodeWidget sme už pridali funcionalitu pre hýbanie '''MoveAction'''. Tak isto sme schopný pridať aj funkcionalitu pre '''HoverAction, SelectAction, a InplaceEditorAction''', v poradí (nadídenie, vybranie, premenovanie)
1. Najprv na úrovni triedy definujte
private WidgetAction editorAction = ActionFactory.createInplaceEditorAction(new LabelTextFieldEditor());
Následne sa objaví znova žltá žiarovka, najprv dajte '''"Add import..."''', následne dajte '''"Create class LabelTextFieldEditor..."''' , čo nám pridá do nášho package triedu.
2.Telo tejto triedy '''LabelTextFieldEditor''' zmeníme nasledovne:
class LabelTextFieldEditor implements TextFieldInplaceEditor {
public boolean isEnabled(Widget widget) {
return true;
}
public String getText(Widget widget) {
return ((LabelWidget) widget).getLabel();
}
public void setText(Widget widget, String text) {
((LabelWidget) widget).setLabel(text);
}
}
Znovu sa v tejto triede objaví zopár žltých žiaroviek, poklikajte na '''"add import..."'''

3. Následne priradíme editorAction nášmu IconNodeWidget, a to tak, že na koniec metódy '''protected Widget attachNodeWidget(MyNode node)''' triedy '''GraphSceneImpl''' vložíme tesne nad riadok ''' mainLayer.addChild(widget);''' nasledujúci kód:
widget.getLabelWidget().getActions().addAction(editorAction);

4. Následne Hower, Clicked action dolníme tak, že po vyššie doplnenom riadku dáme tieto dva:
widget.getActions().addAction(createSelectAction());
widget.getActions().addAction(createObjectHoverAction());

5. Teraz musíme trochu premyslieť poradie, v ktorom sme akcie pridali, info tu [http://bits.netbeans.org/dev/javadoc/org-netbeans-api-visual/org/netbeans/api/visual/widget/doc-files/documentation.html#OrderOfActions]
A následne bude naša metóda '''protected Widget attachNodeWidget''' vypadať nasledovne
protected Widget attachNodeWidget(MyNode node) {
IconNodeWidget widget = new IconNodeWidget(this);
widget.setImage(node.getImage());
widget.setLabel(Long.toString(node.hashCode()));
//double-click, event sa spustí len pri doubleclicku:
widget.getLabelWidget().getActions().addAction(editorAction);
//single-click, event sa spustí pri single clicku
widget.getActions().addAction(createSelectAction());
//mouse-dragged
widget.getActions().addAction(ActionFactory.createMoveAction());
//mouse-over,
widget.getActions().addAction(createObjectHoverAction());
mainLayer.addChild(widget);
return widget;
}

6. Po spustení to bude môcť vypadať takto napr. 
[[Súbor:Ytb desat.png]]

== Záver a riešenie problémov ==

Ukázali sme v skutku len veľmi strohú ukážku, čo by sa s NetBeans dalo spraviť, ale keďže je to problematika, ktorou by sa mali zaoberať knihy pre pokročilejších programátorov, tak tu skončíme.

V prípade nejasností je vždy dobré sa obráti na stránku NetBeans tutorials [http://netbeans.org/kb/trails/platform.html]

V prípade problémov, resp. riešenia chýb uvedeného návodu, '''odporúčam použiť VYTVORENY FUNKCNY MODUL''' 
'''Download:''' [http://plugins.netbeans.org/PluginPortal/faces/PluginDetailPage.jsp?pluginid=14027] 
'''Inštalácia:''' Spustite '''NetBeans--Tools--Plugins--kliknite Downloaded--Add Plugins...--nájdite stiahnutý--install''' 
'''Spustenie pluginu:''' '''Spustite NetBeans--File--New Project--Samples--NetBeansModule--Visual Library Demo''' 
 
V prípade nejasností, je tam všetko štruktúrované ako v našom návode, čiže by ste tam mali nájsť svoju chybu dosť rýchlo a prehľadne. 
 

Zdroj:[http://platform.netbeans.org/tutorials/nbm-visual_library.html]

Základy informatiky - jazyk Java

2010-04-27T12:47:34Z

Pokoraczki1: /* Obsah prednášky */

[[Category:Java]]

<properties>
Názov=Základy informatiky - programovanie v jazyku Java
Forma=Podklady k prednáškam a cvičeniam
Abstrakt= Úvod do programovania, operačný systém, aplikácia, zdrojový kód, kompilovanie a spustenie programu. Syntax jazyka Java. Elementy programovacieho jazyka, identifikátory, klúčové slová, operátory. Dátové typy a ich rozdelenie. Výrazy a poradie vyhodnocovania výrazov. Deklarácie premenných a polí. Riadenie toku, bloky, podmienkové a logické výrazy. Triedy a objekty tried. Výnimky spracovanie výnimiek. Java API, aplikácie a applety.
Rozvrh=3/0/2
Hodnotenie=Skúška
Poznámky=Prvú verziu tohoto kurzu vyvoril [http://www.facebook.com/Peter.Pazak RNDr. Peter Pažák] ako podklady k cvičeniam z predmetu Základy programovania na FMFI UK . Pretože pôvodý text svojim rozsahom a kvalitou spracovania vysoko prevyšoval požiadavky na štandardné podklady ku cvičeniam, po konverzii do wiki je základným učebným textom k prednáške. Pokiaľ by ste chceli pôvodný text rozširovať, doplňovať o vlastné príklady a úlohy, stante sa redaktorom serveru kiwiki.
</properties>
{{Draft}}

== Obsah prednášky ==
* [[Uvod do programovania v jazyku Java]]
** Základné pojmy
** Zdrojový kód
** Kompilácia a spustenie programu
* [[Syntax jazyka Java]]
** Elementy programovacieho jazyka Java
** Kľúčové slová jazyka Java
** Primitívne dátové typy a operátory
** Bloky, vetvenie toku programu a cykly
* [[Triedy a objekty]]
** Deklarácia triedy
** Vytváranie objektov
** Hodnoty a referencie
** Polia
* [[Vytváranie vlastných tried]]
** Trieda Ratio
* [[Dedičnosť a vzťahy medzi triedami]]
** [[Základy práce s NetBeans IDE a vývoj modulov]]

== Doporučená literatúra a odkazy ==

'''WWW'''
* [http://java.sun.com/ Java] - Domáca stránka, dokumentácia, tútoriály ... všetko na jednej kope
* [http://www.particle.kth.se/~lindsey/JavaCourse/Book/courseMap.html JavaTech] - Interaktívny kurz Javy

'''Voľne dostupné učebnice a knihy'''
*[http://www.root.cz/knihy/thinking-in-java/ Thinking in Java]
* [http://www.freeprogrammingresources.com/javabook.html Zoznam voľne dostupnej literatúry]

'''Pomôcky, programy'''
* [http://netbeans.org/ NetBeans IDE] - Domáca stránka komplexného vývojového prostredia
* [http://www.scintilla.org/SciTE.html SciTe] - Jednoduchý multiplatformový programátorský editor
* [http://www.geany.org/ Geany] - Jednoduché multiplatformové vývojové prostredie

Podklady k prednáškam a cvičeniam

2010-04-27T12:46:41Z

Pokoraczki1:

[[Kategória:Študijné materiály]]
== Cvičenia, semináre, návody a iné múdre texty==

* [[Algoritmy a programovanie]]
* [[Databázové systémy - poznámky k Oracle SQL]]
* [[Konfigurovateľné mikroprocesorové systémy]]
* [[Logické a číslicové systémy ]]
* [[Objektovo orientované programovanie]]
* [[Operačné systémy]]
* [[Simulácie a modelovanie]] pre elektroniku a elektrotechniku
* [[Softvérové inžinierstvo]]
* [[Spolupráca počítača s prostredím]]
* [[Webovské technológie]]
* [[Základy informatiky - jazyk C]]
* [[Základy informatiky - jazyk Java]]
* [[Základy informatiky - jazyk Python]]

Základy práce s NetBeans IDE a vývoj modulov

2010-04-26T06:39:23Z

Pokoraczki1: /* Záver a riešenie problémov */

== NetBeans IDE ==
NetBeans je krásne vývojové prostredie, ktorého hlavnou výhodou je jeho modulárna architektúra. Ďalším skvelým prvkom je, že sa spolieha na toolkit SWING UI, čo nám dokopy dáva obrovské výhody.

V tomto článku sa posnažím ukázať, ako možno vytvoriť jednoduchý modul pre NetBeans, ktorý bude iba strohá ukážka toho, čo sa s NetBeans dá robit.

== Požiadavky na postup článkom ==
1. NetBeans IDE ( použitá verzia 6.8 ) 
2. Java_jdk ( použitá verzia 1.6.0.18 ) 
3. Základné znalosti jazyka JAVA

== Vytvorenie a spustenie projektu ==
1. Začneme spustením Netbeans a zvolíme '''File--New Project--NetBeans Modules--Module''' 
[[Súbor:Ytb prvy.png]]

2. Klikneme na tlačítko "NEXT", pomenujeme si náš projekt napr. "ShapeSample", nastavíme ho ako "'''main project'''" a vyberieme si umiestnenie, kde ho chceme uložiť a ponecháme '''Standalone Module'''
[[Súbor:Ytb druhy.png]]

3. Klikneme "NEXT", zadáme do "Code Name Base" '''org.netbeans.shapesample''', a dôležité, klikneme na '''Generate XML Layer'''. Následne klikneme na tlačítko finish, a vytvorí sa nám projekt.
[[Súbor:Ytb treti.png]]

4. V okne "Project" , '''klikneme pravým na "ShapeSample"--Properties--Libraries'''. Module Dependencies klikneme na tlačítko "ADD" a pridáme: 
''a/ Visual Library API 
b/ Utilities API ''
Klikneme na tlačítko OK, čo nám pridá odkazy. 

5. Znova v "Project" window '''klikneme pravým na "ShapeSample"--New--Other--Module Development--Window Component''' , klikneme "NEXT" 

6. Ako Windows Position dáme '''editor''' a zaškrtneme '''Open on application start''' a klikneme "NEXT" 

7.Do políčka "Class Name Prefix" dopíšeme '''Shape''', klikneme na tlačítko "FINISH" 

8. Vygeneruje sa nám viacero súbor, jedným z nich je '''ShapeTopComponent''', 2krát naň klikneme a otvoríme ho v design view. 

9. V design view, pravým klikneme na okno akoby a dáme '''Set Layout--Border Layout''' 
[[Súbor:Ytb stvrty.png]]

== Vytvorenie scény ==
1. Využijeme okno "'''Pallete'''" (ak nie je zobrazené dáme window---pallete) a vložíme na naš layout '''ScrollPane'''. V okne "Inspector" klikneme pravým na jScrollPane1--Change Variable Name a nastavíme hodnotu na "shapePane".

2.V "Project" windows na zložku''' org--netbeans--shapesample''' klikneme pravým a dáme '''new--Java Class''', pomenujme ju "'''GraphSceneImpl'''", a po vytvorení dopíšme do triedy '''extends GraphScene'''

3. Žltá žiarovka s červeným výkričníkom sa nám objaví naľavo v editore, klikneme na ňu, a dáme "'''add Import...'''" 
Následne sa dám objaví ďalšia žltá žiarovka, klikneme na ňu a dáme "'''Implement all abstract methods'''" 
[[Súbor:Ytb piaty.png]]

4. Pre lepšiu orientáciu zmeníme názvy parametrov vygenerovaných NetBeans, a po úprave bude naša trieda vypadať takto: 

public class GraphSceneImpl extends GraphScene
{

public GraphSceneImpl() {
}

protected Widget attachNodeWidget(Object node) {
return null;
}

protected Widget attachEdgeWidget(Object edge) {
return null;
}

protected void attachEdgeSourceAnchor(Object edge, Object oldSourceNode, Object newSourceNode) {

}

protected void attachEdgeTargetAnchor(Object edge, Object oldTargetNode, Object newTargetNode) {

}
}

5.Vrátime sa k ShapeTopComponent, kde sa budeme starať o instanciu GraphSceneImpl , prepneme Design View na SourceView, a nájdeme jeho konštruktor. Do tela konštruktora doplnime nasledujúce riadky:
GraphSceneImpl scene = new GraphSceneImpl();
myView = scene.createView();
shapePane.setViewportView(myView);
add(scene.createSatelliteView(), BorderLayout.WEST);

Týmto sme vytvorili 2 náhľady, jeden veľký, a jeden akoby informačný na ľavej strane, ktorý pomôže používateľovi rýchlejšie sa pohybovať po väčšom rozpätí.

6. Na '''úrovni triedy ShapeTopComponent''' deklarujeme (doplníme napr. hneď nad konštruktor)
private JComponent myView;

Ostanú nám ešte 2 žlté žiarovky, klikneme na každú z nich, a dáme "'''Add Import...'''"

7. Teraz musíme ošetriť, že ak sa NetBeans IDE reštartuje, nemáme žiadny dôvod aby ShapeTopComponent pretrvával, čiže nájdeme metódu '''getPersistenceType()''' v tele triedy, a zmeníme ju nasledovne:
public int getPersistenceType() {
return TopComponent.PERSISTENCE_NEVER;
}

8. Klikneme v "Project" window na náš projekt '''ShapeSample pravým--run'''

9. Nezlaknite sa, spustí sa nová inštancia NetBeans IDE(ak nie je náš projekt už otvorený kliknite na '''window---Shape''') a zobrazí sa Vám niečo takéto: 
[[Súbor:Ytb siesty.png]]

== Vytváranie Palety pre našu scénu ==

Teraz aby sme pokračovali niečím užitočným, vytvoríme si palletu, na čo využijeme Pallete API, ktorá bude obsahovať komponenty, ktoré môžeme použiť a pridať na našu scénu pretiahnutím.
Pre ďalšie pokračovanie budeme potrebovať 3 obrázky našich komponentov, použime tieto(kliknite pravým---uložiť ako, nemente názvy):
[[Súbor:Image1.png]][[Súbor:Image2.png]][[Súbor:Image3.png]]

'''Keďže náš tutoriál sa zaoberá s Visual Library API, a nie s Palette API(info tu:[http://netbeans.org/kb/trails/platform.html] ), na funkcionalitu Paletty použijeme už hotové knižnice, ktoré stiahnete tu''':
[http://www.sendspace.com/file/dqtnbi] (v prípade, že je link nefunkčný, na konci článku je hotový plugin pre tento modul, knižnice vytiahnite z neho)

1. Klikneme na náš projekt pravým--new--Java Package a pomenujeme ho '''org.netbeans.shapesample.palette'''
2. Teraz podme do zložky, kde sme nás projekt uložili, konkrétne '''násProjekt/src/org/netbeans/shapesample/pallete'''. A do tejto''' zložky nakopírujeme stiahnuté obrázky a následne aj knižnice''', čiže tieto súbory: 
a/ Category 
b/ CategoryChildren 
c/ CategoryNode 
d/ PaletteSupport 
e/ Shape 
f/ ShapeChildren 
g/ ShapeNode 
h/ image1, image2, image3 
po zobrazení NetBeans sa nám novo vytvorený package obnoví, a budeme tam mať načítané všetky vložené súbory, pričom niekde sa znovu objavia červené krúžky so žiarovkou, to si nevšímajme chvíľku

3. Klikneme '''pravým na projekt--Properties--Libraries--Add''' a pridáme nasledujúce knižnice: 
a/ Actions APIs 
b/ Nodes API 
c/ Common Palette 
Teraz by sme mali spozorovať, že všetky červené guličky nám zmiznú, a bude nám to vypadať nasledovne: 
[[Súbor:Ytb siedmy.png]]

4. Teraz pridáme našu Palettu do ShapeTopComponentovho náhľadu, a to tak, že do konštruktoru ShapeTopComponent kod
associateLookup( Lookups.fixed( new Object[] { PaletteSupport.createPalette() } ) );

5. Znova sa nám objaví žltá žiarovka, klikneme na ňu dáme "Add import...", následne sa tam objaví znova, čiže znova klikneme a dáme "Add import..."

6. Spustite modul znova(pravým--run), teraz by to už malo vypadať takto, no zatiaľ bez funkcionality, pretože potrebujeme Layer Widget: 
[[Súbor:Ytb osmy.png]]

== Pridanie LayerWidget ==

Pod pojmom LayerWidget si predstavte niečo priesvitné, na ktoré budeme môcť ukladať naše komponenty s paletty.

1. Ná úrovni triedy GraphSceneImpl deklarujte náš LayerWidget
private LayerWidget mainLayer;

2. Do konštruktoru GraphSceneImpl pridajte LayerWidget ako dieťa našej scény:
mainLayer = new LayerWidget (this);
addChild (mainLayer);

Teraz keď pridáme na scénu nejaký komponent s našej paletty , pridajú sa ako deti do našel mainLayer.

== Pridanie IconNodeWidget (komponentu) cez funkcionalitu Drag and Drop (chyť a hoď) ==

Doposiaľ, naša scéna existuje, ale nemá žiadnu funkcionalitu. Túto funkcionalitu pridáme pomocou '''"actions"'''. Action, ktorá nám umožnuje Drag & Drop funkcionalitu je '''AcceptAction''' . Táto action môže byť aplikovaná buď na náš komponent alebo na našu scénu. My ju budeme aplikovať na našu scénu. Využijeme '''createAcceptAction''' na to, aby sme definovali čo sa má stať po tom, ako je komponent pretiahnutý nad našu scénu.

1. Najprv pridajte '''createAcceptAction''' spolu s jeho dvomi metódami do GraphSceneImpl konštruktoru:
getActions().addAction(ActionFactory.createAcceptAction(new AcceptProvider() {
public ConnectorState isAcceptable(Widget widget, Point point, Transferable transferable) {
Image dragImage = getImageFromTransferable(transferable);
JComponent view = getView();
Graphics2D g2 = (Graphics2D) view.getGraphics();
Rectangle visRect = view.getVisibleRect();
view.paintImmediately(visRect.x, visRect.y, visRect.width, visRect.height);
g2.drawImage(dragImage,
AffineTransform.getTranslateInstance(point.getLocation().getX(),
point.getLocation().getY()),
null);
return ConnectorState.ACCEPT;
}
public void accept(Widget widget, Point point, Transferable transferable) {
Image image = getImageFromTransferable(transferable);
Widget w = GraphSceneImpl.this.addNode(new MyNode(image));
w.setPreferredLocation(widget.convertLocalToScene(point));
}
}));

Objaví sa nám viacero chýb, a to z toho dôvodu, že sme použili aj metody, ktoré zatiaľ nie sú definované, čiže si chvíľku nevšímajme tieto errory.

2. Teraz do triedy '''GraphSceneImpl''' pridáme pomocnú metódu na získavanie obrázkov:
private Image getImageFromTransferable(Transferable transferable) {
Object o = null;
try {
o = transferable.getTransferData(DataFlavor.imageFlavor);
} catch (IOException ex) {
ex.printStackTrace();
} catch (UnsupportedFlavorException ex) {
ex.printStackTrace();
}
return o instanceof Image ? (Image) o : ImageUtilities.loadImage("org/netbeans/shapesample/palette/shape1.png");
}
Ako vidíme, je tu ošetrená chyba, čiže môžete do org.netbeans.shapesample.palette doplniť obrázok, ktorý sa má objaviť pri chybe, dajte mu meno shape1.png

3. Z dôvodu toho, že máme len 3 obrázky, mohli by sme vytvoriť akoby len 3 prvky, preto si vytvoríme novú triedu s názvom '''MyNode'''. Klikneme na náš '''package shapesample pravým--new---java class''' a bude vypadať takto:
public class MyNode {
private Image image;

public MyNode(Image image) {
this.image = image;
}
public Image getImage() {
return image;
}
}

Klikneme na žltú žiarovku v tejto triede a dáme '''"Add import..."'''

4. Zmeníme teraz v triede '''GraphSceneImpl''' rodiča, od ktorého dedí, čiže jeden z prvý riadkov bude vypadať takto:
public class GraphSceneImpl extends GraphScene<MyNode, String>{...telo triedy...}
čím sme zabezpečili, že naša Node je prijatá cez Visual Library. Teraz sa nám objaví žltá žiarovka aj pri tomto riadku, lebo teraz musíme dediť iné abstraktné metódy, '''čiže klikneme na ňu --implement all abstract methods'''
5. Kedže používame generics, tak klikneme '''pravým na náš projekt--properties--sources''' a presvedčíme sa, že tam máme hodnotu '''Source level = 1.5'''

6. Následne definujeme náš nový Widget (komponent) v triede '''GraphSceneImpl''' a to tak, že tam nájdeme metódu '''protected Widget attachNodeWidget(MyNode node)''' a upravíme ju nasledovne:
protected Widget attachNodeWidget(MyNode node) {
IconNodeWidget widget = new IconNodeWidget(this);
widget.setImage(node.getImage());
widget.setLabel(Long.toString(node.hashCode()));
widget.getActions().addAction(ActionFactory.createMoveAction());
mainLayer.addChild(widget);
return widget;
}
Týmto nášmu Widgetu nastavíme obrázok, a priradíme mu veľké náhodné číslo, a ešte možnosť posúvať ho po našej scéne, a následne po zastavení ho pridať znova ako child.

7. Ešte stále nám ostáva pár žltých žiaroviek, takže klikneme na každú z nich, ktorá tam bude a dáme '''"Add import..."'''

8. Spustíme náš projekt, a už uvidíme, že je možné presúvať komponenty (Widgety) z našej paletty na našu scénku:

== Pridanie funkcionality pre našu scénu ==
1.Teraz pridáme najprv ZOOMaction na našu scénku a to tak, že na koniec '''GraphSceneImpl''' konštruktoru pridáme:
getActions().addAction(ActionFactory.createZoomAction());

Keď spustíme teraz náš projekt, tak pri pridržaní ctrl+ kolieško myši sa nám bude zoomovať naša plocha

2. Pridaním riadku za predošlým :
getActions().addAction(ActionFactory.createPanAction());
Pridáme funkcionalitu, že keď user potlačí kolečko myši, tak potom môže hýbať do hociktorého smeru.

== Pridanie funkcinality pre IconNodeWidget ==
Pre IconNodeWidget sme už pridali funcionalitu pre hýbanie '''MoveAction'''. Tak isto sme schopný pridať aj funkcionalitu pre '''HoverAction, SelectAction, a InplaceEditorAction''', v poradí (nadídenie, vybranie, premenovanie)
1. Najprv na úrovni triedy definujte
private WidgetAction editorAction = ActionFactory.createInplaceEditorAction(new LabelTextFieldEditor());
Následne sa objaví znova žltá žiarovka, najprv dajte '''"Add import..."''', následne dajte '''"Create class LabelTextFieldEditor..."''' , čo nám pridá do nášho package triedu.
2.Telo tejto triedy '''LabelTextFieldEditor''' zmeníme nasledovne:
class LabelTextFieldEditor implements TextFieldInplaceEditor {
public boolean isEnabled(Widget widget) {
return true;
}
public String getText(Widget widget) {
return ((LabelWidget) widget).getLabel();
}
public void setText(Widget widget, String text) {
((LabelWidget) widget).setLabel(text);
}
}
Znovu sa v tejto triede objaví zopár žltých žiaroviek, poklikajte na '''"add import..."'''

3. Následne priradíme editorAction nášmu IconNodeWidget, a to tak, že na koniec metódy '''protected Widget attachNodeWidget(MyNode node)''' triedy '''GraphSceneImpl''' vložíme tesne nad riadok ''' mainLayer.addChild(widget);''' nasledujúci kód:
widget.getLabelWidget().getActions().addAction(editorAction);

4. Následne Hower, Clicked action dolníme tak, že po vyššie doplnenom riadku dáme tieto dva:
widget.getActions().addAction(createSelectAction());
widget.getActions().addAction(createObjectHoverAction());

5. Teraz musíme trochu premyslieť poradie, v ktorom sme akcie pridali, info tu [http://bits.netbeans.org/dev/javadoc/org-netbeans-api-visual/org/netbeans/api/visual/widget/doc-files/documentation.html#OrderOfActions]
A následne bude naša metóda '''protected Widget attachNodeWidget''' vypadať nasledovne
protected Widget attachNodeWidget(MyNode node) {
IconNodeWidget widget = new IconNodeWidget(this);
widget.setImage(node.getImage());
widget.setLabel(Long.toString(node.hashCode()));
//double-click, event sa spustí len pri doubleclicku:
widget.getLabelWidget().getActions().addAction(editorAction);
//single-click, event sa spustí pri single clicku
widget.getActions().addAction(createSelectAction());
//mouse-dragged
widget.getActions().addAction(ActionFactory.createMoveAction());
//mouse-over,
widget.getActions().addAction(createObjectHoverAction());
mainLayer.addChild(widget);
return widget;
}

6. Po spustení to bude môcť vypadať takto napr. 
[[Súbor:Ytb desat.png]]

== Záver a riešenie problémov ==

Ukázali sme v skutku len veľmi strohú ukážku, čo by sa s NetBeans dalo spraviť, ale keďže je to problematika, ktorou by sa mali zaoberať knihy pre pokročilejších programátorov, tak tu skončíme.

V prípade nejasností je vždy dobré sa obráti na stránku NetBeans tutorials [http://netbeans.org/kb/trails/platform.html]

V prípade problémov, resp. riešenia chýb uvedeného návodu, '''odporúčam použiť VYTVORENY FUNKCNY MODUL''' 
'''Download:''' [http://plugins.netbeans.org/PluginPortal/faces/PluginDetailPage.jsp?pluginid=14027] 
'''Inštalácia:''' Spustite '''NetBeans--Tools--Plugins--kliknite Downloaded--Add Plugins...--nájdite stiahnutý--install''' 
'''Spustenie pluginu:''' '''Spustite NetBeans--File--New Project--Samples--NetBeansModule--Visual Library Demo''' 
 
V prípade nejasností, je tam všetko štruktúrované ako v našom návode, čiže by ste tam mali nájsť svoju chybu dosť rýchlo a prehľadne. 
 

Zdroj:[http://platform.netbeans.org/tutorials/nbm-visual_library.html]

Základy práce s NetBeans IDE a vývoj modulov

2010-04-26T06:38:58Z

Pokoraczki1: /* Záver a riešenie problémov */

== NetBeans IDE ==
NetBeans je krásne vývojové prostredie, ktorého hlavnou výhodou je jeho modulárna architektúra. Ďalším skvelým prvkom je, že sa spolieha na toolkit SWING UI, čo nám dokopy dáva obrovské výhody.

V tomto článku sa posnažím ukázať, ako možno vytvoriť jednoduchý modul pre NetBeans, ktorý bude iba strohá ukážka toho, čo sa s NetBeans dá robit.

== Požiadavky na postup článkom ==
1. NetBeans IDE ( použitá verzia 6.8 ) 
2. Java_jdk ( použitá verzia 1.6.0.18 ) 
3. Základné znalosti jazyka JAVA

== Vytvorenie a spustenie projektu ==
1. Začneme spustením Netbeans a zvolíme '''File--New Project--NetBeans Modules--Module''' 
[[Súbor:Ytb prvy.png]]

2. Klikneme na tlačítko "NEXT", pomenujeme si náš projekt napr. "ShapeSample", nastavíme ho ako "'''main project'''" a vyberieme si umiestnenie, kde ho chceme uložiť a ponecháme '''Standalone Module'''
[[Súbor:Ytb druhy.png]]

3. Klikneme "NEXT", zadáme do "Code Name Base" '''org.netbeans.shapesample''', a dôležité, klikneme na '''Generate XML Layer'''. Následne klikneme na tlačítko finish, a vytvorí sa nám projekt.
[[Súbor:Ytb treti.png]]

4. V okne "Project" , '''klikneme pravým na "ShapeSample"--Properties--Libraries'''. Module Dependencies klikneme na tlačítko "ADD" a pridáme: 
''a/ Visual Library API 
b/ Utilities API ''
Klikneme na tlačítko OK, čo nám pridá odkazy. 

5. Znova v "Project" window '''klikneme pravým na "ShapeSample"--New--Other--Module Development--Window Component''' , klikneme "NEXT" 

6. Ako Windows Position dáme '''editor''' a zaškrtneme '''Open on application start''' a klikneme "NEXT" 

7.Do políčka "Class Name Prefix" dopíšeme '''Shape''', klikneme na tlačítko "FINISH" 

8. Vygeneruje sa nám viacero súbor, jedným z nich je '''ShapeTopComponent''', 2krát naň klikneme a otvoríme ho v design view. 

9. V design view, pravým klikneme na okno akoby a dáme '''Set Layout--Border Layout''' 
[[Súbor:Ytb stvrty.png]]

== Vytvorenie scény ==
1. Využijeme okno "'''Pallete'''" (ak nie je zobrazené dáme window---pallete) a vložíme na naš layout '''ScrollPane'''. V okne "Inspector" klikneme pravým na jScrollPane1--Change Variable Name a nastavíme hodnotu na "shapePane".

2.V "Project" windows na zložku''' org--netbeans--shapesample''' klikneme pravým a dáme '''new--Java Class''', pomenujme ju "'''GraphSceneImpl'''", a po vytvorení dopíšme do triedy '''extends GraphScene'''

3. Žltá žiarovka s červeným výkričníkom sa nám objaví naľavo v editore, klikneme na ňu, a dáme "'''add Import...'''" 
Následne sa dám objaví ďalšia žltá žiarovka, klikneme na ňu a dáme "'''Implement all abstract methods'''" 
[[Súbor:Ytb piaty.png]]

4. Pre lepšiu orientáciu zmeníme názvy parametrov vygenerovaných NetBeans, a po úprave bude naša trieda vypadať takto: 

public class GraphSceneImpl extends GraphScene
{

public GraphSceneImpl() {
}

protected Widget attachNodeWidget(Object node) {
return null;
}

protected Widget attachEdgeWidget(Object edge) {
return null;
}

protected void attachEdgeSourceAnchor(Object edge, Object oldSourceNode, Object newSourceNode) {

}

protected void attachEdgeTargetAnchor(Object edge, Object oldTargetNode, Object newTargetNode) {

}
}

5.Vrátime sa k ShapeTopComponent, kde sa budeme starať o instanciu GraphSceneImpl , prepneme Design View na SourceView, a nájdeme jeho konštruktor. Do tela konštruktora doplnime nasledujúce riadky:
GraphSceneImpl scene = new GraphSceneImpl();
myView = scene.createView();
shapePane.setViewportView(myView);
add(scene.createSatelliteView(), BorderLayout.WEST);

Týmto sme vytvorili 2 náhľady, jeden veľký, a jeden akoby informačný na ľavej strane, ktorý pomôže používateľovi rýchlejšie sa pohybovať po väčšom rozpätí.

6. Na '''úrovni triedy ShapeTopComponent''' deklarujeme (doplníme napr. hneď nad konštruktor)
private JComponent myView;

Ostanú nám ešte 2 žlté žiarovky, klikneme na každú z nich, a dáme "'''Add Import...'''"

7. Teraz musíme ošetriť, že ak sa NetBeans IDE reštartuje, nemáme žiadny dôvod aby ShapeTopComponent pretrvával, čiže nájdeme metódu '''getPersistenceType()''' v tele triedy, a zmeníme ju nasledovne:
public int getPersistenceType() {
return TopComponent.PERSISTENCE_NEVER;
}

8. Klikneme v "Project" window na náš projekt '''ShapeSample pravým--run'''

9. Nezlaknite sa, spustí sa nová inštancia NetBeans IDE(ak nie je náš projekt už otvorený kliknite na '''window---Shape''') a zobrazí sa Vám niečo takéto: 
[[Súbor:Ytb siesty.png]]

== Vytváranie Palety pre našu scénu ==

Teraz aby sme pokračovali niečím užitočným, vytvoríme si palletu, na čo využijeme Pallete API, ktorá bude obsahovať komponenty, ktoré môžeme použiť a pridať na našu scénu pretiahnutím.
Pre ďalšie pokračovanie budeme potrebovať 3 obrázky našich komponentov, použime tieto(kliknite pravým---uložiť ako, nemente názvy):
[[Súbor:Image1.png]][[Súbor:Image2.png]][[Súbor:Image3.png]]

'''Keďže náš tutoriál sa zaoberá s Visual Library API, a nie s Palette API(info tu:[http://netbeans.org/kb/trails/platform.html] ), na funkcionalitu Paletty použijeme už hotové knižnice, ktoré stiahnete tu''':
[http://www.sendspace.com/file/dqtnbi] (v prípade, že je link nefunkčný, na konci článku je hotový plugin pre tento modul, knižnice vytiahnite z neho)

1. Klikneme na náš projekt pravým--new--Java Package a pomenujeme ho '''org.netbeans.shapesample.palette'''
2. Teraz podme do zložky, kde sme nás projekt uložili, konkrétne '''násProjekt/src/org/netbeans/shapesample/pallete'''. A do tejto''' zložky nakopírujeme stiahnuté obrázky a následne aj knižnice''', čiže tieto súbory: 
a/ Category 
b/ CategoryChildren 
c/ CategoryNode 
d/ PaletteSupport 
e/ Shape 
f/ ShapeChildren 
g/ ShapeNode 
h/ image1, image2, image3 
po zobrazení NetBeans sa nám novo vytvorený package obnoví, a budeme tam mať načítané všetky vložené súbory, pričom niekde sa znovu objavia červené krúžky so žiarovkou, to si nevšímajme chvíľku

3. Klikneme '''pravým na projekt--Properties--Libraries--Add''' a pridáme nasledujúce knižnice: 
a/ Actions APIs 
b/ Nodes API 
c/ Common Palette 
Teraz by sme mali spozorovať, že všetky červené guličky nám zmiznú, a bude nám to vypadať nasledovne: 
[[Súbor:Ytb siedmy.png]]

4. Teraz pridáme našu Palettu do ShapeTopComponentovho náhľadu, a to tak, že do konštruktoru ShapeTopComponent kod
associateLookup( Lookups.fixed( new Object[] { PaletteSupport.createPalette() } ) );

5. Znova sa nám objaví žltá žiarovka, klikneme na ňu dáme "Add import...", následne sa tam objaví znova, čiže znova klikneme a dáme "Add import..."

6. Spustite modul znova(pravým--run), teraz by to už malo vypadať takto, no zatiaľ bez funkcionality, pretože potrebujeme Layer Widget: 
[[Súbor:Ytb osmy.png]]

== Pridanie LayerWidget ==

Pod pojmom LayerWidget si predstavte niečo priesvitné, na ktoré budeme môcť ukladať naše komponenty s paletty.

1. Ná úrovni triedy GraphSceneImpl deklarujte náš LayerWidget
private LayerWidget mainLayer;

2. Do konštruktoru GraphSceneImpl pridajte LayerWidget ako dieťa našej scény:
mainLayer = new LayerWidget (this);
addChild (mainLayer);

Teraz keď pridáme na scénu nejaký komponent s našej paletty , pridajú sa ako deti do našel mainLayer.

== Pridanie IconNodeWidget (komponentu) cez funkcionalitu Drag and Drop (chyť a hoď) ==

Doposiaľ, naša scéna existuje, ale nemá žiadnu funkcionalitu. Túto funkcionalitu pridáme pomocou '''"actions"'''. Action, ktorá nám umožnuje Drag & Drop funkcionalitu je '''AcceptAction''' . Táto action môže byť aplikovaná buď na náš komponent alebo na našu scénu. My ju budeme aplikovať na našu scénu. Využijeme '''createAcceptAction''' na to, aby sme definovali čo sa má stať po tom, ako je komponent pretiahnutý nad našu scénu.

1. Najprv pridajte '''createAcceptAction''' spolu s jeho dvomi metódami do GraphSceneImpl konštruktoru:
getActions().addAction(ActionFactory.createAcceptAction(new AcceptProvider() {
public ConnectorState isAcceptable(Widget widget, Point point, Transferable transferable) {
Image dragImage = getImageFromTransferable(transferable);
JComponent view = getView();
Graphics2D g2 = (Graphics2D) view.getGraphics();
Rectangle visRect = view.getVisibleRect();
view.paintImmediately(visRect.x, visRect.y, visRect.width, visRect.height);
g2.drawImage(dragImage,
AffineTransform.getTranslateInstance(point.getLocation().getX(),
point.getLocation().getY()),
null);
return ConnectorState.ACCEPT;
}
public void accept(Widget widget, Point point, Transferable transferable) {
Image image = getImageFromTransferable(transferable);
Widget w = GraphSceneImpl.this.addNode(new MyNode(image));
w.setPreferredLocation(widget.convertLocalToScene(point));
}
}));

Objaví sa nám viacero chýb, a to z toho dôvodu, že sme použili aj metody, ktoré zatiaľ nie sú definované, čiže si chvíľku nevšímajme tieto errory.

2. Teraz do triedy '''GraphSceneImpl''' pridáme pomocnú metódu na získavanie obrázkov:
private Image getImageFromTransferable(Transferable transferable) {
Object o = null;
try {
o = transferable.getTransferData(DataFlavor.imageFlavor);
} catch (IOException ex) {
ex.printStackTrace();
} catch (UnsupportedFlavorException ex) {
ex.printStackTrace();
}
return o instanceof Image ? (Image) o : ImageUtilities.loadImage("org/netbeans/shapesample/palette/shape1.png");
}
Ako vidíme, je tu ošetrená chyba, čiže môžete do org.netbeans.shapesample.palette doplniť obrázok, ktorý sa má objaviť pri chybe, dajte mu meno shape1.png

3. Z dôvodu toho, že máme len 3 obrázky, mohli by sme vytvoriť akoby len 3 prvky, preto si vytvoríme novú triedu s názvom '''MyNode'''. Klikneme na náš '''package shapesample pravým--new---java class''' a bude vypadať takto:
public class MyNode {
private Image image;

public MyNode(Image image) {
this.image = image;
}
public Image getImage() {
return image;
}
}

Klikneme na žltú žiarovku v tejto triede a dáme '''"Add import..."'''

4. Zmeníme teraz v triede '''GraphSceneImpl''' rodiča, od ktorého dedí, čiže jeden z prvý riadkov bude vypadať takto:
public class GraphSceneImpl extends GraphScene<MyNode, String>{...telo triedy...}
čím sme zabezpečili, že naša Node je prijatá cez Visual Library. Teraz sa nám objaví žltá žiarovka aj pri tomto riadku, lebo teraz musíme dediť iné abstraktné metódy, '''čiže klikneme na ňu --implement all abstract methods'''
5. Kedže používame generics, tak klikneme '''pravým na náš projekt--properties--sources''' a presvedčíme sa, že tam máme hodnotu '''Source level = 1.5'''

6. Následne definujeme náš nový Widget (komponent) v triede '''GraphSceneImpl''' a to tak, že tam nájdeme metódu '''protected Widget attachNodeWidget(MyNode node)''' a upravíme ju nasledovne:
protected Widget attachNodeWidget(MyNode node) {
IconNodeWidget widget = new IconNodeWidget(this);
widget.setImage(node.getImage());
widget.setLabel(Long.toString(node.hashCode()));
widget.getActions().addAction(ActionFactory.createMoveAction());
mainLayer.addChild(widget);
return widget;
}
Týmto nášmu Widgetu nastavíme obrázok, a priradíme mu veľké náhodné číslo, a ešte možnosť posúvať ho po našej scéne, a následne po zastavení ho pridať znova ako child.

7. Ešte stále nám ostáva pár žltých žiaroviek, takže klikneme na každú z nich, ktorá tam bude a dáme '''"Add import..."'''

8. Spustíme náš projekt, a už uvidíme, že je možné presúvať komponenty (Widgety) z našej paletty na našu scénku:

== Pridanie funkcionality pre našu scénu ==
1.Teraz pridáme najprv ZOOMaction na našu scénku a to tak, že na koniec '''GraphSceneImpl''' konštruktoru pridáme:
getActions().addAction(ActionFactory.createZoomAction());

Keď spustíme teraz náš projekt, tak pri pridržaní ctrl+ kolieško myši sa nám bude zoomovať naša plocha

2. Pridaním riadku za predošlým :
getActions().addAction(ActionFactory.createPanAction());
Pridáme funkcionalitu, že keď user potlačí kolečko myši, tak potom môže hýbať do hociktorého smeru.

== Pridanie funkcinality pre IconNodeWidget ==
Pre IconNodeWidget sme už pridali funcionalitu pre hýbanie '''MoveAction'''. Tak isto sme schopný pridať aj funkcionalitu pre '''HoverAction, SelectAction, a InplaceEditorAction''', v poradí (nadídenie, vybranie, premenovanie)
1. Najprv na úrovni triedy definujte
private WidgetAction editorAction = ActionFactory.createInplaceEditorAction(new LabelTextFieldEditor());
Následne sa objaví znova žltá žiarovka, najprv dajte '''"Add import..."''', následne dajte '''"Create class LabelTextFieldEditor..."''' , čo nám pridá do nášho package triedu.
2.Telo tejto triedy '''LabelTextFieldEditor''' zmeníme nasledovne:
class LabelTextFieldEditor implements TextFieldInplaceEditor {
public boolean isEnabled(Widget widget) {
return true;
}
public String getText(Widget widget) {
return ((LabelWidget) widget).getLabel();
}
public void setText(Widget widget, String text) {
((LabelWidget) widget).setLabel(text);
}
}
Znovu sa v tejto triede objaví zopár žltých žiaroviek, poklikajte na '''"add import..."'''

3. Následne priradíme editorAction nášmu IconNodeWidget, a to tak, že na koniec metódy '''protected Widget attachNodeWidget(MyNode node)''' triedy '''GraphSceneImpl''' vložíme tesne nad riadok ''' mainLayer.addChild(widget);''' nasledujúci kód:
widget.getLabelWidget().getActions().addAction(editorAction);

4. Následne Hower, Clicked action dolníme tak, že po vyššie doplnenom riadku dáme tieto dva:
widget.getActions().addAction(createSelectAction());
widget.getActions().addAction(createObjectHoverAction());

5. Teraz musíme trochu premyslieť poradie, v ktorom sme akcie pridali, info tu [http://bits.netbeans.org/dev/javadoc/org-netbeans-api-visual/org/netbeans/api/visual/widget/doc-files/documentation.html#OrderOfActions]
A následne bude naša metóda '''protected Widget attachNodeWidget''' vypadať nasledovne
protected Widget attachNodeWidget(MyNode node) {
IconNodeWidget widget = new IconNodeWidget(this);
widget.setImage(node.getImage());
widget.setLabel(Long.toString(node.hashCode()));
//double-click, event sa spustí len pri doubleclicku:
widget.getLabelWidget().getActions().addAction(editorAction);
//single-click, event sa spustí pri single clicku
widget.getActions().addAction(createSelectAction());
//mouse-dragged
widget.getActions().addAction(ActionFactory.createMoveAction());
//mouse-over,
widget.getActions().addAction(createObjectHoverAction());
mainLayer.addChild(widget);
return widget;
}

6. Po spustení to bude môcť vypadať takto napr. 
[[Súbor:Ytb desat.png]]

== Záver a riešenie problémov ==

Ukázali sme v skutku len veľmi strohú ukážku, čo by sa s NetBeans dalo spraviť, ale keďže je to problematika, ktorou by sa mali zaoberať knihy pre pokročilejších programátorov, tak tu skončíme.

V prípade nejasností je vždy dobré sa obráti na stránku NetBeans tutorials [http://netbeans.org/kb/trails/platform.html]

V prípade problémov, resp. riešenia chýb uvedeného návodu, '''odporúčam použiť VYTVORENY FUNKCNY MODUL''' 
'''Download:''' [http://plugins.netbeans.org/PluginPortal/faces/PluginDetailPage.jsp?pluginid=14027] 
'''Inštalácia:''' Spustite '''NetBeans--Tools--Plugins--kliknite Downloaded--Add Plugins...--nájdite stiahnutý--install''' 
'''Spustenie pluginu:''' '''Spustite NetBeans--File--New Project--Samples--NetBeansModule--Visual Library Demo''' 
 
V prípade nejasností, je tam všetko štruktúrované ako v našom návode, čiže by ste tam mali nájsť svoju chybu dosť rýchlo a prehľadne. 
 
'''ENJOY!''' 

Zdroj:[http://platform.netbeans.org/tutorials/nbm-visual_library.html]

Základy práce s NetBeans IDE a vývoj modulov

2010-04-25T21:43:08Z

Pokoraczki1: /* Vytváranie Palety pre našu scénu */

== NetBeans IDE ==
NetBeans je krásne vývojové prostredie, ktorého hlavnou výhodou je jeho modulárna architektúra. Ďalším skvelým prvkom je, že sa spolieha na toolkit SWING UI, čo nám dokopy dáva obrovské výhody.

V tomto článku sa posnažím ukázať, ako možno vytvoriť jednoduchý modul pre NetBeans, ktorý bude iba strohá ukážka toho, čo sa s NetBeans dá robit.

== Požiadavky na postup článkom ==
1. NetBeans IDE ( použitá verzia 6.8 ) 
2. Java_jdk ( použitá verzia 1.6.0.18 ) 
3. Základné znalosti jazyka JAVA

== Vytvorenie a spustenie projektu ==
1. Začneme spustením Netbeans a zvolíme '''File--New Project--NetBeans Modules--Module''' 
[[Súbor:Ytb prvy.png]]

2. Klikneme na tlačítko "NEXT", pomenujeme si náš projekt napr. "ShapeSample", nastavíme ho ako "'''main project'''" a vyberieme si umiestnenie, kde ho chceme uložiť a ponecháme '''Standalone Module'''
[[Súbor:Ytb druhy.png]]

3. Klikneme "NEXT", zadáme do "Code Name Base" '''org.netbeans.shapesample''', a dôležité, klikneme na '''Generate XML Layer'''. Následne klikneme na tlačítko finish, a vytvorí sa nám projekt.
[[Súbor:Ytb treti.png]]

4. V okne "Project" , '''klikneme pravým na "ShapeSample"--Properties--Libraries'''. Module Dependencies klikneme na tlačítko "ADD" a pridáme: 
''a/ Visual Library API 
b/ Utilities API ''
Klikneme na tlačítko OK, čo nám pridá odkazy. 

5. Znova v "Project" window '''klikneme pravým na "ShapeSample"--New--Other--Module Development--Window Component''' , klikneme "NEXT" 

6. Ako Windows Position dáme '''editor''' a zaškrtneme '''Open on application start''' a klikneme "NEXT" 

7.Do políčka "Class Name Prefix" dopíšeme '''Shape''', klikneme na tlačítko "FINISH" 

8. Vygeneruje sa nám viacero súbor, jedným z nich je '''ShapeTopComponent''', 2krát naň klikneme a otvoríme ho v design view. 

9. V design view, pravým klikneme na okno akoby a dáme '''Set Layout--Border Layout''' 
[[Súbor:Ytb stvrty.png]]

== Vytvorenie scény ==
1. Využijeme okno "'''Pallete'''" (ak nie je zobrazené dáme window---pallete) a vložíme na naš layout '''ScrollPane'''. V okne "Inspector" klikneme pravým na jScrollPane1--Change Variable Name a nastavíme hodnotu na "shapePane".

2.V "Project" windows na zložku''' org--netbeans--shapesample''' klikneme pravým a dáme '''new--Java Class''', pomenujme ju "'''GraphSceneImpl'''", a po vytvorení dopíšme do triedy '''extends GraphScene'''

3. Žltá žiarovka s červeným výkričníkom sa nám objaví naľavo v editore, klikneme na ňu, a dáme "'''add Import...'''" 
Následne sa dám objaví ďalšia žltá žiarovka, klikneme na ňu a dáme "'''Implement all abstract methods'''" 
[[Súbor:Ytb piaty.png]]

4. Pre lepšiu orientáciu zmeníme názvy parametrov vygenerovaných NetBeans, a po úprave bude naša trieda vypadať takto: 

public class GraphSceneImpl extends GraphScene
{

public GraphSceneImpl() {
}

protected Widget attachNodeWidget(Object node) {
return null;
}

protected Widget attachEdgeWidget(Object edge) {
return null;
}

protected void attachEdgeSourceAnchor(Object edge, Object oldSourceNode, Object newSourceNode) {

}

protected void attachEdgeTargetAnchor(Object edge, Object oldTargetNode, Object newTargetNode) {

}
}

5.Vrátime sa k ShapeTopComponent, kde sa budeme starať o instanciu GraphSceneImpl , prepneme Design View na SourceView, a nájdeme jeho konštruktor. Do tela konštruktora doplnime nasledujúce riadky:
GraphSceneImpl scene = new GraphSceneImpl();
myView = scene.createView();
shapePane.setViewportView(myView);
add(scene.createSatelliteView(), BorderLayout.WEST);

Týmto sme vytvorili 2 náhľady, jeden veľký, a jeden akoby informačný na ľavej strane, ktorý pomôže používateľovi rýchlejšie sa pohybovať po väčšom rozpätí.

6. Na '''úrovni triedy ShapeTopComponent''' deklarujeme (doplníme napr. hneď nad konštruktor)
private JComponent myView;

Ostanú nám ešte 2 žlté žiarovky, klikneme na každú z nich, a dáme "'''Add Import...'''"

7. Teraz musíme ošetriť, že ak sa NetBeans IDE reštartuje, nemáme žiadny dôvod aby ShapeTopComponent pretrvával, čiže nájdeme metódu '''getPersistenceType()''' v tele triedy, a zmeníme ju nasledovne:
public int getPersistenceType() {
return TopComponent.PERSISTENCE_NEVER;
}

8. Klikneme v "Project" window na náš projekt '''ShapeSample pravým--run'''

9. Nezlaknite sa, spustí sa nová inštancia NetBeans IDE(ak nie je náš projekt už otvorený kliknite na '''window---Shape''') a zobrazí sa Vám niečo takéto: 
[[Súbor:Ytb siesty.png]]

== Vytváranie Palety pre našu scénu ==

Teraz aby sme pokračovali niečím užitočným, vytvoríme si palletu, na čo využijeme Pallete API, ktorá bude obsahovať komponenty, ktoré môžeme použiť a pridať na našu scénu pretiahnutím.
Pre ďalšie pokračovanie budeme potrebovať 3 obrázky našich komponentov, použime tieto(kliknite pravým---uložiť ako, nemente názvy):
[[Súbor:Image1.png]][[Súbor:Image2.png]][[Súbor:Image3.png]]

'''Keďže náš tutoriál sa zaoberá s Visual Library API, a nie s Palette API(info tu:[http://netbeans.org/kb/trails/platform.html] ), na funkcionalitu Paletty použijeme už hotové knižnice, ktoré stiahnete tu''':
[http://www.sendspace.com/file/dqtnbi] (v prípade, že je link nefunkčný, na konci článku je hotový plugin pre tento modul, knižnice vytiahnite z neho)

1. Klikneme na náš projekt pravým--new--Java Package a pomenujeme ho '''org.netbeans.shapesample.palette'''
2. Teraz podme do zložky, kde sme nás projekt uložili, konkrétne '''násProjekt/src/org/netbeans/shapesample/pallete'''. A do tejto''' zložky nakopírujeme stiahnuté obrázky a následne aj knižnice''', čiže tieto súbory: 
a/ Category 
b/ CategoryChildren 
c/ CategoryNode 
d/ PaletteSupport 
e/ Shape 
f/ ShapeChildren 
g/ ShapeNode 
h/ image1, image2, image3 
po zobrazení NetBeans sa nám novo vytvorený package obnoví, a budeme tam mať načítané všetky vložené súbory, pričom niekde sa znovu objavia červené krúžky so žiarovkou, to si nevšímajme chvíľku

3. Klikneme '''pravým na projekt--Properties--Libraries--Add''' a pridáme nasledujúce knižnice: 
a/ Actions APIs 
b/ Nodes API 
c/ Common Palette 
Teraz by sme mali spozorovať, že všetky červené guličky nám zmiznú, a bude nám to vypadať nasledovne: 
[[Súbor:Ytb siedmy.png]]

4. Teraz pridáme našu Palettu do ShapeTopComponentovho náhľadu, a to tak, že do konštruktoru ShapeTopComponent kod
associateLookup( Lookups.fixed( new Object[] { PaletteSupport.createPalette() } ) );

5. Znova sa nám objaví žltá žiarovka, klikneme na ňu dáme "Add import...", následne sa tam objaví znova, čiže znova klikneme a dáme "Add import..."

6. Spustite modul znova(pravým--run), teraz by to už malo vypadať takto, no zatiaľ bez funkcionality, pretože potrebujeme Layer Widget: 
[[Súbor:Ytb osmy.png]]

== Pridanie LayerWidget ==

Pod pojmom LayerWidget si predstavte niečo priesvitné, na ktoré budeme môcť ukladať naše komponenty s paletty.

1. Ná úrovni triedy GraphSceneImpl deklarujte náš LayerWidget
private LayerWidget mainLayer;

2. Do konštruktoru GraphSceneImpl pridajte LayerWidget ako dieťa našej scény:
mainLayer = new LayerWidget (this);
addChild (mainLayer);

Teraz keď pridáme na scénu nejaký komponent s našej paletty , pridajú sa ako deti do našel mainLayer.

== Pridanie IconNodeWidget (komponentu) cez funkcionalitu Drag and Drop (chyť a hoď) ==

Doposiaľ, naša scéna existuje, ale nemá žiadnu funkcionalitu. Túto funkcionalitu pridáme pomocou '''"actions"'''. Action, ktorá nám umožnuje Drag & Drop funkcionalitu je '''AcceptAction''' . Táto action môže byť aplikovaná buď na náš komponent alebo na našu scénu. My ju budeme aplikovať na našu scénu. Využijeme '''createAcceptAction''' na to, aby sme definovali čo sa má stať po tom, ako je komponent pretiahnutý nad našu scénu.

1. Najprv pridajte '''createAcceptAction''' spolu s jeho dvomi metódami do GraphSceneImpl konštruktoru:
getActions().addAction(ActionFactory.createAcceptAction(new AcceptProvider() {
public ConnectorState isAcceptable(Widget widget, Point point, Transferable transferable) {
Image dragImage = getImageFromTransferable(transferable);
JComponent view = getView();
Graphics2D g2 = (Graphics2D) view.getGraphics();
Rectangle visRect = view.getVisibleRect();
view.paintImmediately(visRect.x, visRect.y, visRect.width, visRect.height);
g2.drawImage(dragImage,
AffineTransform.getTranslateInstance(point.getLocation().getX(),
point.getLocation().getY()),
null);
return ConnectorState.ACCEPT;
}
public void accept(Widget widget, Point point, Transferable transferable) {
Image image = getImageFromTransferable(transferable);
Widget w = GraphSceneImpl.this.addNode(new MyNode(image));
w.setPreferredLocation(widget.convertLocalToScene(point));
}
}));

Objaví sa nám viacero chýb, a to z toho dôvodu, že sme použili aj metody, ktoré zatiaľ nie sú definované, čiže si chvíľku nevšímajme tieto errory.

2. Teraz do triedy '''GraphSceneImpl''' pridáme pomocnú metódu na získavanie obrázkov:
private Image getImageFromTransferable(Transferable transferable) {
Object o = null;
try {
o = transferable.getTransferData(DataFlavor.imageFlavor);
} catch (IOException ex) {
ex.printStackTrace();
} catch (UnsupportedFlavorException ex) {
ex.printStackTrace();
}
return o instanceof Image ? (Image) o : ImageUtilities.loadImage("org/netbeans/shapesample/palette/shape1.png");
}
Ako vidíme, je tu ošetrená chyba, čiže môžete do org.netbeans.shapesample.palette doplniť obrázok, ktorý sa má objaviť pri chybe, dajte mu meno shape1.png

3. Z dôvodu toho, že máme len 3 obrázky, mohli by sme vytvoriť akoby len 3 prvky, preto si vytvoríme novú triedu s názvom '''MyNode'''. Klikneme na náš '''package shapesample pravým--new---java class''' a bude vypadať takto:
public class MyNode {
private Image image;

public MyNode(Image image) {
this.image = image;
}
public Image getImage() {
return image;
}
}

Klikneme na žltú žiarovku v tejto triede a dáme '''"Add import..."'''

4. Zmeníme teraz v triede '''GraphSceneImpl''' rodiča, od ktorého dedí, čiže jeden z prvý riadkov bude vypadať takto:
public class GraphSceneImpl extends GraphScene<MyNode, String>{...telo triedy...}
čím sme zabezpečili, že naša Node je prijatá cez Visual Library. Teraz sa nám objaví žltá žiarovka aj pri tomto riadku, lebo teraz musíme dediť iné abstraktné metódy, '''čiže klikneme na ňu --implement all abstract methods'''
5. Kedže používame generics, tak klikneme '''pravým na náš projekt--properties--sources''' a presvedčíme sa, že tam máme hodnotu '''Source level = 1.5'''

6. Následne definujeme náš nový Widget (komponent) v triede '''GraphSceneImpl''' a to tak, že tam nájdeme metódu '''protected Widget attachNodeWidget(MyNode node)''' a upravíme ju nasledovne:
protected Widget attachNodeWidget(MyNode node) {
IconNodeWidget widget = new IconNodeWidget(this);
widget.setImage(node.getImage());
widget.setLabel(Long.toString(node.hashCode()));
widget.getActions().addAction(ActionFactory.createMoveAction());
mainLayer.addChild(widget);
return widget;
}
Týmto nášmu Widgetu nastavíme obrázok, a priradíme mu veľké náhodné číslo, a ešte možnosť posúvať ho po našej scéne, a následne po zastavení ho pridať znova ako child.

7. Ešte stále nám ostáva pár žltých žiaroviek, takže klikneme na každú z nich, ktorá tam bude a dáme '''"Add import..."'''

8. Spustíme náš projekt, a už uvidíme, že je možné presúvať komponenty (Widgety) z našej paletty na našu scénku:

== Pridanie funkcionality pre našu scénu ==
1.Teraz pridáme najprv ZOOMaction na našu scénku a to tak, že na koniec '''GraphSceneImpl''' konštruktoru pridáme:
getActions().addAction(ActionFactory.createZoomAction());

Keď spustíme teraz náš projekt, tak pri pridržaní ctrl+ kolieško myši sa nám bude zoomovať naša plocha

2. Pridaním riadku za predošlým :
getActions().addAction(ActionFactory.createPanAction());
Pridáme funkcionalitu, že keď user potlačí kolečko myši, tak potom môže hýbať do hociktorého smeru.

== Pridanie funkcinality pre IconNodeWidget ==
Pre IconNodeWidget sme už pridali funcionalitu pre hýbanie '''MoveAction'''. Tak isto sme schopný pridať aj funkcionalitu pre '''HoverAction, SelectAction, a InplaceEditorAction''', v poradí (nadídenie, vybranie, premenovanie)
1. Najprv na úrovni triedy definujte
private WidgetAction editorAction = ActionFactory.createInplaceEditorAction(new LabelTextFieldEditor());
Následne sa objaví znova žltá žiarovka, najprv dajte '''"Add import..."''', následne dajte '''"Create class LabelTextFieldEditor..."''' , čo nám pridá do nášho package triedu.
2.Telo tejto triedy '''LabelTextFieldEditor''' zmeníme nasledovne:
class LabelTextFieldEditor implements TextFieldInplaceEditor {
public boolean isEnabled(Widget widget) {
return true;
}
public String getText(Widget widget) {
return ((LabelWidget) widget).getLabel();
}
public void setText(Widget widget, String text) {
((LabelWidget) widget).setLabel(text);
}
}
Znovu sa v tejto triede objaví zopár žltých žiaroviek, poklikajte na '''"add import..."'''

3. Následne priradíme editorAction nášmu IconNodeWidget, a to tak, že na koniec metódy '''protected Widget attachNodeWidget(MyNode node)''' triedy '''GraphSceneImpl''' vložíme tesne nad riadok ''' mainLayer.addChild(widget);''' nasledujúci kód:
widget.getLabelWidget().getActions().addAction(editorAction);

4. Následne Hower, Clicked action dolníme tak, že po vyššie doplnenom riadku dáme tieto dva:
widget.getActions().addAction(createSelectAction());
widget.getActions().addAction(createObjectHoverAction());

5. Teraz musíme trochu premyslieť poradie, v ktorom sme akcie pridali, info tu [http://bits.netbeans.org/dev/javadoc/org-netbeans-api-visual/org/netbeans/api/visual/widget/doc-files/documentation.html#OrderOfActions]
A následne bude naša metóda '''protected Widget attachNodeWidget''' vypadať nasledovne
protected Widget attachNodeWidget(MyNode node) {
IconNodeWidget widget = new IconNodeWidget(this);
widget.setImage(node.getImage());
widget.setLabel(Long.toString(node.hashCode()));
//double-click, event sa spustí len pri doubleclicku:
widget.getLabelWidget().getActions().addAction(editorAction);
//single-click, event sa spustí pri single clicku
widget.getActions().addAction(createSelectAction());
//mouse-dragged
widget.getActions().addAction(ActionFactory.createMoveAction());
//mouse-over,
widget.getActions().addAction(createObjectHoverAction());
mainLayer.addChild(widget);
return widget;
}

6. Po spustení to bude môcť vypadať takto napr. 
[[Súbor:Ytb desat.png]]

== Záver a riešenie problémov ==

Ukázali sme v skutku len veľmi strohú ukážku, čo by sa s NetBeans dalo spraviť, ale keďže je to problematika, ktorou by sa mali zaoberať knihy pre pokročilejších programerov, tak tu skončíme.

V prípade nejasností je vždy dobré sa obráti na stránku NetBeans tutorials [http://netbeans.org/kb/trails/platform.html]

V prípade problémov, resp. riešenia chýb uvedeného návodu, '''odporúčam použiť VYTVORENY FUNKCNY MODUL''' 
'''Download:''' [http://plugins.netbeans.org/PluginPortal/faces/PluginDetailPage.jsp?pluginid=14027] 
'''Inštalácia:''' Spustite '''NetBeans--Tools--Plugins--kliknite Downloaded--Add Plugins...--nájdite stiahnutý--install''' 
'''Spustenie pluginu:''' '''Spustite NetBeans--File--New Project--Samples--NetBeansModule--Visual Library Demo''' 
 
V prípade nejasností, je tam všetko štruktúrované ako v našom návode, čiže by ste tam mali nájsť svoju chybu dosť rýchlo a prehľadne. 
 
'''ENJOY!''' 

Zdroj:[http://platform.netbeans.org/tutorials/nbm-visual_library.html]

Základy práce s NetBeans IDE a vývoj modulov

2010-04-25T21:33:06Z

Pokoraczki1:

== NetBeans IDE ==
NetBeans je krásne vývojové prostredie, ktorého hlavnou výhodou je jeho modulárna architektúra. Ďalším skvelým prvkom je, že sa spolieha na toolkit SWING UI, čo nám dokopy dáva obrovské výhody.

V tomto článku sa posnažím ukázať, ako možno vytvoriť jednoduchý modul pre NetBeans, ktorý bude iba strohá ukážka toho, čo sa s NetBeans dá robit.

== Požiadavky na postup článkom ==
1. NetBeans IDE ( použitá verzia 6.8 ) 
2. Java_jdk ( použitá verzia 1.6.0.18 ) 
3. Základné znalosti jazyka JAVA

== Vytvorenie a spustenie projektu ==
1. Začneme spustením Netbeans a zvolíme '''File--New Project--NetBeans Modules--Module''' 
[[Súbor:Ytb prvy.png]]

2. Klikneme na tlačítko "NEXT", pomenujeme si náš projekt napr. "ShapeSample", nastavíme ho ako "'''main project'''" a vyberieme si umiestnenie, kde ho chceme uložiť a ponecháme '''Standalone Module'''
[[Súbor:Ytb druhy.png]]

3. Klikneme "NEXT", zadáme do "Code Name Base" '''org.netbeans.shapesample''', a dôležité, klikneme na '''Generate XML Layer'''. Následne klikneme na tlačítko finish, a vytvorí sa nám projekt.
[[Súbor:Ytb treti.png]]

4. V okne "Project" , '''klikneme pravým na "ShapeSample"--Properties--Libraries'''. Module Dependencies klikneme na tlačítko "ADD" a pridáme: 
''a/ Visual Library API 
b/ Utilities API ''
Klikneme na tlačítko OK, čo nám pridá odkazy. 

5. Znova v "Project" window '''klikneme pravým na "ShapeSample"--New--Other--Module Development--Window Component''' , klikneme "NEXT" 

6. Ako Windows Position dáme '''editor''' a zaškrtneme '''Open on application start''' a klikneme "NEXT" 

7.Do políčka "Class Name Prefix" dopíšeme '''Shape''', klikneme na tlačítko "FINISH" 

8. Vygeneruje sa nám viacero súbor, jedným z nich je '''ShapeTopComponent''', 2krát naň klikneme a otvoríme ho v design view. 

9. V design view, pravým klikneme na okno akoby a dáme '''Set Layout--Border Layout''' 
[[Súbor:Ytb stvrty.png]]

== Vytvorenie scény ==
1. Využijeme okno "'''Pallete'''" (ak nie je zobrazené dáme window---pallete) a vložíme na naš layout '''ScrollPane'''. V okne "Inspector" klikneme pravým na jScrollPane1--Change Variable Name a nastavíme hodnotu na "shapePane".

2.V "Project" windows na zložku''' org--netbeans--shapesample''' klikneme pravým a dáme '''new--Java Class''', pomenujme ju "'''GraphSceneImpl'''", a po vytvorení dopíšme do triedy '''extends GraphScene'''

3. Žltá žiarovka s červeným výkričníkom sa nám objaví naľavo v editore, klikneme na ňu, a dáme "'''add Import...'''" 
Následne sa dám objaví ďalšia žltá žiarovka, klikneme na ňu a dáme "'''Implement all abstract methods'''" 
[[Súbor:Ytb piaty.png]]

4. Pre lepšiu orientáciu zmeníme názvy parametrov vygenerovaných NetBeans, a po úprave bude naša trieda vypadať takto: 

public class GraphSceneImpl extends GraphScene
{

public GraphSceneImpl() {
}

protected Widget attachNodeWidget(Object node) {
return null;
}

protected Widget attachEdgeWidget(Object edge) {
return null;
}

protected void attachEdgeSourceAnchor(Object edge, Object oldSourceNode, Object newSourceNode) {

}

protected void attachEdgeTargetAnchor(Object edge, Object oldTargetNode, Object newTargetNode) {

}
}

5.Vrátime sa k ShapeTopComponent, kde sa budeme starať o instanciu GraphSceneImpl , prepneme Design View na SourceView, a nájdeme jeho konštruktor. Do tela konštruktora doplnime nasledujúce riadky:
GraphSceneImpl scene = new GraphSceneImpl();
myView = scene.createView();
shapePane.setViewportView(myView);
add(scene.createSatelliteView(), BorderLayout.WEST);

Týmto sme vytvorili 2 náhľady, jeden veľký, a jeden akoby informačný na ľavej strane, ktorý pomôže používateľovi rýchlejšie sa pohybovať po väčšom rozpätí.

6. Na '''úrovni triedy ShapeTopComponent''' deklarujeme (doplníme napr. hneď nad konštruktor)
private JComponent myView;

Ostanú nám ešte 2 žlté žiarovky, klikneme na každú z nich, a dáme "'''Add Import...'''"

7. Teraz musíme ošetriť, že ak sa NetBeans IDE reštartuje, nemáme žiadny dôvod aby ShapeTopComponent pretrvával, čiže nájdeme metódu '''getPersistenceType()''' v tele triedy, a zmeníme ju nasledovne:
public int getPersistenceType() {
return TopComponent.PERSISTENCE_NEVER;
}

8. Klikneme v "Project" window na náš projekt '''ShapeSample pravým--run'''

9. Nezlaknite sa, spustí sa nová inštancia NetBeans IDE(ak nie je náš projekt už otvorený kliknite na '''window---Shape''') a zobrazí sa Vám niečo takéto: 
[[Súbor:Ytb siesty.png]]

== Vytváranie Palety pre našu scénu ==

Teraz aby sme pokračovali niečím užitočným, vytvoríme si palletu, na čo využijeme Pallete API, ktorá bude obsahovať komponenty, ktoré môžeme použiť a pridať na našu scénu pretiahnutím.
Pre ďalšie pokračovanie budeme potrebovať 3 obrázky našich komponentov, použime tieto(kliknite pravým---uložiť ako, nemente názvy):
[[Súbor:Image1.png]][[Súbor:Image2.png]][[Súbor:Image3.png]]

'''Keďže náš tutoriál sa zaoberá s Visual Library API, a nie s Palette API(info tu:[http://netbeans.org/kb/trails/platform.html] ), na funkcionalitu Paletty použijeme už hotové knižnice, ktoré stiahnete tu''':
[http://www.sendspace.com/file/dqtnbi]

1. Klikneme na náš projekt pravým--new--Java Package a pomenujeme ho '''org.netbeans.shapesample.palette'''
2. Teraz podme do zložky, kde sme nás projekt uložili, konkrétne '''násProjekt/src/org/netbeans/shapesample/pallete'''. A do tejto''' zložky nakopírujeme stiahnuté obrázky a následne aj knižnice''', čiže tieto súbory: 
a/ Category 
b/ CategoryChildren 
c/ CategoryNode 
d/ PaletteSupport 
e/ Shape 
f/ ShapeChildren 
g/ ShapeNode 
h/ image1, image2, image3 
po zobrazení NetBeans sa nám novo vytvorený package obnoví, a budeme tam mať načítané všetky vložené súbory, pričom niekde sa znovu objavia červené krúžky so žiarovkou, to si nevšímajme chvíľku

3. Klikneme '''pravým na projekt--Properties--Libraries--Add''' a pridáme nasledujúce knižnice: 
a/ Actions APIs 
b/ Nodes API 
c/ Common Palette 
Teraz by sme mali spozorovať, že všetky červené guličky nám zmiznú, a bude nám to vypadať nasledovne: 
[[Súbor:Ytb siedmy.png]]

4. Teraz pridáme našu Palettu do ShapeTopComponentovho náhľadu, a to tak, že do konštruktoru ShapeTopComponent kod
associateLookup( Lookups.fixed( new Object[] { PaletteSupport.createPalette() } ) );

5. Znova sa nám objaví žltá žiarovka, klikneme na ňu dáme "Add import...", následne sa tam objaví znova, čiže znova klikneme a dáme "Add import..."

6. Spustite modul znova(pravým--run), teraz by to už malo vypadať takto, no zatiaľ bez funkcionality, pretože potrebujeme Layer Widget: 
[[Súbor:Ytb osmy.png]]

== Pridanie LayerWidget ==

Pod pojmom LayerWidget si predstavte niečo priesvitné, na ktoré budeme môcť ukladať naše komponenty s paletty.

1. Ná úrovni triedy GraphSceneImpl deklarujte náš LayerWidget
private LayerWidget mainLayer;

2. Do konštruktoru GraphSceneImpl pridajte LayerWidget ako dieťa našej scény:
mainLayer = new LayerWidget (this);
addChild (mainLayer);

Teraz keď pridáme na scénu nejaký komponent s našej paletty , pridajú sa ako deti do našel mainLayer.

== Pridanie IconNodeWidget (komponentu) cez funkcionalitu Drag and Drop (chyť a hoď) ==

Doposiaľ, naša scéna existuje, ale nemá žiadnu funkcionalitu. Túto funkcionalitu pridáme pomocou '''"actions"'''. Action, ktorá nám umožnuje Drag & Drop funkcionalitu je '''AcceptAction''' . Táto action môže byť aplikovaná buď na náš komponent alebo na našu scénu. My ju budeme aplikovať na našu scénu. Využijeme '''createAcceptAction''' na to, aby sme definovali čo sa má stať po tom, ako je komponent pretiahnutý nad našu scénu.

1. Najprv pridajte '''createAcceptAction''' spolu s jeho dvomi metódami do GraphSceneImpl konštruktoru:
getActions().addAction(ActionFactory.createAcceptAction(new AcceptProvider() {
public ConnectorState isAcceptable(Widget widget, Point point, Transferable transferable) {
Image dragImage = getImageFromTransferable(transferable);
JComponent view = getView();
Graphics2D g2 = (Graphics2D) view.getGraphics();
Rectangle visRect = view.getVisibleRect();
view.paintImmediately(visRect.x, visRect.y, visRect.width, visRect.height);
g2.drawImage(dragImage,
AffineTransform.getTranslateInstance(point.getLocation().getX(),
point.getLocation().getY()),
null);
return ConnectorState.ACCEPT;
}
public void accept(Widget widget, Point point, Transferable transferable) {
Image image = getImageFromTransferable(transferable);
Widget w = GraphSceneImpl.this.addNode(new MyNode(image));
w.setPreferredLocation(widget.convertLocalToScene(point));
}
}));

Objaví sa nám viacero chýb, a to z toho dôvodu, že sme použili aj metody, ktoré zatiaľ nie sú definované, čiže si chvíľku nevšímajme tieto errory.

2. Teraz do triedy '''GraphSceneImpl''' pridáme pomocnú metódu na získavanie obrázkov:
private Image getImageFromTransferable(Transferable transferable) {
Object o = null;
try {
o = transferable.getTransferData(DataFlavor.imageFlavor);
} catch (IOException ex) {
ex.printStackTrace();
} catch (UnsupportedFlavorException ex) {
ex.printStackTrace();
}
return o instanceof Image ? (Image) o : ImageUtilities.loadImage("org/netbeans/shapesample/palette/shape1.png");
}
Ako vidíme, je tu ošetrená chyba, čiže môžete do org.netbeans.shapesample.palette doplniť obrázok, ktorý sa má objaviť pri chybe, dajte mu meno shape1.png

3. Z dôvodu toho, že máme len 3 obrázky, mohli by sme vytvoriť akoby len 3 prvky, preto si vytvoríme novú triedu s názvom '''MyNode'''. Klikneme na náš '''package shapesample pravým--new---java class''' a bude vypadať takto:
public class MyNode {
private Image image;

public MyNode(Image image) {
this.image = image;
}
public Image getImage() {
return image;
}
}

Klikneme na žltú žiarovku v tejto triede a dáme '''"Add import..."'''

4. Zmeníme teraz v triede '''GraphSceneImpl''' rodiča, od ktorého dedí, čiže jeden z prvý riadkov bude vypadať takto:
public class GraphSceneImpl extends GraphScene<MyNode, String>{...telo triedy...}
čím sme zabezpečili, že naša Node je prijatá cez Visual Library. Teraz sa nám objaví žltá žiarovka aj pri tomto riadku, lebo teraz musíme dediť iné abstraktné metódy, '''čiže klikneme na ňu --implement all abstract methods'''
5. Kedže používame generics, tak klikneme '''pravým na náš projekt--properties--sources''' a presvedčíme sa, že tam máme hodnotu '''Source level = 1.5'''

6. Následne definujeme náš nový Widget (komponent) v triede '''GraphSceneImpl''' a to tak, že tam nájdeme metódu '''protected Widget attachNodeWidget(MyNode node)''' a upravíme ju nasledovne:
protected Widget attachNodeWidget(MyNode node) {
IconNodeWidget widget = new IconNodeWidget(this);
widget.setImage(node.getImage());
widget.setLabel(Long.toString(node.hashCode()));
widget.getActions().addAction(ActionFactory.createMoveAction());
mainLayer.addChild(widget);
return widget;
}
Týmto nášmu Widgetu nastavíme obrázok, a priradíme mu veľké náhodné číslo, a ešte možnosť posúvať ho po našej scéne, a následne po zastavení ho pridať znova ako child.

7. Ešte stále nám ostáva pár žltých žiaroviek, takže klikneme na každú z nich, ktorá tam bude a dáme '''"Add import..."'''

8. Spustíme náš projekt, a už uvidíme, že je možné presúvať komponenty (Widgety) z našej paletty na našu scénku:

== Pridanie funkcionality pre našu scénu ==
1.Teraz pridáme najprv ZOOMaction na našu scénku a to tak, že na koniec '''GraphSceneImpl''' konštruktoru pridáme:
getActions().addAction(ActionFactory.createZoomAction());

Keď spustíme teraz náš projekt, tak pri pridržaní ctrl+ kolieško myši sa nám bude zoomovať naša plocha

2. Pridaním riadku za predošlým :
getActions().addAction(ActionFactory.createPanAction());
Pridáme funkcionalitu, že keď user potlačí kolečko myši, tak potom môže hýbať do hociktorého smeru.

== Pridanie funkcinality pre IconNodeWidget ==
Pre IconNodeWidget sme už pridali funcionalitu pre hýbanie '''MoveAction'''. Tak isto sme schopný pridať aj funkcionalitu pre '''HoverAction, SelectAction, a InplaceEditorAction''', v poradí (nadídenie, vybranie, premenovanie)
1. Najprv na úrovni triedy definujte
private WidgetAction editorAction = ActionFactory.createInplaceEditorAction(new LabelTextFieldEditor());
Následne sa objaví znova žltá žiarovka, najprv dajte '''"Add import..."''', následne dajte '''"Create class LabelTextFieldEditor..."''' , čo nám pridá do nášho package triedu.
2.Telo tejto triedy '''LabelTextFieldEditor''' zmeníme nasledovne:
class LabelTextFieldEditor implements TextFieldInplaceEditor {
public boolean isEnabled(Widget widget) {
return true;
}
public String getText(Widget widget) {
return ((LabelWidget) widget).getLabel();
}
public void setText(Widget widget, String text) {
((LabelWidget) widget).setLabel(text);
}
}
Znovu sa v tejto triede objaví zopár žltých žiaroviek, poklikajte na '''"add import..."'''

3. Následne priradíme editorAction nášmu IconNodeWidget, a to tak, že na koniec metódy '''protected Widget attachNodeWidget(MyNode node)''' triedy '''GraphSceneImpl''' vložíme tesne nad riadok ''' mainLayer.addChild(widget);''' nasledujúci kód:
widget.getLabelWidget().getActions().addAction(editorAction);

4. Následne Hower, Clicked action dolníme tak, že po vyššie doplnenom riadku dáme tieto dva:
widget.getActions().addAction(createSelectAction());
widget.getActions().addAction(createObjectHoverAction());

5. Teraz musíme trochu premyslieť poradie, v ktorom sme akcie pridali, info tu [http://bits.netbeans.org/dev/javadoc/org-netbeans-api-visual/org/netbeans/api/visual/widget/doc-files/documentation.html#OrderOfActions]
A následne bude naša metóda '''protected Widget attachNodeWidget''' vypadať nasledovne
protected Widget attachNodeWidget(MyNode node) {
IconNodeWidget widget = new IconNodeWidget(this);
widget.setImage(node.getImage());
widget.setLabel(Long.toString(node.hashCode()));
//double-click, event sa spustí len pri doubleclicku:
widget.getLabelWidget().getActions().addAction(editorAction);
//single-click, event sa spustí pri single clicku
widget.getActions().addAction(createSelectAction());
//mouse-dragged
widget.getActions().addAction(ActionFactory.createMoveAction());
//mouse-over,
widget.getActions().addAction(createObjectHoverAction());
mainLayer.addChild(widget);
return widget;
}

6. Po spustení to bude môcť vypadať takto napr. 
[[Súbor:Ytb desat.png]]

== Záver a riešenie problémov ==

Ukázali sme v skutku len veľmi strohú ukážku, čo by sa s NetBeans dalo spraviť, ale keďže je to problematika, ktorou by sa mali zaoberať knihy pre pokročilejších programerov, tak tu skončíme.

V prípade nejasností je vždy dobré sa obráti na stránku NetBeans tutorials [http://netbeans.org/kb/trails/platform.html]

V prípade problémov, resp. riešenia chýb uvedeného návodu, '''odporúčam použiť VYTVORENY FUNKCNY MODUL''' 
'''Download:''' [http://plugins.netbeans.org/PluginPortal/faces/PluginDetailPage.jsp?pluginid=14027] 
'''Inštalácia:''' Spustite '''NetBeans--Tools--Plugins--kliknite Downloaded--Add Plugins...--nájdite stiahnutý--install''' 
'''Spustenie pluginu:''' '''Spustite NetBeans--File--New Project--Samples--NetBeansModule--Visual Library Demo''' 
 
V prípade nejasností, je tam všetko štruktúrované ako v našom návode, čiže by ste tam mali nájsť svoju chybu dosť rýchlo a prehľadne. 
 
'''ENJOY!''' 

Zdroj:[http://platform.netbeans.org/tutorials/nbm-visual_library.html]

Základy práce s NetBeans IDE a vývoj modulov

2010-04-25T21:31:41Z

Pokoraczki1: /* Záver a riešenie problémov */

'''Work in progress :)'''

== NetBeans IDE ==
NetBeans je krásne vývojové prostredie, ktorého hlavnou výhodou je jeho modulárna architektúra. Ďalším skvelým prvkom je, že sa spolieha na toolkit SWING UI, čo nám dokopy dáva obrovské výhody.

V tomto článku sa posnažím ukázať, ako možno vytvoriť jednoduchý modul pre NetBeans, ktorý bude iba strohá ukážka toho, čo sa s NetBeans dá robit.

== Požiadavky na postup článkom ==
1. NetBeans IDE ( použitá verzia 6.8 ) 
2. Java_jdk ( použitá verzia 1.6.0.18 ) 
3. Základné znalosti jazyka JAVA

== Vytvorenie a spustenie projektu ==
1. Začneme spustením Netbeans a zvolíme '''File--New Project--NetBeans Modules--Module''' 
[[Súbor:Ytb prvy.png]]

2. Klikneme na tlačítko "NEXT", pomenujeme si náš projekt napr. "ShapeSample", nastavíme ho ako "'''main project'''" a vyberieme si umiestnenie, kde ho chceme uložiť a ponecháme '''Standalone Module'''
[[Súbor:Ytb druhy.png]]

3. Klikneme "NEXT", zadáme do "Code Name Base" '''org.netbeans.shapesample''', a dôležité, klikneme na '''Generate XML Layer'''. Následne klikneme na tlačítko finish, a vytvorí sa nám projekt.
[[Súbor:Ytb treti.png]]

4. V okne "Project" , '''klikneme pravým na "ShapeSample"--Properties--Libraries'''. Module Dependencies klikneme na tlačítko "ADD" a pridáme: 
''a/ Visual Library API 
b/ Utilities API ''
Klikneme na tlačítko OK, čo nám pridá odkazy. 

5. Znova v "Project" window '''klikneme pravým na "ShapeSample"--New--Other--Module Development--Window Component''' , klikneme "NEXT" 

6. Ako Windows Position dáme '''editor''' a zaškrtneme '''Open on application start''' a klikneme "NEXT" 

7.Do políčka "Class Name Prefix" dopíšeme '''Shape''', klikneme na tlačítko "FINISH" 

8. Vygeneruje sa nám viacero súbor, jedným z nich je '''ShapeTopComponent''', 2krát naň klikneme a otvoríme ho v design view. 

9. V design view, pravým klikneme na okno akoby a dáme '''Set Layout--Border Layout''' 
[[Súbor:Ytb stvrty.png]]

== Vytvorenie scény ==
1. Využijeme okno "'''Pallete'''" (ak nie je zobrazené dáme window---pallete) a vložíme na naš layout '''ScrollPane'''. V okne "Inspector" klikneme pravým na jScrollPane1--Change Variable Name a nastavíme hodnotu na "shapePane".

2.V "Project" windows na zložku''' org--netbeans--shapesample''' klikneme pravým a dáme '''new--Java Class''', pomenujme ju "'''GraphSceneImpl'''", a po vytvorení dopíšme do triedy '''extends GraphScene'''

3. Žltá žiarovka s červeným výkričníkom sa nám objaví naľavo v editore, klikneme na ňu, a dáme "'''add Import...'''" 
Následne sa dám objaví ďalšia žltá žiarovka, klikneme na ňu a dáme "'''Implement all abstract methods'''" 
[[Súbor:Ytb piaty.png]]

4. Pre lepšiu orientáciu zmeníme názvy parametrov vygenerovaných NetBeans, a po úprave bude naša trieda vypadať takto: 

public class GraphSceneImpl extends GraphScene
{

public GraphSceneImpl() {
}

protected Widget attachNodeWidget(Object node) {
return null;
}

protected Widget attachEdgeWidget(Object edge) {
return null;
}

protected void attachEdgeSourceAnchor(Object edge, Object oldSourceNode, Object newSourceNode) {

}

protected void attachEdgeTargetAnchor(Object edge, Object oldTargetNode, Object newTargetNode) {

}
}

5.Vrátime sa k ShapeTopComponent, kde sa budeme starať o instanciu GraphSceneImpl , prepneme Design View na SourceView, a nájdeme jeho konštruktor. Do tela konštruktora doplnime nasledujúce riadky:
GraphSceneImpl scene = new GraphSceneImpl();
myView = scene.createView();
shapePane.setViewportView(myView);
add(scene.createSatelliteView(), BorderLayout.WEST);

Týmto sme vytvorili 2 náhľady, jeden veľký, a jeden akoby informačný na ľavej strane, ktorý pomôže používateľovi rýchlejšie sa pohybovať po väčšom rozpätí.

6. Na '''úrovni triedy ShapeTopComponent''' deklarujeme (doplníme napr. hneď nad konštruktor)
private JComponent myView;

Ostanú nám ešte 2 žlté žiarovky, klikneme na každú z nich, a dáme "'''Add Import...'''"

7. Teraz musíme ošetriť, že ak sa NetBeans IDE reštartuje, nemáme žiadny dôvod aby ShapeTopComponent pretrvával, čiže nájdeme metódu '''getPersistenceType()''' v tele triedy, a zmeníme ju nasledovne:
public int getPersistenceType() {
return TopComponent.PERSISTENCE_NEVER;
}

8. Klikneme v "Project" window na náš projekt '''ShapeSample pravým--run'''

9. Nezlaknite sa, spustí sa nová inštancia NetBeans IDE(ak nie je náš projekt už otvorený kliknite na '''window---Shape''') a zobrazí sa Vám niečo takéto: 
[[Súbor:Ytb siesty.png]]

== Vytváranie Palety pre našu scénu ==

Teraz aby sme pokračovali niečím užitočným, vytvoríme si palletu, na čo využijeme Pallete API, ktorá bude obsahovať komponenty, ktoré môžeme použiť a pridať na našu scénu pretiahnutím.
Pre ďalšie pokračovanie budeme potrebovať 3 obrázky našich komponentov, použime tieto(kliknite pravým---uložiť ako, nemente názvy):
[[Súbor:Image1.png]][[Súbor:Image2.png]][[Súbor:Image3.png]]

'''Keďže náš tutoriál sa zaoberá s Visual Library API, a nie s Palette API(info tu:[http://netbeans.org/kb/trails/platform.html] ), na funkcionalitu Paletty použijeme už hotové knižnice, ktoré stiahnete tu''':
[http://www.sendspace.com/file/dqtnbi]

1. Klikneme na náš projekt pravým--new--Java Package a pomenujeme ho '''org.netbeans.shapesample.palette'''
2. Teraz podme do zložky, kde sme nás projekt uložili, konkrétne '''násProjekt/src/org/netbeans/shapesample/pallete'''. A do tejto''' zložky nakopírujeme stiahnuté obrázky a následne aj knižnice''', čiže tieto súbory: 
a/ Category 
b/ CategoryChildren 
c/ CategoryNode 
d/ PaletteSupport 
e/ Shape 
f/ ShapeChildren 
g/ ShapeNode 
h/ image1, image2, image3 
po zobrazení NetBeans sa nám novo vytvorený package obnoví, a budeme tam mať načítané všetky vložené súbory, pričom niekde sa znovu objavia červené krúžky so žiarovkou, to si nevšímajme chvíľku

3. Klikneme '''pravým na projekt--Properties--Libraries--Add''' a pridáme nasledujúce knižnice: 
a/ Actions APIs 
b/ Nodes API 
c/ Common Palette 
Teraz by sme mali spozorovať, že všetky červené guličky nám zmiznú, a bude nám to vypadať nasledovne: 
[[Súbor:Ytb siedmy.png]]

4. Teraz pridáme našu Palettu do ShapeTopComponentovho náhľadu, a to tak, že do konštruktoru ShapeTopComponent kod
associateLookup( Lookups.fixed( new Object[] { PaletteSupport.createPalette() } ) );

5. Znova sa nám objaví žltá žiarovka, klikneme na ňu dáme "Add import...", následne sa tam objaví znova, čiže znova klikneme a dáme "Add import..."

6. Spustite modul znova(pravým--run), teraz by to už malo vypadať takto, no zatiaľ bez funkcionality, pretože potrebujeme Layer Widget: 
[[Súbor:Ytb osmy.png]]

== Pridanie LayerWidget ==

Pod pojmom LayerWidget si predstavte niečo priesvitné, na ktoré budeme môcť ukladať naše komponenty s paletty.

1. Ná úrovni triedy GraphSceneImpl deklarujte náš LayerWidget
private LayerWidget mainLayer;

2. Do konštruktoru GraphSceneImpl pridajte LayerWidget ako dieťa našej scény:
mainLayer = new LayerWidget (this);
addChild (mainLayer);

Teraz keď pridáme na scénu nejaký komponent s našej paletty , pridajú sa ako deti do našel mainLayer.

== Pridanie IconNodeWidget (komponentu) cez funkcionalitu Drag and Drop (chyť a hoď) ==

Doposiaľ, naša scéna existuje, ale nemá žiadnu funkcionalitu. Túto funkcionalitu pridáme pomocou '''"actions"'''. Action, ktorá nám umožnuje Drag & Drop funkcionalitu je '''AcceptAction''' . Táto action môže byť aplikovaná buď na náš komponent alebo na našu scénu. My ju budeme aplikovať na našu scénu. Využijeme '''createAcceptAction''' na to, aby sme definovali čo sa má stať po tom, ako je komponent pretiahnutý nad našu scénu.

1. Najprv pridajte '''createAcceptAction''' spolu s jeho dvomi metódami do GraphSceneImpl konštruktoru:
getActions().addAction(ActionFactory.createAcceptAction(new AcceptProvider() {
public ConnectorState isAcceptable(Widget widget, Point point, Transferable transferable) {
Image dragImage = getImageFromTransferable(transferable);
JComponent view = getView();
Graphics2D g2 = (Graphics2D) view.getGraphics();
Rectangle visRect = view.getVisibleRect();
view.paintImmediately(visRect.x, visRect.y, visRect.width, visRect.height);
g2.drawImage(dragImage,
AffineTransform.getTranslateInstance(point.getLocation().getX(),
point.getLocation().getY()),
null);
return ConnectorState.ACCEPT;
}
public void accept(Widget widget, Point point, Transferable transferable) {
Image image = getImageFromTransferable(transferable);
Widget w = GraphSceneImpl.this.addNode(new MyNode(image));
w.setPreferredLocation(widget.convertLocalToScene(point));
}
}));

Objaví sa nám viacero chýb, a to z toho dôvodu, že sme použili aj metody, ktoré zatiaľ nie sú definované, čiže si chvíľku nevšímajme tieto errory.

2. Teraz do triedy '''GraphSceneImpl''' pridáme pomocnú metódu na získavanie obrázkov:
private Image getImageFromTransferable(Transferable transferable) {
Object o = null;
try {
o = transferable.getTransferData(DataFlavor.imageFlavor);
} catch (IOException ex) {
ex.printStackTrace();
} catch (UnsupportedFlavorException ex) {
ex.printStackTrace();
}
return o instanceof Image ? (Image) o : ImageUtilities.loadImage("org/netbeans/shapesample/palette/shape1.png");
}
Ako vidíme, je tu ošetrená chyba, čiže môžete do org.netbeans.shapesample.palette doplniť obrázok, ktorý sa má objaviť pri chybe, dajte mu meno shape1.png

3. Z dôvodu toho, že máme len 3 obrázky, mohli by sme vytvoriť akoby len 3 prvky, preto si vytvoríme novú triedu s názvom '''MyNode'''. Klikneme na náš '''package shapesample pravým--new---java class''' a bude vypadať takto:
public class MyNode {
private Image image;

public MyNode(Image image) {
this.image = image;
}
public Image getImage() {
return image;
}
}

Klikneme na žltú žiarovku v tejto triede a dáme '''"Add import..."'''

4. Zmeníme teraz v triede '''GraphSceneImpl''' rodiča, od ktorého dedí, čiže jeden z prvý riadkov bude vypadať takto:
public class GraphSceneImpl extends GraphScene<MyNode, String>{...telo triedy...}
čím sme zabezpečili, že naša Node je prijatá cez Visual Library. Teraz sa nám objaví žltá žiarovka aj pri tomto riadku, lebo teraz musíme dediť iné abstraktné metódy, '''čiže klikneme na ňu --implement all abstract methods'''
5. Kedže používame generics, tak klikneme '''pravým na náš projekt--properties--sources''' a presvedčíme sa, že tam máme hodnotu '''Source level = 1.5'''

6. Následne definujeme náš nový Widget (komponent) v triede '''GraphSceneImpl''' a to tak, že tam nájdeme metódu '''protected Widget attachNodeWidget(MyNode node)''' a upravíme ju nasledovne:
protected Widget attachNodeWidget(MyNode node) {
IconNodeWidget widget = new IconNodeWidget(this);
widget.setImage(node.getImage());
widget.setLabel(Long.toString(node.hashCode()));
widget.getActions().addAction(ActionFactory.createMoveAction());
mainLayer.addChild(widget);
return widget;
}
Týmto nášmu Widgetu nastavíme obrázok, a priradíme mu veľké náhodné číslo, a ešte možnosť posúvať ho po našej scéne, a následne po zastavení ho pridať znova ako child.

7. Ešte stále nám ostáva pár žltých žiaroviek, takže klikneme na každú z nich, ktorá tam bude a dáme '''"Add import..."'''

8. Spustíme náš projekt, a už uvidíme, že je možné presúvať komponenty (Widgety) z našej paletty na našu scénku:

== Pridanie funkcionality pre našu scénu ==
1.Teraz pridáme najprv ZOOMaction na našu scénku a to tak, že na koniec '''GraphSceneImpl''' konštruktoru pridáme:
getActions().addAction(ActionFactory.createZoomAction());

Keď spustíme teraz náš projekt, tak pri pridržaní ctrl+ kolieško myši sa nám bude zoomovať naša plocha

2. Pridaním riadku za predošlým :
getActions().addAction(ActionFactory.createPanAction());
Pridáme funkcionalitu, že keď user potlačí kolečko myši, tak potom môže hýbať do hociktorého smeru.

== Pridanie funkcinality pre IconNodeWidget ==
Pre IconNodeWidget sme už pridali funcionalitu pre hýbanie '''MoveAction'''. Tak isto sme schopný pridať aj funkcionalitu pre '''HoverAction, SelectAction, a InplaceEditorAction''', v poradí (nadídenie, vybranie, premenovanie)
1. Najprv na úrovni triedy definujte
private WidgetAction editorAction = ActionFactory.createInplaceEditorAction(new LabelTextFieldEditor());
Následne sa objaví znova žltá žiarovka, najprv dajte '''"Add import..."''', následne dajte '''"Create class LabelTextFieldEditor..."''' , čo nám pridá do nášho package triedu.
2.Telo tejto triedy '''LabelTextFieldEditor''' zmeníme nasledovne:
class LabelTextFieldEditor implements TextFieldInplaceEditor {
public boolean isEnabled(Widget widget) {
return true;
}
public String getText(Widget widget) {
return ((LabelWidget) widget).getLabel();
}
public void setText(Widget widget, String text) {
((LabelWidget) widget).setLabel(text);
}
}
Znovu sa v tejto triede objaví zopár žltých žiaroviek, poklikajte na '''"add import..."'''

3. Následne priradíme editorAction nášmu IconNodeWidget, a to tak, že na koniec metódy '''protected Widget attachNodeWidget(MyNode node)''' triedy '''GraphSceneImpl''' vložíme tesne nad riadok ''' mainLayer.addChild(widget);''' nasledujúci kód:
widget.getLabelWidget().getActions().addAction(editorAction);

4. Následne Hower, Clicked action dolníme tak, že po vyššie doplnenom riadku dáme tieto dva:
widget.getActions().addAction(createSelectAction());
widget.getActions().addAction(createObjectHoverAction());

5. Teraz musíme trochu premyslieť poradie, v ktorom sme akcie pridali, info tu [http://bits.netbeans.org/dev/javadoc/org-netbeans-api-visual/org/netbeans/api/visual/widget/doc-files/documentation.html#OrderOfActions]
A následne bude naša metóda '''protected Widget attachNodeWidget''' vypadať nasledovne
protected Widget attachNodeWidget(MyNode node) {
IconNodeWidget widget = new IconNodeWidget(this);
widget.setImage(node.getImage());
widget.setLabel(Long.toString(node.hashCode()));
//double-click, event sa spustí len pri doubleclicku:
widget.getLabelWidget().getActions().addAction(editorAction);
//single-click, event sa spustí pri single clicku
widget.getActions().addAction(createSelectAction());
//mouse-dragged
widget.getActions().addAction(ActionFactory.createMoveAction());
//mouse-over,
widget.getActions().addAction(createObjectHoverAction());
mainLayer.addChild(widget);
return widget;
}

6. Po spustení to bude môcť vypadať takto napr. 
[[Súbor:Ytb desat.png]]

== Záver a riešenie problémov ==

Ukázali sme v skutku len veľmi strohú ukážku, čo by sa s NetBeans dalo spraviť, ale keďže je to problematika, ktorou by sa mali zaoberať knihy pre pokročilejších programerov, tak tu skončíme.

V prípade nejasností je vždy dobré sa obráti na stránku NetBeans tutorials [http://netbeans.org/kb/trails/platform.html]

V prípade problémov, resp. riešenia chýb uvedeného návodu, '''odporúčam použiť VYTVORENY FUNKCNY MODUL''' 
'''Download:''' [http://plugins.netbeans.org/PluginPortal/faces/PluginDetailPage.jsp?pluginid=14027] 
'''Inštalácia:''' Spustite '''NetBeans--Tools--Plugins--kliknite Downloaded--Add Plugins...--nájdite stiahnutý--install''' 
'''Spustenie pluginu:''' '''Spustite NetBeans--File--New Project--Samples--NetBeansModule--Visual Library Demo''' 
 
V prípade nejasností, je tam všetko štruktúrované ako v našom návode, čiže by ste tam mali nájsť svoju chybu dosť rýchlo a prehľadne. 
 
'''ENJOY!''' 

Zdroj:[http://platform.netbeans.org/tutorials/nbm-visual_library.html]

Základy práce s NetBeans IDE a vývoj modulov

2010-04-25T21:22:42Z

Pokoraczki1: /* Pridanie funkcinality pre IconNodeWidget */

Súbor:Ytb desat.png

2010-04-25T21:22:18Z

Pokoraczki1:

Základy práce s NetBeans IDE a vývoj modulov

2010-04-25T21:20:18Z

Pokoraczki1: /* Pridanie IconNodeWidget (komponentu) cez funkcionalitu Drag and Drop (chyť a hoď) */

Základy práce s NetBeans IDE a vývoj modulov

2010-04-25T20:54:46Z

Pokoraczki1: /* Pridanie IconNodeWidget (komponentu) cez funkcionalitu Drag and Drop (chyť a hoď) */

Základy práce s NetBeans IDE a vývoj modulov

2010-04-25T20:48:03Z

Pokoraczki1: /* Pridanie IconNodeWidget (komponentu) cez funkcionalitu Drag and Drop (chyť a hoď) */

Základy práce s NetBeans IDE a vývoj modulov

2010-04-25T10:42:20Z

Pokoraczki1: /* Pridanie LayerWidget */

Základy práce s NetBeans IDE a vývoj modulov

2010-04-25T09:44:51Z

Pokoraczki1:

Súbor:Ytb osmy.png

2010-04-25T09:42:09Z

Pokoraczki1:

Súbor:Ytb siedmy.png

2010-04-25T09:32:44Z

Pokoraczki1:

Súbor:Image3.png

2010-04-25T09:05:58Z

Pokoraczki1:

Súbor:Image2.png

2010-04-25T09:05:31Z

Pokoraczki1:

Súbor:Image1.png

2010-04-25T09:04:53Z

Pokoraczki1:

Základy práce s NetBeans IDE a vývoj modulov

2010-04-21T22:16:54Z

Pokoraczki1:

Súbor:Ytb siesty.png

2010-04-21T22:15:11Z

Pokoraczki1:

Základy práce s NetBeans IDE a vývoj modulov

2010-04-21T21:47:40Z

Pokoraczki1:

Súbor:Ytb piaty.png

2010-04-21T21:44:53Z

Pokoraczki1:

Súbor:Ytb stvrty.png

2010-04-21T21:33:18Z

Pokoraczki1: bola nahraná nová verzia „Súbor:Ytb stvrty.png“

Základy práce s NetBeans IDE a vývoj modulov

2010-04-21T21:29:01Z

Pokoraczki1:

Súbor:Ytb stvrty.png

2010-04-21T21:27:46Z

Pokoraczki1:

Základy práce s NetBeans IDE a vývoj modulov

2010-04-21T21:09:08Z

Pokoraczki1:

Súbor:Ytb treti.png

2010-04-21T21:06:32Z

Pokoraczki1:

Súbor:Ytb druhy.png

2010-04-21T21:02:12Z

Pokoraczki1:

Súbor:Ytb prvy.png

2010-04-21T20:59:03Z

Pokoraczki1:

Základy práce s NetBeans IDE a vývoj modulov

2010-04-21T19:28:01Z

Pokoraczki1: Vytvorená stránka „Work in progress :)“

Work in progress :)

Podklady k prednáškam a cvičeniam

2010-04-21T19:27:38Z

Pokoraczki1: