ARTICLE DETAIL

资讯详情

深耕网站建设、视觉设计与SEO优化的一线实战洞察。

Java SWT 桌面开发阶段练习:从空窗口到联系人管理器

Java SWT 桌面开发阶段练习:从空窗口到联系人管理器

带过几轮刚学完 Java 基础的新人之后,我发现一个挺有意思的现象:语法题刷得再溜,一到"写个能双击打开的窗口程序"就集体卡壳。大家第一反应是 Swing,教材上都是它;第二反应是 JavaFX,一看打包配置就劝退。中间其实还有一条路——SWT 框架,它不自己画控件,而是直接调用操作系统的原生控件,做出来的界面跟系统里的记事本、资源管理器是一个"长相",启动快、内存也不难看。这篇阶段练习的复盘,就是围绕 SWT 展开的:从一个空白窗口开始,一步步做出一个有列表、有搜索、有表单校验、有文件导入导出的小工具,把控件、布局、事件、资源释放、线程这几块硬骨头啃一遍。适合刚学完 Java SE、想碰一碰桌面开发的初学者,也适合从 Swing 转过来、被 SWT 的dispose()和线程访问搞懵过一次的人。我会把每一步"为什么这么设计"讲清楚,参数怎么算、坑长什么样,都按我实际踩过的写下来。

1. 阶段练习练什么:先把目标拆成能验收的清单

1.1 为什么这个阶段练习选 SWT 而不是别的

选型这件事我一般先问三个问题:跑得快不快、学到的知识能不能迁移、出错的时候能不能定位。SWT 在这三点上对初学者比较友好。它是 JNI 调用本地控件,界面渲染交给操作系统,Java 层只负责组织逻辑,所以窗口拖动的跟手程度和系统原生程序没差别;控件模型非常"规矩",每个控件都是父子树的节点,父容器释放时子节点跟着走,这种树形思维学一次能用很久;出错信息也相对直白,Widget is disposed、Invalid thread access这类提示虽然吓人,但对应的原因基本是唯一的。

更重要的是,SWT 强制你面对两个真实工程问题:资源必须手动释放、UI 只能在一个线程里更新。Swing 里 garbage collector 帮你兜底的东西,SWT 全要你自己管。初学者第一次被这两个问题咬到,后面写任何 GUI 代码都会长记性。这也是我把 SWT 放在"阶段练习"位置的原因——它不教你花哨的动画,但教你把一个界面程序的骨架搭正。

另外提一句 JFace。JFace 是架在 SWT 上面的一层封装,主要解决表格、树、列表的数据绑定问题,TableViewer就是它的东西。练习阶段我建议先用裸Table手动填数据,把增删改查的逻辑写明白,等你嫌麻烦了,再上TableViewer,这时候你才知道它帮你省了多少事。反过来先用 JFace,你会觉得它在变魔术,出问题就抓瞎。

1.2 练习项目的功能边界与验收标准

标题写的是"阶段练习",那就必须有个能验收的成品,否则写到一半就没劲了。我给自己定的题目是一个本地联系人管理器:左边是分组列表,中间是联系人表格,右边是编辑表单,顶部有搜索框,底部是状态栏。功能不多,但每一个都能对应到一块知识点。

功能点考察的核心能力验收标准
主窗口分栏显示SashForm、CTabFolder、混合布局拖动分隔条时两侧控件自适应,不出现遮挡
表格展示联系人Table / TableColumn、表头与列宽列宽合理,选中行能拿到完整数据
顶部实时搜索ModifyListener、数据过滤、刷新策略输入一个字符结果即时变化,无卡顿
右侧表单录入Text、Combo、Button 组合、布局对齐标签与输入框基线对齐,窗口拉大不走形
输入合法性校验VerifyListener、焦点事件电话号码只允许数字,非法字符打不进去
保存与导入导出FileDialog、Properties 或简单文本格式用户取消对话框时不抛异常
关闭窗口清理DisposeListener、资源枚举反复开关 50 次内存不持续增长

把验收标准写出来这一步别省。我见过太多人做到一半开始加功能,加着加着自己都不知道要做什么了。清单定死之后,做不下去了回头看清单,缺哪块补哪块。

另外提一个"阶段性"的做法:先做出能跑通主流程的版本(能增删改查、能保存),再回头补细节(校验、快捷键、图标、状态栏提示)。一上来就纠结图标尺寸和字体,很容易在第一天就放弃。

