目录   -  基本 Java 编辑 -  智能输入功能 -  代码完成 -  查看 Javadoc 文档 -  词语匹配功能 -  查找 Java 元素的使用实例 -  搜索 -  建立指向声明的超级链接 -  使用导入的类和包 -  编辑器选项

基本 Java 编辑

1. 在 IDE 的“欢迎”页中，单击“创建新项目”。在“新建项目”向导中，选择：
   
   类别：Web
   项目：JSF Web 应用程序
   
   
2. 单击“下一步”。
   
   
3. 在“项目名称”中输入 EditorExample。可以使用缺省的项目文件夹，也可以指定其他存储位置。
   
   
4. 单击“完成”。项目将在可视设计器中打开，并且显示 Page1。

1. 打开组件面板的“组件”标签，然后将以下“基本”组件拖动到 Page1 的设计表面上：
   
   
   • 文本字段
   • 静态文本
   • 按钮
   
   
2. 按照下图所示，排列这些组件。
   
   

   图 1：Page1 的基本组件布局

    
   
3. 选择“按钮”组件，然后单击“按钮”组件的文本，并将其更改为 Submit。或者，也可以选择“按钮”组件，然后在“属性”窗口中将其 text 属性更改为 Submit。
   
   
4. 选择“文本字段”组件，然后将其 id 属性更改为 inputText。
   
   
5. 选择“静态文本”组件，然后将其 id 属性更改为 outputText。
   
   
6. 双击“按钮”组件打开 Java 编辑器，插入点位于 button1_action() 方法中。
   
   
7. 单击该方法中以 // TODO: 开头的注释行，然后按 Ctrl-E 组合键删除该行。您也可以删除后续的注释行。
   
   
8. 打开组件面板的“代码片段”标签。
   
   
9. 将“Java 基本知识”> "If-Then-Else" 拖动到 Java 编辑器中，并将其放在已删除的注释的位置。
   
   将打开一个对话框，提示您输入 If-Then-Else 代码片段的参数值。
   
   
10. 将 String 替换为 MyString，然后单击“确定”。
    
    
11. 按 Ctrl-Shift-F 组合键以在 Java 编辑器中重新设置代码格式。
    
    删除某些注释后，页面应如下图所示。
    
    

    图 2：If-Then-Else 代码片段

     
    
12. 请注意三行代码左侧旁注处的红色 X 标注以及表达式下面的红色波浪线。出现错误是由于名称 getTextField1 和 getStaticText1 所导致的。这些名称应该分别标识“文本字段”和“静态文本”组件。由于重命名了这些组件，因此必须更改缺省名称，如图 3 所示。
    
    

    图 3：已更正的代码片段

     
    
13. 单击“运行主项目”工具栏按钮 或者按 Ctrl-F5 组合键，以生成并运行示例。在 Web 浏览器中输入 MyString 并单击 "Submit" 时，您应该看到下面的左窗口中显示的结果。当输入其他字符串时，看到的结果应该与右窗口中的内容类似。
    
    

    图 4：示例程序输出

     
    创建好工作示例后，可以开始了解 Java 编辑器更为高级的功能。

智能输入功能

1. 在 Java 编辑器中，将文本插入光标放置在以下行的 typed 一词之前：
   
   getStaticText1().setText("you typed something else");
   
   
