You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@netbeans.apache.org by ge...@apache.org on 2020/11/29 13:36:50 UTC
[netbeans-website] branch master updated: Update Platform Module
quickstart
This is an automated email from the ASF dual-hosted git repository.
geertjan pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/netbeans-website.git
The following commit(s) were added to refs/heads/master by this push:
new 023d7da Update Platform Module quickstart
new fb53855 Merge pull request #500 from bradh/nbm-quick-start
023d7da is described below
commit 023d7dad4edf5981e76857efcbe98e486a093691
Author: Brad Hards <br...@frogmouth.net>
AuthorDate: Sun Nov 22 15:51:37 2020 +1100
Update Platform Module quickstart
---
.../tutorials/images/nbm-quick-start/new-api-1.png | Bin 0 -> 20317 bytes
.../images/nbm-quick-start/new-api-10.png | Bin 0 -> 31590 bytes
.../tutorials/images/nbm-quick-start/new-api-2.png | Bin 0 -> 58779 bytes
.../tutorials/images/nbm-quick-start/new-api-3.png | Bin 0 -> 58371 bytes
.../tutorials/images/nbm-quick-start/new-api-4.png | Bin 0 -> 26561 bytes
.../tutorials/images/nbm-quick-start/new-api-5.png | Bin 0 -> 33211 bytes
.../tutorials/images/nbm-quick-start/new-api-6.png | Bin 0 -> 56757 bytes
.../tutorials/images/nbm-quick-start/new-api-7.png | Bin 0 -> 28613 bytes
.../tutorials/images/nbm-quick-start/new-api-8.png | Bin 0 -> 24505 bytes
.../tutorials/images/nbm-quick-start/new-api-9.png | Bin 0 -> 58736 bytes
.../tutorials/images/nbm-quick-start/new-app-1.png | Bin 0 -> 30677 bytes
.../tutorials/images/nbm-quick-start/new-app-2.png | Bin 0 -> 53627 bytes
.../tutorials/images/nbm-quick-start/new-app-3.png | Bin 0 -> 45156 bytes
.../tutorials/images/nbm-quick-start/new-app-4.png | Bin 0 -> 45276 bytes
.../images/nbm-quick-start/new-history-1.png | Bin 0 -> 59133 bytes
.../images/nbm-quick-start/new-history-2.png | Bin 0 -> 61937 bytes
.../images/nbm-quick-start/new-history-3.png | Bin 0 -> 22188 bytes
.../images/nbm-quick-start/new-impl-1.png | Bin 0 -> 17955 bytes
.../images/nbm-quick-start/new-impl-10.png | Bin 0 -> 56292 bytes
.../images/nbm-quick-start/new-impl-11.png | Bin 0 -> 34510 bytes
.../images/nbm-quick-start/new-impl-12.png | Bin 0 -> 37012 bytes
.../images/nbm-quick-start/new-impl-13.png | Bin 0 -> 36186 bytes
.../images/nbm-quick-start/new-impl-14.png | Bin 0 -> 22987 bytes
.../images/nbm-quick-start/new-impl-15.png | Bin 0 -> 37918 bytes
.../images/nbm-quick-start/new-impl-2.png | Bin 0 -> 58621 bytes
.../images/nbm-quick-start/new-impl-3.png | Bin 0 -> 58616 bytes
.../images/nbm-quick-start/new-impl-4.png | Bin 0 -> 20902 bytes
.../images/nbm-quick-start/new-impl-5.png | Bin 0 -> 23275 bytes
.../images/nbm-quick-start/new-impl-6.png | Bin 0 -> 36944 bytes
.../images/nbm-quick-start/new-impl-7.png | Bin 0 -> 22851 bytes
.../images/nbm-quick-start/new-impl-8.png | Bin 0 -> 23842 bytes
.../images/nbm-quick-start/new-impl-9.png | Bin 0 -> 38118 bytes
.../images/nbm-quick-start/new-module-1.png | Bin 0 -> 14537 bytes
.../images/nbm-quick-start/new-module-2.png | Bin 0 -> 58561 bytes
.../images/nbm-quick-start/new-module-3.png | Bin 0 -> 58302 bytes
.../images/nbm-quick-start/new-module-4.png | Bin 0 -> 21372 bytes
.../images/nbm-quick-start/new-project-1.png | Bin 0 -> 76558 bytes
.../images/nbm-quick-start/new-project-2.png | Bin 0 -> 59152 bytes
.../images/nbm-quick-start/new-project-3.png | Bin 0 -> 12546 bytes
.../images/nbm-quick-start/new-result-1.png | Bin 0 -> 46401 bytes
.../images/nbm-quick-start/new-result-2.png | Bin 0 -> 52964 bytes
.../images/nbm-quick-start/new-window-1.png | Bin 0 -> 31002 bytes
.../images/nbm-quick-start/new-window-2.png | Bin 0 -> 85653 bytes
.../images/nbm-quick-start/new-window-3.png | Bin 0 -> 60172 bytes
.../images/nbm-quick-start/new-window-4.png | Bin 0 -> 62417 bytes
.../images/nbm-quick-start/new-window-5.png | Bin 0 -> 23353 bytes
.../images/nbm-quick-start/new-window-6.png | Bin 0 -> 16320 bytes
.../images/nbm-quick-start/new-window-7.png | Bin 0 -> 19228 bytes
.../images/nbm-quick-start/new-window-8.png | Bin 0 -> 18317 bytes
.../src/content/tutorials/nbm-quick-start.asciidoc | 396 ++++++++++++---------
50 files changed, 225 insertions(+), 171 deletions(-)
diff --git a/netbeans.apache.org/src/content/tutorials/images/nbm-quick-start/new-api-1.png b/netbeans.apache.org/src/content/tutorials/images/nbm-quick-start/new-api-1.png
new file mode 100644
index 0000000..66d2931
Binary files /dev/null and b/netbeans.apache.org/src/content/tutorials/images/nbm-quick-start/new-api-1.png differ
diff --git a/netbeans.apache.org/src/content/tutorials/images/nbm-quick-start/new-api-10.png b/netbeans.apache.org/src/content/tutorials/images/nbm-quick-start/new-api-10.png
new file mode 100644
index 0000000..f3a5882
Binary files /dev/null and b/netbeans.apache.org/src/content/tutorials/images/nbm-quick-start/new-api-10.png differ
diff --git a/netbeans.apache.org/src/content/tutorials/images/nbm-quick-start/new-api-2.png b/netbeans.apache.org/src/content/tutorials/images/nbm-quick-start/new-api-2.png
new file mode 100644
index 0000000..366db45
Binary files /dev/null and b/netbeans.apache.org/src/content/tutorials/images/nbm-quick-start/new-api-2.png differ
diff --git a/netbeans.apache.org/src/content/tutorials/images/nbm-quick-start/new-api-3.png b/netbeans.apache.org/src/content/tutorials/images/nbm-quick-start/new-api-3.png
new file mode 100644
index 0000000..ae91c37
Binary files /dev/null and b/netbeans.apache.org/src/content/tutorials/images/nbm-quick-start/new-api-3.png differ
diff --git a/netbeans.apache.org/src/content/tutorials/images/nbm-quick-start/new-api-4.png b/netbeans.apache.org/src/content/tutorials/images/nbm-quick-start/new-api-4.png
new file mode 100644
index 0000000..eed39f2
Binary files /dev/null and b/netbeans.apache.org/src/content/tutorials/images/nbm-quick-start/new-api-4.png differ
diff --git a/netbeans.apache.org/src/content/tutorials/images/nbm-quick-start/new-api-5.png b/netbeans.apache.org/src/content/tutorials/images/nbm-quick-start/new-api-5.png
new file mode 100644
index 0000000..71af62a
Binary files /dev/null and b/netbeans.apache.org/src/content/tutorials/images/nbm-quick-start/new-api-5.png differ
diff --git a/netbeans.apache.org/src/content/tutorials/images/nbm-quick-start/new-api-6.png b/netbeans.apache.org/src/content/tutorials/images/nbm-quick-start/new-api-6.png
new file mode 100644
index 0000000..4f8ef65
Binary files /dev/null and b/netbeans.apache.org/src/content/tutorials/images/nbm-quick-start/new-api-6.png differ
diff --git a/netbeans.apache.org/src/content/tutorials/images/nbm-quick-start/new-api-7.png b/netbeans.apache.org/src/content/tutorials/images/nbm-quick-start/new-api-7.png
new file mode 100644
index 0000000..4a2a656
Binary files /dev/null and b/netbeans.apache.org/src/content/tutorials/images/nbm-quick-start/new-api-7.png differ
diff --git a/netbeans.apache.org/src/content/tutorials/images/nbm-quick-start/new-api-8.png b/netbeans.apache.org/src/content/tutorials/images/nbm-quick-start/new-api-8.png
new file mode 100644
index 0000000..5c6380f
Binary files /dev/null and b/netbeans.apache.org/src/content/tutorials/images/nbm-quick-start/new-api-8.png differ
diff --git a/netbeans.apache.org/src/content/tutorials/images/nbm-quick-start/new-api-9.png b/netbeans.apache.org/src/content/tutorials/images/nbm-quick-start/new-api-9.png
new file mode 100644
index 0000000..4b6cd3a
Binary files /dev/null and b/netbeans.apache.org/src/content/tutorials/images/nbm-quick-start/new-api-9.png differ
diff --git a/netbeans.apache.org/src/content/tutorials/images/nbm-quick-start/new-app-1.png b/netbeans.apache.org/src/content/tutorials/images/nbm-quick-start/new-app-1.png
new file mode 100644
index 0000000..c401736
Binary files /dev/null and b/netbeans.apache.org/src/content/tutorials/images/nbm-quick-start/new-app-1.png differ
diff --git a/netbeans.apache.org/src/content/tutorials/images/nbm-quick-start/new-app-2.png b/netbeans.apache.org/src/content/tutorials/images/nbm-quick-start/new-app-2.png
new file mode 100644
index 0000000..318aba0
Binary files /dev/null and b/netbeans.apache.org/src/content/tutorials/images/nbm-quick-start/new-app-2.png differ
diff --git a/netbeans.apache.org/src/content/tutorials/images/nbm-quick-start/new-app-3.png b/netbeans.apache.org/src/content/tutorials/images/nbm-quick-start/new-app-3.png
new file mode 100644
index 0000000..d4dec70
Binary files /dev/null and b/netbeans.apache.org/src/content/tutorials/images/nbm-quick-start/new-app-3.png differ
diff --git a/netbeans.apache.org/src/content/tutorials/images/nbm-quick-start/new-app-4.png b/netbeans.apache.org/src/content/tutorials/images/nbm-quick-start/new-app-4.png
new file mode 100644
index 0000000..ec1b7b0
Binary files /dev/null and b/netbeans.apache.org/src/content/tutorials/images/nbm-quick-start/new-app-4.png differ
diff --git a/netbeans.apache.org/src/content/tutorials/images/nbm-quick-start/new-history-1.png b/netbeans.apache.org/src/content/tutorials/images/nbm-quick-start/new-history-1.png
new file mode 100644
index 0000000..a9a9700
Binary files /dev/null and b/netbeans.apache.org/src/content/tutorials/images/nbm-quick-start/new-history-1.png differ
diff --git a/netbeans.apache.org/src/content/tutorials/images/nbm-quick-start/new-history-2.png b/netbeans.apache.org/src/content/tutorials/images/nbm-quick-start/new-history-2.png
new file mode 100644
index 0000000..da15c11
Binary files /dev/null and b/netbeans.apache.org/src/content/tutorials/images/nbm-quick-start/new-history-2.png differ
diff --git a/netbeans.apache.org/src/content/tutorials/images/nbm-quick-start/new-history-3.png b/netbeans.apache.org/src/content/tutorials/images/nbm-quick-start/new-history-3.png
new file mode 100644
index 0000000..a0808c9
Binary files /dev/null and b/netbeans.apache.org/src/content/tutorials/images/nbm-quick-start/new-history-3.png differ
diff --git a/netbeans.apache.org/src/content/tutorials/images/nbm-quick-start/new-impl-1.png b/netbeans.apache.org/src/content/tutorials/images/nbm-quick-start/new-impl-1.png
new file mode 100644
index 0000000..6b3afc2
Binary files /dev/null and b/netbeans.apache.org/src/content/tutorials/images/nbm-quick-start/new-impl-1.png differ
diff --git a/netbeans.apache.org/src/content/tutorials/images/nbm-quick-start/new-impl-10.png b/netbeans.apache.org/src/content/tutorials/images/nbm-quick-start/new-impl-10.png
new file mode 100644
index 0000000..2abc0aa
Binary files /dev/null and b/netbeans.apache.org/src/content/tutorials/images/nbm-quick-start/new-impl-10.png differ
diff --git a/netbeans.apache.org/src/content/tutorials/images/nbm-quick-start/new-impl-11.png b/netbeans.apache.org/src/content/tutorials/images/nbm-quick-start/new-impl-11.png
new file mode 100644
index 0000000..6caebe9
Binary files /dev/null and b/netbeans.apache.org/src/content/tutorials/images/nbm-quick-start/new-impl-11.png differ
diff --git a/netbeans.apache.org/src/content/tutorials/images/nbm-quick-start/new-impl-12.png b/netbeans.apache.org/src/content/tutorials/images/nbm-quick-start/new-impl-12.png
new file mode 100644
index 0000000..27db45f
Binary files /dev/null and b/netbeans.apache.org/src/content/tutorials/images/nbm-quick-start/new-impl-12.png differ
diff --git a/netbeans.apache.org/src/content/tutorials/images/nbm-quick-start/new-impl-13.png b/netbeans.apache.org/src/content/tutorials/images/nbm-quick-start/new-impl-13.png
new file mode 100644
index 0000000..ba5c18f
Binary files /dev/null and b/netbeans.apache.org/src/content/tutorials/images/nbm-quick-start/new-impl-13.png differ
diff --git a/netbeans.apache.org/src/content/tutorials/images/nbm-quick-start/new-impl-14.png b/netbeans.apache.org/src/content/tutorials/images/nbm-quick-start/new-impl-14.png
new file mode 100644
index 0000000..32fec80
Binary files /dev/null and b/netbeans.apache.org/src/content/tutorials/images/nbm-quick-start/new-impl-14.png differ
diff --git a/netbeans.apache.org/src/content/tutorials/images/nbm-quick-start/new-impl-15.png b/netbeans.apache.org/src/content/tutorials/images/nbm-quick-start/new-impl-15.png
new file mode 100644
index 0000000..080a4b4
Binary files /dev/null and b/netbeans.apache.org/src/content/tutorials/images/nbm-quick-start/new-impl-15.png differ
diff --git a/netbeans.apache.org/src/content/tutorials/images/nbm-quick-start/new-impl-2.png b/netbeans.apache.org/src/content/tutorials/images/nbm-quick-start/new-impl-2.png
new file mode 100644
index 0000000..fdc436b
Binary files /dev/null and b/netbeans.apache.org/src/content/tutorials/images/nbm-quick-start/new-impl-2.png differ
diff --git a/netbeans.apache.org/src/content/tutorials/images/nbm-quick-start/new-impl-3.png b/netbeans.apache.org/src/content/tutorials/images/nbm-quick-start/new-impl-3.png
new file mode 100644
index 0000000..6c3f0bc
Binary files /dev/null and b/netbeans.apache.org/src/content/tutorials/images/nbm-quick-start/new-impl-3.png differ
diff --git a/netbeans.apache.org/src/content/tutorials/images/nbm-quick-start/new-impl-4.png b/netbeans.apache.org/src/content/tutorials/images/nbm-quick-start/new-impl-4.png
new file mode 100644
index 0000000..26b5b47
Binary files /dev/null and b/netbeans.apache.org/src/content/tutorials/images/nbm-quick-start/new-impl-4.png differ
diff --git a/netbeans.apache.org/src/content/tutorials/images/nbm-quick-start/new-impl-5.png b/netbeans.apache.org/src/content/tutorials/images/nbm-quick-start/new-impl-5.png
new file mode 100644
index 0000000..4f7fbf7
Binary files /dev/null and b/netbeans.apache.org/src/content/tutorials/images/nbm-quick-start/new-impl-5.png differ
diff --git a/netbeans.apache.org/src/content/tutorials/images/nbm-quick-start/new-impl-6.png b/netbeans.apache.org/src/content/tutorials/images/nbm-quick-start/new-impl-6.png
new file mode 100644
index 0000000..d78992a
Binary files /dev/null and b/netbeans.apache.org/src/content/tutorials/images/nbm-quick-start/new-impl-6.png differ
diff --git a/netbeans.apache.org/src/content/tutorials/images/nbm-quick-start/new-impl-7.png b/netbeans.apache.org/src/content/tutorials/images/nbm-quick-start/new-impl-7.png
new file mode 100644
index 0000000..7faa107
Binary files /dev/null and b/netbeans.apache.org/src/content/tutorials/images/nbm-quick-start/new-impl-7.png differ
diff --git a/netbeans.apache.org/src/content/tutorials/images/nbm-quick-start/new-impl-8.png b/netbeans.apache.org/src/content/tutorials/images/nbm-quick-start/new-impl-8.png
new file mode 100644
index 0000000..675cf61
Binary files /dev/null and b/netbeans.apache.org/src/content/tutorials/images/nbm-quick-start/new-impl-8.png differ
diff --git a/netbeans.apache.org/src/content/tutorials/images/nbm-quick-start/new-impl-9.png b/netbeans.apache.org/src/content/tutorials/images/nbm-quick-start/new-impl-9.png
new file mode 100644
index 0000000..37226c2
Binary files /dev/null and b/netbeans.apache.org/src/content/tutorials/images/nbm-quick-start/new-impl-9.png differ
diff --git a/netbeans.apache.org/src/content/tutorials/images/nbm-quick-start/new-module-1.png b/netbeans.apache.org/src/content/tutorials/images/nbm-quick-start/new-module-1.png
new file mode 100644
index 0000000..dab212e
Binary files /dev/null and b/netbeans.apache.org/src/content/tutorials/images/nbm-quick-start/new-module-1.png differ
diff --git a/netbeans.apache.org/src/content/tutorials/images/nbm-quick-start/new-module-2.png b/netbeans.apache.org/src/content/tutorials/images/nbm-quick-start/new-module-2.png
new file mode 100644
index 0000000..70e4c40
Binary files /dev/null and b/netbeans.apache.org/src/content/tutorials/images/nbm-quick-start/new-module-2.png differ
diff --git a/netbeans.apache.org/src/content/tutorials/images/nbm-quick-start/new-module-3.png b/netbeans.apache.org/src/content/tutorials/images/nbm-quick-start/new-module-3.png
new file mode 100644
index 0000000..d1062d2
Binary files /dev/null and b/netbeans.apache.org/src/content/tutorials/images/nbm-quick-start/new-module-3.png differ
diff --git a/netbeans.apache.org/src/content/tutorials/images/nbm-quick-start/new-module-4.png b/netbeans.apache.org/src/content/tutorials/images/nbm-quick-start/new-module-4.png
new file mode 100644
index 0000000..9eff703
Binary files /dev/null and b/netbeans.apache.org/src/content/tutorials/images/nbm-quick-start/new-module-4.png differ
diff --git a/netbeans.apache.org/src/content/tutorials/images/nbm-quick-start/new-project-1.png b/netbeans.apache.org/src/content/tutorials/images/nbm-quick-start/new-project-1.png
new file mode 100644
index 0000000..60b3ef6
Binary files /dev/null and b/netbeans.apache.org/src/content/tutorials/images/nbm-quick-start/new-project-1.png differ
diff --git a/netbeans.apache.org/src/content/tutorials/images/nbm-quick-start/new-project-2.png b/netbeans.apache.org/src/content/tutorials/images/nbm-quick-start/new-project-2.png
new file mode 100644
index 0000000..bbb8741
Binary files /dev/null and b/netbeans.apache.org/src/content/tutorials/images/nbm-quick-start/new-project-2.png differ
diff --git a/netbeans.apache.org/src/content/tutorials/images/nbm-quick-start/new-project-3.png b/netbeans.apache.org/src/content/tutorials/images/nbm-quick-start/new-project-3.png
new file mode 100644
index 0000000..5c95caa
Binary files /dev/null and b/netbeans.apache.org/src/content/tutorials/images/nbm-quick-start/new-project-3.png differ
diff --git a/netbeans.apache.org/src/content/tutorials/images/nbm-quick-start/new-result-1.png b/netbeans.apache.org/src/content/tutorials/images/nbm-quick-start/new-result-1.png
new file mode 100644
index 0000000..3037fab
Binary files /dev/null and b/netbeans.apache.org/src/content/tutorials/images/nbm-quick-start/new-result-1.png differ
diff --git a/netbeans.apache.org/src/content/tutorials/images/nbm-quick-start/new-result-2.png b/netbeans.apache.org/src/content/tutorials/images/nbm-quick-start/new-result-2.png
new file mode 100644
index 0000000..13a48e6
Binary files /dev/null and b/netbeans.apache.org/src/content/tutorials/images/nbm-quick-start/new-result-2.png differ
diff --git a/netbeans.apache.org/src/content/tutorials/images/nbm-quick-start/new-window-1.png b/netbeans.apache.org/src/content/tutorials/images/nbm-quick-start/new-window-1.png
new file mode 100644
index 0000000..540a7e0
Binary files /dev/null and b/netbeans.apache.org/src/content/tutorials/images/nbm-quick-start/new-window-1.png differ
diff --git a/netbeans.apache.org/src/content/tutorials/images/nbm-quick-start/new-window-2.png b/netbeans.apache.org/src/content/tutorials/images/nbm-quick-start/new-window-2.png
new file mode 100644
index 0000000..39d4fa8
Binary files /dev/null and b/netbeans.apache.org/src/content/tutorials/images/nbm-quick-start/new-window-2.png differ
diff --git a/netbeans.apache.org/src/content/tutorials/images/nbm-quick-start/new-window-3.png b/netbeans.apache.org/src/content/tutorials/images/nbm-quick-start/new-window-3.png
new file mode 100644
index 0000000..33458a1
Binary files /dev/null and b/netbeans.apache.org/src/content/tutorials/images/nbm-quick-start/new-window-3.png differ
diff --git a/netbeans.apache.org/src/content/tutorials/images/nbm-quick-start/new-window-4.png b/netbeans.apache.org/src/content/tutorials/images/nbm-quick-start/new-window-4.png
new file mode 100644
index 0000000..0fd132d
Binary files /dev/null and b/netbeans.apache.org/src/content/tutorials/images/nbm-quick-start/new-window-4.png differ
diff --git a/netbeans.apache.org/src/content/tutorials/images/nbm-quick-start/new-window-5.png b/netbeans.apache.org/src/content/tutorials/images/nbm-quick-start/new-window-5.png
new file mode 100644
index 0000000..38c9cf0
Binary files /dev/null and b/netbeans.apache.org/src/content/tutorials/images/nbm-quick-start/new-window-5.png differ
diff --git a/netbeans.apache.org/src/content/tutorials/images/nbm-quick-start/new-window-6.png b/netbeans.apache.org/src/content/tutorials/images/nbm-quick-start/new-window-6.png
new file mode 100644
index 0000000..919628c
Binary files /dev/null and b/netbeans.apache.org/src/content/tutorials/images/nbm-quick-start/new-window-6.png differ
diff --git a/netbeans.apache.org/src/content/tutorials/images/nbm-quick-start/new-window-7.png b/netbeans.apache.org/src/content/tutorials/images/nbm-quick-start/new-window-7.png
new file mode 100644
index 0000000..281a99e
Binary files /dev/null and b/netbeans.apache.org/src/content/tutorials/images/nbm-quick-start/new-window-7.png differ
diff --git a/netbeans.apache.org/src/content/tutorials/images/nbm-quick-start/new-window-8.png b/netbeans.apache.org/src/content/tutorials/images/nbm-quick-start/new-window-8.png
new file mode 100644
index 0000000..17c22b6
Binary files /dev/null and b/netbeans.apache.org/src/content/tutorials/images/nbm-quick-start/new-window-8.png differ
diff --git a/netbeans.apache.org/src/content/tutorials/nbm-quick-start.asciidoc b/netbeans.apache.org/src/content/tutorials/nbm-quick-start.asciidoc
index 0b562d8..df1085b 100644
--- a/netbeans.apache.org/src/content/tutorials/nbm-quick-start.asciidoc
+++ b/netbeans.apache.org/src/content/tutorials/nbm-quick-start.asciidoc
@@ -51,7 +51,7 @@ NOTE: If you are using an earlier version of Apache NetBeans, see link:74/nbm-q
For troubleshooting purposes, you are welcome to download the link:http://web.archive.org/web/20170409072842/http://java.net/projects/nb-api-samples/show/versions/8.0/tutorials/WordProcessor[completed tutorial source code].
-NOTE: Even though it is a separate product, there is no need to download the NetBeans Platform separately. Typically, you develop the application in NetBeans IDE and then exclude the modules that are specific to the IDE but that are superfluous to your application.
+NOTE: Even though it is a separate product, there is no need to download the NetBeans Platform separately. Typically, you develop the application in NetBeans IDE and then exclude the modules that are specific to the IDE but that are not required for your application.
== A Single Module NetBeans Platform Application
@@ -73,7 +73,7 @@ In this section, you create your first NetBeans Platform application.
1. Choose File | New Project and then choose NetBeans Modules. Select "NetBeans Platform Application". You should see this:
-image::images/new-project-1.png[]
+image::images/nbm-quick-start/new-project-1.png[]
The difference between the 4 templates above is as follows:
@@ -82,19 +82,19 @@ The difference between the 4 templates above is as follows:
* *Library Wrapper Module.* A project that puts a library JAR file on its classpath and exports some or all of the JAR file's packages from the module as public packages.
* *Module.* A project for implementing the functionality, business logic, and user interface of a module or application built on the NetBeans Platform.
-Click Next.
+Click btn:[Next].
[start=2]
-1. Name your new application "WordProcessor" and specify a folder on disk for storing it:
+1. Name your new application `WordProcessor` and specify a folder on disk for storing it:
-image::images/new-project-2.png[]
+image::images/nbm-quick-start/new-project-2.png[]
-Click Finish. The new project appears as follows in the Projects window:
+Click btn:[Finish]. The new project appears as follows in the Projects window:
-image::images/new-project-3.png[]
+image::images/nbm-quick-start/new-project-3.png[]
=== Create the Module
@@ -106,100 +106,96 @@ In this section, you create your first NetBeans Platform module.
1. Right-click the "Modules" node, shown in the screenshot above, and choose "Add New":
-image::images/new-module-1.png[]
+image::images/nbm-quick-start/new-module-1.png[]
-Name the new module "WordEditorCore":
+The New Module Project dialog will appear.
+Name the new module `WordEditorCore`:
-image::images/new-module-2.png[]
+image::images/nbm-quick-start/new-module-2.png[]
-Click Next.
+Click btn:[Next].
[start=2]
-1. Specify "org.word.editor.core" as the unique string identifying the module, which is its code name base, together with a project display name that will be shown in the Projects window.
+1. Specify "org.word.editor.core" as the Code Name Base, which is a unique string identifying the module. The Module Display Name is used as a label for the module in the Projects window.
-image::images/new-module-3.png[]
+image::images/nbm-quick-start/new-module-3.png[]
-Click Finish. The new module is created and its structure is shown in the Projects window:
+Click btn:[Finish]. The new module is created and its structure is shown in the Projects window:
-image::images/new-module-4.png[]
+image::images/nbm-quick-start/new-module-4.png[]
=== Create the Window
-In this section, you create your first NetBeans window.
+Having created a module, you now create your first NetBeans window.
[start=1]
-1. Right-click the "WordEditorCore" module and choose New | Other. In the Module Development category, select "Window":
+1. Right-click the "WordEditorCore" module and choose New | Other.
+image::images/nbm-quick-start/new-window-1.png[]
+The New File dialog appears. In the Module Development category, select "Window":
-image::images/new-window-1.png[]
+image::images/nbm-quick-start/new-window-2.png[]
-Click Next.
+Click btn:[Next].
[start=2]
-1. You should now see a dialog for specifying the position where the new window will appear in the application frame, as well as whether it will open automatically when the application starts, among other settings:
+1. You should now see a dialog for specifying the position where the new window will appear in the application frame, as well as whether it will open automatically when the application starts, among other settings.
+Set the Window Position to be `editor`, which is the default central position within the application frame, and select "Open on Application Start".
+image::images/nbm-quick-start/new-window-3.png[]
-image::images/new-window-2.png[]
-
-
-In the wizard step above, select "editor", which is the default central position within the application frame, and "Open on Application Start". Then click Next.
-
+Then click btn:[Next].
[start=3]
-1. Set the class name prefix to "Word" and the package to "org.word.editor.core":
-
-
-
-image::images/new-window-3.png[]
-
-
-Click Finish. The new window is added to the source structure of your module:
-
+1. Set the class name prefix to `Word` and the package to `org.word.editor.core`:
+image::images/nbm-quick-start/new-window-4.png[]
-image::images/new-window-4.png[]
+Click btn:[Finish]. The new window ("WordTopComponent.java") is added to the source structure of your module:
+image::images/nbm-quick-start/new-window-5.png[]
[start=4]
-1. Now double click on the file "WordTopComponent.java" to open it in the Design view of the "Matisse" GUI Builder.
+1. The new window should have opened in the Design view of the "Matisse" GUI Builder. You can double-click (or select "Open" from the context menu) it if it didn't open automatically.
+image::images/nbm-quick-start/new-window-6.png[]
+The Palette should be open on the right side (you can use menu:Window[IDE Tools>Palette] or kbd:[Ctrl+Shift+8] if not). Drag and drop a Button and a Text Area from the Palette onto the window:
-image::images/new-window-5.png[]
+image::images/nbm-quick-start/new-window-7.png[]
-Use the Palette (Ctrl-Shift-8) to drag and drop a button and a text area onto the window:
+Do the following to make the new GUI components more meaningful:
+* Right-click the text area, choose "Change Variable Name", and then name it `text`.
+* Right-click the button, choose "Edit Text", and then set the text of the button to `Filter!`. Also rename the variable to `filterButton`.
-
-image::images/new-window-5a.png[]
-
-Do the following to make the new GUI components meaningful:
-
-* Right-click the text area, choose "Change Variable Name", and then name it "text".
-* Right-click the button, choose "Edit Text", and then set the text of the button to "Filter!"
+image::images/nbm-quick-start/new-window-7.png[]
[start=5]
-1. Double click on the button, causing an event handling method to automatically be created in the Source editor. The method is called whenever the button is clicked. Change the body of the method to the following code.
+1. Double click on the button. This will create an event handling method in the Source editor. The method is called whenever the button is clicked. Change the body of the method to the following code:
[source,java]
----
-
-private void jButton1ActionPerformed(java.awt.event.ActionEvent evt) {
- *String s = text.getText();
- s = s.toUpperCase();
- text.setText(s);*
-}
+ private void filterButtonActionPerformed(java.awt.event.ActionEvent evt) {
+ String s = text.getText();
+ s = s.toUpperCase();
+ text.setText(s);
+ }
----
+You have now created the window module. When the "Filter!" button is clicked, the
+`filterButtonActionPerformed` method will be called, which will get the content of the
+`text` text area, convert that text to upper case, and put the upper case version into
+the `text` text area.
=== Run the Application
@@ -207,19 +203,26 @@ In this section, you deploy the application.
[start=1]
-1. Right-click the WordProcessor application and choose Run. Doing so will start up your new NetBeans Platform application and install your module. You will have a new window, as well as a new menu item for opening it, as shown below:
+1. Right-click the WordProcessor application (not the WordEditorCore module) and choose Run.
+
+image::images/nbm-quick-start/new-app-1.png[]
+Doing so will start up your new NetBeans Platform application and install your module. You will have a new window, as well as a new menu item for opening it, as shown below:
-image::images/new-app-1.png[]
+
+image::images/nbm-quick-start/new-app-2.png[]
[start=2]
-1. Enter a text in lowercase in the text area, and click "Filter!". You should see that the text is now shown in uppercase:
+1. Enter a text in lowercase in the text area, and click "Filter!".
+
+image::images/nbm-quick-start/new-app-3.png[]
+You should see that the text is now shown in uppercase:
-image::images/new-app-2.png[]
+image::images/nbm-quick-start/new-app-4.png[]
-You have learned how to create a new NetBeans Platform application and how to add new modules to it. In the next section, you will be introduced to the NetBeans Platform's pluggable service infrastructure.
+You have learned how to create a new Apache NetBeans Platform application and how to add new modules to it. In the next section, you will be introduced to the Apache NetBeans Platform's pluggable service infrastructure.
== A Modular Application Using Lookup
@@ -230,11 +233,14 @@ The GUI module, which you created in the previous section, will be loosely coupl
You will then create another loosely coupled service provider, named "LowercaseFilter".
+The concept is that instead of all the different functions needing to be added to "WordEditorCore", each function can be implemented separately, without coupling the filter operation to the display of the result.
+
+The steps are:
+
* <<api,Create the API>>
* <<impl,Implement the API>>
* <<run2,Run the Application>>
-
=== Create the API
In this section, you create an API.
@@ -244,31 +250,41 @@ In this section, you create an API.
1. Expand the new application in the Projects window, right-click the Modules node, and choose "Add New":
-image::images/new-api-1.png[]
+image::images/nbm-quick-start/new-api-1.png[]
-Name the new module "WordEditorAPI":
+The New Module Project dialog appears. Set the Project Name for the new module to be "WordEditorAPI":
-image::images/new-api-2.png[]
+image::images/nbm-quick-start/new-api-2.png[]
-Click Next. Use code name base "org.word.editor.api", as shown below:
+Click btn:[Next]. Set the Code Name Base to be `org.word.editor.api`, as shown below:
-image::images/new-api-3.png[]
+image::images/nbm-quick-start/new-api-3.png[]
-Complete the wizard, which adds the module to your previously created application, as you did in the previous section:
+Click btn:[Finish] to complete the wizard, which adds the module to your previously created application, just as in the previous section:
-image::images/new-api-4.png[]
+image::images//nbm-quick-start/new-api-4.png[]
+Having created the module, the next activity is to add an Interface to it.
+
[start=2]
-1. Right-click the "WordEditorAPI" module and choose New | Java Interface. Name the Java interface "WordFilter", in the package "org.word.editor.api":
+1. Right-click the "WordEditorAPI" module and choose New | Java Interface.
+
+image::images//nbm-quick-start/new-api-5.png[]
+Name the Java interface `WordFilter`, in the package `org.word.editor.api`:
-image::images/new-api-5.png[]
+image::images/nbm-quick-start/new-api-6.png[]
-Use the editor to define it as follows:
+Click btn:[Finish] to complete the wizard, which adds the interface to your module.
+
+image::images/nbm-quick-start/new-api-7.png[]
+
+[start=3]
+1. The WordFilter.java interface should be open. Use the editor to define it as follows:
[source,java]
@@ -284,91 +300,103 @@ public interface WordFilter {
----
-[start=3]
-1. Right-click the "WordEditorAPI" module, choose Properties, and use the "API Versioning" tab to specify that the package containing the interface should be available throughout the application:
+[start=4]
+1. Right-click the "WordEditorAPI" module, choose Properties to open the Project Properties window.
+image::images/nbm-quick-start/new-api-8.png[]
-image::images/new-api-6.png[]
+Select the "API Versioning" category, and check the box under "Public Packages" to specify that the package containing the interface should be available throughout the application:
-Click OK.
+image::images/nbm-quick-start/new-api-9.png[]
-In the Projects window, expand "Important Files" in the "WordEditorAPI" project and then double-click "Project Metadata". The "project.xml" file opens and you should see that the package has now been declared public:
+Click btn:[OK].
+
+As another way to see this, in the Projects window, expand "Important Files" in the "WordEditorAPI" project and then double-click "Project Metadata".
+
+image::images/nbm-quick-start/new-api-10.png[]
+
+The "project.xml" file opens and you should see that the package has now been declared public:
-[source,xml]
-----
+[source,xml,linenums,highlight='9-11']
+----
<?xml version="1.0" encoding="UTF-8"?>
-<project xmlns="https://netbeans.org/ns/project/1">
+<project xmlns="http://www.netbeans.org/ns/project/1">
<type>org.netbeans.modules.apisupport.project</type>
<configuration>
- <data xmlns="https://netbeans.org/ns/nb-module-project/3">
+ <data xmlns="http://www.netbeans.org/ns/nb-module-project/3">
<code-name-base>org.word.editor.api</code-name-base>
<suite-component/>
<module-dependencies/>
- *<public-packages>
+ <public-packages>
<package>org.word.editor.api</package>
- </public-packages>*
+ </public-packages>
</data>
</configuration>
</project>
----
+The API definition is now complete.
=== Implement the API
-In this section, you implement the API, in a separate module.
+In this section you implement the API that you just defined, again using a separate module. This implementation will do the same conversion to upper case, but with loose coupling.
[start=1]
-1. Expand the new application in the Projects window, right-click the Modules node, and choose "Add New" again:
-
+1. In the Projects window, right-click the Modules node of the application, and choose "Add New" again:
-image::images/new-impl-1.png[]
+image::images/nbm-quick-start/new-impl-1.png[]
Name the new module "UppercaseFilter":
+image::images/nbm-quick-start/new-impl-2.png[]
-image::images/new-impl-2.png[]
+Click btn:[Next]. Set the Code Name Base to `org.word.editor.uppercase`, as shown below:
-Click Next. Use code name base "org.word.editor.uppercase", as shown below:
+image::images/nbm-quick-start/new-impl-3.png[]
+Click btn:[Finish] to complete the wizard, which adds the module to your previously created application, as you did in the previous section:
-image::images/new-impl-3.png[]
+image::images/nbm-quick-start/new-impl-4.png[]
-Complete the wizard, which adds the module to your previously created application, as you did in the previous section:
+[start=2]
+1. Right-click the Libraries node of the "UppercaseFilter" module, and choose Add Module Dependency, as shown below:
-image::images/new-impl-4.png[]
+image::images/nbm-quick-start/new-impl-5.png[]
+Start typing the name of the API class (WordEditorAPI) and notice that the list narrows until the module containing the class is found:
-[start=2]
-1. Right-click the Libraries node of the "UppercaseFilter" module, and choose Add Module Dependency, as shown below:
+image::images/nbm-quick-start/new-impl-6.png[]
-image::images/new-impl-5.png[]
+Click btn:[OK].
-Start typing the name of the API class and notice that the list narrows until the module containing the class is found:
+A confirmation dialog will appear:
+image::images/nbm-quick-start/new-impl-7.png[]
-image::images/new-impl-6.png[]
+Click btn:[Yes] to add the dependency.
-Click OK.
+In the Projects window, expand "Libraries" in the "UppercaseFilter" project to see that the "WordEditorAPI" dependency has been added:
-In the Projects window, expand "Important Files" in the "UppercaseFilter" project, and then double-click "Project Metadata". The "project.xml" file opens and you should see that a new dependency has been declared:
+image::images/nbm-quick-start/new-impl-8.png[]
+As another way to see this, in the Projects window, expand "Important Files" in the "UppercaseFilter" project, and then double-click "Project Metadata". The "project.xml" file opens and you should see that a new dependency has been declared:
-[source,xml]
-----
+[source,xml,linenums,highlight='9-16']
+----
<?xml version="1.0" encoding="UTF-8"?>
-<project xmlns="https://netbeans.org/ns/project/1">
+<project xmlns="http://www.netbeans.org/ns/project/1">
<type>org.netbeans.modules.apisupport.project</type>
<configuration>
- <data xmlns="https://netbeans.org/ns/nb-module-project/3">
+ <data xmlns="http://www.netbeans.org/ns/nb-module-project/3">
<code-name-base>org.word.editor.uppercase</code-name-base>
<suite-component/>
- *<module-dependencies>
+ <module-dependencies>
<dependency>
<code-name-base>org.word.editor.api</code-name-base>
<build-prerequisite/>
@@ -377,7 +405,7 @@ In the Projects window, expand "Important Files" in the "UppercaseFilter" projec
<specification-version>1.0</specification-version>
</run-dependency>
</dependency>
- </module-dependencies>*
+ </module-dependencies>
<public-packages/>
</data>
</configuration>
@@ -390,17 +418,26 @@ In the Projects window, expand "Important Files" in the "UppercaseFilter" projec
[start=4]
-1. Because of the Lookup API dependency you defined above, you can now implement the interface defined in the WordEditorAPI module. Do so in the "UppercaseFilter" module, by creating a new class named "UppercaseFilter", in the "org.word.editor.uppercase" package, as shown below. Start by creating a new Java class, named "UppercaseFilter", and then define it as follows:
+1. You can now implement the interface defined in the WordEditorAPI module. In the "UppercaseFilter" module create a new class in the `org.word.editor.uppercase` package, as shown below.
+
+image::images/nbm-quick-start/new-impl-9.png[]
+
+Name the new class `UppercaseFilter`:
+
+image::images/nbm-quick-start/new-impl-10.png[]
+
+Click btn:[Finish] to exit the wizard and create the file. It should open automatically for editing.
+
+Define the class as follows:
[source,java]
----
-
package org.word.editor.uppercase;
import org.openide.util.lookup.ServiceProvider;
import org.word.editor.api.WordFilter;
-@ServiceProvider(service=WordFilter.class)
+@ServiceProvider(service = WordFilter.class)
public class UppercaseFilter implements WordFilter {
@Override
@@ -411,34 +448,57 @@ public class UppercaseFilter implements WordFilter {
}
----
-At compile time, the @ServiceProvider annotation will create a META-INF/services folder with a file that registers your implementation of the WordFilter interface, following the JDK 6 ServiceLoader mechanism.
+At compile time, the `@ServiceProvider` annotation will create a META-INF/services folder with a file that registers your implementation of the WordFilter interface, following the JDK 6 ServiceLoader mechanism.
+Now we need to update the WordEditorCore module so that all implementations of the interface "WordFilter" are located and loaded. When each implementation is found, we will invoke its `process` method to filter the text. Before we can do this, we need to add a dependency in the the "WordEditorCore" module on the "WordEditorAPI" module, similar to how we did for the UppercaseFilter.
[start=5]
-1. In the WordEditorCore module, the code that handles a click on the filter button now needs to be changed, so that all implementations of the interface "WordFilter" are located and loaded. When such implementations are found, you need to invoke its method to filter the text. Before we can do this, we need to add a dependency in the the "WordEditorCore" module on the "WordEditorAPI" module:
+1. In the Projects tree, expand the WordEditorCore module to locate the Libraries node. Right click and select "Add Modules Dependency...".
+
+image::images/nbm-quick-start/new-impl-11.png[]
+
+Add the WordEditorAPI dependency:
+image::images/nbm-quick-start/new-impl-12.png[]
-image::images/new-impl-7.png[]
+Expand the Libraries entries to verify the dependency as been added:
-Now, you can load implementations of the "WordFilter" class, as shown below:
+image::images/nbm-quick-start/new-impl-13.png[]
+
+[start=6]
+6. Now we can modify the `WordTopComponent.java` implementation to load implementations of the "WordFilter" interface. Replace the previous implementation (which was hard-coded to just upper-case text) with the following:
[source,java]
----
-
-private void jButton1ActionPerformed(java.awt.event.ActionEvent evt) {
- *String enteredText = text.getText();
- Collection<? extends WordFilter> allFilters = Lookup.getDefault().lookupAll(WordFilter.class);
- StringBuilder sb = new StringBuilder();
- for (WordFilter textFilter : allFilters) {
- String processedText = textFilter.process(enteredText);
- sb.append(processedText).append("\n");
- }
- text.setText(sb.toString());*
+private void filterButtonActionPerformed(java.awt.event.ActionEvent evt) {
+ String enteredText = text.getText();
+ Collection<? extends WordFilter> allFilters = Lookup.getDefault().lookupAll(WordFilter.class);
+ StringBuilder sb = new StringBuilder();
+ for (WordFilter textFilter : allFilters) {
+ String processedText = textFilter.process(enteredText);
+ sb.append(processedText).append("\n");
+ }
+ text.setText(sb.toString());
}
----
-The above could be achieved via the JDK 6 "ServiceLoader" class, except that the "Lookup" class can be used in JDK's prior to JDK 6. Aside from that, the "Lookup" class has a number of additional features, as the next section will illustrate.
+The required imports are:
+
+[source,java]
+----
+import java.util.Collection;
+import org.netbeans.api.settings.ConvertAsProperties;
+import org.openide.awt.ActionID;
+import org.openide.awt.ActionReference;
+import org.openide.util.Lookup;
+import org.openide.windows.TopComponent;
+import org.openide.util.NbBundle.Messages;
+import org.word.editor.api.WordFilter;
+----
+
+Lookup provides an ability to do service loading, without coupling consumers to particular service implementations. This is the key to the flexible pluggable architecture provided by
+the Apache NetBeans Platform.
=== Run the Application
@@ -447,14 +507,19 @@ In this section, you run the application again.
[start=1]
-1. Now you can run the application again and check that everything works just as before. While the functionality is the same, the new modular design offers a clear separation between the GUI and the implementation of the filter. The structure of the application should be as shown below:
+1. Now you can run the application again and check that everything works just as before.
+image::images/nbm-quick-start/new-impl-14.png[]
-image::images/new-impl-8.png[]
+While the functionality is the same, the new modular design offers a clear separation between the GUI and the implementation of the filter. The structure of the application should be as shown below:
+
+image::images/nbm-quick-start/new-impl-15.png[]
[start=2]
-1. The new application can also be extended quite easily, by adding new service providers to the application's classpath. As an exercise, add a new module that provides a "LowercaseFilter" implementation of the API to the application.
+1. The new application can also be extended quite easily by adding new service providers to the application's classpath. As an exercise, add a new module that provides a "LowercaseFilter" implementation of the API to the application.
+
+Note: When there is more than one filter, the results of each filter will be added to the text area.
You have now used the default Lookup, that is, "Lookup.getDefault()", to load implementations of an interface from the META-INF/services folder.
@@ -473,19 +538,18 @@ In this section, you publish a String into the Lookup of the TopComponent. Whene
[start=1]
-1. In the "WordEditorCore" module, we publish a String whenever the user clicks the "Filter!" button. To do so, change the constructor of the "WordTopComponent" as follows:
+1. In the "WordEditorCore" module, we publish a String whenever the user clicks the "Filter!" button. To do so, add a member variable and update the constructor of the "WordTopComponent" as follows:
-[source,java]
+[source,java,linenums,highlight=1,7-8]
----
+private final InstanceContent content;
-*private InstanceContent content;*
-
-private WordTopComponent() {
+public WordTopComponent() {
initComponents();
setName(Bundle.CTL_WordTopComponent());
setToolTipText(Bundle.HINT_WordTopComponent());
- *content = new InstanceContent();
- this.associateLookup(new AbstractLookup(content));*
+ content = new InstanceContent();
+ this.associateLookup(new AbstractLookup(content));
}
----
@@ -494,19 +558,18 @@ private WordTopComponent() {
1. Change the code of the filter button so that the entered text is added to the ``InstanceContent`` object when the button is clicked.
-[source,java]
+[source,java,linenums,highlight=8]
----
-
-private void jButton1ActionPerformed(java.awt.event.ActionEvent evt) {
- String enteredText = text.getText();
- Collection<? extends WordFilter> allFilters = Lookup.getDefault().lookupAll(WordFilter.class);
- StringBuilder sb = new StringBuilder();
- for (WordFilter textFilter : allFilters) {
- String processedText = textFilter.process(enteredText);
- sb.append(processedText).append("\n");
- *content.add(enteredText);*
- }
- text.setText(sb.toString());
+private void filterButtonActionPerformed(java.awt.event.ActionEvent evt) {
+ String enteredText = text.getText();
+ Collection<? extends WordFilter> allFilters = Lookup.getDefault().lookupAll(WordFilter.class);
+ StringBuilder sb = new StringBuilder();
+ for (WordFilter textFilter : allFilters) {
+ String processedText = textFilter.process(enteredText);
+ sb.append(processedText).append("\n");
+ content.add(enteredText);
+ }
+ text.setText(sb.toString());
}
----
@@ -517,45 +580,41 @@ In this section, you create a new module, with a new window. In the new window,
[start=1]
-1. In the same way as done in the previous sections, create another module in your application and name it "WordHistory". Use code name base "org.word.editor.history".
+1. In the same way as done in the previous sections, create another module in your application and name it "WordHistory". Set the Code Name Base to be `org.word.editor.history`.
[start=2]
-1. In the WordHistory module, right-click the "org.word.editor.history" package and choose New | Window. Use the New Window wizard to create a new window component that will automatically be opened on the left side of the application frame, which is the "explorer" position:
+1. In the WordHistory module, right-click the `org.word.editor.history` package and choose New | Window. Use the New Window wizard to create a new window component that will automatically be opened on the left side of the application frame, which is the `explorer` position:
+image::images/nbm-quick-start/new-history-1.png[]
-image::images/new-history-1.png[]
+Click btn:[Next]. Use prefix `WordHistory` and specify that the new window will be stored in the `org.word.editor.history` package.
-Click Next. Use prefix "WordHistory" and specify that the new window will be stored in the "org.word.editor.history" package. Click Finish.
+image::images/nbm-quick-start/new-history-2.png[]
+Click btn:[Finish] to complete the wizard and create the Window.
[start=3]
-1. Once you have created the window, add a ``JTextArea`` to it, resizing it so that it covers the whole area of the window:
+1. Once you have created the window, add a Text Area (`JTextArea`) to it, resizing it so that it covers the whole area of the window:
-image::images/new-history-w.png[]
+image::images/nbm-quick-start/new-history-3.png[]
Change the variable name of the text area to "historyText".
[start=4]
-1. In the Source view, add code to the constructor of the HistoryTopComponent class so that it listens to the lookup of the ``String`` class of the current active window. It displays all retrieved ``String`` objects in the text area:
+1. In the Source view, add code to the `HistoryTopComponent` class so that it listens to the lookup of the `String` class of the current active window (implements `org.openide.util.LookupListener`) and displays all retrieved `String` objects in the text area. Update the `componentOpened()` and `componentClosed()` methods, and add `result` and `resultChanged` members, as well as the `implements` and additional imports.
[source,java]
----
+import org.openide.util.LookupEvent;
+import org.openide.util.LookupListener;
-...
-...
-...
-public final class HistoryTopComponent extends TopComponent *implements LookupListener* {
-
- *private org.openide.util.Lookup.Result<String> result;*
+public final class WordHistoryTopComponent extends TopComponent implements LookupListener {
+ private org.openide.util.Lookup.Result<String> result;
- ...
- ...
- ...
-
- *@Override
+ @Override
public void componentOpened() {
result = org.openide.util.Utilities.actionsGlobalContext().lookupResult(String.class);
result.addLookupListener(this);
@@ -565,7 +624,7 @@ public final class HistoryTopComponent extends TopComponent *implements LookupLi
public void componentClosed() {
result.removeLookupListener(this);
}
-
+
@Override
public void resultChanged(LookupEvent le) {
Collection<? extends String> allStrings = result.allInstances();
@@ -574,11 +633,7 @@ public final class HistoryTopComponent extends TopComponent *implements LookupLi
sb.append(string).append("\n");
}
historyText.setText(sb.toString());
- }*
-
- ...
- ...
- ...
+ }
----
@@ -587,25 +642,24 @@ public final class HistoryTopComponent extends TopComponent *implements LookupLi
1. Then you can start the application and experiment with it. The result should look similar to that shown in the screenshot below:
-image::images/new-result-1.png[]
+image::images/nbm-quick-start/new-result-1.png[]
As an exercise, redesign the user interface of the "WordTopComponent" in such a way that a ``JList`` displays the filters.
Congratulations! At this stage, with very little coding, you have created a small example of a loosely-coupled modular application:
-image::images/new-result-2.png[]
+image::images/nbm-quick-start/new-result-2.png[]
Two important concepts have been covered in this tutorial.
[start=1]
-1. The application consists of four modules. Code from one module can only be used by another module if (1) the first module explicitly exposes packages and (2) the second module sets a dependency on the first module. In this way, the NetBeans Platform helps to organize your code in a strict modular architecture, ensuring that code isn't reused randomly but only when there are contracts set between the modules that provide the code.
+1. The application consists of four modules. Code from one module can only be used by another module if (1) the first module explicitly exposes packages and (2) the second module sets a dependency on the first module. In this way, the Apache NetBeans Platform helps to organize your code in a strict modular architecture, ensuring that code isn't reused randomly but only when there are contracts set between the modules that provide the code.
-[start=2]
-1. Secondly, the ``Lookup`` class has been introduced as a mechanism for communicating between modules, as an extension of the JDK 6 ServiceLoader approach. Implementations are loaded via their interfaces. Without using any code from an implementation, the "WordEditorCore" module is able to display the service provided by the implementor. Loose coupling is provided to NetBeans Platform applications in this way.
+2. Secondly, the `Lookup` class has been introduced as a mechanism for communicating between modules. Implementations are loaded via their interfaces. Without using any code from an implementation, the "WordEditorCore" module is able to display the service provided by the implementor. This enables loose coupling in the Apache NetBeans Platform applications.
-To continue learning about modularity and the NetBeans Platform, head on to the four-part "NetBeans Platform Selection Management" series, link:https://netbeans.apache.org/tutorials/nbm-selection-1.html[which starts here]. After that, get started with the link:https://netbeans.apache.org/kb/docs/platform.html[NetBeans Platform Learning Trail], choosing the tutorials that are most relevant to your particular business scenario. Also, whenever you have questions about the NetBeans Platfor [...]
+To continue learning about modularity and the NetBeans Platform, head on to the four-part "NetBeans Platform Selection Management" series, link:https://netbeans.apache.org/tutorials/nbm-selection-1.html[which starts here]. After that, get started with the link:https://netbeans.apache.org/kb/docs/platform.html[NetBeans Platform Learning Trail], choosing the tutorials that are most relevant to your particular business scenario. Also, whenever you have questions about the NetBeans Platfor [...]
Have fun with the NetBeans Platform and see you on the mailing list!
---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscribe@netbeans.apache.org
For additional commands, e-mail: commits-help@netbeans.apache.org
For further information about the NetBeans mailing lists, visit:
https://cwiki.apache.org/confluence/display/NETBEANS/Mailing+lists