2. 环境搭建与工程骨架:先把"跑不起来"这件事解决

2.1 依赖引入与平台包的选择逻辑

SWT 和普通 jar 最大的区别是:它不是跨平台的单一包。因为它调用本地库,所以每个操作系统、每种 CPU 架构都对应一个独立的构件,里面带着对应的本地动态库文件。你在 Windows 上引入的包,拷到别的机器上跑不了。这就解释了为什么很多人第一次 importorg.eclipse.swt.widgets.Shell就报红——依赖没选对平台。

用 Maven 的话,坐标大致是这样的(版本号去仓库里挑一个和你 JDK 匹配的即可):

<dependency> <groupId>org.eclipse.platform</groupId> <artifactId>org.eclipse.swt.win32.win32.x86_64</artifactId> <version>3.124.0</version> </dependency> <!-- 需要 TableViewer 的话再补这一层 --> <dependency> <groupId>org.eclipse.platform</groupId> <artifactId>org.eclipse.jface</artifactId> <version>3.30.0</version> </dependency>

这里的win32.win32.x86_64拆开看是"窗口系统-操作系统-架构",换平台就整段换掉。JDK 版本也要一起看:SWT 的 3.12x 系列基本要求 JDK 11 起步,如果你还在用 JDK 8,那就得往回找老版本,不然会在启动时抛UnsupportedClassVersionError。这个错和 SWT 本身没关系,纯粹是字节码版本对不上,别往框架上赖。

非 Maven 的同学,直接下那个平台的 jar 丢进 classpath 也行,但要记得里面带的.dll(或.so、.dylib)文件必须能被 JVM 加载到。常见的UnsatisfiedLinkError: no swt-win32-xxxx in java.library.path就是这一环断了——要么 jar 下错了平台,要么你把 jar 解压后只拷了 class 没拷本地库。我的建议是老老实实用构建工具,它能帮你把这一步做对。

2.2 最小可运行骨架:Display 与 Shell 到底是什么关系

所有 SWT 程序都长一个样,先把这段代码背下来,比什么都管用:

import org.eclipse.swt.widgets.Display; import org.eclipse.swt.widgets.Shell; import org.eclipse.swt.layout.FillLayout; public class App { public static void main(String[] args) { // Display 是"和操作系统打交道的那一层",一个线程只能有一个 Display display = new Display(); // Shell 是窗口,必须有 Display 才能创建 Shell shell = new Shell(display); shell.setText("联系人管理器 - 阶段练习"); shell.setSize(900, 600); shell.setLayout(new FillLayout()); shell.open(); // 事件循环:没有这段,窗口一闪就没了 while (!shell.isDisposed()) { if (!display.readAndDispatch()) { display.sleep(); } } display.dispose(); } }

理解这段代码的关键是把Display当成"一个前台接待员"。它负责从操作系统那里取事件(鼠标点击、键盘输入、窗口重绘),readAndDispatch()就是"看看有没有新事件,有就派发下去",没有就sleep()让线程挂起,别空转烧 CPU。while (!shell.isDisposed())保证窗口关掉之后循环能退出。

初学者最容易犯的错是:写完shell.open()就以为完事了,程序直接main返回,窗口闪一下就消失。也有人在循环里写成display.readAndDispatch();而不判断返回值,结果就是 CPU 单核跑满、风扇狂转。这两个坑我都亲手挖过。

还有一个小知识点:Display的创建线程就是 UI 线程。SWT 不像 Swing 有明确的 EDT 说法,但规则一样——控件只能在创建它的那个线程里操作。这条规则后面第 5 节会专门讲。

2.3 工程目录与资源管理的前置约定

骨架跑通之后,先别急着堆控件,花十分钟把目录和人约定好,后面能省很多事。我的习惯是这样:

src/main/java └─ app ├─ App.java 启动与事件循环 ├─ ui/ 界面组装,一个类负责一块 │ ├─ MainWindow.java │ └─ EditorPanel.java ├─ model/ 纯数据对象,不 import 任何 swt 包 ├─ store/ 读写文件 └─ util/ 常量、格式化、校验 src/main/resources └─ icons/ 图标按 DPI 分目录

这里有一条硬规矩:model包里不许出现import org.eclipse.swt。听起来有点教条,但好处很实在——数据层能单独写单元测试,将来真要换 UI 框架,数据逻辑一行不动。我见过把TableItem直接当数据模型用的写法,结果想加个排序功能,发现数据全靠界面控件撑着,只能推倒重来。

资源目录也一样,图标、字体文件、初始数据模板都放在resources下,代码里通过getClass().getResourceAsStream()读。别用相对路径new File("icons/add.png"),在 IDE 里跑得好好的,打成 jar 就找不到文件了,这个坑几乎人人踩一次。

3. 界面布局:SWT 里最容易翻车的一环

3.1 五种布局管理器的取舍与适用场景

SWT 不自带"绝对坐标 + 自适应"那一套,控件的摆放完全交给布局管理器。刚上手的人常常直接setBounds()硬编码坐标,窗口一拉大就全乱。所以布局是必须过的坎。常用的就五个,我把它们的脾气整理成一张表:

布局类分配逻辑适合什么典型翻车点
FillLayout所有子控件等分剩余空间单控件填满、标签页内容放两个以上控件时大小完全一样,没法调
RowLayout横向或纵向依次排列,可设间距一行按钮、一列输入项不给 RowData 宽度时,输入框被压成一条缝
GridLayout网格,按列对齐,支持跨列表单、复杂面板(首选)忘了设grabExcessHorizontalSpace,拉大窗口控件不长
FormLayout相对定位,支持百分比需要精细对齐的少量控件附件关系写错会互相挤没
StackLayout多个控件叠放,同时只显示一个同一区域的页面切换忘了设topControl,什么都看不见

选择顺序我的经验是:能 GridLayout 就 GridLayout。它虽然参数多,但行为最好预测,出问题也能一眼看出是列数不对还是 grab 没设。FormLayout 适合做"标签贴左上、按钮贴右下"这种少数场景,控件一多附件关系会变成一团乱麻。FillLayout 我只在两种情况下用:单个控件铺满,或者放了SashForm、CTabFolder这种自带分配逻辑的容器。

StackLayout是个例外,它在练习项目里很有用——右侧编辑区可以准备"空状态页"和"表单页"两个面板,选中表格行就切到表单页,取消选中就切回空状态页。切换只要一行stack.topControl = formPage; parent.layout();。注意改完topControl必须再调一次父容器的layout(),不然界面不会重绘,这个点特别容易忘。

3.2 GridLayout 的列宽与 grab 规则,参数怎么算

GridLayout的核心就两个数字:列数、是否等宽。new GridLayout(2, false)表示两列、各列宽度由内容决定。列宽的计算规则是:每一列取该列中最宽子控件的宽度,所以第一列放标签、第二列放输入框,天然就是对齐的。窗口变宽时,多出来的空间分给谁?分给GridData里grabExcessHorizontalSpace = true的那些控件。这是整个 SWT 布局里最需要记牢的一句话。

看一段实操代码:

Composite form = new Composite(parent, SWT.NONE); form.setLayout(new GridLayout(2, false)); Label lblName = new Label(form, SWT.NONE); lblName.setText("姓名:"); lblName.setLayoutData(new GridData(SWT.RIGHT, SWT.CENTER, false, false)); Text txtName = new Text(form, SWT.BORDER); GridData gdName = new GridData(SWT.FILL, SWT.CENTER, true, false); gdName.widthHint = 180; // 最小可视宽度,防止被压没 gdName.minimumWidth = 120; // 窗口缩小时的兜底 txtName.setLayoutData(gdName);

GridData的构造函数四个参数依次是:水平对齐、垂直对齐、是否抢占水平剩余空间、是否抢占垂直剩余空间。第三位写true的那个控件,就是窗口拉伸时的赢家。如果把注释框也设成true,两个控件会平分多出来的空间——有时候你想要这个效果,有时候不想要,得想清楚。

还有两个经常用的字段:horizontalSpan用于跨列,比如一段长备注要横跨标签列和输入列,就设成2;verticalAlignment建议统一写SWT.CENTER,让标签和输入框在垂直方向居中对齐,视觉上才不会一高一低。我看到有人用SWT.BEGINNING,单行输入框还行,一旦旁边是带边框的多行文本,标签就会往上顶,看着别扭。

3.3 混合布局实战:SashForm 加 CTabFolder 拆主界面

真实界面很少只用一种布局,混合使用是常态。我的主窗口结构是这样的:最外层FillLayout,放一个SashForm(可拖动的分隔容器),左侧放分组列表,右侧放一个CTabFolder,两个标签页分别是"表格视图"和"详情视图"。这样拆的好处是每个区域职责单一,改一处不影响别处。

import org.eclipse.swt.custom.SashForm; import org.eclipse.swt.custom.CTabFolder; import org.eclipse.swt.custom.CTabItem; SashForm sash = new SashForm(shell, SWT.HORIZONTAL); sash.setLayout(new FillLayout()); // SashForm 内部也要有布局 List lstGroup = new List(sash, SWT.BORDER | SWT.SINGLE); CTabFolder folder = new CTabFolder(sash, SWT.BORDER); folder.setSimple(false); // false 才有圆角标签效果 CTabItem tabTable = new CTabItem(folder, SWT.NONE); tabTable.setText("列表"); CTabItem tabDetail = new CTabItem(folder, SWT.NONE); tabDetail.setText("详情"); // 分栏比例:左侧 1 份、右侧 4 份 sash.setWeights(new int[]{1, 4});

SashForm有一个小脾气:它的子控件不能直接设GridData,因为它的布局必须是FillLayout或者RowLayout。如果你在SashForm里塞了一个Composite,那这个Composite内部再自己设GridLayout,这是正确姿势。反过来把GridData用在SashForm的直接子控件上,会静默失效,控件大小莫名其妙,我第一次遇到排查了半小时。

setWeights要在所有子控件加完之后再调,中途调用会被后续的添加操作覆盖。另外CTabFolder和TabFolder的区别值得知道:TabFolder是系统原生标签页,长得朴素;CTabFolder是自定义绘制的,支持关闭按钮、渐进色、圆角,做工具类软件一般选后者。两者用法几乎一样,但CTabFolder属于custom包,别 import 错了。

4. 控件与事件:把"能点"变成"能用"

4.1 常用控件速查与风格常量的组合套路

SWT 控件的构造函数第二个参数是风格常量,用按位或组合。这套设计有点老派,但表达力很强,很多行为一个常量就搞定了。常用的组合我列一下,基本覆盖日常需求的八成:

控件常用风格组合效果说明
TextSWT.BORDER单行带边框输入框
TextSWT.BORDER | SWT.MULTI | SWT.WRAP | SWT.V_SCROLL自动换行的多行文本域
TextSWT.BORDER | SWT.READ_ONLY只读展示,仍可复制
ButtonSWT.PUSH普通按钮
ButtonSWT.CHECK复选框
ButtonSWT.RADIO单选,同一父容器内互斥
ButtonSWT.TOGGLE可切换状态的按钮
TableSWT.BORDER | SWT.FULL_SELECTION | SWT.MULTI整行选中,支持多选
ComboSWT.DROP_DOWN | SWT.READ_ONLY只读下拉框,防止用户乱输

有两个地方新手特别容易漏。第一,Table想要显示表头,必须显式table.setHeaderVisible(true),光加TableColumn是看不见的;想要网格线,还得setLinesVisible(true)。第二,Combo不加SWT.READ_ONLY,用户就可以往里面敲任意文本,如果你的后续逻辑默认它一定是预设值之一,就会拿到意外数据。这个坑我在做分组下拉框时踩过,用户输入了一个不存在的分组名,保存时直接报空指针。

Button的单选组还有个细节:互斥范围是同一个父容器。也就是说你把两组单选按钮放在同一个Composite里,它们会串成一组。正确做法是每组单选各给一个子Composite。

4.2 事件监听模型:为什么 SWT 用监听器而不是回调赋值

SWT 的事件模型是"控件 + 监听器 + 事件对象",比如button.addSelectionListener(new SelectionAdapter(){...})。有人会问为什么不像某些框架那样直接button.onClick = ...。原因在于一个控件往往需要多个监听:一个输入框可能同时要ModifyListener(内容变了)、VerifyListener(输入前拦截)、FocusListener(焦点进出)、TraverseListener(Tab 键行为)。用监听器列表的方式,谁都能加,互不覆盖。

SelectionAdapter和SelectionListener的关系也值得说一句。接口里有两个方法widgetSelected和widgetDefaultSelected,前者是"点了/选中了",后者是"双击了/回车了"。用SelectionAdapter只覆写你关心的那个,代码干净。但要注意:按钮的默认行为是靠widgetSelected触发的,如果你不小心覆写错了方法,按钮看着能点但没反应,排查起来还挺费劲。

事件对象里带了很有用的信息。SelectionEvent有widget、item(列表或表格里具体哪一项)、detail(比如勾选框的选中状态)。写表格双击编辑功能时,e.item就是被双击的那一行,取数据比自己去查选中索引靠谱得多。

4.3 输入校验:VerifyListener 与 ModifyListener 的分工

校验是练习项目里最值得花时间的一块,也是最容易做错的地方。VerifyListener触发在文本真正写入之前,可以修改或否决;ModifyListener触发在写入之后,用来做事后反应(比如实时过滤)。两者职责完全不同,别混用。

电话号码只允许数字,正确写法是:

Text txtPhone = new Text(form, SWT.BORDER); txtPhone.addVerifyListener(e -> { // e.text 是即将插入的内容,粘贴也会走这里 if (!e.text.matches("[0-9]*")) { e.doit = false; // 否决这次修改 } });

这里e.text的关键作用是粘贴也能拦住。很多人只在KeyListener里判断按键是不是数字,结果用户一个 Ctrl+V 就绕过校验了,这个漏洞太常见。用VerifyListener从数据入口拦截,才是从根上解决。

但有一点要注意:VerifyListener里不要弹MessageBox。它可能在用户每敲一个字符时触发一次,弹框会疯狂闪,而且模态框会干扰输入法状态。想给提示就改旁边的Label文字,或者把输入框边框颜色变一下。

ModifyListener的典型用途是实时搜索。做法是在监听器里取当前文本,过滤数据列表,然后刷新表格。这里有个性能问题:如果数据量大,每敲一个字符就重建一次表格项会明显卡顿。我的处理是加一个Display.getCurrent().timerExec(200, ...)做防抖,200 毫秒内连续输入只触发最后一次。这个技巧在 SWT 里很实用,timerExec是 UI 线程上的定时器,不用担心线程问题。

private Runnable pendingFilter; txtSearch.addModifyListener(e -> { String kw = txtSearch.getText().trim(); if (pendingFilter != null) { display.timerExec(-1, pendingFilter); // 取消上一次待执行 } pendingFilter = () -> refreshTable(filterByKeyword(kw)); display.timerExec(200, pendingFilter); });

timerExec(-1, runnable)是取消任务的写法,参数传负的毫秒数。这段代码第一次看我以为是黑魔法,其实就是一个很朴素的防抖。

4.4 表格:裸 Table 与 TableViewer 的取舍判断

练习阶段我建议先用裸Table,理由前面说过——把增删改查写透。裸Table的操作流程是:先建列,再建TableItem,每行一个 item,item.setText(int index, String value)填值。刷新时最直接的做法是table.removeAll()再全量重建。数据量几十上百条完全没问题,超过几千条才会卡。

Table table = new Table(tabTable.getParent(), SWT.BORDER | SWT.FULL_SELECTION | SWT.MULTI); table.setHeaderVisible(true); table.setLinesVisible(true); String[] heads = {"姓名", "电话", "分组", "备注"}; int[] widths = {120, 140, 100, 260}; for (int i = 0; i < heads.length; i++) { TableColumn col = new TableColumn(table, SWT.LEFT); col.setText(heads[i]); col.setWidth(widths[i]); }

列宽这块有个小设计:初始宽度我是拍脑袋给的,但要在窗口拉伸时保持合理,就得在 resize 事件里重新分配。做法是监听父容器的ControlListener,把最后一列宽度设为"总宽减去前面各列之和",让表格始终填满。这比给每列都设死宽度好看得多。

TableViewer的优势是数据绑定,setInput(list)之后表格自己重建,配合ITableLabelProvider决定每列显示什么字段。好处是数据和界面解耦,坏处是多了一层概念要学。我的建议是:等你在Table里写得手指疼,并且开始为"排序后怎么保持选中项"这种问题发愁时,再切过去,那时候你会觉得它真香。

5. 资源释放与线程模型:SWT 最容易埋雷的两件事

5.1 谁创建谁释放:Color、Font、Image 的生命周期

这是 SWT 和 Java 世界其他地方最不一样的地方。Color、Font、Image、Cursor、GC这些持有本地资源的对象,GC 管不了,必须显式dispose()。不释放的后果是本地资源句柄持续增长,跑一阵子就会抛SWTError: No more handles,然后整个程序崩掉。

规矩很简单:谁 new 的谁负责 dispose,且在创建它的父容器被销毁之前释放。跟着控件走的一般挂在DisposeListener上:

final Color warnColor = new Color(display, 0xC0, 0x39, 0x2B); Label lblTip = new Label(form, SWT.NONE); lblTip.setForeground(warnColor); lblTip.addDisposeListener(e -> { if (warnColor != null && !warnColor.isDisposed()) { warnColor.dispose(); } });

isDisposed()这个判断别嫌啰嗦。窗口可能被重复关闭,或者你在别处也调了dispose(),重复释放会抛异常。加上判断就稳了。

有一个特别容易犯的错误是在循环里创建 Color。比如按分组给表格行上色,如果每行都new Color(...),一百行就是一百个句柄。正确做法是把颜色集中创建在一处,做成一个ResourceRegistry或者干脆用常量池:

// 全局只创建一次,窗口关闭时统一释放 private final Map<String, Color> colorCache = new HashMap<>(); private Color colorOf(Display display, String key, int r, int g, int b) { return colorCache.computeIfAbsent(key, k -> new Color(display, r, g, b)); } // 统一释放 shell.addDisposeListener(e -> colorCache.values().forEach(c -> { if (!c.isDisposed()) c.dispose(); }) );

这套写法我在每个稍大的 SWT 项目里都放一份,几乎没有例外。

5.2 UI 线程与后台任务:asyncExec 和 syncExec 怎么选

前面提过,控件只能在 UI 线程操作。那么问题来了:读一个大文件、做一次网络请求(当然练习项目里没有),耗时操作放 UI 线程里,界面就卡住不重绘,用户以为程序死了。解决办法是开个普通线程干活,干完回到 UI 线程更新界面。

SWT 提供了两个入口:

方法行为使用场景
display.asyncExec(Runnable)把任务排到 UI 线程队列,立即返回后台任务完成后刷新界面(最常见)
display.syncExec(Runnable)阻塞当前线程,等 UI 线程执行完后台线程需要立即拿到界面数据
display.timerExec(ms, Runnable)延迟执行,可取消防抖、延时刷新

具体到代码:

new Thread(() -> { List<Contact> loaded = store.loadAll(); // 耗时操作,不碰界面 if (display.isDisposed()) return; // 用户可能已经关窗了 display.asyncExec(() -> { if (table.isDisposed()) return; fillTable(loaded); statusLabel.setText("已加载 " + loaded.size() + " 条"); }); }, "loader").start();

这段代码里两个判空非常关键。第一个display.isDisposed()防的是"窗口全关了、事件循环退出、Display 被释放"之后再往队列里塞任务;第二个table.isDisposed()防的是"任务排进去了,但执行前控件被销毁"。这两个判断漏掉任意一个,都可能抛Widget is disposed,而这个异常在用户机器上是随机出现的,极难复现。

syncExec要慎用。它会让调用线程一直等,如果 UI 线程恰好也在等这个后台线程(比如用了join()),就死锁了。我的原则是:默认用 asyncExec,除非确有必要拿返回值。

5.3 关窗时的收尾顺序与"假死"排查

关窗顺序这件事没什么技术含量,但顺序错了会有麻烦。我的做法是监听shell的ShellEvent,先拦截关闭请求,做收尾,再决定要不要真关:

shell.addShellListener(new ShellAdapter() { @Override public void shellClosed(ShellEvent e) { if (dirty && !confirmSave()) { e.doit = false; // 用户点"取消",阻止关闭 } } });

e.doit = false就是取消关闭的开关,用来做"有未保存修改,是否确认退出"的提示。这里用MessageBox弹确认框,返回值判断SWT.YES还是SWT.NO。

至于"关窗后进程还在"的问题,八成是还有非守护线程活着(比如你自己开的后台线程没结束),或者事件循环没退出。排查方法很简单:在main末尾加一句打印,看看窗口消失后有没有输出。如果没有,说明卡在循环里了——通常是某个Shell没有真正dispose(),或者是还有别的窗口没关。

6. 数据落地与文件交互:让练习项目像个真工具

6.1 存储格式选型:别在这个阶段引入复杂度

数据怎么存,直接影响后面能走多远。练习项目里我选的是TSV(制表符分隔)纯文本,理由很实在:肉眼可读、出问题能直接打开看、不依赖任何第三方库、几十行代码就能读写完。JSON 更好看,但要引依赖;序列化最省事,但版本一改就全废,而且调试时看到一堆乱码,出问题完全没法排查。

写文件的时候有两个细节要处理。第一,字段里可能出现制表符或换行,必须先转义再拼:

private String escape(String s) { if (s == null) return ""; return s.replace("\\", "\\\\") .replace("\t", "\\t") .replace("\n", "\\n"); }

第二,写文件要先写临时文件再原子替换,不然写到一半程序崩了,原数据就没了。做法是写data.tsv.tmp,写完Files.move(tmp, target, REPLACE_EXISTING, ATOMIC_MOVE)。这两步加起来不到十行代码,但能救你一次。

文件路径别写死在代码里,用System.getProperty("user.home")拼一个应用目录,不存在就mkdirs()。我习惯放在user.home/.practice/contacts.tsv这样的位置,卸载时用户自己删目录就行,不污染系统目录。

6.2 FileDialog 的使用与"用户取消"这个必答题

导入导出需要文件选择框,SWT 提供FileDialog和DirectoryDialog。用法很直接:

FileDialog dialog = new FileDialog(shell, SWT.SAVE); dialog.setText("导出联系人"); dialog.setFilterNames(new String[]{"制表符文本", "所有文件"}); dialog.setFilterExtensions(new String[]{"*.tsv", "*.*"}); dialog.setFileName("contacts.tsv"); String path = dialog.open(); if (path == null) { return; // 用户点了取消,这是最常见的情况 }

dialog.open()返回null表示用户取消,必须判空。这是新手第一个坑,不判的话紧接着new File(path)就空指针了。第二个坑是覆盖确认:SWT.SAVE模式下,选了一个已存在的文件时,对话框会自己弹"是否覆盖",不需要你手动做。

还有一个路径合法性问题。用户可能在一个只读目录里选保存位置,或者文件名里带了非法字符。我的做法是保存前先试探性try (OutputStream os = new FileOutputStream(file)) {},能打开就继续,打不开给个友好的MessageBox提示,比直接抛异常堆栈友好一万倍。

6.3 提示与反馈:MessageBox 的分级使用

MessageBox的图标常量基本对应日志级别,用对了用户能一眼看出严重程度:

图标常量使用场景按钮组合
SWT.ICON_INFORMATION保存成功、导入完成SWT.OK
SWT.ICON_WARNING数据不完整,是否继续SWT.YES | SWT.NO
SWT.ICON_ERROR文件读取失败、格式错误SWT.OK
SWT.ICON_QUESTION确认删除这类需要二次确认的操作SWT.YES | SWT.NO

有个细节:MessageBox是模态的,弹出期间主窗口不响应,所以绝对不能在循环里弹。比如批量导入时某几行格式错误,不要每错一行弹一次窗,用户得点一百次。正确做法是收集错误行号,最后一次性汇总提示:"共 12 行解析失败,第 3、7、15 行……"。

状态栏提示也要利用起来。我把窗口底部放一个Label,任何操作都在这里留一行字:"已保存到 xxx""共 23 条记录""已按关键词过滤,剩余 5 条"。这类即时反馈不打断操作,用户体验的差别其实很大。

7. 常见问题与排查技巧实录

7.1 报错速查表:把这几个症状背下来

SWT 的报错信息不算多,来来回回就那么几个。我整理了一份对照表,基本能覆盖练习阶段九成的问题:

现象 / 报错根本原因处理方式
No more handlesColor/Font/Image 没释放全局搜new Color、new Font,补 dispose
Invalid thread access在非 UI 线程操作控件用display.asyncExec包一层
Widget is disposed异步任务执行时控件已销毁执行前判isDisposed()
UnsatisfiedLinkError: no swt-...平台包选错或本地库没加载换成对应系统的构件
控件不显示 / 尺寸为 0父容器没设布局,或GridData没给补setLayout和setLayoutData
窗口拉伸控件不变grabExcessHorizontalSpace为 false把需要拉伸的控件设为 true
中文显示成方块字体名写错或用了不支持中文的字体换成系统自带的中文字体
界面发虚、字体模糊高 DPI 缩放与 SWT 版本不匹配更新 SWT 版本,或用启动参数调整缩放
UnsupportedClassVersionError依赖版本要求的 JDK 高于当前降依赖版本或升级 JDK
关闭窗口后进程不退出有非守护线程存活检查自建线程,必要时设setDaemon(true)

用这张表的时候有个思路:先看错误类型,再看触发时机。Widget is disposed一定是异步相关,Invalid thread access一定是线程相关,No more handles一定是资源相关。定位到类别,范围就缩小到十几行代码了。

7.2 高 DPI、字体与中文显示的实测经验

高 DPI 这块我踩过最久。现象是:在 125% 或 150% 缩放的屏幕上,界面整体放大但文字发虚,或者反过来控件被裁掉一块。原因在于 SWT 的自动缩放逻辑在不同版本里行为有差异,早期版本需要手动指定缩放比例。

现在新版 SWT 自带自动缩放,大部分情况下不用管。如果确实遇到问题,可以试试在启动参数里加-Dswt.autoScale=200之类,具体数值按你屏幕的实际缩放比例来。但这个参数不是万灵药,不同版本的实现不一样,一定要在你自己的机器上实测,别照抄别人的配置。

字体方面,中文界面我一般统一设一个系统自带字体,比如"微软雅黑 UI"或者"苹方",字号 9 到 10。设置方式是在Display上做全局覆盖:

Font baseFont = new Font(display, "Microsoft YaHei UI", 10, SWT.NORMAL); shell.setFont(baseFont); shell.addDisposeListener(e -> { if (!baseFont.isDisposed()) baseFont.dispose(); });

注意shell.setFont只对没有单独设字体的子控件生效,设过的会被覆盖。所以要么统一设、要么别设,混着来容易出现"这个按钮字大那个字小"的情况。

中文乱码的另一个来源是源码文件编码。如果代码文件存成了 GBK,编译器按 UTF-8 读,字符串常量里的中文就会变乱码,而且编译不报错,运行时才发现。检查方法很简单:看源文件里的中文在编辑器里显示是否正常,另外构建配置里加一句-encoding UTF-8。

7.3 我个人的几条避坑心得

第一条:每加一个面板就setBackground换个颜色跑一次。我用SWT.COLOR_WIDGET_LIGHT_SHADOW这类浅色给每个Composite上临时底色,一眼就能看出布局边界对不对、有没有被压成 0 宽。调完再删掉。这个土办法比任何布局调试工具都直观。

第二条:窗口最小尺寸一定要设。shell.setMinimumSize(800, 500)。不加的话用户把窗口拖到很窄,GridLayout会把输入框压到看不见,界面上只剩下一堆标签,看着像程序坏了。

第三条:写代码前先在纸上画控件树。SWT 的一切都是父子关系,Composite套Composite,每一层的布局各管各的。纸上画清楚哪层用什么布局,比在代码里反复试快得多。我现在的习惯是画一棵树,每个节点旁边标注布局类型和GridData的关键参数,照着敲几乎不用改。

第四条:数据结构先行。先把Contact类和存储层的读写跑通,用手写几条假数据打印出来验证,再去接界面。反过来先做界面后想数据,中间会有大量临时变量到处飞,后期一片混乱。

第五条:每次改完跑满 10 分钟。SWT 的资源泄漏和线程问题不会立刻暴露,往往要操作一段时间才崩。我的验收方式是:反复打开关闭窗口、反复导入导出几次、连续切换页面几十次,看内存曲线是否平稳。这个过程很枯燥,但比上线后被用户投诉强。

最后说个小技巧。调试界面时可以给Shell加一个全局快捷键,触发时把当前所有控件的边界框打印出来:

shell.getDisplay().addFilter(SWT.KeyDown, e -> { if (e.keyCode == SWT.F2) { dumpBounds(shell, 0); } }); private void dumpBounds(Control c, int depth) { System.out.println(" ".repeat(depth) + c.getClass().getSimpleName() + " " + c.getBounds()); if (c instanceof Composite comp) { for (Control child : comp.getChildren()) dumpBounds(child, depth + 1); } }

" ".repeat(depth)需要 JDK 11 以上,用不了就换StringUtils或自己写个循环。这个 dump 出来的树,基本等于把布局问题摆在解剖台上,哪里宽度是 0、哪里位置跑到负坐标,一目了然。我在做那个联系人管理器的表单对齐时,靠它省了大半天时间。

返回列表