2. 按 Enter 键，字符串将被拆分到两个单独的行，如下所示：
   
   getStaticText1().setText("you " +
"typed something else");
   
   
3. 要覆盖此功能，请按 Ctrl-Enter 组合键，而不是按 Enter 键。例如，如果将光标放置在 something 一词之前，然后按 Ctrl-Enter 组合键，则该行将变为：
   
   getStaticText1().setText("you " +
"typed
something else");
   
   由于其中的两行现在含有不正确的语法，因此在这些行的左旁注处将出现错误标注。
   
   
4. 通过按 Ctrl-Z 组合键或者根据需要从主菜单中选择“编辑”>“撤消”多次，可以撤消所做的更改。
   
   注意：通过按 Shift-Enter 组合键，可以开始一个新行，并且即使光标位于当前行的中间，也不会影响当前行。

1. 删除 Java 文件中位于下行结尾处的分号：
   
   getOutputText1().setText("you typed something else")
   
   
2. 将文本插入光标放置在字符串中（例如 typed 一词中），然后按分号键。您会看到：分号字符将出现在行尾。

1. 在 Java 编辑器中，将文本插入光标放置在一个新行上，然后键入 trc。
   
   
2. 按空格键。文本将扩展为 try-catch 块，随后您可以定制该块。
   
   注意：要在缩写之后键入实际的空格，请按 Shift-空格键。

1. 从主菜单中选择“工具”>“选项”。
   
   
2. 在“选项”对话框中，在选中“基本”单选按钮的情况下，从“选项”面板中选择“编辑”>“编辑器设置”>“Java 编辑器”节点。
   
   
3. 单击“缩写”属性右侧的省略号 (...) 按钮。
   
   
4. 此时将出现“缩写”对话框，可以在该对话框中查看、添加、编辑或删除缩写。单击对话框底部的“帮助”按钮，可以获取有关如何使用它的信息。
   
   

   图 5：“缩写”对话框

   
   

代码完成

1. 在 Java 编辑器中，将文本插入光标放置在文件顶部的 import 块下方。
   
   

   图 6：将光标放置在 Import 块下方

    
   
2. 在位于 import 块下面的行中，键入以下字符：import javax.faces.c。
   
   
3. 按 Ctrl-空格键（或 Ctrl-\ 组合键）。将显示代码完成框，其中包含可以完成您的表达式的可能包滚动列表以及 Javadoc 信息。请注意，如果 import 块是折叠的，则它将会在您编辑时展开以显示现有的 import 表达式。
   
   

   图 7：代码完成框

    
   
4. 使用键盘上的方向键选择 "convert" 文件夹，然后按 Enter 键。现在表达式如下所示：
   
   import javax.faces.convert
5. 在行尾键入一个句点，此时不要按 Ctrl-空格键。稍等片刻，您会发现：键入句点后，如果暂停时间超过 500 毫秒，Java 编辑器就会自动显示完成框。
   
   如果需要，可以禁用自动代码完成框，以便仅在按下 Ctrl-空格键时才会显示它。要禁用自动代码完成，请选择“工具”>“选项”。在“选项”对话框中，在选中“基本”单选按钮的情况下，从“选项”面板中选择“编辑”>“编辑器设置”>“Java 编辑器”节点，然后取消选中“常规”>“自动弹出完成窗口”复选框。
   
   
6. 返回到 Java 编辑器，在必要时按 Ctrl-空格键以显示 import javax.faces.convert. 表达式的完成框，然后双击 CharacterConverter，或者选择它后再按 Enter 键。
   
   

   图 8：在代码完成框中滚动

    
   
7. 键入一个分号以完成该行。现在，Java 编辑器将解析该行，位于该行旁边的错误标注将被删除，并且 import 块会因为包含新的表达式而得到扩展。
   
   

   图 9：输入的新 Import 语句

    
   

1. 将文本插入光标放置在 import 文本块中。
   
   
2. 在 Java 编辑器中单击鼠标右键，然后从弹出式菜单中选择“代码折叠”>“折叠”。新表达式将与其他 import 语句一起被隐藏。
   
   
提示：作为一种快捷方式，只需单击块中第一条语句旁边的减号即可折叠块。



图 10：折叠代码

 
注意：无需展开折叠的代码块，即可快速看到其内容。如果将光标悬停在折叠块旁边的省略号 (...) 上，则会打开一个工具提示窗口，以显示该块的内容。

• 如果代码完成框中的选项看起来过多，请继续键入内容以缩小选择范围。
  
  
• 使用鼠标或导航键（向上方向键、向下方向键、Page Up、Page Down、Home 和 End 键等）可滚动列表并选择表达式。
  
  
• 按 Enter 键可将代码完成框中的选择添加到文件，并且关闭代码完成框。或者可以双击代码完成框中的条目。
  
  
• 要使代码完成框保持打开状态，请按 Shift-Enter 组合键以将代码完成框中的选择添加到文件。
  
  
• 按 Tab 键可将代码完成框中所有项的常用字母添加到 Java 文件，并使代码完成框保持打开状态。此选项仅在如下情况中起作用：代码完成框中的所有项以一组常用字母开头，而该组字母尚未完全键入到 Java 编辑器中。
  
  
• 按 Esc 键可关闭代码完成框而不输入选择。
  
  
• 如果在代码完成框中按 Enter 键以添加带参数的方法，则将为第一个参数提供可替换的文本，然后您可以通过键入来覆盖该文本。如果方法带有多个参数，则在键入每个参数之后，可以通过键入逗号来重新打开列表。
  
  
• 如果输入的参数与方法名称的任何已识别参数组合均不匹配，则会显示所有已识别的方法及其参数列表，并在代码完成框的标题中显示星号 (*)。
  
  

  图 11：代码完成框中的所有已识别参数

   
  

1. 在主菜单中，选择“工具”>“选项”。
   
   
2. 在“选项”对话框中，在选中“基本”单选按钮的情况下，从“选项”面板中选择“编辑”>“编辑器设置”>“Java 编辑器”节点。
   
   
3. 取消选择“自动弹出完成窗口”属性。

查看 Javadoc 文档

1. 在 import 文本块的顶部找到 AbstractPageBean import 语句：
   
   import com.sun.rave.web.ui.appbase.AbstractPageBean;
   
   
2. 将文本插入光标放置在 AbstractPageBean 类名称中。
   
   
3. 按 Alt-F1 组合键，或者单击鼠标右键，然后选择“显示 Javadoc”。内部 Web 浏览器将在编辑区域中打开一个窗口，显示 AbstractPageBean 类的 Javadoc 描述。

词语匹配功能

1. 再次将文本插入光标放置在 import 代码块后面的行中。
   
   

   图 12：将光标放置在 Import 块下方

    
   
2. 键入字母 i，然后按 Ctrl-K 组合键。编辑器将向上搜索文件来查找以 i 开头的匹配词语，并完成 import 一词。
   
   

   图 13：向上的词语匹配

    
   
3. 按 Ctrl-L 组合键，编辑器将显示您的输入字符 i。再次按 Ctrl-L 组合键，编辑器将向下搜索文件，以查找第一个匹配词 initialization。
   
   每按一次 Ctrl-L 组合键，编辑器就会显示下一个匹配词：incoming、int、is、inserted 等。搜索完当前文件后，编辑器将按文件的最新使用顺序搜索其他打开的文件。
   
   正如您所预料的，如果按 Ctrl-L（或 Ctrl-K）组合键而不键入一个词的开头字符，则编辑器将生成下一个（或上一个）词，以匹配它在您按组合键时所遇到的每个词。
   
   
4. 完成词语匹配的演练后，请删除您输入的内容以消除错误。

查找 Java 元素的使用实例

1. 在 Java 编辑器中，将文本插入光标放置在以下代码行中的 setText 方法上：
   
   getStaticText1().setText("you typed MyString");
   
   
2. 按 Alt-F7 组合键，或者单击鼠标右键，然后选择“查找使用实例”。
   
   
3. 在“查找使用实例”对话框中，保留“查找使用实例”处的设置，然后单击“下一步”。“使用实例”窗口将在 Java 编辑器下面打开，并显示找到的该方法的所有使用实例。
   
   

   图 14：“使用实例”窗口

    
   
4. 在“使用实例”窗口中双击找到的第二项，可转到它在 Java 编辑器中的位置。

搜索

1. 向下滚动到 button1_action() 方法中的 else 子句，然后通过将光标拖过以下行来选择它们：
   
   

   getOutputText1().setText("you typed something else");
   } // end if
   

