BlogJava-键盘上的舞者-随笔分类-NetBeans

Node的属性改变后通知属性表单（Propertites Sheet）更新

陈维 — Sun, 06 Mar 2011 14:15:00 GMT

Node API提供了一个方法在Node属性集变化时通知注册在其上的监听器更新。

protected final void firePropertySetsChange(Node.PropertySet[] o, Node.PropertySet[] n)

如图，精灵动画就是一个自定义的Node，当使用鼠标将Node从A点拖拽到B点时，Node坐标已经改变，可以调用Node的firePropertySetsChange()方法通知属性表单（Propertites Sheet）更新显示。

因为firePropertySetsChange()是个受保护（protected）的方法，如果需要在Node的外部调用，还可以包装在自定义的公共（public）方法里。

public void notifySheetChange(){
firePropertySetsChange(null, Sheet.createDefault().toArray());
}

陈维 2011-03-06 22:15 发表评论

使用TopComponent群组

陈维 — Sat, 07 Aug 2010 14:46:00 GMT

TopComponent群组的作用是在打开一个TopComponent组件的同时，打开其他相关的TopComponent组件。例如，当打开或者激活GUI编辑器的时候，“组件面板”、“属性”窗口和“检查器”窗口都会出现。当需要一个组件同时伴随着很多其他类似于组件面板窗口的时候，利用TopComponent群组可以轻松实现一个组件的激活引发其他组件被打开或者被选中。

定义群组涉及到2种XML文件。首先是wsgrp，它代表“窗口系统群组（Window System Group）”。它定义了“窗口系统”的群组，系统根据它的定义查找对应的目录，它也定义了群组是否应该在启动时打开。另一个文件是wstcgrp，它代表“窗口系统TopComponent群组（Window System TopComponent Group）”，这个文件通过ID识别单态的TopComponent组件，同时还定义了一些群组的打开和关闭属性。

TopComponent群组编程实例

首先创建一个模块项目TopComponentGroup，然后新建2个窗口组件（TopComponent），命名为EditorTopComponent和SatelliteTopComponent，就像窗口的名字所表示的那样，SatelliteTopComponent将会随着EditorTopComponent的打开和关闭一同打开和关闭。

首先新建一个名为EditorGroupWsgrp的xml文件，这个文件里定义了名为EditorGroup的编辑器窗口群组。

<group version="2.0">
    <module name="org.jqueen.nb.topcomponentgroup" spec="1.0" />
    <name unique="EditorGroup" />
    <state opened="false" />
group>

再新建一个名为SatelliteTopComponentWstcgrp的xml文件，在这个文件里可以通过ID识别出SatelliteTopComponent组件。

<tc-group version="2.0">
<tc-id id="SatelliteTopComponent" />
<open-close-behavior open="true" close="true" />
tc-group>

编辑模块的layer.xml文件，在系统文件系统中的Windows2目录添加一个Group文件夹，将名为"EditorGroup"的群组添加进Group。

<folder name="Groups">
    <file name="EditorGroup.wsgrp" url="EditorGroupWsgrp.xml"/>
    <folder name="EditorGroup">
        <file name="SatelliteTopComponent.wstcgrp" url="SatelliteTopComponentWstcgrp.xml"/>
    folder>
folder>

编辑EditorTopComponent内容，重写TopComponent类的componentOpened()和componentClosed()方法，在EditorTopComponent被打开和关闭时打开和关闭名为"EditorGroup"的群组。

    @Override
    protected void componentOpened() {
        TopComponentGroup group = WindowManager.getDefault().findTopComponentGroup("EditorGroup");
        if (group != null) {
            group.open();
        }
    }

    @Override
    public void componentClosed() {
        TopComponentGroup group = WindowManager.getDefault().findTopComponentGroup("EditorGroup");
        if (group != null) {
            group.close();
        }
    }

至此，就完成了一个TopComponent群组的编辑。执行模块项目，当从窗口菜单中打开EditorTopComponent时SatelliteTopComponent会自动打开，EditorTopComponent被关闭时SatelliteTopComponent也会自动关闭。

样例程序下载

陈维 2010-08-07 22:46 发表评论

与NetBeans6.8无关

陈维 — Fri, 11 Dec 2009 13:12:00 GMT

今天NetBeans 6.8正式发布，作为粉丝当然第一时间去官网下载。
随手点开了Overview视频，视频随后部分介绍了一些基于NetBeans Platform开发的富客户端应用，在5分53秒突然一张很熟悉的抓图跃入眼帘，那是我在07年在NetBeans 5.5上开发的一个图像处理富客户端应用，兴奋之余又开始习惯性的反省，这2年在Platform开发上没什么成绩，要努力。

陈维 2009-12-11 21:12 发表评论

Visual Library 2.0 - Examples

