简介SWTChart是一款基于SWT的Java图表类库面向需要在Eclipse RCP或SWT桌面应用中嵌入数据可视化的Java开发者尤其适合追求轻量、无需额外依赖的图表绘制场景。它支持线图、散点图、堆栈图、柱形图、面积图、步骤图、对数标度、分类轴、多轴、轴取向与系列标签等多种图表类型可满足常规统计与工程数据展示需求。资源包共36个文件约287KB以24个java源码文件为核心辅以2个jar包、2个project与classpath配置、2个html说明文档及gif、properties、mf、xml等辅助文件目录中同时包含插件工程与示例工程便于直接导入Eclipse运行调试。目前已有640人学习下载。通过阅读源码与示例读者可掌握SWTChart的图表构建流程、坐标轴与系列配置方式并借鉴其插件化目录组织快速将图表能力集成到自己的SWT项目中。1. 桌面端图表选型为什么我最终把 SWTChart 塞进了工具箱做 Java 桌面端的人大概都经历过这种尴尬界面用 SWT 搭得挺利索一到画图表就卡壳。Swing 那边有 JFreeChart 撑场子可 SWT 和 Swing 混用要么线程模型打架要么渲染风格割裂轻则界面闪烁重则直接抛异常。我早些年接手一个工业监控面板需求是实时折线加柱状对比试过把 JFreeChart 嵌进 SWT 的 Composite结果重绘频率一高就掉帧鼠标悬停提示还经常错位。后来翻到 SWTChart 这个纯 SWT 实现的图表类库才算把这块补上。它不依赖 Swing直接基于 SWT 的 GC 绘制坐标轴、系列、图例、工具提示都是原生控件风格跟 RCP 应用能无缝拼在一起。如果你也在用 SWT 做桌面工具、测试台软件或者设备上位机需要轻量、可嵌入、不引入额外 UI 框架的图表方案这个类库值得花半小时摸一遍。2. SWTChart 核心对象模型从 Chart 到 Series 的装配逻辑2.1 三个必须分清的层级Chart、Axis、SeriesSWTChart 的 API 设计比较直白但新手容易把 Axis 和 Series 的关系搞反。一个 Chart 实例是画布容器它内部默认带 X 轴和 Y 轴对象但轴本身不存数据只负责刻度范围、标签格式和网格线样式。真正承载数据点的是 Series每个 Series 持有一组 x/y 值并且必须绑定到某个轴。常见做法是先new Chart(parent, SWT.NONE)拿到画布再通过chart.getAxisSet().getXAxis(0)和getYAxis(0)拿到默认轴然后用chart.getSeriesSet().createSeries(SeriesType.LINE, 温度)创建系列。这里有个细节SeriesType 决定了渲染方式LINE、BAR、AREA、SCATTER 都支持但一个 Chart 里混用多种类型时轴的范围要手动算否则柱状图的基线可能被折线图的负值带偏。// 创建画布父容器通常是 SWT 的 Composite Chart chart new Chart(parent, SWT.NONE); // 拿到默认的 X 轴和 Y 轴索引 0 表示主坐标轴 IXAxis xAxis chart.getAxisSet().getXAxis(0); IYAxis yAxis chart.getAxisSet().getYAxis(0); // 创建折线系列名称会显示在图例里 ILineSeries lineSeries (ILineSeries) chart.getSeriesSet() .createSeries(SeriesType.LINE, 温度曲线); // 设置数据xSeries 和 ySeries 是 double[] 数组 lineSeries.setXSeries(xSeries); lineSeries.setYSeries(ySeries); // 让轴根据数据自动调整范围否则默认是 0 到 100 chart.getAxisSet().adjustRange();上面这段是标准起手式。adjustRange()很关键不调用的话轴范围固定数据超出就看不见。参数方面setXSeries和setYSeries接收 double 数组长度必须一致否则运行时会抛 IllegalArgumentException。如果数据是动态追加的别每次重建 Series用lineSeries.add(x, y)或者直接操作底层数组再调chart.update()前者适合低频更新后者适合批量刷新。2.2 样式与交互线宽、符号、工具提示的配置入口SWTChart 的样式配置分散在 Series 和 Axis 上没有统一的样式表。线宽用lineSeries.setLineWidth(2)颜色用setLineColor(display.getSystemColor(SWT.COLOR_BLUE))数据点符号通过setSymbolType(SymbolType.CIRCLE)开启符号大小用setSymbolSize(4)。工具提示需要显式启用lineSeries.setToolTipEnabled(true)然后实现ISeriesToolTip接口或者直接用默认的默认会显示系列名和当前点的 x/y 值。这里有个坑工具提示的格式化依赖setXAxisFormat和setYAxisFormat如果轴格式是整数而数据是浮点提示会四舍五入看起来像数据丢了精度。// 设置折线颜色和线宽 lineSeries.setLineColor(display.getSystemColor(SWT.COLOR_DARK_GREEN)); lineSeries.setLineWidth(2); // 开启数据点符号类型为圆形大小为 5 像素 lineSeries.setSymbolType(SymbolType.CIRCLE); lineSeries.setSymbolSize(5); // 启用工具提示鼠标悬停时显示数值 lineSeries.setToolTipEnabled(true); // 设置 Y 轴数字格式保留两位小数 yAxis.setNumberFormat(#.##);setNumberFormat用的是 DecimalFormat 模式#.##表示最多两位小数整数部分不补零。如果数据范围跨几个数量级建议用科学计数法模式0.00E0否则轴标签会挤成一团。另外display对象要从当前 Shell 获取别在非 UI 线程里调这些 setterSWT 的控件操作必须在 UI 线程执行否则抛 SWTException。3. 把数据画出来从静态数组到实时刷新的完整链路3.1 静态数据绑定一次填充与范围校准静态场景最简单准备两个 double 数组创建 Series塞进去调adjustRange()最后chart.update()触发重绘。但实际项目里数据往往来自 CSV 或数据库查询结果常见做法是先把结果集转成ListDouble再转 double 数组。注意空值和 NaN 的处理SWTChart 遇到 NaN 会直接跳过该点折线断开这有时是想要的效果有时不是。如果希望断点处连线得手动插值或者用Double.NaN之外的哨兵值。下面是一个从二维数组填充的示例顺便设置轴标题。// 假设 data 是 double[][]第一列是 x第二列是 y double[] xData new double[data.length]; double[] yData new double[data.length]; for (int i 0; i data.length; i) { xData[i] data[i][0]; yData[i] data[i][1]; } ILineSeries series (ILineSeries) chart.getSeriesSet() .createSeries(SeriesType.LINE, 采样值); series.setXSeries(xData); series.setYSeries(yData); // 设置轴标题显示在轴末端 chart.getAxisSet().getXAxis(0).getTitle().setText(时间 (s)); chart.getAxisSet().getYAxis(0).getTitle().setText(幅值 (mV)); // 根据数据自动调整轴范围 chart.getAxisSet().adjustRange(); chart.update();adjustRange()会遍历所有 Series 的 x/y 值算出最小最大值然后留一点边距。如果数据里有异常大值轴范围会被拉得很开正常数据挤在底部。这时候别用 adjustRange手动setRange(min, max)更稳妥。轴标题的字体和颜色可以通过getTitle().setForegroundColor()改但默认样式通常够用。3.2 实时刷新定时器、双缓冲与重绘频率控制实时图表是 SWTChart 的高频使用场景也是翻车重灾区。常见做法是用Display.timerExec(interval, runnable)或者Executors.newScheduledThreadPool配合Display.asyncExec往 UI 线程推更新。关键点是不要每次新数据都调chart.update()那样重绘太频繁CPU 直接飙满。我一般会攒一批点比如每 200ms 刷新一次或者数据量超过阈值时再刷。另外Series 的数据数组如果频繁扩容内存抖动明显建议用固定长度的环形缓冲区或者直接操作lineSeries.getXSeries()返回的数组引用改完值再调chart.update()。// 使用 Display.timerExec 实现定时刷新间隔 200ms display.timerExec(200, new Runnable() { Override public void run() { // 模拟从设备读取新数据 double newX System.currentTimeMillis() / 1000.0; double newY readSensorValue(); // 追加到 Series内部会扩容低频场景可接受 lineSeries.add(newX, newY); // 只保留最近 100 个点避免内存无限增长 if (lineSeries.getXSeries().length 100) { double[] xArr lineSeries.getXSeries(); double[] yArr lineSeries.getYSeries(); double[] newXArr new double[100]; double[] newYArr new double[100]; System.arraycopy(xArr, xArr.length - 100, newXArr, 0, 100); System.arraycopy(yArr, yArr.length - 100, newYArr, 0, 100); lineSeries.setXSeries(newXArr); lineSeries.setYSeries(newYArr); } // 重新校准轴范围并重绘 chart.getAxisSet().adjustRange(); chart.update(); // 继续下一次定时 display.timerExec(200, this); } });这段代码里lineSeries.add每次都会新建数组数据量大时 GC 压力不小。如果刷新频率高建议自己维护环形缓冲区直接改数组元素然后调chart.update()。adjustRange()在实时场景下也会遍历所有点数据多了是 O(n) 开销可以改成手动setRange只显示滑动窗口。另外display.timerExec必须在 UI 线程调用通常放在createContents或者按钮事件里。4. 避坑与排查SWTChart 落地时最容易踩的五条4.1 现象图表一片空白没有任何线条原因通常是 Series 没绑定到正确的轴或者轴范围是默认的 0 到 100 而数据在 1000 以上。还有一种可能是chart.update()没调SWTChart 不会自动重绘。解决先确认createSeries返回的 Series 非空再检查adjustRange()是否执行最后手动setRange到数据实际范围。如果用的是自定义轴确认 Series 通过setXAxis和setYAxis绑定了。4.2 现象鼠标悬停工具提示不显示或显示错位原因一般是setToolTipEnabled(true)没开或者 Series 的setXSeries和setYSeries长度不一致导致内部索引越界。错位则可能是轴格式和实际数据精度不匹配比如数据是 0.001 级别轴格式却是整数。解决开启工具提示后检查两个数组长度设置合适的setNumberFormat必要时自定义ISeriesToolTip实现。4.3 现象实时刷新时界面卡顿CPU 占用高原因是chart.update()调用过于频繁或者adjustRange()在每次刷新时遍历全量数据。解决降低刷新频率到 100ms 以上用滑动窗口限制数据点数量把adjustRange()换成手动setRange只在数据范围变化时调整。另外避免在非 UI 线程直接操作 Series用Display.asyncExec包一层。4.4 现象多条 Series 混用时柱状图被折线图压扁原因是所有 Series 共享同一个 Y 轴柱状图的值域和折线图差异大时轴范围被拉偏。解决SWTChart 支持多轴通过chart.getAxisSet().createYAxis()创建第二个 Y 轴然后把柱状图 Series 绑定到新轴并设置新轴的范围和颜色。注意多轴时图例会混在一起需要手动调整位置。4.5 现象导出图片时背景全黑或文字丢失原因是 SWTChart 的save方法依赖 GC 绘制如果直接调chart.save(test.png, SWT.IMAGE_PNG)在某些平台下背景透明处理有问题。解决先创建一个Image对象用GC画上去再保存。或者用chart.print(new GC(image))的方式确保背景色显式设置为白色。导出前调chart.update()保证渲染状态最新。5. 进阶技巧用 SWTChart 做可交互的实时频谱图频谱图对刷新率和数据量都敏感我一般会关掉符号和工具提示只保留折线线宽设为 1颜色用亮绿或青色。数据源用环形缓冲区每次刷新只更新数组末尾的 N 个点然后调chart.update()。轴范围固定为 0 到采样率的一半避免adjustRange的开销。如果要做瀑布图SWTChart 本身不支持但可以用多个 Chart 叠加或者换成 SWT 的 Canvas 自绘。验证方法很简单开一个Display.timerExec每 50ms 推一次随机数据观察任务管理器的 CPU 占用正常应该在 5% 以下。如果超过 20%检查是不是每次都在重建 Series 或者调了adjustRange。// 频谱图初始化固定轴范围关闭符号和提示 ILineSeries spectrumSeries (ILineSeries) chart.getSeriesSet() .createSeries(SeriesType.LINE, 频谱); spectrumSeries.setSymbolType(SymbolType.NONE); spectrumSeries.setToolTipEnabled(false); spectrumSeries.setLineWidth(1); spectrumSeries.setLineColor(display.getSystemColor(SWT.COLOR_GREEN)); // 固定 X 轴范围 0 到 20000 HzY 轴 0 到 100 dB chart.getAxisSet().getXAxis(0).setRange(0, 20000); chart.getAxisSet().getYAxis(0).setRange(0, 100); // 预分配数组避免每次刷新重建 double[] freqData new double[512]; double[] ampData new double[512]; spectrumSeries.setXSeries(freqData); spectrumSeries.setYSeries(ampData); // 定时刷新只改数组值不重建 Series display.timerExec(50, new Runnable() { Override public void run() { // 模拟填充新频谱数据 for (int i 0; i 512; i) { freqData[i] i * 40.0; ampData[i] 50 30 * Math.sin(i * 0.1 System.currentTimeMillis() / 1000.0); } // 直接更新 Series 数据引用触发重绘 spectrumSeries.setXSeries(freqData); spectrumSeries.setYSeries(ampData); chart.update(); display.timerExec(50, this); } });这段代码的关键是预分配数组每次只改值不新建对象。setXSeries和setYSeries会复制数组引用所以改原数组后需要重新 set 一次才能让 Series 感知到变化。如果嫌麻烦可以直接用spectrumSeries.getXSeries()拿到内部数组改但那样绕过了封装版本升级可能出问题。我一般还是老老实实 set 一遍性能差异在 512 点级别可以忽略。从那以后我每次接 SWT 桌面项目只要涉及图表都会先拿 SWTChart 搭个最小原型跑一遍实时刷新确认 CPU 和内存曲线平稳再往下做。希望帮到你。本文还有配套的精品资源点击获取