2. 按 Ctrl-H 组合键，或者从菜单栏中选择“编辑”>“替换”，以打开“替换”对话框。
   
   
3. 输入 else 作为搜索字符串，然后输入 different 作为替换字符串。请注意，已自动选中“搜索选定的内容”框。
   
   

   图 15：在选定的内容中搜索和替换

    
   
4. 单击“全部替换”按钮。请注意，选定内容中的字符串 else 将被替换为 different，但它上面的行中（和文件中的其他位置）出现的 else 将保持不变。
   
   

   图 16：搜索和替换后的效果

    
   
5. 单击“关闭”关闭“替换”对话框。

1. 按 Ctrl-F 组合键。将打开“查找”对话框。
   
   
2. 要搜索并突出显示所有表达式语句（以分号结尾的行），请确保同时选中了“正则表达式”、“突出显示结果”和“回绕”复选框。
   
   
3. 键入以下搜索字符：
   
   .*;$
   
   
4. 单击“查找”，将突出显示所有表达式语句。
   
   您输入的搜索字符串将被保存在历史下拉列表中。
   
   

   图 17：搜索正则表达式

    
   
5. 要查看找到的内容，请在源文件中查找突出显示的部分。
   
   
6. 单击“关闭”关闭“查找”对话框。

图 18：搜索工具栏