陈维 — Mon, 14 Sep 2009 12:58:00 GMT

Visual Library是NetBeans中广泛使用的可视化函数库，用于展现复杂的上下文关系，如建模或流程绘图等工作。

Visual Library源自于NetBeans的社区项目，随着类库逐步发展成熟并被开发者认可，在2007年正式成为NetBeans Platform. 6.0的一部分。目前的NetBeans IDE中，BPEL业务流程设计器，Mobile开发以及JavaEE开发的设计工具都在使用Visual Library来实现可视化编辑效果。

Visual Library 2.0版本在使用时的编程风格同Swing类似，需要创建Scene场景包含，并使用Widgets生成所需的可视化元素，之后通过Scene场景的 createView操作来创建Swing的JComponent组件，以将可视化场景集成在Swing界面中呈现。

关于Visual Library的使用，官方站点已经给出非常好的示例代码，以展示Visual Library提供的几十种不同的功能和用法，包含Action的使用，可视化组件的生成与连接等。

示例代码下载页面：

http://graph.netbeans.org/examples.html

使用Visual Library开发的几个案例截图：

陈维 2009-09-14 20:58 发表评论

使用文件模板和向导创建一个类型文件

陈维 — Mon, 14 Sep 2009 12:45:00 GMT

摘要: 通过工具创建类型文件时通常会使用到各式各样的模板，例如IDE在创建java文件时会自动在文件头添加作者和创建日期的注释、XML文件会自动添加根元素的标签等。在NetBeans里通过使用文件模板可以很方便的按照既定的模式创建你的类型文件。我在《创建新的文件类型》里介绍了怎样创建一个自定义的文件类型，创建后的文件类型里就包含了一个名为MapTemplate.xmap的空文件模板。现在我们将... 阅读全文

陈维 2009-09-14 20:45 发表评论

创建新的文件类型

陈维 — Mon, 14 Sep 2009 12:23:00 GMT

我们在开发过程中经常会根据数据组织形式的不同创造新数据格式，例如我为开发2D游戏地图所创造的xmap格式。NetNeans很方便的提供了对新数据格式的支持，我们现在就可以动手创建自己的文件格式。

我们首先新建一个名为“Map Core”的模块项目，然后在这个模块里创建一个新的文件类型。

创建文件类型的过程如下：

1、点击菜单栏的新建文件选项，在弹出的向导对话框的类别列表里选择“模块开发”，在文件类型列表里选择“文件类型”，然后点击“下一步”按钮

2、在文件识别面板，MIME类型输入框里输入我们自定义类型“text/x-map”，然后在文件扩展名输入框里输入文件扩展名“xmap”。文件扩展名可以输入多个，用空格或者逗号分隔。如此可以使得这个新文件类型支持多种后缀的文件，例如jpg，jpeg后缀皆表示JPEG图像格式。输入完成后进行下一步操作。

3、最后在输入类名前缀、图标和在磁盘上生成文件的位置，点击“完成”后NetBeans会根据输入自动生成和配置相关的几个文件。

我们已经成功创建了自己的MIME文件类型“text/x-map”，检查一下项目文件夹，NetBeans为我们自动创建了几个文件：

Icon_Map.gif 自定义xmap文件的默认图标。

MapDataObject.java 当系统发现xmap文件时会创造一个MapDataObject对象用来表示文件的内容。

MapResolver.xml 作为MIME类型解析器，它描述了“text/x-map”类型的文件后缀用于生成DataObject对象。

MapTemplate.xmap 这是一个xmap文件模板，我们可以在其中添加标准的内容后使用这个模板创建新的地图文件。

layer.xml 添加了内容用于注册MIME类型解析器和文件模板以及一系列标准操作，例如复制、粘贴等。

最后，我们将项目编译后在目标平台中重新装入，来检验新的文件类型。现在可以看到xmap类型的文件在安装了MapCore模块的目标平台上显示时和其他文件已经有所区别，使用了我们自己创建的图标，说明xmap类型文件已经被识别。

陈维 2009-09-14 20:23 发表评论

创建NetBeans模块项目

陈维 — Mon, 14 Sep 2009 12:19:00 GMT

学习NetBeans模块开发首先需要做的就是创建一个NetBenas的模块项目，使用NetNeans IDE提供的新建项目向导只需要经过4个步骤就可以新建一个模块项目。

1、首先IDE菜单中的新建项目创建一个新项目，在向导对话框中的项目类别选择“NetBeans 模块”，项目选择“模块”。

2、下一步填写项目名称和项目所在的磁盘位置。我将项目命名为“MapCore”。

3、接下来填写代码名称基和模块显示名称。项目名称基的作用类似于Java类的包名，用来标识一个NB模块。模块显示名称顾名思义模块用于显示的名字。

