一、概述
文本编辑器是一种最常用的应用程序,下面我们利用jbuilder 9集成开发环境,用java语言实现一个简单的文本编辑器。该文本编辑器具有读出、写入、编辑文本文件,可以设定文字颜色、字形和编辑区域背景颜色等基本功能。
我们首先通过jbuilder 9项目向导和应用向导创建项目,然后应用可视化设计工具,修改ui设计,连接事件,编辑源码以及常用控件和任务诸如菜单项、工具条、文本区域和系统事件等常用控件和任务的处理。涉及到具体技术有:
用jfilechooser 对话框让用户选择文本文件。
用jtextarea读、写和处理文本文件中的文字。
设置前景色和背景色。
用dbswing fontchooser对话框设置字型。
在状态栏和窗口标题栏显示信息。
手工添加处理ui事件的代码 。
通过将代码放在一个可被菜单项和按钮两个事件处理器调用的新的"帮助"方法中, 使得菜单项和按钮执行相同的代码。
给jtextarea控件增加一个右击菜单。
保持对文件的位置以及文件是否活动过的跟踪,展示对文件|新建, 文件|打开, 文件|保存, 文件|另存为,编辑和退出等逻辑的处理。
将"text editor" 应用程序展开为jar 文件。
二、开发文本编辑器java源程序说明
文本编辑器程序包含三个java 源程序即texteditframe.java、texteditclass.java 和texteditframe_aboutbox.java 程序,下面将分别介绍如下:
1、texteditframe.java的源程序代码(节选部分):
texteditframe.java 是实现文本编辑器的主要程序,它有下面6点编程技巧说明:
1) 制作一个完全充满用户界面顶部菜单栏和底部状态栏之间区域的文本区
主用户界面容器的布局管理器需要采用边界布局(borderlayout)。在主容器中,含有一个叫做内容窗(contentpane)的jpanel 控件,被改变成边界布局,需要做的只是在内容窗添加一个文本区控件。为此,先在内容窗添加一个滚动窗,再在滚动窗内放上文本区控件(jtextarea)。滚动窗提供一个带滚动棒(jscollpane)的文本区。
一个边界布局的容器被分成五个区域:北、南、东、西、中。每个区域只能有一个控件,所以最多可有五个控件(注:含有多个控件的面板被认为是一个控件)。放进中心区域的控件完全占满该容器控件,不被含有控件的任何其他区域所占据。例如,在本例中,工具栏占据北区(顶),状态栏占据南区(低步),由于东西两个区域没有安排控件,这样滚动窗控件占据中心区域并扩展到容器的左(西)右(东)的边缘。
2) 创建菜单file (包含new、open、save、save as 和exit菜单项),菜单edit{包含font(字体)、foreground(前景色)和background(背景色)菜单项} 和菜单help (包含about帮助说明)
①菜单edit的font(字体)、foreground(前景色)和background(背景色)菜单项:
添加字型选择对话框
给菜单挂上事件,从 edit|font 菜单项开始,该菜单将引出一个fontchooser (字型选择)对话框。
给fontchooser附加一个菜单项事件(源程序)如下:
给jcolorchooser(颜色选择)附加一个菜单项事件
创建edit|foreground and edit|background两个菜单事件,并将它们与swing中的jcolorchooser对话控件连接起来。
②菜单file 的new、open、save、save as 和exit菜单项:
添加测试文件是否被修改的代码
程序需要保持跟踪文件被生成、打开、或保存之后是否被修改过("脏的"),这样当关闭文件或退出程序时就可以提示问用户是否要保存操作。为此增加一个称作dirty的布尔变量。
在源代码中添加下列oktoabandon()方法,可将这个新方法紧放在saveasfile()方法之后:
将在随后完成的上面方法当用户选择 file|new, file|open, 或 file|exit时就被调用。 这个方法的目的是测试文本是否需要保存(是否动过)。若文本动过,这个方法就用yes, no, cancel消息对话问用户是否保存。这个方法在用户点选yes按钮时,也调用savefile()。若这个方法返回的布尔值是true(真),则表明可以退出当前文件,因为文件是干净的或用户点选了yes或no按钮。如果返回值是false(假),意味着用户点选了cancel。实际检查文件是否被改变的代码在随后的步骤中添加。目前这个方法总认为文件是不干净的,即使文字根本没被动过。随后要添加一个当用户在文本区域输入文字时就将dirty变量设置为true的方法,并在oktoabandon()方法的头部增加测试dirty变量的代码。
添加一个清除文本区的菜单事件处理器
将file|new菜单项与清除文本区的事件处理器挂起钩来。
添加一个文件选择对话框
将file|open菜单项与提供给用户一个文件选择对话框的jfilechooser控件的事件处理器挂起钩来。如果用户选择了一个文件,按下了ok按钮,这个事件处理器打开那个文本文件并把文字放入jtextarea(即文本区)。
添加从文件中读出文字的代码
添加从选定的文件中将文字实际读到文本区jtextarea的代码。
首先需要在用户类中增加一个新的方法执行实际打开文件的操作,这个方法叫作openfile()。
替换先前所说的file|open 事件处理器中的 if() 语句:
添加一个保存文件的菜单项
在选择file|save 和 file|save as时,将文件写回到磁盘的代码。
为此,需要增加一个含有被打开文件名字的字符串例程变量和增加将文字写回到文件或另一个文件的方法。
创建下列可从file|save事件处理器调用的方法savefile()。可将其放在openfile()方法之后。这个方法在保存时也将文件名写到状态栏。
创建没有当前文件名时,从savefile()方法中调用的saveasfile()方法。它也可以从file|save as 菜单调用。将下列代码紧放在savefile()方法之后:
菜单file|exit, 在退出应用程序的代码如下:
3) 激活工具栏按钮
如果在应用向导中选择了generate toolbar(生成工具栏)选项,则jbuilder就生成通常带有三个jbutton 按钮(open file、save file 和about) 控件且有图标显示的jtoolbar(工具栏)代码。要做的就是给每个按钮的标称指定文字和指定工具提示文字,并为每个按钮创建一个actionperformed()事件,用户从每个按钮actionperformed()事件中调用相应的事件处理方法。
指定按钮工具的提示文字
对应jbutton1输入open file
对应jbutton2输入save file
对应jbutton3输入about
创建按钮事件
创建对应jbutton1的jbutton1_actionperformed(actionevent e)事件并从中调用openfile()方法:
创建对应jbutton2的jbutton2_actionperformed(actionevent e)事件并从中调用 savefile()方法:
创建fileopen()方法
fileopen()方法的目的是执行当前在file|open菜单项处理方法中的操作。即按下open按钮和选择file|open 菜单项执行的是同样的操作,所以创建fileopen()方法将代码复制一下即可。从file|open 菜单和open按钮调用相同的代码。
创建savefile()方法
对file|save菜单和save按钮再做一次同样的事情。将当前file|save事件处理器中的代码收集到新的 savefile()方法中,即可从菜单处理器也可从按钮处理器对其调用。
建helpabout()方法
对help|about菜单和about按钮再做一次同样的事情。将当前help|about事件处理器中的代码收集到新的 helpabout()方法中,即可从菜单处理器也可从按钮处理器对其调用。
4) 将事件处理与文本区联系起来
将事件处理与文本区jtextarea联系起来,这样只要有输入操作用户程序就设置dirty标志为真。为此需要在jtextarea的文本模板中添加一个swing控件documentlistener(文本监听器)且检查插入、删除和改变等事件。
documentlistener被添加到 jbinit():
在void document1_changedupdate(documentevent e)事件中插入下面代码:
为document1 再创建两个事件:insertupdate()和removeupdate()。 在这些事件中插入在changedupdate()事件中使用的同样的代码。
这样只要在文本区输入任何字符都将强迫dirty标志为真。
5) 在文本区添加一个右击弹出菜单
控件dbtextdatabinder用来在swing文本控件中添加一个执行诸如剪切、复制、粘贴等简单编辑任务的右击菜单。dbtextdatabinder还有一个将文件装入jtextarea和保存文件的内部动作,但不允许用户恢复显示在状态栏的装入或保存的文件名。本例中,只是添加一个dbtextdatabinder控件给jtextarea1,不使用其中的文件打开和保存操作。
6) 在窗口的标题栏展示文件名和状态
添加使用应用程序的标题栏显示当前文件名和当文件受"污染"时显示一个星花号的代码。为此,创建一个更新标题栏的新方法,然后从代码改变文件名或改变dirty标志的地方调用它。给这个新方法取名为updatecaption()。
updatecaption()方法:
从dirty标志被实际改变的每一个地方或者每当用户改变当前文件名currfilename的时候调用 updatecaption()。特别要将调用 updatecaption()语句放在下列这些地方:
①在texteditframe()构造器的try模块内紧接着调用jbinit()方法之后;
② 在openfile()方法的try模块的最后一行;
③ 在savefile()方法try模块返回true的前一行;
④ 在file|new 菜单处理器jmenuitem1_actionperformed()的if模块的最后一行;
⑤当由于用户输入,dirty标志在干净的文件中第一次被设置为true时。每一个文本事件处理器都应该改变为:
2、texteditclass.java的源程序代码:
上面的这段程序主要是构建 texteditorframe 的主窗口和主方法入口(main ()),它有下面2点编程技巧说明:
1) 设置外观及基调
设计时的外观和基调
如果已经把 jbuilder的外观和基调从其默认值改变了,则在开始使用ui设计器之前,在jbuilder 内让ui 设计器使用 metal look & feel(金属外观和基调),也可以使用其它外观和基调,但本例中选择金属外观和基调,这时一种适合于跨平台设计的选择。
运行时的外观和基调
在设计器的弹出菜单或jbuilder环境选项对话框中设置的外观和基调对运行时的用户界面(ui)没有任何影响。要强制一个运行时的外观和基调,必须在应用程序(本例即为texteditclass.java)的类的主方法(main())中设置。
作为默认,应用向导会在可运行类的main()方法中生成下列一行代码:
其含义是运行时的外观采用主机系统使用的外观。
若是想要cde/motif 或 windows 式的外观则参数应改变为:
2) 窗口的定义
3、texteditframe_aboutbox.java的源程序代码:
说明:上面的这段程序主要是构建help菜单的aboutbox 对话框,显示product、version 和comments 等内容。
至此我们已完成文本编辑器所有的菜单及代码设计等工作,在 jbuilder9 环境下编译运行会出现如下的text editor窗口:
三、从命令行运行打包程序有关说明
首先将text editor应用程序装配成一个jar文件。既然已经创建了"text editor" 应用程序,用户就可以使用jbuilder9的archive builder(档案构筑器)将全部文件装配成一个java archive file(jar,java归档文件)。
在从命令行运行应用程序之前,用户必须确保操作系统的path环境变量指向jdk jre/bin/目录,即java的运行环境。jbuilder9安装过程保证了jbuilder9 知道到那里找到jdk 类文件。但是若离开了jbuilder9环境,系统需要知道运行java时,类文件被安装到了什么位置。如何设置path环境变量视用户所用操作系统而定。要从命令行运行 text edit程序,步骤如下:
①切换到命令行窗口,将路径改变到jar文件所在的texteditor 目录。
② 在命令行输入java看看java是否在当前路径中,若在就会显示java的使用和选项,若不在,就将path环境变量设到jdk的jre/bin/文件夹。对于windows xp和nt/2000/2003系统,设置路径如下:
set path=<e:>/<jbuilder9>/<jdk>/jre/bin
这里:
<e:> 是驱动器;
<jbuilder9>是 jbuilder9目录名;
<jdk>是jbuilder安装时提供的jdk 目录名,例如:jbuilder9/jdk1.4/
③ 在命令行输入下列命令:
这里:
java ---- 运行java文件的java工具。
jar ---- 该选项告诉 java vm (java虚拟机)这是一个打包文件。
texteditor.jar ---- 包文件的名字。
由于清单文件在main-class头中提供了运行那个类,所以在命令行末尾无需指定类名,并且由于所有的类、资源、和独立件都被包含到了装配成包的jar文件中,所以也不需要指定类路径classpath或将jbuilder的库文件复制到当前目录。
注:一旦使用了-jar选项,java运行时就会忽略任何显式给出的classpath设置。
如果我们不是在 texteditor 目录下运行这个jar文件,则应使用下列java命令:
java运行时在jar文件中寻找启动类和应用程序使用的其它类,java vm虚拟机使用三个搜寻路径查找文件,它们是:引导类路径、安装时扩展路径和用户类路径。
文本编辑器是一种最常用的应用程序,下面我们利用jbuilder 9集成开发环境,用java语言实现一个简单的文本编辑器。该文本编辑器具有读出、写入、编辑文本文件,可以设定文字颜色、字形和编辑区域背景颜色等基本功能。
我们首先通过jbuilder 9项目向导和应用向导创建项目,然后应用可视化设计工具,修改ui设计,连接事件,编辑源码以及常用控件和任务诸如菜单项、工具条、文本区域和系统事件等常用控件和任务的处理。涉及到具体技术有:
用jfilechooser 对话框让用户选择文本文件。
用jtextarea读、写和处理文本文件中的文字。
设置前景色和背景色。
用dbswing fontchooser对话框设置字型。
在状态栏和窗口标题栏显示信息。
手工添加处理ui事件的代码 。
通过将代码放在一个可被菜单项和按钮两个事件处理器调用的新的"帮助"方法中, 使得菜单项和按钮执行相同的代码。
给jtextarea控件增加一个右击菜单。
保持对文件的位置以及文件是否活动过的跟踪,展示对文件|新建, 文件|打开, 文件|保存, 文件|另存为,编辑和退出等逻辑的处理。
将"text editor" 应用程序展开为jar 文件。
二、开发文本编辑器java源程序说明
文本编辑器程序包含三个java 源程序即texteditframe.java、texteditclass.java 和texteditframe_aboutbox.java 程序,下面将分别介绍如下:
1、texteditframe.java的源程序代码(节选部分):
| package texteditor; //texteditframe.java import java.awt.*;//导入类 import java.awt.event.*; import javax.swing.*; import com.borland.dbswing.*; import java.io.*; import javax.swing.text.*; import javax.swing.event.*; public class texteditframe extends jframe { intlswingsupport intlswingsupport1 = new intlswingsupport(); //swing 控件互联网化:即本地化应用程序,需要添加一行代码以便swing 控件jfilechooser //和jcolorchooser出现在程序运行的语言中 jpanel contentpane; //设置内容窗(contentpane)的jpanel控件 jmenubar menubar1 = new jmenubar();//创建菜单条并加入到框架窗体中 jmenu menufile = new jmenu();//创建file菜单和相应的菜单项 jmenuitem menufileexit = new jmenuitem(); jmenu menuhelp = new jmenu();//创建help菜单和相应的菜单项 jmenuitem menuhelpabout = new jmenuitem(); jtoolbar toolbar = new jtoolbar();//创建工具条组件 jbutton jbutton1 = new jbutton();//创建按钮组件 jbutton jbutton2 = new jbutton(); jbutton jbutton3 = new jbutton(); imageicon image1;//定义图标 imageicon image2; imageicon image3; jlabel statusbar = new jlabel();//创建标签组件 borderlayout borderlayout1 = new borderlayout();//创建borderlayout 布局器 jscrollpane jscrollpane1 = new jscrollpane();//创建滚动窗控件 jtextarea jtextarea1 = new jtextarea();//创建多行文本域组件 jmenuitem jmenuitem1 = new jmenuitem();//创建菜单项 jmenuitem jmenuitem2 = new jmenuitem(); jmenuitem jmenuitem3 = new jmenuitem(); jmenuitem jmenuitem4 = new jmenuitem(); fontchooser fontchooser1 = new fontchooser();//创建字型选择对话框 jmenu jmenu1 = new jmenu(); jmenuitem jmenuitem5 = new jmenuitem(); jmenuitem jmenuitem6 = new jmenuitem(); jmenuitem jmenuitem7 = new jmenuitem(); jfilechooser jfilechooser1 = new jfilechooser();//创建文本选择对话框 string currfilename = null; // full path with filename. null means new/untitled. boolean dirty = false; document document1; //文本 dbtextdatabinder dbtextdatabinder1 = new dbtextdatabinder(); // true means modified text. //构造架框 public texteditframe() { enableevents(awtevent.window_event_mask); try { jbinit(); updatecaption(); } catch(exception e) { e.printstacktrace(); } } //组件初始化 private void jbinit() throws exception { //三个工具栏按钮图标 image1 = new imageicon(texteditframe.class.getresource("openfile.gif")); image2 = new imageicon(texteditframe.class.getresource("closefile.gif")); image3 = new imageicon(texteditframe.class.getresource("help.gif")); contentpane = (jpanel) this.getcontentpane();//内容创格 document1 = jtextarea1.getdocument();//多行文本域文档 contentpane.setlayout(borderlayout1);//borderlayout布局器 this.setsize(new dimension(400, 300));//窗口大小 this.settitle("text editor");//窗口标题 statusbar.settext(" "); menufile.settext("file"); menufileexit.settext("exit"); menufileexit.addactionlistener(new texteditframe_menufileexit_actionadapter (this)); //添加事件监听器 menuhelp.settext("help"); menuhelpabout.settext("about"); menuhelpabout.addactionlistener(new texteditframe_menuhelpabout_actionadapter (this)); jbutton1.seticon(image1);//设置三个工具栏按钮图标,添加事件监听器 jbutton1.addactionlistener(new texteditframe_jbutton1_actionadapter(this)); jbutton1.settooltiptext("open file"); jbutton2.seticon(image2); jbutton2.addactionlistener(new texteditframe_jbutton2_actionadapter(this)); jbutton2.settooltiptext("close file"); jbutton3.seticon(image3); jbutton3.addactionlistener(new texteditframe_jbutton3_actionadapter(this)); jbutton3.settooltiptext("about"); jtextarea1.setlinewrap(true); jtextarea1.setwrapstyleword(true); jtextarea1.setbackground(color.white); jmenuitem1.settext("new");//设置菜单,添加事件监听器 jmenuitem1.addactionlistener(new texteditframe_jmenuitem1_actionadapter(this)); jmenuitem2.settext("open"); jmenuitem2.addactionlistener(new texteditframe_jmenuitem2_actionadapter(this)); jmenuitem3.settext("save"); jmenuitem3.addactionlistener(new texteditframe_jmenuitem3_actionadapter(this)); jmenuitem4.settext("save as"); jmenuitem4.addactionlistener(new texteditframe_jmenuitem4_actionadapter(this)); fontchooser1.setframe(this); fontchooser1.settitle("font"); jmenu1.settext("edit"); jmenuitem5.settext("font"); jmenuitem5.addactionlistener(new texteditframe_jmenuitem5_actionadapter(this)); jmenuitem6.settext("foreground color"); jmenuitem6.addactionlistener(new texteditframe_jmenuitem6_actionadapter(this)); jmenuitem7.settext("background color"); jmenuitem7.addactionlistener(new texteditframe_jmenuitem7_actionadapter(this)); document1.adddocumentlistener(new texteditframe_document1_documentadapter(this)); dbtextdatabinder1.setjtextcomponent(jtextarea1); //turn off right-click file open... menu item. dbtextdatabinder1.setenablefileloading(false); //turn off right-click file save... menu item. dbtextdatabinder1.setenablefilesaving(false); toolbar.add(jbutton1);//工具组件添加按钮 toolbar.add(jbutton2); toolbar.add(jbutton3); menufile.add(jmenuitem1);//菜单组件添加菜单项 menufile.add(jmenuitem2); menufile.add(jmenuitem3); menufile.add(jmenuitem4); menufile.addseparator();//采单组件添加分隔线 menufile.add(menufileexit); menuhelp.add(menuhelpabout); menubar1.add(menufile); menubar1.add(jmenu1); menubar1.add(menuhelp); this.setjmenubar(menubar1); contentpane.add(toolbar, borderlayout.north); //内容窗设置borderlayout布局器 contentpane.add(statusbar, borderlayout.south); contentpane.add(jscrollpane1, borderlayout.center); jscrollpane1.getviewport().add(jtextarea1, null); jmenu1.add(jmenuitem5); jmenu1.add(jmenuitem6); jmenu1.add(jmenuitem7); } // display the about box. void helpabout() { texteditframe_aboutbox dlg = new texteditframe_aboutbox(this); dimension dlgsize = dlg.getpreferredsize(); dimension frmsize = getsize(); point loc = getlocation(); dlg.setlocation((frmsize.width - dlgsize.width) / 2 + loc.x, (frmsize.height - dlgsize.height) / 2 + loc.y); dlg.setmodal(true); dlg.show(); } ......... ......... |
texteditframe.java 是实现文本编辑器的主要程序,它有下面6点编程技巧说明:
1) 制作一个完全充满用户界面顶部菜单栏和底部状态栏之间区域的文本区
主用户界面容器的布局管理器需要采用边界布局(borderlayout)。在主容器中,含有一个叫做内容窗(contentpane)的jpanel 控件,被改变成边界布局,需要做的只是在内容窗添加一个文本区控件。为此,先在内容窗添加一个滚动窗,再在滚动窗内放上文本区控件(jtextarea)。滚动窗提供一个带滚动棒(jscollpane)的文本区。
一个边界布局的容器被分成五个区域:北、南、东、西、中。每个区域只能有一个控件,所以最多可有五个控件(注:含有多个控件的面板被认为是一个控件)。放进中心区域的控件完全占满该容器控件,不被含有控件的任何其他区域所占据。例如,在本例中,工具栏占据北区(顶),状态栏占据南区(低步),由于东西两个区域没有安排控件,这样滚动窗控件占据中心区域并扩展到容器的左(西)右(东)的边缘。
2) 创建菜单file (包含new、open、save、save as 和exit菜单项),菜单edit{包含font(字体)、foreground(前景色)和background(背景色)菜单项} 和菜单help (包含about帮助说明)
①菜单edit的font(字体)、foreground(前景色)和background(背景色)菜单项:
添加字型选择对话框
给菜单挂上事件,从 edit|font 菜单项开始,该菜单将引出一个fontchooser (字型选择)对话框。
给fontchooser附加一个菜单项事件(源程序)如下:
void jmenuitem5_actionperformed(actionevent e) { // handle the "edit font" menu item // pick up the existing font from the text area // and put it into the fontchooser before showing // the fontchooser, so that we are editing the // existing / previous font. fontchooser1.setselectedfont(jtextarea1.getfont()); // obtain the new font from the fontchooser. // first test the return value of showdialog() to // see if the user pressed ok. if (fontchooser1.showdialog()) { // set the font of jtextarea1 to the font // the user selected before pressing the ok button jtextarea1.setfont(fontchooser1.getselectedfont()); } //repaints menu after item is selected this.repaint(); //repaints text properly if some text is highlighted when font is changed. jtextarea1.repaint(); } |
给jcolorchooser(颜色选择)附加一个菜单项事件
创建edit|foreground and edit|background两个菜单事件,并将它们与swing中的jcolorchooser对话控件连接起来。
| void jmenuitem6_actionperformed(actionevent e) { // handle the "foreground color" menu item color color = jcolorchooser.showdialog(this,"foreground color",jtextarea1.getforeground()); if (color != null) { jtextarea1.setforeground(color); } //repaints menu after item is selected this.repaint(); } void jmenuitem7_actionperformed(actionevent e) { // handle the "background color" menu item color color = jcolorchooser.showdialog(this,"background color",jtextarea1.getbackground()); if (color != null) { jtextarea1.setbackground(color); } //repaints menu after item is selected this.repaint(); } |
②菜单file 的new、open、save、save as 和exit菜单项:
添加测试文件是否被修改的代码
程序需要保持跟踪文件被生成、打开、或保存之后是否被修改过("脏的"),这样当关闭文件或退出程序时就可以提示问用户是否要保存操作。为此增加一个称作dirty的布尔变量。
在源代码中添加下列oktoabandon()方法,可将这个新方法紧放在saveasfile()方法之后:
| // check if file is dirty. // if so get user to make a "save? yes/no/cancel" decision. boolean oktoabandon() { int value = joptionpane.showconfirmdialog(this, "save changes?","text edit", joptionpane.yes_no_cancel_option); switch (value) { case joptionpane.yes_option: // yes, please save changes return savefile(); case joptionpane.no_option: // no, abandon edits // i.e. return true without saving return true; case joptionpane.cancel_option: default: // cancel return false; } } |
将在随后完成的上面方法当用户选择 file|new, file|open, 或 file|exit时就被调用。 这个方法的目的是测试文本是否需要保存(是否动过)。若文本动过,这个方法就用yes, no, cancel消息对话问用户是否保存。这个方法在用户点选yes按钮时,也调用savefile()。若这个方法返回的布尔值是true(真),则表明可以退出当前文件,因为文件是干净的或用户点选了yes或no按钮。如果返回值是false(假),意味着用户点选了cancel。实际检查文件是否被改变的代码在随后的步骤中添加。目前这个方法总认为文件是不干净的,即使文字根本没被动过。随后要添加一个当用户在文本区域输入文字时就将dirty变量设置为true的方法,并在oktoabandon()方法的头部增加测试dirty变量的代码。
添加一个清除文本区的菜单事件处理器
将file|new菜单项与清除文本区的事件处理器挂起钩来。
| void jmenuitem1_actionperformed(actionevent e) { // handle the file|new menu item. if (oktoabandon()) { // clears the text of the textarea jtextarea1.settext(""); // clear the current filename and set the file as clean: currfilename = null; dirty = false; updatecaption(); } } |
添加一个文件选择对话框
将file|open菜单项与提供给用户一个文件选择对话框的jfilechooser控件的事件处理器挂起钩来。如果用户选择了一个文件,按下了ok按钮,这个事件处理器打开那个文本文件并把文字放入jtextarea(即文本区)。
| void jmenuitem2_actionperformed(actionevent e) { //handle the file|open menu item. if (!oktoabandon()) { return; } // use the open version of the dialog, test return for approve/cancel if (jfilechooser.approve_option == jfilechooser1.showopendialog(this)) { // call openfile to attempt to load the text from file into textarea openfile(jfilechooser1.getselectedfile().getpath()); } this.repaint(); } |
添加从文件中读出文字的代码
添加从选定的文件中将文字实际读到文本区jtextarea的代码。
首先需要在用户类中增加一个新的方法执行实际打开文件的操作,这个方法叫作openfile()。
| // open named file; read text from file into jtextarea1; report to statusbar. void openfile(string filename) { try { // open a file of the given name. file file = new file(filename); // get the size of the opened file. int size = (int)file.length(); // set to zero a counter for counting the number of // characters that have been read from the file. int chars_read = 0; // create an input reader based on the file, so we can read its data. // filereader handles international character encoding conversions. filereader in = new filereader(file); // create a character array of the size of the file, // to use as a data buffer, into which we will read // the text data. char[] data = new char[size]; // read all available characters into the buffer. while(in.ready()) { // increment the count for each character read, // and accumulate them in the data buffer. chars_read += in.read(data, chars_read, size - chars_read); } in.close(); // create a temporary string containing the data, // and set the string into the jtextarea. jtextarea1.settext(new string(data, 0, chars_read)); // display the name of the opened directory+file in the statusbar. statusbar.settext("opened "+filename); } catch (ioexception e) { statusbar.settext("error opening "+filename); } } |
替换先前所说的file|open 事件处理器中的 if() 语句:
| // display the name of the opened directory+file in the statusbar. statusbar.settext("opened "+jfilechooser1.getselectedfile().getpath()); // code will need to go here to actually load text // from file into jtextarea. with this new openfile() method instead, using the concatenated directory and file name. // call openfile to attempt to load the text from file into jtextarea openfile(jfilechooser1.getselectedfile().getpath()); //repaints menu after item is selected this.repaint(); |
添加一个保存文件的菜单项
在选择file|save 和 file|save as时,将文件写回到磁盘的代码。
为此,需要增加一个含有被打开文件名字的字符串例程变量和增加将文字写回到文件或另一个文件的方法。
创建下列可从file|save事件处理器调用的方法savefile()。可将其放在openfile()方法之后。这个方法在保存时也将文件名写到状态栏。
| // save current file; handle not yet having a filename; report to statusbar. boolean savefile() { // handle the case where we don't have a file name yet. if (currfilename == null) { return saveasfile(); } try { // open a file of the current name. file file = new file (currfilename); // create an output writer that will write to that file. // filewriter handles international characters encoding conversions. filewriter out = new filewriter(file); string text = jtextarea1.gettext(); out.write(text); out.close(); this.dirty = false; // display the name of the saved directory+file in the statusbar. statusbar.settext("saved to " + currfilename); return true; } catch (ioexception e) { statusbar.settext("error saving "+currfilename); } return false; } |
创建没有当前文件名时,从savefile()方法中调用的saveasfile()方法。它也可以从file|save as 菜单调用。将下列代码紧放在savefile()方法之后:
| // save current file, asking user for new destination name. // report to statubar. boolean saveasfile() { // use the save version of the dialog, test return for approve/cancel if (jfilechooser.approve_option == jfilechooser1.showsavedialog(this)) { // set the current file name to the user's selection, // then do a regular savefile currfilename = jfilechooser1.getselectedfile().getpath(); //repaints menu after item is selected this.repaint(); return savefile(); } else { this.repaint(); return false; } } |
菜单file|exit, 在退出应用程序的代码如下:
| //file | exit action performed public void jmenufileexit_actionperformed(actionevent e) { if (oktoabandon()) { system.exit(0); } } |
3) 激活工具栏按钮
如果在应用向导中选择了generate toolbar(生成工具栏)选项,则jbuilder就生成通常带有三个jbutton 按钮(open file、save file 和about) 控件且有图标显示的jtoolbar(工具栏)代码。要做的就是给每个按钮的标称指定文字和指定工具提示文字,并为每个按钮创建一个actionperformed()事件,用户从每个按钮actionperformed()事件中调用相应的事件处理方法。
指定按钮工具的提示文字
对应jbutton1输入open file
对应jbutton2输入save file
对应jbutton3输入about
创建按钮事件
创建对应jbutton1的jbutton1_actionperformed(actionevent e)事件并从中调用openfile()方法:
| //handle toolbar open button openfile(); |
创建对应jbutton2的jbutton2_actionperformed(actionevent e)事件并从中调用 savefile()方法:
| //handle toolbar save button savefile(); 创建对应jbutton3的jbutton3_actionperformed(actionevent e)事件并从中调用helpabout()方法: //handle toolbar about button helpabout(); |
创建fileopen()方法
fileopen()方法的目的是执行当前在file|open菜单项处理方法中的操作。即按下open按钮和选择file|open 菜单项执行的是同样的操作,所以创建fileopen()方法将代码复制一下即可。从file|open 菜单和open按钮调用相同的代码。
| // handle the file|open menu or button, invoking oktoabandon and openfile // as needed. void fileopen() { if (!oktoabandon()) { return; } // use the open version of the dialog, test return for approve/cancel if (jfilechooser.approve_option == jfilechooser1.showopendialog(this)) { // call openfile to attempt to load the text from file into textarea openfile(jfilechooser1.getselectedfile().getpath()); } this.repaint(); } |
创建savefile()方法
对file|save菜单和save按钮再做一次同样的事情。将当前file|save事件处理器中的代码收集到新的 savefile()方法中,即可从菜单处理器也可从按钮处理器对其调用。
| // save current file; handle not yet having a filename; report to statusbar. boolean savefile() { // handle the case where we don't have a file name yet. if (currfilename == null) { return saveasfile(); } try { // open a file of the current name. file file = new file (currfilename); // create an output writer that will write to that file. // filewriter handles international characters encoding conversions. filewriter out = new filewriter(file); string text = jtextarea1.gettext(); out.write(text); out.close(); this.dirty = false; // display the name of the saved directory+file in the statusbar. statusbar.settext("saved to " + currfilename); updatecaption(); return true; } catch (ioexception e) { statusbar.settext("error saving " + currfilename); } return false; } |
建helpabout()方法
对help|about菜单和about按钮再做一次同样的事情。将当前help|about事件处理器中的代码收集到新的 helpabout()方法中,即可从菜单处理器也可从按钮处理器对其调用。
| // display the about box. void helpabout() { texteditframe_aboutbox dlg = new texteditframe_aboutbox(this); dimension dlgsize = dlg.getpreferredsize(); dimension frmsize = getsize(); point loc = getlocation(); dlg.setlocation((frmsize.width - dlgsize.width) / 2 + loc.x,(frmsize.height - dlgsize.height) / 2 + loc.y); dlg.setmodal(true); dlg.show(); } |
4) 将事件处理与文本区联系起来
将事件处理与文本区jtextarea联系起来,这样只要有输入操作用户程序就设置dirty标志为真。为此需要在jtextarea的文本模板中添加一个swing控件documentlistener(文本监听器)且检查插入、删除和改变等事件。
documentlistener被添加到 jbinit():
| document1.adddocumentlistener(new texteditframe_document1_documentadapter(this)); |
在void document1_changedupdate(documentevent e)事件中插入下面代码:
| dirty = true; |
为document1 再创建两个事件:insertupdate()和removeupdate()。 在这些事件中插入在changedupdate()事件中使用的同样的代码。
这样只要在文本区输入任何字符都将强迫dirty标志为真。
5) 在文本区添加一个右击弹出菜单
控件dbtextdatabinder用来在swing文本控件中添加一个执行诸如剪切、复制、粘贴等简单编辑任务的右击菜单。dbtextdatabinder还有一个将文件装入jtextarea和保存文件的内部动作,但不允许用户恢复显示在状态栏的装入或保存的文件名。本例中,只是添加一个dbtextdatabinder控件给jtextarea1,不使用其中的文件打开和保存操作。
6) 在窗口的标题栏展示文件名和状态
添加使用应用程序的标题栏显示当前文件名和当文件受"污染"时显示一个星花号的代码。为此,创建一个更新标题栏的新方法,然后从代码改变文件名或改变dirty标志的地方调用它。给这个新方法取名为updatecaption()。
updatecaption()方法:
| // update the title bar of the application to show the filename and its dirty state. void updatecaption() { string caption; if (currfilename == null) { // synthesize the "untitled" name if no name yet. caption = "untitled"; } else { caption = currfilename; } // add a "*" in the caption if the file is dirty. if (dirty) { caption = "* " + caption; } caption = "text editor - " + caption; this.settitle(caption); } |
从dirty标志被实际改变的每一个地方或者每当用户改变当前文件名currfilename的时候调用 updatecaption()。特别要将调用 updatecaption()语句放在下列这些地方:
①在texteditframe()构造器的try模块内紧接着调用jbinit()方法之后;
② 在openfile()方法的try模块的最后一行;
③ 在savefile()方法try模块返回true的前一行;
④ 在file|new 菜单处理器jmenuitem1_actionperformed()的if模块的最后一行;
⑤当由于用户输入,dirty标志在干净的文件中第一次被设置为true时。每一个文本事件处理器都应该改变为:
| void document1_changedupdate(documentevent e) { if (!dirty) { dirty = true; updatecaption(); } } void document1_insertupdate(documentevent e) { if (!dirty) { dirty = true; updatecaption(); } } void document1_removeupdate(documentevent e) { if (!dirty) { dirty = true; updatecaption(); } } |
2、texteditclass.java的源程序代码:
| package texteditor; import javax.swing.uimanager; import java.awt.*; /** * <p>title: texteditor</p> * <p>description: this is a study programme</p> * <p>copyright: copyright (c) 2004</p> * <p>company: ghq</p> * @author ghq * @version 1.0 */ public class texteditclass { boolean packframe = false; //construct the application public texteditclass() { texteditframe frame = new texteditframe(); //validate frames that have preset sizes //pack frames that have useful preferred size info, e.g. from their layout if (packframe) { frame.pack(); } else { frame.validate(); } //center the window dimension screensize = toolkit.getdefaulttoolkit().getscreensize(); dimension framesize = frame.getsize(); if (framesize.height > screensize.height) { framesize.height = screensize.height; } if (framesize.width > screensize.width) { framesize.width = screensize.width; } frame.setlocation((screensize.width - framesize.width) / 2, (screensize.height - framesize.height) / 2); frame.setvisible(true); } //main method public static void main(string[] args) { try { uimanager.setlookandfeel(uimanager.getcrossplatformlookandfeelclassname()); } catch(exception e) { e.printstacktrace(); } new texteditclass(); } } |
上面的这段程序主要是构建 texteditorframe 的主窗口和主方法入口(main ()),它有下面2点编程技巧说明:
1) 设置外观及基调
设计时的外观和基调
如果已经把 jbuilder的外观和基调从其默认值改变了,则在开始使用ui设计器之前,在jbuilder 内让ui 设计器使用 metal look & feel(金属外观和基调),也可以使用其它外观和基调,但本例中选择金属外观和基调,这时一种适合于跨平台设计的选择。
运行时的外观和基调
在设计器的弹出菜单或jbuilder环境选项对话框中设置的外观和基调对运行时的用户界面(ui)没有任何影响。要强制一个运行时的外观和基调,必须在应用程序(本例即为texteditclass.java)的类的主方法(main())中设置。
作为默认,应用向导会在可运行类的main()方法中生成下列一行代码:
| uimanager.setlookandfeel(uimanager.getsystemlookandfeelclassname()); |
其含义是运行时的外观采用主机系统使用的外观。
若是想要cde/motif 或 windows 式的外观则参数应改变为:
| uimanager.setlookandfeel ("com.sun.java.swing.plaf.motif.motiflookandfeel"); 或 uimanager.setlookandfeel ("com.sun.java.swing.plaf.windows.windowslookandfeel"); |
2) 窗口的定义
| dimension screensize = toolkit.getdefaulttoolkit().getscreensize(); dimension framesize = frame.getsize(); if (framesize.height > screensize.height) { framesize.height = screensize.height; } if (framesize.width > screensize.width) { framesize.width = screensize.width; } frame.setlocation((screensize.width - framesize.width) / 2, (screensize.height - framesize.height) / 2); frame.setvisible(true); |
3、texteditframe_aboutbox.java的源程序代码:
| package texteditor; import java.awt.*; import java.awt.event.*; import javax.swing.*; import javax.swing.border.*; /** * <p>title: texteditor</p> * <p>description: this is a study programme</p> * <p>copyright: copyright (c) 2004</p> * <p>company: ghq</p> * @author ghq * @version 1.0 */ public class texteditframe_aboutbox extends jdialog implements actionlistener { jpanel panel1 = new jpanel(); jpanel panel2 = new jpanel(); jpanel insetspanel1 = new jpanel(); jpanel insetspanel2 = new jpanel(); jpanel insetspanel3 = new jpanel(); jbutton button1 = new jbutton(); jlabel imagecontrol1 = new jlabel(); imageicon imageicon; jlabel label1 = new jlabel(); jlabel label2 = new jlabel(); jlabel label3 = new jlabel(); jlabel label4 = new jlabel(); borderlayout borderlayout1 = new borderlayout(); borderlayout borderlayout2 = new borderlayout(); flowlayout flowlayout1 = new flowlayout(); flowlayout flowlayout2 = new flowlayout(); gridlayout gridlayout1 = new gridlayout(); string product = "texteditor"; string version = "1.0"; string copyright = "copyright (c) 2002"; string comments = "this is a study programme"; //construct the frame public texteditframe_aboutbox(frame parent) { super(parent); enableevents(awtevent.window_event_mask); try { jbinit(); } catch(exception e) { e.printstacktrace(); } pack(); } //component initialization private void jbinit() throws exception { //imagelabel.seticon(new imageicon(texteditframe_aboutbox.class.getresource("[your image]"))); this.settitle("about"); setresizable(false); panel1.setlayout(borderlayout1); panel2.setlayout(borderlayout2); insetspanel1.setlayout(flowlayout1); insetspanel2.setlayout(flowlayout1); insetspanel2.setborder(new emptyborder(10, 10, 10, 10)); gridlayout1.setrows(4); gridlayout1.setcolumns(1); label1.settext(product); label2.settext(version); label3.settext(copyright); label4.settext(comments); insetspanel3.setlayout(gridlayout1); insetspanel3.setborder(new emptyborder(10, 60, 10, 10)); button1.settext("ok"); button1.addactionlistener(this); insetspanel2.add(imagecontrol1, null); panel2.add(insetspanel2, borderlayout.west); this.getcontentpane().add(panel1, null); insetspanel3.add(label1, null); insetspanel3.add(label2, null); insetspanel3.add(label3, null); insetspanel3.add(label4, null); panel2.add(insetspanel3, borderlayout.center); insetspanel1.add(button1, null); panel1.add(insetspanel1, borderlayout.south); panel1.add(panel2, borderlayout.north); } //overridden so we can exit when windows is cancel protected void processwindowevent(windowevent e) { if (e.getid() == windowevent.window_closing) { cancel(); } super.processwindowevent(e); } void cancel() { dispose(); } // help|about de button is used action performed public void actionperformed(actionevent e) { if (e.getsource() == button1) { cancel(); } } } |
说明:上面的这段程序主要是构建help菜单的aboutbox 对话框,显示product、version 和comments 等内容。
至此我们已完成文本编辑器所有的菜单及代码设计等工作,在 jbuilder9 环境下编译运行会出现如下的text editor窗口:
首先将text editor应用程序装配成一个jar文件。既然已经创建了"text editor" 应用程序,用户就可以使用jbuilder9的archive builder(档案构筑器)将全部文件装配成一个java archive file(jar,java归档文件)。
在从命令行运行应用程序之前,用户必须确保操作系统的path环境变量指向jdk jre/bin/目录,即java的运行环境。jbuilder9安装过程保证了jbuilder9 知道到那里找到jdk 类文件。但是若离开了jbuilder9环境,系统需要知道运行java时,类文件被安装到了什么位置。如何设置path环境变量视用户所用操作系统而定。要从命令行运行 text edit程序,步骤如下:
①切换到命令行窗口,将路径改变到jar文件所在的texteditor 目录。
② 在命令行输入java看看java是否在当前路径中,若在就会显示java的使用和选项,若不在,就将path环境变量设到jdk的jre/bin/文件夹。对于windows xp和nt/2000/2003系统,设置路径如下:
set path=<e:>/<jbuilder9>/<jdk>/jre/bin
这里:
<e:> 是驱动器;
<jbuilder9>是 jbuilder9目录名;
<jdk>是jbuilder安装时提供的jdk 目录名,例如:jbuilder9/jdk1.4/
③ 在命令行输入下列命令:
| java -jar texteditor.jar |
这里:
java ---- 运行java文件的java工具。
jar ---- 该选项告诉 java vm (java虚拟机)这是一个打包文件。
texteditor.jar ---- 包文件的名字。
由于清单文件在main-class头中提供了运行那个类,所以在命令行末尾无需指定类名,并且由于所有的类、资源、和独立件都被包含到了装配成包的jar文件中,所以也不需要指定类路径classpath或将jbuilder的库文件复制到当前目录。
注:一旦使用了-jar选项,java运行时就会忽略任何显式给出的classpath设置。
如果我们不是在 texteditor 目录下运行这个jar文件,则应使用下列java命令:
| java -jar -classpath <full_path> <main_class_name> |
java运行时在jar文件中寻找启动类和应用程序使用的其它类,java vm虚拟机使用三个搜寻路径查找文件,它们是:引导类路径、安装时扩展路径和用户类路径。
闽公网安备 35060202000074号