建立指向声明的超级链接

1. 滚动到 button1_action() 方法。按 Ctrl 键并将鼠标悬停在以下表达式中的 String 元素上：
   

   if (((String)getInputText().getText()).equals("MyString")) {
   

   该元素将变成一个超级链接。
   
   

   图 19：查看超级链接

    
   
2. 按住 Ctrl 键单击超级链接，编辑器将显示文件 String.java 中 String 类的声明。
   
   

   图 20：查看超级链接所指向的声明

使用导入的类和包

1. 在示例应用程序中，删除整个 import 块。由于存在未解析的类，因此代码中出现错误标注。
   
   
2. 按 Alt-Shift-F 组合键，或者单击鼠标右键，然后从弹出式菜单中选择“修复导入”。将自动生成一个新的 import 块，而且错误标注消失。如果可以使用多个包解析类，则 Java 编辑器将显示一个“修复导入”对话框，您可以在该对话框中指定要导入的包。
   
   

   图 21：“修复导入”对话框

    
   
3. 按照图中所示，指定包，然后单击“确定”。
   
   
4. 通过单击“运行主项目”工具栏按钮 或者按 Ctrl-F5 组合键生成并运行项目，以便验证 import 语句是否起作用。

1. 在示例应用程序中，删除以下 import 表达式语句：
   
   import com.sun.jsfcl.app.AbstractPageBean;
   
   请注意，由于存在未解析的类，因此代码中出现错误指示符。如果将鼠标悬停在左旁注处的错误指示符上，则可以看到导致出现问题的类。
   
   

   图 22：因未解析的类而导致的错误

    
   
2. 将鼠标悬停在第一行（在其中指示了错误）左旁注处的 X 上：
   
   public class Page1 extends AbstractPageBean {
   
   可以看到 AbstractPageBean 类是无法识别的类。
   
   
3. 将文本插入光标放置在此类中，然后按 Alt-Shift-I 组合键。将打开“导入类”对话框。
   
   
4. 如果存在多个可导入的类用于解析代码中的表达式，将会全部显示它们，您可以从中选择一个类。在本例中，选择 com.sun.jsfcl.app.AbstractPageBean 类。单击“导入类”按钮，然后单击“确定”。
   
   

   图 23：使用快速导入

    
   在“导入类”对话框中单击“确定”可生成以下 import 语句：
   
   import com.sun.jsfcl.app.AbstractPageBean;
   
   如果选择了“导入包”选项，则单击“确定”将在 import 块中生成以下语句：
   
   import com.sun.jsfcl.app.*;
   
   如果选择了“全限定名称”选项，则单击“确定”会将当前行修改为：
   
   public class Page1 extends com.sun.jsfcl.app.AbstractPageBean {

编辑器选项

图 24：Java 编辑器选项窗口

小结

• 在编辑器中查看错误
• 使用智能输入和缩写
• 使用词语匹配和代码完成
• 查看 Javadoc 文档
• 查找类、方法或字段的所有使用实例
• 跨文件搜索和在选定的内容中搜索
• 建立指向声明语句的超级链接
• 使用“快速导入”和“修复导入”功能修复对类和包的引用
• 设置控制 Java 编辑器功能的选项

• 使用调试器
• Sun Java Studio Creator 入门指南