netbeans.apache.org/src/old_content/content/tutorials/691/nbm-osgi-quickstart_zh_CN.adoc

// 
//     Licensed to the Apache Software Foundation (ASF) under one
//     or more contributor license agreements.  See the NOTICE file
//     distributed with this work for additional information
//     regarding copyright ownership.  The ASF licenses this file
//     to you under the Apache License, Version 2.0 (the
//     "License"); you may not use this file except in compliance
//     with the License.  You may obtain a copy of the License at
// 
//       http://www.apache.org/licenses/LICENSE-2.0
// 
//     Unless required by applicable law or agreed to in writing,
//     software distributed under the License is distributed on an
//     "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
//     KIND, either express or implied.  See the License for the
//     specific language governing permissions and limitations
//     under the License.
//

= 在 NetBeans 平台中使用 OSGi 的快速入门
:jbake-type: platform_tutorial
:jbake-tags: tutorials 
:jbake-status: published
:syntax: true
:source-highlighter: pygments
:toc: left
:toc-title:
:icons: font
:experimental:
:description: 在 NetBeans 平台中使用 OSGi 的快速入门 - Apache NetBeans
:keywords: Apache NetBeans Platform, Platform Tutorials, 在 NetBeans 平台中使用 OSGi 的快速入门

本文档快速演示了如何将 OSGi 包集成到 NetBeans 平台应用程序中。

本教程重点介绍一个基于 link:http://www.aqute.biz/Code/Download#sudoku[由 Peter Kriens 开发的 Sudoku 游戏]的 "hello world" 方案。您需要导入构成 Sudoku 游戏的 OSGi 包，以及所需的相关 Equinox 包。在部署该应用程序之后，Web 浏览器中会显示以下应用程序：


image::http://netbeans.dzone.com/sites/all/files/sudokugame-4.png[]

在学完此简单方案后，本教程结尾的“深入阅读”部分还列出了更多有用的方案。







*注意：*为开发适用于 NetBeans 平台的应用程序，您无需下载该平台的独立版本。通常，您是在 NetBeans IDE 中开发应用程序和模块，并且只包含运行 NetBeans 平台和您的应用程序所需的模块。


== 设置环境

除了下载上面列出的软件以外，您还需要执行一些步骤来准备您的环境，如下所述。


[start=1]
1. 在您磁盘上的文件系统中创建一个新文件夹。

[start=2]
1. 将 Equinox 分发中的以下文件存放在该文件夹中：
* javax.servlet_xxx.jar
* org.eclipse.equinox.ds_xxx.jar
* org.eclipse.equinox.http_xxx.jar
* org.eclipse.equinox.util_xxx.jar
* org.eclipse.osgi.services_xxx.jar
* org.eclipse.osgi_xxx.jar

[start=3]
1. 将下面两个 Sudoku JAR 也存放在上述 JAR 所在的文件夹中：
* aQute.sudoku.jar
* aQute.webrpc.jar

现在，您已将要导入的 OSGi 包集中存放在一个位置，从该位置可以将这些包集成到应用程序中。


== 创建应用程序

在准备好所有必需的 OSGi 包之后，请按照下面所述创建新的 NetBeans 平台应用程序。


[start=1]
1. 选择“文件”|“新建项目”，然后选择通过 Equinox 模板创建基于 Equinox 的 NetBeans 平台应用程序：


image::http://netbeans.dzone.com/sites/all/files/sudokugame-5.png[]

单击“下一步”。


[start=2]
1. 为该应用程序指定名称，如下所示。


image::http://netbeans.dzone.com/sites/all/files/sudokugame-3.png[]

单击“完成”。


[start=3]
1. 您可以运行通过上述模板生成的应用程序，随即您会看到包含一个窗口的应用程序，其中显示了构成应用程序的所有 NetBeans 模块和 OSGi 包。


== 导入 OSGi 包

除了下载上面列出的软件以外，您还需要执行一些步骤来准备您的环境，如下所述。


[start=1]
1. 在“项目”窗口中右键单击该应用程序，选择“属性”，转至“库”标签，单击“添加群集”，然后浏览到上述 JAR 所在的文件夹。随即会打开一个向导，以便您将这些 JAR 转换为一个“群集”（即一组将被合并到应用程序中的相关模块/包）。


image::http://netbeans.dzone.com/sites/all/files/sudokugame-1.png[]


[start=2]
1. 如上所示，将所有导入的 OSGi 包设置为“启用”，以便在应用程序启动时可以装入并使用这些包。

[start=3]
1. 单击“完成”后，将会更新 "platform.properties" 配置文件。它应该与以下内容类似：

[source,java]
----

cluster.path.extra=netbinox:\../../path/to/my/nbsudokugame/folder
disabled.modules.extra=org.netbeans.libs.felix
cluster.path=\
    ${nbplatform.active.dir}/harness:\
    ${nbplatform.active.dir}/platform:\
    ${cluster.path.extra}
disabled.modules=\
    org.jdesktop.layout,\
    org.netbeans.api.visual,\
    org.netbeans.core.execution,\
    org.netbeans.core.multiview,\
    org.netbeans.insane,\
    org.netbeans.libs.felix,\
    org.netbeans.libs.jsr223,\
    org.netbeans.modules.apisupport.harness,\
    org.netbeans.modules.apisupport.tc.cobertura,\
    org.netbeans.modules.autoupdate.services,\
    org.netbeans.modules.autoupdate.ui,\
    org.netbeans.modules.core.kit,\
    org.netbeans.modules.favorites,\
    org.netbeans.modules.jellytools.platform,\
    org.netbeans.modules.jemmy,\
    org.openide.compat,\
    org.openide.execution,\
    org.openide.options,\
    org.openide.util.enumerations
