NetBeans 平台绘图应用程序教程

创建应用程序框架

可以使用“NetBeans 平台应用程序”模板来创建应用程序框架。该框架包含一组模块，它们协同工作以形成应用程序的基础。将使用“项目属性”对话框来指定应用程序闪屏、应用程序名称以及要使用的 NetBeans 模块类型和数量。此外，您还可以利用一些操作，如创建 ZIP 分发和构建 Java WebStart (JNLP) 应用程序，它们是确保其他用户能够使用您的应用程序的重要工具。

1. 选择“文件”>“新建项目”。在“类别”下选择“NetBeans 模块”。在“项目”下，选择“NetBeans 平台应用程序”：

   

   单击“下一步”。

2. 在“名称和位置”面板的“项目名称”中键入 PaintApp。将项目位置更改为计算机上的任意目录。将“设置为主项目”复选框保留为选中状态。单击“完成”。

将在 IDE 中打开新应用程序框架。它在“项目”窗口中包含两个节点。第一个节点（“模块”节点）用于在应用程序中手动添加模块和库包装模块。此外，在使用模块向导或库包装模块向导时，可以自动将创建的模块添加到应用程序中。

创建库包装模块

库包装模块是这样一个模块，其 JAR 文件不包含任何代码，它只是一个指向库的指针。该模块会将库转换为 NetBeans 模块，这样 NetBeans 类加载器系统的所有保护措施都会应用于该库，您无需对原始的 JAR 文件执行修改。然后您的应用程序就可以依赖于库了，就好像该库只是另外一个 NetBeans 模块一样。此外，如果库存在更新的版本，则只需为包装库分发单个的 NetBeans 模块 (NetBeans Module, NBM) 文件即可，无需分发其他任何内容。

注意：在 NetBeans 平台上构建应用程序的一个优点是：其用户界面基于 Java 的标准用户界面工具包 Swing。由于 Swing 已被广泛使用了很长时间，因此许多 Swing 组件都可以在应用程序中重用。在本教程中，您将重用现有的颜色选择器 JavaBean（可以在 NetBeans CVS 中的 contrib/coloreditor 下找到其源代码）。该 JAR 文件名为 ColorChooser.jar。您可以从此处下载库。将其保存到文件系统中的任意位置。

请执行以下操作为 ColorChooser.jar 文件创建库包装模块：

1. 选择“文件”>“新建项目”。在“类别”下选择“NetBeans 模块”。在“项目”下，选择“库包装模块”，然后单击“下一步”。
2. 在“选择库”面板的“库”文本框中，键入 ColorChooser.jar 的路径，或者浏览到它所在的位置。
3. 将“许可证”文本字段保留为空。如果希望分发完整的产品，则应该包括外部库的许可证文件。单击“下一步”。
4. 在“名称和位置”面板中，填写项目名称，设置项目位置，并确保“添加到模块套件中”下拉列表显示模块将添加到应用程序中。单击“下一步”。
5. 在“基本模块配置”面板的“代码名称基”中键入唯一名称，指定模块显示名称以及模块的本地化包位置：

   

   单击“完成”。

选定 colorchooser.jar 的包装模块是由 IDE 创建的。新模块的结构将显示在“项目”窗口中。应用程序结构中的“模块”节点显示模块是应用程序的一部分。

创建模块

现在，您需要使用一个模块来包含将要编写的实际代码。

1. 选择“文件”>“新建项目”。在“类别”下选择“NetBeans 模块”。在“项目”下选择“模块”，然后单击“下一步”。
2. 在“名称和位置”面板的“项目名称”中键入 Paint。将项目位置更改为计算机上的任意目录。确保“添加到模块套件中”单选按钮处于选定状态，并在“模块套件”下拉列表中选定了 PaintApp 应用程序。选中“设置为主项目”复选框。单击“下一步”。
3. 在“基本模块配置”面板中，键入 org.netbeans.paint。将“模块显示名称”保留为 Paint。保留本地化包的位置。单击“生成 XML 层”，并且不更改建议的位置，以便将本地化包和 XML 层文件存储在名为 org.netbeans.paint 的包中。

   这些文件将执行以下操作：

   • 本地化包。为国际化指定特定于语言的字符串。
   • XML 层。在 NetBeans 平台应用程序中注册菜单和工具栏按钮等项。

   单击“完成”。

IDE 将创建 Paint 项目。该项目包含所有源代码和项目 meta 数据，如项目的 Ant 生成脚本。此项目将会在 IDE 中打开。您可以在“项目”窗口 (Ctrl-1) 中查看其逻辑结构，在“文件”窗口 (Ctrl-2) 中查看其文件结构。例如，“项目”窗口应如下所示：