4、点击“完成”按钮结束MapCore模块的创建，创建后的项目文件结构如下：

陈维 2009-09-14 20:19 发表评论

将你的文件类型集合进XML编辑器（第二部分）

陈维 — Mon, 14 Sep 2009 12:03:00 GMT

我发现了昨天的错误。不用将 MultiDataObject 替换成 XMLDataObject，你只需要简单地确认 MIME 类型是以"+xml"结尾。例如，类似 text/x-foo+xml。一旦你这样做了，你的文档就会在 XML 编辑器里 打开。换句话说，你拥有免费的语法着色，简单的确保 MIME 类型正确。根据昨天 Blog 里 描述 的4个步骤 增加 Cookies 可以为你提供 XML 的检查、验证和根据 XSLT 改变功能。诸如此类，事实上 尽管那个文件类型不是以".xml"结尾。

最后，添加一个导航器，以便我们能够获取我们的 XML 文件提纲和便于我们在导航器里节点的跳跃关联到 XML 编辑器。

在这里教你怎样添加 XML 导航器：

1、必须确保你的 MIME 类型处于 text/x-foo+xml 模式，否则 XML 导航器将不会工作。当我们点击一个节点，一个行的文档将会打开，并且新的文档不含有语法着色，换句话说，你的文档内容将打开在一般的文本编辑器里。从3个地方可以看出你的 MIME 类型是否正确，MIME 类型的 resolver、Layer 文件和 DataLoader。（译者注：NB6.5 上验证需要检查 XxxResolver.xml 和 layer.xml 文件）

2、在重要文件节点里，展开和其中的<上下文中的此层>。找到导航文件夹，在导航文件夹里创建一个新的文件夹。这个文件夹的名字必须和你的 MIME 类型相同。然后复制XML文件夹下的内容到你的文件夹里。祝贺你，你已经制作了XML导航器用于激活你的 MIME 类型。

3、安装模块。如果你安装在开发 IDE 上，你就必须重新启动 IDE 使 XML 导航器注册生效。

现在，每当文档得到焦点，XML导航器就会显示文档的提纲。另外，你可以使用 XML 导航器导航到文档的任何地方，就像显示的那样：

原文地址：http://blogs.sun.com/geertjan/entry/integrating_the_xml_editor_for

陈维 2009-09-14 20:03 发表评论

将你的文件类型集合进XML编辑器（第一部分）

陈维 — Mon, 14 Sep 2009 12:01:00 GMT

感谢 Vadiraj 的帮助，我现在知道了如何在XML编辑器里打开非XML文件。有时候你拥有一个内容是XML但是却并非以“.xml”结尾的文件。如何让IDE把它看作一个XML文件呢？接下来你可以看到一个后缀为“.test”的文件在XML编辑器里被打开。你知道它被打开是因为语法着色和缩进，以及XML文件特有的附加菜单项：

1、使用文件类型向导，会创建一些不同的类。只需要修改名为 XxxDataObject 的类。

2、为模块依赖关系添加 XML Tools API。

3、在 DataObject 里，将继承的类由 MultiDataObject 改为 XMLDataObject。

4、在构造函数里补充验证 XML、确认 XML 和使用 XSLT 改变 XML 样式等附加功能所提供的 Cookies，像这样：

public TestDataObject(FileObject pf, TestDataLoader loader) throws DataObjectExistsException, IOException {
    super(pf, loader);
    CookieSet cookies = getCookieSet();
    InputSource is = DataObjectAdapters.inputSource(this);
    Source source = DataObjectAdapters.source(this);
    cookies.add(new CheckXMLSupport(is));
    cookies.add(new ValidateXMLSupport(is));
    cookies.add(new TransformableSupport(source));
    cookies.add((Node.Cookie) DataEditorSupport.create(this, getPrimaryEntry(), cookies));
}

5、确认导入合适的声明。

import java.io.IOException;
import javax.xml.transform.Source;
import org.netbeans.spi.xml.cookies.CheckXMLSupport;
import org.netbeans.spi.xml.cookies.DataObjectAdapters;
import org.netbeans.spi.xml.cookies.TransformableSupport;
import org.netbeans.spi.xml.cookies.ValidateXMLSupport;
import org.openide.filesystems.FileObject;
import org.openide.loaders.DataObjectExistsException;
import org.openide.loaders.XMLDataObject;
import org.openide.nodes.CookieSet;
import org.openide.nodes.Node;
import org.openide.text.DataEditorSupport;
import org.xml.sax.InputSource;

就这样，你已经完成。你的文件现在可以被看作是一个 XML 文件，就像其他所有的 XML 文件一样。

原文地址：http://blogs.sun.com/geertjan/entry/integrating_the_xml_edior_for

陈维 2009-09-14 20:01 发表评论