nbplatform.active=default
----

*注意：*上面的第一行指向您之前创建的文件夹。


[start=4]
1. 然后，将以下代码行添加到应用程序的 "project.properties" 配置文件中，该代码指定将不显示闪屏，并且还指定了用于部署应用程序的端口：

[source,java]
----

run.args.extra=--nosplash -J-Dorg.osgi.service.http.port=8080
----


== 运行应用程序

现在，该应用程序已准备就绪，可以按照如下所述进行部署。


[start=1]
1. 运行应用程序！随即会部署应用程序中的所有 OSGi 包和 NetBeans 模块。同时，还会部署用于查看已部署的 OSGi 包和 NetBeans 模块的应用程序，最终提供的桌面应用程序可使您非常方便地监视当前已部署的项目：


image::http://netbeans.dzone.com/sites/all/files/sudokugame-6_0.png[]

或者，也可以删除提供上述窗口的整个模块。然后，删除上述窗口需要的所有模块，即删除窗口系统、操作系统及其他所有内容，但 OSGi 集成所需的一些 JAR 除外，这些 JAR 包括：引导、启动、文件系统、模块系统、实用程序和查找。


[source,java]
----

cluster.path.extra=netbinox:\../../path/to/my/nbsudokugame/folder
disabled.modules.extra=org.netbeans.libs.felix
cluster.path=\
    ${nbplatform.active.dir}/harness:\
    ${nbplatform.active.dir}/platform:\
    ${cluster.path.extra}
disabled.modules=\
    org.jdesktop.layout,\
    org.netbeans.api.annotations.common,\
    org.netbeans.api.progress,\
    org.netbeans.api.visual,\
    org.netbeans.core,\
    org.netbeans.core.execution,\
    org.netbeans.core.io.ui,\
    org.netbeans.core.multiview,\
    org.netbeans.core.nativeaccess,\
    org.netbeans.core.output2,\
    org.netbeans.core.ui,\
    org.netbeans.core.windows,\
    org.netbeans.insane,\
    org.netbeans.libs.felix,\
    org.netbeans.libs.jna,\
    org.netbeans.libs.jsr223,\
    org.netbeans.libs.junit4,\
    org.netbeans.modules.apisupport.harness,\
    org.netbeans.modules.apisupport.tc.cobertura,\
    org.netbeans.modules.applemenu,\
    org.netbeans.modules.autoupdate.services,\
    org.netbeans.modules.autoupdate.ui,\
    org.netbeans.modules.core.kit,\
    org.netbeans.modules.editor.mimelookup,\
    org.netbeans.modules.editor.mimelookup.impl,\
    org.netbeans.modules.favorites,\
    org.netbeans.modules.javahelp,\
    org.netbeans.modules.jellytools.platform,\
    org.netbeans.modules.jemmy,\
    org.netbeans.modules.keyring,\
    org.netbeans.modules.masterfs,\
    org.netbeans.modules.nbjunit,\
    org.netbeans.modules.options.api,\
    org.netbeans.modules.options.keymap,\
    org.netbeans.modules.print,\
    org.netbeans.modules.progress.ui,\
    org.netbeans.modules.queries,\
    org.netbeans.modules.sendopts,\
    org.netbeans.modules.settings,\
    org.netbeans.modules.spi.actions,\
    org.netbeans.spi.quicksearch,\
    org.netbeans.swing.outline,\
    org.netbeans.swing.plaf,\
    org.netbeans.swing.tabcontrol,\
    org.openide.actions,\
    org.openide.awt,\
    org.openide.compat,\
    org.openide.dialogs,\
    org.openide.execution,\
    org.openide.explorer,\
    org.openide.io,\
    org.openide.loaders,\
    org.openide.nodes,\
    org.openide.options,\
    org.openide.text,\
    org.openide.util.enumerations,\
    org.openide.windows
nbplatform.active=default
----

然后，您将获得一个非常适合进行模块化 Web 开发的非 GUI 应用程序（即服务器应用程序）。


[start=2]
1. 现在，在浏览器中输入以下 URL（可选，使用 NetBeans UI 实用程序 API 中的 URLDisplayer.getDefault() 以编程方式在所需的位置打开浏览器），随即会部署 Sudoku 游戏中定义的 "index.html" 并将其显示在浏览器中，接下来您便可以开始玩 Suduko 游戏：

[source,java]
----

http://localhost:8080/rpc/sudoku/index.html
----

恭喜！您已将第一批 OSGi 包集成到了 NetBeans 平台应用程序中。


== 深入阅读

现在，您已经学完了本教程并了解了在 NetBeans 平台应用程序中重用 OSGi 包所需执行的步骤，接下来可以参阅以下相关文档和更高级的方案：

*  link:http://www.osgi.org/blog/2006_09_01_archive.html[Peter Kriens 和 Sudoku 游戏]
*  link:http://wiki.apidesign.org/wiki/NetbinoxTutorial[Jaroslav Tulach 和 Netbinox]
* Toni Epple 的 OSGi/NetBeans  link:http://eppleton.sharedhost.de/blog/?p=662[博客文章]和 link:http://eppleton.sharedhost.de/blog/?s=Frankenstein%27s+IDE[演示]
* Gunnar Reinseth 的 NetBeans 与 EMF 集成（ link:http://eclipse.dzone.com/emf-on-netbeans-rcp[第 1 部分]， link:http://eclipse.dzone.com/emf-on-netbeans-rcp-2[第 2 部分]）
* 还可以阅读  link:http://java.dzone.com/news/new-cool-tools-osgi-developers[OSGi 开发者的新炫酷工具]