除了本地化包和 XML 层以外，此项目还包括以下重要文件：

• 模块清单。声明项目是一个模块。此外，它还设定了一些特定于模块的设置，如 XML 层的位置、本地化包的位置以及模块版本。
• 生成脚本。提供一个位置，供您创建自己的 Ant 目标并覆盖在 nbproject/build-impl.xml 中指定的 Ant 目标。
• 项目 Meta 数据。包含一些信息，如项目的类型、内容、平台、类路径、依赖关系以及项目命令与 Ant 脚本中的目标之间的映射。

您在本教程中不需要修改其中的任何文件。

指定模块的依赖关系

您需要根据一些属于 NetBeans API 的类创建子类。此外，该项目还依赖于 ColorChooser.jar 文件。由于所有 NetBeans API 都是由模块实现的，因此完成这两个任务实际上就意味着：将某些模块添加到保证我们的模块正常运行所需的模块列表中。

1. 在“项目”窗口中右键单击 Paint 项目节点，然后选择“属性”。将打开“项目属性”对话框。在“类别”下单击“库”。
2. 对于下表中列出的每个 API，单击“添加依赖关系...”，然后在“过滤器”文本框中开始键入要创建子类的类名称。
   
   

   类	API	用途
   ColorChooser	ColorChooser	所创建的颜色选择器组件的库包装模块
   DataObject	Datasystems API	包含 DataObject 类的 NetBeans 模块
   DialogDisplayer	对话框 API	用于创建并显示用户通知（对话框的描述）
   AbstractFile	文件系统 API	提供了以统一方式访问文件的通用 API
   AbstractNode	节点 API	用作 NetBeans 中进行对象可视化的主要工具
   StatusDisplayer	UI 实用程序 API	用于编写主窗口中状态栏的 StatusDisplayer 类
   WeakListeners	实用程序 API	包含 WeakListeners 类
   TopComponent	窗口系统 API	包含 TopComponent JPanel 类

   上表中的第一列列出了将在本教程中创建子类的所有类。在每种情况下，当在“过滤器”中键入类名时，可观察到“模块”列表的选择范围逐渐缩小。使用表的第二列可以从缩小的“模块”列表中选取适当的 API（对于 ColorChooser，应选取库），然后单击“确定”以确认选择：

   

3. 单击“确定”退出“项目属性”对话框。
4. 在“项目”窗口中，如果尚未展开 "Paint" 模块的项目节点，请将其展开。然后展开“重要文件”节点，再双击“项目 Meta 数据”节点。请注意，您所选择的 API 已声明为与该模块具有依赖关系。

创建画布

下一步将创建用户可以在上面绘图的实际组件。对于本教程，您将使用一个纯 Swing 组件，因此，让我们跳过该组件的实现细节，只利用它的最终版本。在此面板的源代码中，将使用您已为其创建库包装模块的颜色选择器 Bean，当您运行完成的应用程序时，会在用于编辑图像的面板的工具栏中看到它。

1. 在“项目”窗口中，展开 Paint 节点，然后展开“源包”节点，再右键单击 org.netbeans.paint 节点。选择“新建”>“Java 类”。
2. 在“类名”中输入 PaintCanvas。请确保“包”中列出的是 org.netbeans.paint。单击“完成”。将在源代码编辑器中打开 PaintCanvas.java。
3. 将文件的缺省内容替换为此处的内容。如果为包指定 org.netbeans.paint 以外的名称，请在源代码编辑器中更正包名。

准备 TopComponent 类

现在您将编写第一个与 NetBeans API 交互的类。它是一个 TopComponent 类。TopComponent 类正是一个 NetBeans 的窗口系统知道如何与其进行交互的 JPanel 类，因此可以将其置于主窗口中的标签化容器内。

