1. 为什么2025年还有人学Rational Rose这款老工具的核心价值先说说我自己碰到的场景。前阵子帮A同学调试一个老项目的设计文档他发过来一个 .mdl 后缀的文件我问他用什么工具打开他说老师让用Rational Rose 2017。我心里咯噔一下——这软件官方早就停止维护了但他所在的高校课程还在用而且用的是网上流传的汉化整合包。这事其实很普遍很多软件工程课程至今仍然把Rational Rose作为UML建模的标准教学工具考试、课程设计、毕业设计都用它来画用例图、类图、序列图。如果你恰好也遇到同样的情况这篇教程就是给你写的。Rational Rose是IBM出品的UML建模工具在2000年代是行业里的绝对主流后来官方停止了更新最后一版停留在7.0。市面上流传的Rational Rose 2017并不是IBM官方发布的版本而是国内的汉化整合包在安装后显示的属性名称——这个版本号更像一个汉化发布版的命名方式。它本质上是Rational Rose 7.0英文原版加上一个汉化补丁再打包成一个一键安装的ISO镜像。所以你在学习时遇到的一切问题本质上都是在跟一款2005年左右开发、但至今仍在教学中服役的老工具打交道。为什么要学一个老古董我的看法是Rational Rose的价值不在它的界面而在它把UML的规范落实得很扎实。它严格按照UML标准组织模型——用例视图、逻辑视图、组件视图、部署视图四个视图的划分清晰而且Rose模型是真正意义上的模型不是画出来的图片。你在类图里改一个类的属性序列图里的消息、代码生成的结果都会跟着变这是现代众多轻量级绘图工具做不到的。对初学者来说用Rose建模能帮助你建立模型驱动的思维方式而不是画完图就扔。这篇教程会从环境准备、模型新建、四大视图的使用、核心图形绘制到反向工程和代码生成以及我实际使用中踩过的坑完整走一遍。无论你是刚上软件工程课的学生还是需要维护老项目的开发者按着这个流程走至少能保证工具装得上、图画得出、文件存得下。2. Rational Rose 2017到底是什么版本代码与安装环境准备2.1 版本澄清不要被版本号误导先要说明一个容易混淆的地方。你在网盘或校园网资源站下载的Rational Rose 2017解压后通常会看到一个ISO镜像文件或者一个名为Rational Rose Enterprise Edition的安装目录。安装完成后你在帮助 → 关于里看到的版本信息大概率是Rational Rose 7.0而不是2017。为什么会有2017这种叫法我推测这个命名是汉化整合包的发布者为了表明我更新了兼容Windows 10的补丁而采用的版本标记。实际测试下来这个整合包确实内置了对Windows 10的兼容性调整包括JREJava运行环境的匹配和注册表项的预配置。所以如果你拿到的资源是Rational Rose 2017大概率等于Rational Rose 7.0 汉化包 Win10兼容补丁。这本身是好事省去了自己折腾兼容性的麻烦。但如果你的老师或同事让你下载Rational Rose 7.0你们用的其实是同一个东西。2.2 安装前的硬件与系统准备安装Rational Rose对硬件几乎没有要求但有几个软件层面的准备工作操作系统支持Windows 7、Windows 1032位或64位均可Windows 11实测也能装上但需要用兼容模式。内存与磁盘2GB以上内存安装后占用约1.5GB磁盘空间。杀毒软件安装前必须暂时关闭实时防护。Rational Rose的安装程序包含注册表写入和COM组件注册某些杀毒软件会拦截导致安装到最后一步报错Feature: Rose Database或Error 1904。不要安装到中文路径这是我在课程辅导中最常见的问题。默认安装路径是C:\Program Files\Rational\Rose请一定保持默认或使用纯英文路径。Rational Rose对中文路径支持得很差装到D:\软件\Rational启动时会直接报无法定位程序输入点或者加载模型失败。2.3 安装步骤与常见选项拿到ISO镜像后推荐用虚拟光驱加载或者直接解压后运行setup.exe。关键步骤如下选择Rational Rose Enterprise Edition不要选Rational Rose Professional或Rose RealTime课程设计里用的都是Enterprise版。安装类型选择自定义在组件列表中一定要勾选Rational Rose JJava反向工程组件。如果不勾选后面对Java代码做反向工程时会找不到菜单。在Rational Software Installer里选择Desktop installation from CD image即可。安装过程中可能会要求重启正常操作即可。安装完成后先不要急着打开。接着装汉化补丁。汉化补丁的安装方式有两种一种是运行Chinese.exe选择Rational Rose安装目录点击安装另一种是直接把汉化包里的lang文件夹覆盖到安装目录下的同名文件夹。实际效果上覆盖文件夹的方式更可靠因为它在替换语言文件的同时不会修改注册表。需要注意汉化完成后第一次启动时菜单栏可能显示为英文需要手动在View → Language里切换到Chinese。提示如果汉化后菜单变成一片乱码或方块不要卸载重装先退出程序找到安装目录下的lang\zh_CN文件夹检查里面是否只有一个RationalRose.dll文件。正常情况下应该还有几个.properties文件缺失的话从汉化包原目录补全即可。2.4 启动时的兼容性设置在Windows 10/11上启动Rational Rose建议右键快捷方式选择属性→兼容性→勾选以兼容模式运行下拉选择Windows 7。同时勾选以管理员身份运行。这一步不是可有可无的。Rational Rose在启动时会尝试写入C:\Windows\System32下的某些配置没有管理员权限时可能静默失败表现症状是启动后工具栏残缺、菜单点击无响应。3. Rational Rose建模全流程从用例图、类图到序列图的完整操作3.1 新建模型的正确姿势安装配置好以后第一次启动会看到一个新建模型对话框。这里有几个选项J2EE、Java、J、VC、Visual Basic等。很多人会在这纠结我统一建议课程设计选题是Java就选J2EE是C就选VC如果你只是需要画图交作业选J2EE模板问题也不大。模板的选择影响的是Rose预设的模型库比如Java模板会自带标准数据类型以及后面对代码生成的支持。选中模板后记得给模型起名字。模型文件的扩展名是.mdl默认保存在我的文档下。强烈建议养成特定课程一个文件夹的习惯——因为Rational Rose没有自动保存功能崩溃一次没保存画三个小时的心血就全没了。注意保存路径同样不要有中文和空格。D:\UML\图书馆管理系统.mdl这种路径在Rose中可以打开但在代码生成、反向工程时Rose需要把路径拼进ClassName里中文路径会直接报错ClassNotFoundException。3.2 四个视图的结构认知打开Rose后左侧浏览器Browser中会显示四个视图这是Rational Rose最核心的组织方式用例视图Use Case View存放用例图、参与者、用例间的关系以及用例描述文档。逻辑视图Logical View存放类图、对象图、状态图、活动图、序列图、协作图。类是在这里定义的是建模的核心区域。组件视图Component View存放组件图表示代码模块jar包、dll、源文件等之间的依赖关系。部署视图Deployment View存放部署图表示节点和节点上的组件分布。很多初学者习惯一个文档画一张图在Rose里这个思路要反过来先把组成模型的元素类、用例、组件在浏览器里创建好再把它们拖到图上去排布。这样做的好处是同一张类图里出现的类可以同时在序列图里作为消息的发送方和接收方出现它们在模型层面是同一个对象改动一处处处更新。这是Rational Rose区别于Visio等绘图工具的核心理念。3.3 用例图的绘制要点在Use Case View中右键选择New → Use Case Diagram命名后双击进入绘图区。绘图区右侧的工具栏中Actor是参与者Use Case是用例Association是关联关系。画用例图时三步走找参与者。先明确系统的外部角色。比如图书馆管理系统里参与者是读者和管理员。把Actor拖到图上命名时注意用业务角色名称不要用用户这种含糊表述。找用例。从业务功能出发一个功能需求一个用例。在图上用椭圆表示命名用动词名词结构比如借阅图书归还图书查询图书。连线。参与者与用例之间用直线关联注意不是箭头。箭头语义在Rose中表示依赖关系。如果用例之间有包含include和扩展extend关系需要右键用例选择Include或Extend然后选取目标用例。这里我踩过一个坑如果用工具栏的依赖箭头直接画includeRose会把它处理成通用依赖代码生成、用例文档导出时这个关系是识别不了的。3.4 类图的绘制与多重性设置类图是Rational Rose中最考验规范性的图。进入Logical View右键选择New → Class Diagram双击进入绘图区。从工具栏选择Class工具在图中点击后填写类名然后在类上右键选择New Attribute属性和New Operation方法。属性的设置有几个细节可见性public用表示private用-表示protected用#表示package用~表示。很多同学画类图时只写属性名不写可见性这在Rose中不算错但导出文档或生成代码时会有问题。类型属性类型直接填写Java或C的类型名。如果用了模板还可以点击类型下拉箭头从模型库中选。多重性右键属性选择Open Specification在Multiplicity选项卡里设置。一对多关系在Rose中的语义与数据库不同它表示的是一个对象持有多少个目标对象引用不是表之间的关系。类之间的关系有三种常用关联Association、依赖Dependency、泛化Generalization。在工具栏中它们的图标分别是实线箭头、虚线箭头、带空心三角形箭头的实线。绘制时要注意泛化关系的箭头必须指向父类而且父类在上方是约定俗成的排布习惯。3.5 序列图的绘制与消息类型序列图在Rose中是验证你类设计是否合理的关键工具。在Logical View中右键选择New → Sequence Diagram双击进入。序列图绘图区上方是对象生命线左侧的Object工具点击画布可以放置对象。对象之间通过生命线上的虚线表示时间轴消息箭头从发送方生命线指向接收方生命线。消息类型有三种很关键同步消息实心箭头表示调用请求发出后发送方等接收方返回值比如调用一个普通方法。异步消息半箭头表示发送方不等待结果比如Java中new Thread().start()。返回消息虚线箭头表示方法返回。注意返回消息在Rose中默认不自动生成需要手动用工具栏的Return Message工具绘制。实际操作中我见过很多同学的序列图只有同步消息没有返回消息这在Rose的模型校验中不算错误但如果有老师要求代码生成或文档导出缺失返回消息会让序列图不完整。另外一定要把对象的类名写上不要只写server而不指定它是一个什么类的实例。在对象上右键Open Specification在Class下拉框里选中对应的类这样序列图中的消息参数才能和类图对应起来。4. 反向工程与代码生成把Java代码变成UML图再把UML图变成代码4.1 反向工程的前置条件Rational Rose支持从Java字节码.class文件反向生成类图和模型这个功能叫Reverse Engineering。在工作面试题里经常问如何理解代码与模型的双向关系Rose就是最直观的工具。打开Rose后点击菜单Tools → Java/J2EE → Reverse Engineer。如果这个菜单是灰色的说明安装时没有勾选Rose J组件只能重新运行安装程序补救。点击后会弹出Classpath对话框。此时需要把你要反向工程的Java源代码目录或class文件所在目录添加进去。注意这里的一个大坑Rose的Java反向工程需要class文件而不是.java源文件。所以必须先用javac编译一次再把编译好的classes目录添加进去。很多同学直接选了src目录结果提示找不到类。添加路径后在Reverse Engineer对话框左侧会列出所有包结构勾选要反向的包和类点击Reverse按钮Rose会自动在Logical View下创建一个包并在其中生成对应的类图。类与类之间的关联、继承关系也会一起生成效果相当可观。4.2 代码生成前的模型配置反向工程是把代码导成模型代码生成自然是反过来把模型变成代码框架。这是Rational Rose另一个非常实用的功能。同样在菜单Tools → Java/J2EE → Generate Code。点击后会先提示你选择代码生成的根目录。这里要注意Rose生成代码时不会自动创建包目录建议提前在本地建好对应的包结构目录否则生成出来的.java文件会全部堆在根目录下。在生成前需要检查类图和模型中的几个配置每个类必须指定Java类名且不能与包名冲突。每个属性必须指定明确的Java类型String、int、List等Ros自带模糊类型映射但最好手动确认。类与类之间的关联请在关联线属性中指定多重性、导航性和角色名。如果关联没有角色名生成的代码中会生成一个奇怪的字段名通常是instance1instance2这种。配置好后点击GenerateRose会弹出一个类图让你勾选要生成的元素之后在指定目录下生成所有.java文件。生成的代码只包含类结构、属性和方法签名方法体是空壳如果方法有前置条件和后置条件会生成相应的注释而不是逻辑代码。4.3 两种语言反向工程的差异对比Rational Rose的Java和C反向工程在操作方式上有一定差别用表格对比会更直观对比项Java反向工程C反向工程输入文件类型.class字节码.h/.cpp源文件是否需要预编译必须先用javac编译不需要直接解析源码对类模板的支持支持泛型但需手动调整支持模板类映射生成的图表形式类图包图类图模块图常见问题Classpath配置不准导致找不到类头文件依赖顺序导致解析失败上面这个对比是我在同一个测试项目里同时用Java和C模板跑反向工程后总结的。C版本对源文件的解析能力更直接因为不必经过字节码这一层但C头文件里的include顺序会显著影响解析结果如果头文件A引用了头文件B但B在配置里排后面Rose就会把A类解析成没有基类的孤立类。4.4 套件路径与CLASSPATH配置跑Java反向工程时Classpath是一个绕不开的配置。Rose内置了一个小小的JRE但如果你电脑上装了其他JDK反向工程时Rose可能找不到外部类。解决方法是在反向工程对话框里先把JDK自带的rt.jar路径加进去一般为C:\Program Files\Java\jdk1.x.x_xx\lib\rt.jar再把你的项目编译输出目录加进去。顺序有讲究第三方库在中间项目类放在最后。这样配置之后那些main方法以外的工具类、业务类的继承关系才能被完整解析出来。如果配置后仍然提示Class not found不要急着怀疑Rose坏了先确认你的项目里是否用了外部依赖库。Rose的Java反向工程默认只能解析JDK自带类和当前Classpath里指定的类路径第三方jar包内部类的继承关系也需要jar包路径加进来才能解析完整。实用性更强的tip课程设计里的Java项目如果依赖了junit、spring之类的框架反向工程前先把这些jar包从Classpath里去掉。否则Rose会把一大堆框架类也解析进模型里类图乱成一团老师一眼就能看出你没有清洗模型。5. 安装与使用中遇到的典型问题排查5.1 启动时提示Error 1904或无法定位程序输入点这个报错在Windows 10上特别常见90%的原因都是安装路径问题或权限不足。先在控制面板程序和功能里确认Rational Rose是否完整安装。如果安装记录里显示成功但启动仍报错优先尝试修复右键Rational Rose快捷方式选择以管理员身份运行。如果还不行看安装目录下的Rational\Rose\rose.mdl文件是否被占用——有些杀毒软件会后台锁定.mdl文件启动读取时就会报无法定位。另外一个冷门原因是XP兼容模式。有些教程让你勾选以Windows XP兼容模式运行实测在Win10上反而会出问题。改成Windows 7模式后正常。这属于典型的老教程误导新系统情况。5.2 汉化后菜单变英文或者文字乱码汉化后有几种表现对应的处理方式不同部分菜单英文部分中文说明语言文件没有覆盖完整。正常情况Rose的lang\zh_CN下应该有5个文件以上如果只有1个重新用汉化包的完整lang文件夹覆盖。菜单全部变成方格或乱码这是字体问题。Rose使用的是老旧的宋体字体映射Win10默认禁用了一些GDI字体。打开C:\Windows\Fonts找到simsun.ttc宋体右键安装重启Rose即可。菜单点不开或点击无反应这通常是汉化DLL版本不匹配。确认你下载的汉化包声称匹配的版本是否是7.0如果匹配Rational Rose 2003之类的老版本不要混用。5.3 保存的.mdl文件打不开或文件损坏这是最让人崩溃的问题。Rose的.mdl文件在保存时会生成一个临时.mdl.tmp文件正常流程是先写临时文件再替换原文件。如果保存时断电或Rose闪退原文件可能还是旧版本但.tmp文件是新的。遇到.mdl打不开的情况按这个顺序排查看同目录下有没有.mdl.tmp文件。把.tmp改名为.mdl覆盖原文件通常能找回大部分数据。这个技巧我救回过一次通宵画完的模型。如果.tmp文件也没有看看有没有.bak备份。Rose默认关闭自动备份但如果之前保存过手动把原文件复制一份留底的习惯就派上用场了。不要用记事本打开.mdl它不是纯文本。如果真的要用脚本方式抢救数据可以用strings命令提取里面的文本内容但只能找回类名、属性名这些信息图表布局信息会丢失。5.4 工具栏图标丢失或绘图区空白装完汉化后第一次启动有时会出现工具栏残缺或者绘图区完全空白的情况。先别急着重装试试在View → Toolbars里手动重新勾选对应工具栏。如果绘图区空白但浏览器里能看到模型元素右击绘图区选择Reload Graph或按F5刷新。图形元素实际上还是存在的只是绘制刷新挂起了。有个更终极的解决方法是把菜单栏的Options → Preference里的Diagram Window颜色从白色改成其他颜色再改回白色触发一次全量重绘这个老技巧解决了很多渲染问题。5.5 在Windows 11上的特殊处理Windows 11上跑Rational Rose除了兼容模式还需要处理一个问题Windows 11默认启用了内存完整性基于虚拟化的安全这个特性会拦截Rose使用的旧版COM接口表现为启动后主窗口出现但立即闪退。遇到这种情况打开Windows安全中心 → 设备安全性 → 内核隔离关闭内存完整性后重启。这个操作会影响一定的系统安全性只在需要使用Rose时临时关闭即可。另外Windows 11的默认字体渲染也对Rose有影响建议在Rose快捷方式属性中勾选禁用全屏优化绘图区的字体显示会更正常。5.6 模型图元字体大小异常或变形Win10/11对DPI缩放的处理方式和老软件不兼容Rational Rose在150%缩放下图中文字可能变糊或比例失衡。右键快捷方式属性 → 兼容性 → 更改高DPI设置勾选替代高DPI缩放行为缩放执行改为系统重启后文字就清晰了。如果你使用的是高分屏2K或4K这个设置几乎是必须的。我看到很多同学教程没读到这一步最终放弃了在笔记本上使用Rose改在线画图工具——其实不必要DPI问题一分钟就解决了。6. 把Rational Rose从画图工具变成建模工具的实操建议6.1 先定类图后画序列图不要反过来Rational Rose建模有一个推荐的顺序先分析需求画用例图再从用例图提取候选类绘制类图然后针对每个核心用例画序列图来验证类的协作最后补充状态图和活动图再用组件图和部署图来规划物理部署。这个顺序其实是UML标准方法论在Rose中的实践顺序。如果你先画了序列图再去补类图会发现类图中缺很多方法——因为你在序列图里发了消息但接收消息的对象还没有对应的方法Rose不会自动帮你创建。它会默默忽略这个不一致导致你的序列图画得热闹类图却空洞。正确做法是先在浏览器里创建所有候选类给每个类添加候选方法和属性哪怕先空着再画序列图。画序列图的时候给对象设置类消息名去类图里检查对应方法是否存在。6.2 利用Rose的模型校验功能找错Rose自带一个模型校验功能在工具Tools → Check Model。它不会检查你的设计是否合理但能检查模型的合法性——比如类图中出现了没有类型的属性关联关系缺少导航性方法名重复等。每个课程设计交作业前跑一次Check Model把报告里的错误修掉老师那边大多数评分点就稳了。需要注意一点Check Model 对序列图的消息和类图的方法名一致性也有校验。如果序列图里发送消息queryBook()但你类图中对应的方法写的是queryBooks()多了个sRose会报错Information级别的提示。虽然不影响运行但导出文档后很显眼。我的经验是最后统一检查一遍消息名和方法名的拼写。6.3 生成文档Rose的报告功能课程设计通常需要提交设计说明书Rational Rose自带报告生成功能在Tools → Report Generation。可以选择生成HTML或RTF格式的用例图报告、类图报告。报告里会自动列出所有类的属性、方法、关系、用例描述。这对写文档的帮助极大。很多同学的课程设计文档要大段大段地描述系统有登录功能、有注册功能其实Rose的报告已经把类和用例的细节都列出来了你只需要补充业务逻辑的核心说明即可。生成HTML报告的速度比RTF快而且可以在浏览器里直接看到所有图的关系。RTF格式的图片排版会乱需要手动调一下。实际使用中我发现报告里的用例描述默认是空的。如果你希望报告里有用例描述一栏需要在用例图上右键用例选择Open Specification在Documentation选项卡里填入一段自然语言描述。这个文本会出现在文档里而且Rose内部搜索也支持。养成填Documentation的习惯时间长了你的模型就是一份可检索的设计文档。6.4 用泳道图组织业务活动活动图的角色分配状态图和活动图在很多课程设计里被草草带过其实Rational Rose里活动图的泳道功能非常好用它能把业务活动按角色分配到不同列中代表谁负责做什么。画活动图时在绘图区空白处右键Swimlane创建泳道把活动节点拖到对应的泳道里。Rose会自动调整泳道的宽度和布局。这个能力在现代工具里很常见但在Rational Rose那个年代已经是相当成熟的设计了。泳道图的实用价值在于课程设计的业务流程分析章节几乎都能用它来描述。比如读者借书流程用一个泳道图画清楚——读者发起请求、管理员审核、系统更新库存、读者取书四个泳道一目了然。老师看这种图比看大段文字省力得多评分时自然有优势。6.5 双人协作与模型合并的注意事项Rose支持多人协作可以通过配置Rose Team Server实现模型分割和合并但这个功能在老版本上配置复杂网络上教程也多且杂实际教学中基本没人用。如果两个人要同时做一个模型我的建议是分工画不同视图一个人负责用例视图和逻辑视图的类图另一个人负责序列图和部署图。最后合并时用Tools → Model Properties → Units将模型拆成控制单元Controlled Unit每个人导出自己负责的单元再用Control Units合并进主模型。不过说实话这个流程对课程设计来说太重了。我见过的最稳妥方案是先用在线协作工具国内有不少UML在线绘图平台把图的布局讨论清楚最后统一用Rational Rose画最终版。Rose输出格式比较统一提交作业时也方便。7. 使用Rational Rose的八个心得最后写一点我用这款老工具的体会希望能帮你少走弯路。第一务必养成先建元素后连线的习惯。在浏览器里先把类、用例原子化地建好再拖到图上连线。很多操作习惯从Visio带过来——直接在图上画框框——这在Rose里会让你后期寸步难行。Rose的模型规范性是优势但前提是按它的规则来。第二画图过程中频繁保存。Rational Rose没有自动保存和崩溃恢复机制不像现代编辑器。我习惯每画完一张图就按CtrlS这个动作救了我不止一次。另外建议每完成一个阶段把.mdl手动复制一份带日期的备份文件放在单独的备份文件夹里。第三慎重使用撤销。Rose的撤销极不稳定尤其在撤销刚创建的关系时有时会连类一起删掉有时会留下残影。最安全的方式是画错后手动右键删除不要依赖CtrlZ。这是一条血泪教训我用Rose做实验时一次性撤销五步操作直接让一个含几十个类的大图变成了空白图Checksum检查都救不回来。第四注意工具箱图标。Rose的工具栏里有些图标长得非常像比如依赖虚线箭头和实现虚线空心三角箭头很容易混淆画错后老师会扣分。第五适配不同版本的汉化包很讲究。如果你在安装汉化包后启动报错先试试把汉化包比不装上看原版能否启动。如果原版可以而汉化后不行问题一定出在汉化包上。第六画类图时用说明字段Documentation。在类、用例、属性的Description中写中文描述导出文档时Rose会把它们都变成描述性段落。不要等到最后统一补边画边写效率更高。第七需要输出图片时不要截图。使用File → Export Diagram导出为EMF或EPS。EMF格式在Word里放大打印基本不失真截图在高分辨率打印时会有锯齿。有些老师会把课程设计的图打印出来看矢量格式的提升是肉眼可见的。第八理性看待老工具。Rational Rose的学习曲线挺陡峭但它的价值不在权限而在于它让你理解模型不是图这个道理。你在Rose里构建的用例视图、逻辑视图、组件视图、部署视图就是一套可追踪的设计蓝图。这份能力放到任何一个现代工具上都是通用的。如果只是应付作业画完图交差即可如果想真正入门UML建模建议每个项目都完整跑一遍用例图→类图→序列图→部署图的流程用Check Model功能反复修正你会发现自己的设计在逻辑完整性上有质的提升。这是我在Rational Rose上花了很多时间之后最想对每个初学者说的话。
1. 为什么2025年还有人学Rational Rose这款老工具的核心价值先说说我自己碰到的场景。前阵子帮A同学调试一个老项目的设计文档他发过来一个 .mdl 后缀的文件我问他用什么工具打开他说老师让用Rational Rose 2017。我心里咯噔一下——这软件官方早就停止维护了但他所在的高校课程还在用而且用的是网上流传的汉化整合包。这事其实很普遍很多软件工程课程至今仍然把Rational Rose作为UML建模的标准教学工具考试、课程设计、毕业设计都用它来画用例图、类图、序列图。如果你恰好也遇到同样的情况这篇教程就是给你写的。Rational Rose是IBM出品的UML建模工具在2000年代是行业里的绝对主流后来官方停止了更新最后一版停留在7.0。市面上流传的Rational Rose 2017并不是IBM官方发布的版本而是国内的汉化整合包在安装后显示的属性名称——这个版本号更像一个汉化发布版的命名方式。它本质上是Rational Rose 7.0英文原版加上一个汉化补丁再打包成一个一键安装的ISO镜像。所以你在学习时遇到的一切问题本质上都是在跟一款2005年左右开发、但至今仍在教学中服役的老工具打交道。为什么要学一个老古董我的看法是Rational Rose的价值不在它的界面而在它把UML的规范落实得很扎实。它严格按照UML标准组织模型——用例视图、逻辑视图、组件视图、部署视图四个视图的划分清晰而且Rose模型是真正意义上的模型不是画出来的图片。你在类图里改一个类的属性序列图里的消息、代码生成的结果都会跟着变这是现代众多轻量级绘图工具做不到的。对初学者来说用Rose建模能帮助你建立模型驱动的思维方式而不是画完图就扔。这篇教程会从环境准备、模型新建、四大视图的使用、核心图形绘制到反向工程和代码生成以及我实际使用中踩过的坑完整走一遍。无论你是刚上软件工程课的学生还是需要维护老项目的开发者按着这个流程走至少能保证工具装得上、图画得出、文件存得下。2. Rational Rose 2017到底是什么版本代码与安装环境准备2.1 版本澄清不要被版本号误导先要说明一个容易混淆的地方。你在网盘或校园网资源站下载的Rational Rose 2017解压后通常会看到一个ISO镜像文件或者一个名为Rational Rose Enterprise Edition的安装目录。安装完成后你在帮助 → 关于里看到的版本信息大概率是Rational Rose 7.0而不是2017。为什么会有2017这种叫法我推测这个命名是汉化整合包的发布者为了表明我更新了兼容Windows 10的补丁而采用的版本标记。实际测试下来这个整合包确实内置了对Windows 10的兼容性调整包括JREJava运行环境的匹配和注册表项的预配置。所以如果你拿到的资源是Rational Rose 2017大概率等于Rational Rose 7.0 汉化包 Win10兼容补丁。这本身是好事省去了自己折腾兼容性的麻烦。但如果你的老师或同事让你下载Rational Rose 7.0你们用的其实是同一个东西。2.2 安装前的硬件与系统准备安装Rational Rose对硬件几乎没有要求但有几个软件层面的准备工作操作系统支持Windows 7、Windows 1032位或64位均可Windows 11实测也能装上但需要用兼容模式。内存与磁盘2GB以上内存安装后占用约1.5GB磁盘空间。杀毒软件安装前必须暂时关闭实时防护。Rational Rose的安装程序包含注册表写入和COM组件注册某些杀毒软件会拦截导致安装到最后一步报错Feature: Rose Database或Error 1904。不要安装到中文路径这是我在课程辅导中最常见的问题。默认安装路径是C:\Program Files\Rational\Rose请一定保持默认或使用纯英文路径。Rational Rose对中文路径支持得很差装到D:\软件\Rational启动时会直接报无法定位程序输入点或者加载模型失败。2.3 安装步骤与常见选项拿到ISO镜像后推荐用虚拟光驱加载或者直接解压后运行setup.exe。关键步骤如下选择Rational Rose Enterprise Edition不要选Rational Rose Professional或Rose RealTime课程设计里用的都是Enterprise版。安装类型选择自定义在组件列表中一定要勾选Rational Rose JJava反向工程组件。如果不勾选后面对Java代码做反向工程时会找不到菜单。在Rational Software Installer里选择Desktop installation from CD image即可。安装过程中可能会要求重启正常操作即可。安装完成后先不要急着打开。接着装汉化补丁。汉化补丁的安装方式有两种一种是运行Chinese.exe选择Rational Rose安装目录点击安装另一种是直接把汉化包里的lang文件夹覆盖到安装目录下的同名文件夹。实际效果上覆盖文件夹的方式更可靠因为它在替换语言文件的同时不会修改注册表。需要注意汉化完成后第一次启动时菜单栏可能显示为英文需要手动在View → Language里切换到Chinese。提示如果汉化后菜单变成一片乱码或方块不要卸载重装先退出程序找到安装目录下的lang\zh_CN文件夹检查里面是否只有一个RationalRose.dll文件。正常情况下应该还有几个.properties文件缺失的话从汉化包原目录补全即可。2.4 启动时的兼容性设置在Windows 10/11上启动Rational Rose建议右键快捷方式选择属性→兼容性→勾选以兼容模式运行下拉选择Windows 7。同时勾选以管理员身份运行。这一步不是可有可无的。Rational Rose在启动时会尝试写入C:\Windows\System32下的某些配置没有管理员权限时可能静默失败表现症状是启动后工具栏残缺、菜单点击无响应。3. Rational Rose建模全流程从用例图、类图到序列图的完整操作3.1 新建模型的正确姿势安装配置好以后第一次启动会看到一个新建模型对话框。这里有几个选项J2EE、Java、J、VC、Visual Basic等。很多人会在这纠结我统一建议课程设计选题是Java就选J2EE是C就选VC如果你只是需要画图交作业选J2EE模板问题也不大。模板的选择影响的是Rose预设的模型库比如Java模板会自带标准数据类型以及后面对代码生成的支持。选中模板后记得给模型起名字。模型文件的扩展名是.mdl默认保存在我的文档下。强烈建议养成特定课程一个文件夹的习惯——因为Rational Rose没有自动保存功能崩溃一次没保存画三个小时的心血就全没了。注意保存路径同样不要有中文和空格。D:\UML\图书馆管理系统.mdl这种路径在Rose中可以打开但在代码生成、反向工程时Rose需要把路径拼进ClassName里中文路径会直接报错ClassNotFoundException。3.2 四个视图的结构认知打开Rose后左侧浏览器Browser中会显示四个视图这是Rational Rose最核心的组织方式用例视图Use Case View存放用例图、参与者、用例间的关系以及用例描述文档。逻辑视图Logical View存放类图、对象图、状态图、活动图、序列图、协作图。类是在这里定义的是建模的核心区域。组件视图Component View存放组件图表示代码模块jar包、dll、源文件等之间的依赖关系。部署视图Deployment View存放部署图表示节点和节点上的组件分布。很多初学者习惯一个文档画一张图在Rose里这个思路要反过来先把组成模型的元素类、用例、组件在浏览器里创建好再把它们拖到图上去排布。这样做的好处是同一张类图里出现的类可以同时在序列图里作为消息的发送方和接收方出现它们在模型层面是同一个对象改动一处处处更新。这是Rational Rose区别于Visio等绘图工具的核心理念。3.3 用例图的绘制要点在Use Case View中右键选择New → Use Case Diagram命名后双击进入绘图区。绘图区右侧的工具栏中Actor是参与者Use Case是用例Association是关联关系。画用例图时三步走找参与者。先明确系统的外部角色。比如图书馆管理系统里参与者是读者和管理员。把Actor拖到图上命名时注意用业务角色名称不要用用户这种含糊表述。找用例。从业务功能出发一个功能需求一个用例。在图上用椭圆表示命名用动词名词结构比如借阅图书归还图书查询图书。连线。参与者与用例之间用直线关联注意不是箭头。箭头语义在Rose中表示依赖关系。如果用例之间有包含include和扩展extend关系需要右键用例选择Include或Extend然后选取目标用例。这里我踩过一个坑如果用工具栏的依赖箭头直接画includeRose会把它处理成通用依赖代码生成、用例文档导出时这个关系是识别不了的。3.4 类图的绘制与多重性设置类图是Rational Rose中最考验规范性的图。进入Logical View右键选择New → Class Diagram双击进入绘图区。从工具栏选择Class工具在图中点击后填写类名然后在类上右键选择New Attribute属性和New Operation方法。属性的设置有几个细节可见性public用表示private用-表示protected用#表示package用~表示。很多同学画类图时只写属性名不写可见性这在Rose中不算错但导出文档或生成代码时会有问题。类型属性类型直接填写Java或C的类型名。如果用了模板还可以点击类型下拉箭头从模型库中选。多重性右键属性选择Open Specification在Multiplicity选项卡里设置。一对多关系在Rose中的语义与数据库不同它表示的是一个对象持有多少个目标对象引用不是表之间的关系。类之间的关系有三种常用关联Association、依赖Dependency、泛化Generalization。在工具栏中它们的图标分别是实线箭头、虚线箭头、带空心三角形箭头的实线。绘制时要注意泛化关系的箭头必须指向父类而且父类在上方是约定俗成的排布习惯。3.5 序列图的绘制与消息类型序列图在Rose中是验证你类设计是否合理的关键工具。在Logical View中右键选择New → Sequence Diagram双击进入。序列图绘图区上方是对象生命线左侧的Object工具点击画布可以放置对象。对象之间通过生命线上的虚线表示时间轴消息箭头从发送方生命线指向接收方生命线。消息类型有三种很关键同步消息实心箭头表示调用请求发出后发送方等接收方返回值比如调用一个普通方法。异步消息半箭头表示发送方不等待结果比如Java中new Thread().start()。返回消息虚线箭头表示方法返回。注意返回消息在Rose中默认不自动生成需要手动用工具栏的Return Message工具绘制。实际操作中我见过很多同学的序列图只有同步消息没有返回消息这在Rose的模型校验中不算错误但如果有老师要求代码生成或文档导出缺失返回消息会让序列图不完整。另外一定要把对象的类名写上不要只写server而不指定它是一个什么类的实例。在对象上右键Open Specification在Class下拉框里选中对应的类这样序列图中的消息参数才能和类图对应起来。4. 反向工程与代码生成把Java代码变成UML图再把UML图变成代码4.1 反向工程的前置条件Rational Rose支持从Java字节码.class文件反向生成类图和模型这个功能叫Reverse Engineering。在工作面试题里经常问如何理解代码与模型的双向关系Rose就是最直观的工具。打开Rose后点击菜单Tools → Java/J2EE → Reverse Engineer。如果这个菜单是灰色的说明安装时没有勾选Rose J组件只能重新运行安装程序补救。点击后会弹出Classpath对话框。此时需要把你要反向工程的Java源代码目录或class文件所在目录添加进去。注意这里的一个大坑Rose的Java反向工程需要class文件而不是.java源文件。所以必须先用javac编译一次再把编译好的classes目录添加进去。很多同学直接选了src目录结果提示找不到类。添加路径后在Reverse Engineer对话框左侧会列出所有包结构勾选要反向的包和类点击Reverse按钮Rose会自动在Logical View下创建一个包并在其中生成对应的类图。类与类之间的关联、继承关系也会一起生成效果相当可观。4.2 代码生成前的模型配置反向工程是把代码导成模型代码生成自然是反过来把模型变成代码框架。这是Rational Rose另一个非常实用的功能。同样在菜单Tools → Java/J2EE → Generate Code。点击后会先提示你选择代码生成的根目录。这里要注意Rose生成代码时不会自动创建包目录建议提前在本地建好对应的包结构目录否则生成出来的.java文件会全部堆在根目录下。在生成前需要检查类图和模型中的几个配置每个类必须指定Java类名且不能与包名冲突。每个属性必须指定明确的Java类型String、int、List等Ros自带模糊类型映射但最好手动确认。类与类之间的关联请在关联线属性中指定多重性、导航性和角色名。如果关联没有角色名生成的代码中会生成一个奇怪的字段名通常是instance1instance2这种。配置好后点击GenerateRose会弹出一个类图让你勾选要生成的元素之后在指定目录下生成所有.java文件。生成的代码只包含类结构、属性和方法签名方法体是空壳如果方法有前置条件和后置条件会生成相应的注释而不是逻辑代码。4.3 两种语言反向工程的差异对比Rational Rose的Java和C反向工程在操作方式上有一定差别用表格对比会更直观对比项Java反向工程C反向工程输入文件类型.class字节码.h/.cpp源文件是否需要预编译必须先用javac编译不需要直接解析源码对类模板的支持支持泛型但需手动调整支持模板类映射生成的图表形式类图包图类图模块图常见问题Classpath配置不准导致找不到类头文件依赖顺序导致解析失败上面这个对比是我在同一个测试项目里同时用Java和C模板跑反向工程后总结的。C版本对源文件的解析能力更直接因为不必经过字节码这一层但C头文件里的include顺序会显著影响解析结果如果头文件A引用了头文件B但B在配置里排后面Rose就会把A类解析成没有基类的孤立类。4.4 套件路径与CLASSPATH配置跑Java反向工程时Classpath是一个绕不开的配置。Rose内置了一个小小的JRE但如果你电脑上装了其他JDK反向工程时Rose可能找不到外部类。解决方法是在反向工程对话框里先把JDK自带的rt.jar路径加进去一般为C:\Program Files\Java\jdk1.x.x_xx\lib\rt.jar再把你的项目编译输出目录加进去。顺序有讲究第三方库在中间项目类放在最后。这样配置之后那些main方法以外的工具类、业务类的继承关系才能被完整解析出来。如果配置后仍然提示Class not found不要急着怀疑Rose坏了先确认你的项目里是否用了外部依赖库。Rose的Java反向工程默认只能解析JDK自带类和当前Classpath里指定的类路径第三方jar包内部类的继承关系也需要jar包路径加进来才能解析完整。实用性更强的tip课程设计里的Java项目如果依赖了junit、spring之类的框架反向工程前先把这些jar包从Classpath里去掉。否则Rose会把一大堆框架类也解析进模型里类图乱成一团老师一眼就能看出你没有清洗模型。5. 安装与使用中遇到的典型问题排查5.1 启动时提示Error 1904或无法定位程序输入点这个报错在Windows 10上特别常见90%的原因都是安装路径问题或权限不足。先在控制面板程序和功能里确认Rational Rose是否完整安装。如果安装记录里显示成功但启动仍报错优先尝试修复右键Rational Rose快捷方式选择以管理员身份运行。如果还不行看安装目录下的Rational\Rose\rose.mdl文件是否被占用——有些杀毒软件会后台锁定.mdl文件启动读取时就会报无法定位。另外一个冷门原因是XP兼容模式。有些教程让你勾选以Windows XP兼容模式运行实测在Win10上反而会出问题。改成Windows 7模式后正常。这属于典型的老教程误导新系统情况。5.2 汉化后菜单变英文或者文字乱码汉化后有几种表现对应的处理方式不同部分菜单英文部分中文说明语言文件没有覆盖完整。正常情况Rose的lang\zh_CN下应该有5个文件以上如果只有1个重新用汉化包的完整lang文件夹覆盖。菜单全部变成方格或乱码这是字体问题。Rose使用的是老旧的宋体字体映射Win10默认禁用了一些GDI字体。打开C:\Windows\Fonts找到simsun.ttc宋体右键安装重启Rose即可。菜单点不开或点击无反应这通常是汉化DLL版本不匹配。确认你下载的汉化包声称匹配的版本是否是7.0如果匹配Rational Rose 2003之类的老版本不要混用。5.3 保存的.mdl文件打不开或文件损坏这是最让人崩溃的问题。Rose的.mdl文件在保存时会生成一个临时.mdl.tmp文件正常流程是先写临时文件再替换原文件。如果保存时断电或Rose闪退原文件可能还是旧版本但.tmp文件是新的。遇到.mdl打不开的情况按这个顺序排查看同目录下有没有.mdl.tmp文件。把.tmp改名为.mdl覆盖原文件通常能找回大部分数据。这个技巧我救回过一次通宵画完的模型。如果.tmp文件也没有看看有没有.bak备份。Rose默认关闭自动备份但如果之前保存过手动把原文件复制一份留底的习惯就派上用场了。不要用记事本打开.mdl它不是纯文本。如果真的要用脚本方式抢救数据可以用strings命令提取里面的文本内容但只能找回类名、属性名这些信息图表布局信息会丢失。5.4 工具栏图标丢失或绘图区空白装完汉化后第一次启动有时会出现工具栏残缺或者绘图区完全空白的情况。先别急着重装试试在View → Toolbars里手动重新勾选对应工具栏。如果绘图区空白但浏览器里能看到模型元素右击绘图区选择Reload Graph或按F5刷新。图形元素实际上还是存在的只是绘制刷新挂起了。有个更终极的解决方法是把菜单栏的Options → Preference里的Diagram Window颜色从白色改成其他颜色再改回白色触发一次全量重绘这个老技巧解决了很多渲染问题。5.5 在Windows 11上的特殊处理Windows 11上跑Rational Rose除了兼容模式还需要处理一个问题Windows 11默认启用了内存完整性基于虚拟化的安全这个特性会拦截Rose使用的旧版COM接口表现为启动后主窗口出现但立即闪退。遇到这种情况打开Windows安全中心 → 设备安全性 → 内核隔离关闭内存完整性后重启。这个操作会影响一定的系统安全性只在需要使用Rose时临时关闭即可。另外Windows 11的默认字体渲染也对Rose有影响建议在Rose快捷方式属性中勾选禁用全屏优化绘图区的字体显示会更正常。5.6 模型图元字体大小异常或变形Win10/11对DPI缩放的处理方式和老软件不兼容Rational Rose在150%缩放下图中文字可能变糊或比例失衡。右键快捷方式属性 → 兼容性 → 更改高DPI设置勾选替代高DPI缩放行为缩放执行改为系统重启后文字就清晰了。如果你使用的是高分屏2K或4K这个设置几乎是必须的。我看到很多同学教程没读到这一步最终放弃了在笔记本上使用Rose改在线画图工具——其实不必要DPI问题一分钟就解决了。6. 把Rational Rose从画图工具变成建模工具的实操建议6.1 先定类图后画序列图不要反过来Rational Rose建模有一个推荐的顺序先分析需求画用例图再从用例图提取候选类绘制类图然后针对每个核心用例画序列图来验证类的协作最后补充状态图和活动图再用组件图和部署图来规划物理部署。这个顺序其实是UML标准方法论在Rose中的实践顺序。如果你先画了序列图再去补类图会发现类图中缺很多方法——因为你在序列图里发了消息但接收消息的对象还没有对应的方法Rose不会自动帮你创建。它会默默忽略这个不一致导致你的序列图画得热闹类图却空洞。正确做法是先在浏览器里创建所有候选类给每个类添加候选方法和属性哪怕先空着再画序列图。画序列图的时候给对象设置类消息名去类图里检查对应方法是否存在。6.2 利用Rose的模型校验功能找错Rose自带一个模型校验功能在工具Tools → Check Model。它不会检查你的设计是否合理但能检查模型的合法性——比如类图中出现了没有类型的属性关联关系缺少导航性方法名重复等。每个课程设计交作业前跑一次Check Model把报告里的错误修掉老师那边大多数评分点就稳了。需要注意一点Check Model 对序列图的消息和类图的方法名一致性也有校验。如果序列图里发送消息queryBook()但你类图中对应的方法写的是queryBooks()多了个sRose会报错Information级别的提示。虽然不影响运行但导出文档后很显眼。我的经验是最后统一检查一遍消息名和方法名的拼写。6.3 生成文档Rose的报告功能课程设计通常需要提交设计说明书Rational Rose自带报告生成功能在Tools → Report Generation。可以选择生成HTML或RTF格式的用例图报告、类图报告。报告里会自动列出所有类的属性、方法、关系、用例描述。这对写文档的帮助极大。很多同学的课程设计文档要大段大段地描述系统有登录功能、有注册功能其实Rose的报告已经把类和用例的细节都列出来了你只需要补充业务逻辑的核心说明即可。生成HTML报告的速度比RTF快而且可以在浏览器里直接看到所有图的关系。RTF格式的图片排版会乱需要手动调一下。实际使用中我发现报告里的用例描述默认是空的。如果你希望报告里有用例描述一栏需要在用例图上右键用例选择Open Specification在Documentation选项卡里填入一段自然语言描述。这个文本会出现在文档里而且Rose内部搜索也支持。养成填Documentation的习惯时间长了你的模型就是一份可检索的设计文档。6.4 用泳道图组织业务活动活动图的角色分配状态图和活动图在很多课程设计里被草草带过其实Rational Rose里活动图的泳道功能非常好用它能把业务活动按角色分配到不同列中代表谁负责做什么。画活动图时在绘图区空白处右键Swimlane创建泳道把活动节点拖到对应的泳道里。Rose会自动调整泳道的宽度和布局。这个能力在现代工具里很常见但在Rational Rose那个年代已经是相当成熟的设计了。泳道图的实用价值在于课程设计的业务流程分析章节几乎都能用它来描述。比如读者借书流程用一个泳道图画清楚——读者发起请求、管理员审核、系统更新库存、读者取书四个泳道一目了然。老师看这种图比看大段文字省力得多评分时自然有优势。6.5 双人协作与模型合并的注意事项Rose支持多人协作可以通过配置Rose Team Server实现模型分割和合并但这个功能在老版本上配置复杂网络上教程也多且杂实际教学中基本没人用。如果两个人要同时做一个模型我的建议是分工画不同视图一个人负责用例视图和逻辑视图的类图另一个人负责序列图和部署图。最后合并时用Tools → Model Properties → Units将模型拆成控制单元Controlled Unit每个人导出自己负责的单元再用Control Units合并进主模型。不过说实话这个流程对课程设计来说太重了。我见过的最稳妥方案是先用在线协作工具国内有不少UML在线绘图平台把图的布局讨论清楚最后统一用Rational Rose画最终版。Rose输出格式比较统一提交作业时也方便。7. 使用Rational Rose的八个心得最后写一点我用这款老工具的体会希望能帮你少走弯路。第一务必养成先建元素后连线的习惯。在浏览器里先把类、用例原子化地建好再拖到图上连线。很多操作习惯从Visio带过来——直接在图上画框框——这在Rose里会让你后期寸步难行。Rose的模型规范性是优势但前提是按它的规则来。第二画图过程中频繁保存。Rational Rose没有自动保存和崩溃恢复机制不像现代编辑器。我习惯每画完一张图就按CtrlS这个动作救了我不止一次。另外建议每完成一个阶段把.mdl手动复制一份带日期的备份文件放在单独的备份文件夹里。第三慎重使用撤销。Rose的撤销极不稳定尤其在撤销刚创建的关系时有时会连类一起删掉有时会留下残影。最安全的方式是画错后手动右键删除不要依赖CtrlZ。这是一条血泪教训我用Rose做实验时一次性撤销五步操作直接让一个含几十个类的大图变成了空白图Checksum检查都救不回来。第四注意工具箱图标。Rose的工具栏里有些图标长得非常像比如依赖虚线箭头和实现虚线空心三角箭头很容易混淆画错后老师会扣分。第五适配不同版本的汉化包很讲究。如果你在安装汉化包后启动报错先试试把汉化包比不装上看原版能否启动。如果原版可以而汉化后不行问题一定出在汉化包上。第六画类图时用说明字段Documentation。在类、用例、属性的Description中写中文描述导出文档时Rose会把它们都变成描述性段落。不要等到最后统一补边画边写效率更高。第七需要输出图片时不要截图。使用File → Export Diagram导出为EMF或EPS。EMF格式在Word里放大打印基本不失真截图在高分辨率打印时会有锯齿。有些老师会把课程设计的图打印出来看矢量格式的提升是肉眼可见的。第八理性看待老工具。Rational Rose的学习曲线挺陡峭但它的价值不在权限而在于它让你理解模型不是图这个道理。你在Rose里构建的用例视图、逻辑视图、组件视图、部署视图就是一套可追踪的设计蓝图。这份能力放到任何一个现代工具上都是通用的。如果只是应付作业画完图交差即可如果想真正入门UML建模建议每个项目都完整跑一遍用例图→类图→序列图→部署图的流程用Check Model功能反复修正你会发现自己的设计在逻辑完整性上有质的提升。这是我在Rational Rose上花了很多时间之后最想对每个初学者说的话。