1. 在“项目”窗口中，展开 Paint 节点，然后展开“源包”节点，再右键单击 org.netbeans.paint 节点。选择“新建”>“Java 类”。
在“类名”中输入 PaintTopComponent。请确保“包”中列出的是 org.netbeans.paint。单击“完成”。将在源代码编辑器中打开 PaintTopComponent.java。
2. 在该文件的顶部附近，将类声明改为以下代码：

   public class PaintTopComponent extends TopComponent implements ActionListener, ChangeListener {

3. 按 Ctrl-Shift-I 组合键修复导入，然后在对话框中单击“确定”。IDE 会将所需的 import 包声明置于文件顶部。

   请注意刚刚输入的类声明下面的红线。将光标放置在该行上，您会注意到其左侧空白处显示了一个灯泡图标。单击该灯泡图标（或按 Alt-Enter 组合键），如下所示：

   

   选择“实现所有抽象方法”。IDE 将生成两个方法框架 - actionPerformed() 和 stateChanged()。您将在本教程的后面部分填充这些方法。

4. 将以下三个变量声明添加到 PaintTopComponent 类的顶部，然后修复 import 语句 (Ctrl-Shift-I)。

       private PaintCanvas canvas = new PaintCanvas(); //The component the user draws on
       private JComponent preview; //A component in the toolbar that shows the paintbrush size
       private static int ct = 0; //A counter you use to provide names for new images

5. 现在需要实现两个样板方法。第一个方法通知窗口系统在应用程序关闭时忽略打开的窗口；第二个方法提供一个基本字符串作为组件的唯一字符串 ID。每个 TopComponent 都有一个唯一的字符串 ID，此 ID 在保存 TopComponent 时使用。在 PaintTopComponent 类中插入以下两个方法：

       @Override
       public int getPersistenceType() {
           return PERSISTENCE_NEVER;
       }
   
       @Override
       public String preferredID() {
           return "Image";
       }

该类现在应如下所示：

public class PaintTopComponent extends TopComponent implements ActionListener, ChangeListener {
    
    private PaintCanvas canvas = new PaintCanvas(); //The component the user draws on
    private JComponent preview; //A component in the toolbar that shows the paintbrush size
    private static int ct = 0; //A counter you use to provide names for new images
    
    public PaintTopComponent() {
    }
    
    @Override
    public void actionPerformed(ActionEvent arg0) {
        throw new UnsupportedOperationException("Not supported yet.");
    }
    
    @Override
    public void stateChanged(ChangeEvent arg0) {
        throw new UnsupportedOperationException("Not supported yet.");
    }
    
    @Override
    public int getPersistenceType() {
        return PERSISTENCE_NEVER;
    }
    
    @Override
    public String preferredID() {
        return "Image";
    }
    
}

初始化 TopComponent 类

在本节中，我们添加初始化用户界面的代码。

1. 定义构造函数，然后修复 import 语句 (Ctrl-Shift-I)：

       public PaintTopComponent() {
   
           initComponents();
   
           String displayName = NbBundle.getMessage(
                   PaintTopComponent.class,
                   "UnsavedImageNameFormat",
                   new Object[] { new Integer(ct++) }
           );
   
           setDisplayName(displayName);
   
       }

此处的代码非常简单。首先调用的是尚未编写的方法 initComponents()，该方法用于在 TopComponent 中添加一个工具栏和一个 PaintCanvas。由于尚未编写该方法，因此它下面会显示一条红线。如前面所述，单击灯泡图标（或按 Alt-Enter 组合键），并接受建议的内容：



将为您生成 initComponents() 方法框架。

2. 在“项目”窗口中展开 org.netbeans.paint 包。双击 Bundle.properties 文件，以便在源代码编辑器中将其打开。将以下代码行添加到该文件的末尾：

       UnsavedImageNameFormat=Image {0}

   此代码用于指定在用户保存一个新的图像文件之前，应用程序中标识此图像的文本。例如，当用户第一次在完成的应用程序中单击 "New Canvas" 时，源代码编辑器的上方将显示一个带有文本 'Image 0' 的标签。确保保存此文件，然后再继续。

填充框架方法

在本节中，我们将编写应用程序用户界面的代码。还可以使用 IDE 的 GUI 生成器以可视方式设计布局。

1. initComponents() 方法用于安装面板中的组件，以便用户可以与其进行交互。在上一节，已在 PaintTopComponent.java 类中生成了它的框架方法。请按如下所示填充该方法：

       private void initComponents() {
   
           setLayout(new BorderLayout());
           JToolBar bar = new JToolBar();
   
           ColorChooser fg = new ColorChooser();
           preview = canvas.createBrushSizeView();
   
           //Now build our toolbar:
   
           //Make sure components don't get squished:
           Dimension min = new Dimension(32, 32);
           preview.setMaximumSize(min);
           fg.setPreferredSize(new Dimension(16, 16));
           fg.setMinimumSize(min);
           fg.setMaximumSize(min);
   
           JButton clear = new JButton(
             	    NbBundle.getMessage(PaintTopComponent.class, "LBL_Clear"));
   
           JLabel fore = new JLabel(
            	    NbBundle.getMessage(PaintTopComponent.class, "LBL_Foreground"));
   
           fg.addActionListener(this);
           clear.addActionListener(this);
   
           JSlider js = new JSlider();
           js.setMinimum(1);
           js.setMaximum(24);
           js.setValue(canvas.getDiam());
           js.addChangeListener(this);
   
           fg.setColor(canvas.getColor());
   
           bar.add(clear);
           bar.add(fore);
           bar.add(fg);
           JLabel bsize = new JLabel(
        	    NbBundle.getMessage(PaintTopComponent.class, "LBL_BrushSize"));
   
           bar.add(bsize);
           bar.add(js);
           bar.add(preview);
   
           JLabel spacer = new JLabel("   "); //Just a spacer so the brush preview
           //isn't stretched to the end of the
           //toolbar
   
           spacer.setPreferredSize(new Dimension(400, 24));
           bar.add(spacer);
   
           //And install the toolbar and the painting component:
           add(bar, BorderLayout.NORTH);
           add(canvas, BorderLayout.CENTER);
           
       }

按 Ctrl-Shift-I 组合键生成所需的 import 语句。

2. 填充您生成的另外两个方法。它们用于侦听 PaintTopComponent 类：

       public void actionPerformed(ActionEvent e) {
   
           if (e.getSource() instanceof JButton) {
              canvas.clear();
           } else if (e.getSource() instanceof ColorChooser) {
              ColorChooser cc = (ColorChooser) e.getSource();
              canvas.setPaint (cc.getColor());
           }
           
           preview.paintImmediately(0, 0, preview.getWidth(), preview.getHeight());
           
       }

       public void stateChanged(ChangeEvent e) {
   
           JSlider js = (JSlider) e.getSource();
           canvas.setDiam (js.getValue());
           preview.paintImmediately(0, 0, preview.getWidth(), preview.getHeight());
           
       }

3. 在 Bundle.properties 文件的末尾添加以下键值对：

       LBL_Clear = Clear
       LBL_Foreground = Foreground 
       LBL_BrushSize = Brush Size
   

   确保保存此文件，然后再继续。

将图像保存到硬盘

在新的应用程序中，允许用户保存所创建的图像是一个非常好的想法。在 PaintTopComponent 类中包括以下代码可激活此功能。

1. 在 PaintTopComponent 类中插入以下代码：

       public void save() throws IOException {
   
           if (getDisplayName().endsWith(".png")) {
   	    doSave(new File(getDisplayName()));
           } else {
   	    saveAs();
           }
           
       }

       public void saveAs() throws IOException {
   
           JFileChooser ch = new JFileChooser();
           if (ch.showSaveDialog(this) == JFileChooser.APPROVE_OPTION && ch.getSelectedFile() != null) {
   
   	    File f = ch.getSelectedFile();
               
   	    if (!f.getPath().endsWith(".png")) {
   	        f = new File(f.getPath() + ".png");
   	    }
               
   	    if (!f.exists()) {
               
   	        if (!f.createNewFile()) {
   		    String failMsg = NbBundle.getMessage(
   		             PaintTopComponent.class,
   			    "MSG_SaveFailed", new Object[] { f.getPath() }
   	            );
   		    JOptionPane.showMessageDialog(this, failMsg);
   		    return;
   	        }
                   
   	    } else {
   	        String overwriteMsg = NbBundle.getMessage(
   		    PaintTopComponent.class,
                       "MSG_Overwrite", new Object[] { f.getPath() }
   	        );
                   
   	        if (JOptionPane.showConfirmDialog(this, overwriteMsg)
   	        != JOptionPane.OK_OPTION) {
   		    return;
   	        }
                   
   	    }
               
   	    doSave(f);
               
           }
           
       }

       private void doSave(File f) throws IOException {
   
           BufferedImage img = canvas.getImage();
           ImageIO.write(img, "png", f);
           String statusMsg = NbBundle.getMessage(PaintTopComponent.class,
               "MSG_Saved", new Object[] { f.getPath() });
           StatusDisplayer.getDefault().setStatusText(statusMsg);
           setDisplayName(f.getName());
           
       }

2. 将以下代码行添加到 Bundle.properties 文件中：

       MSG_SaveFailed = Could not write to file {0}
       MSG_Overwrite = {0} exists.  Overwrite?
       MSG_Saved = Saved image to {0}

   确保保存此文件，然后再继续。

3. 按 Ctrl-Shift-I 组合键修复 import 语句。您会注意到 File 类有两个全限定名称。请选择 java.io.File 选项。