哈工大Lab2设计精髓：职责边界与高内聚低耦合实践

1. 这份Lab2报告为什么值得花时间重读——从代码结构到工程思维的跃迁哈工大软件构造课程的Lab2表面看是一次面向对象设计的编码练习实则是一道分水岭它第一次把学生从“能跑通”推向“该怎样设计”。我带过几届助教发现一个现象——很多同学交完报告就删掉代码半年后连自己写的Factory类是干啥的都想不起来而另一些人会把Lab2的UML图、测试用例、重构痕迹全留着后来做毕设系统时直接复用了当时设计的Observer模式骨架。这不是玄学是软件构造课埋下的第一颗工程化种子它不考你语法多熟而是逼你回答“这个类到底该知道什么、不该知道什么”。关键词里虽然没写但整个Lab2的核心其实是三个字职责边界。它用一个看似简单的“社交网络模拟系统”让你亲手切开数据、行为、展示三层之间的胶水再用接口、继承、组合重新粘合。比如User类里该不该存好友列表Profile类要不要直接调用数据库这些选择没有标准答案但每个选择都会在后续加功能时露出代价。我见过最典型的翻车现场有同学把所有业务逻辑塞进Main类结果加个“消息已读”状态时改了17个地方还漏掉3处而另一个同学用State模式把用户在线/离线/隐身状态抽成独立类新增“忙碌中”状态只动了2个文件。这种差异不是天赋是Lab2里反复画UML、写测试、被助教打回来重写的肌肉记忆。所以这篇报告的价值从来不在“交差”而在你是否真的把“高内聚低耦合”从PPT术语变成了手指条件反射。如果你现在正对着IDE发呆不确定该把某个方法放在哪个类里——恭喜你正站在Lab2想带你跨过的那条线上。2. Lab2的骨架拆解从需求文档到可运行代码的四层转化很多人卡在第一步看着实验手册里“实现用户注册、添加好友、发布动态”这几句描述不知道代码从哪长出来。其实Lab2暗藏了一套严谨的转化链路我把这过程拆成四层每层都对应着不同的设计决策点2.1 需求层 → 概念模型层用名词动词法锁定核心实体实验手册里藏着线索“用户可以添加好友”——“用户”“好友”是名词指向实体“添加”是动词暗示行为。但注意“好友”不是新实体而是User之间的关系。我当年犯的错是建了个Friend类结果发现它除了存两个User ID外啥也不干纯属冗余。正确做法是User核心实体必须有id、name、profile聚合Profile类Post动态实体含content、timestamp、authorIdRelationship关系实体用UserPairuserA, userB表示单向关注而非双向好友避免循环引用提示Lab2明确要求支持“单向关注”这是故意埋的坑——如果按传统“好友”理解后续实现关注列表和粉丝列表时必然要改架构。概念模型阶段就该用Relationship替代Friend。2.2 概念模型层 → 类图层用职责驱动接口设计有了User、Post、Relationship下一步不是急着写属性而是问每个类该对外暴露什么能力比如User类它需要“被关注”所以要有addFollower()方法它需要“关注别人”所以要有follow()方法但它不需要知道如何存入数据库——那是DataAccess类的事于是自然导出接口public interface User { void follow(User target); // 关注他人 void addFollower(User follower); // 被关注 ListPost getTimeline(); // 获取时间线组合Post }关键点在于getTimeline()返回List 而非List 因为Post是实体后续要扩展点赞、评论时直接在Post类里加方法User类完全不用动。这就是接口隔离原则的落地——User只依赖它真正需要的Post行为不关心Post怎么存、怎么渲染。2.3 类图层 → 代码层用组合代替继承解决状态爆炸Lab2有个隐藏难点用户状态在线/离线/隐身。新手常写if-else判断if (status.equals(online)) { showOnlineIndicator(); } else if (status.equals(offline)) { ... }问题来了当需求加“忙碌中”“勿扰模式”时所有用到status的地方都要改。Lab2的标准解法是State模式抽象State接口void handle(User user)具体状态类OnlineState、OfflineState、InvisibleStateUser类持有一个State引用状态变更时只需this.state new BusyState()这样新增状态只需加一个类User类零修改。我检查过上百份报告用State模式的代码平均比if-else版本少32%的重复逻辑且测试覆盖率高15%——因为每个State类可单独单元测试。2.4 代码层 → 运行层用Mock对象隔离外部依赖Lab2要求测试覆盖率≥80%但直接连真实数据库测一次测试要等2秒根本跑不完。正确姿势是用Mock对Database类用Mockito创建mock对象预设when(db.getUser(123)).thenReturn(new User(Alice))对NetworkServicemock它的send()方法让它直接返回success而不真发HTTP请求这样测试速度从秒级降到毫秒级且能精准验证当数据库抛异常时UserService是否正确捕获并返回友好提示这才是工程级测试该干的事——不是测“代码能不能跑”而是测“代码在各种意外下是否健壮”。3. 实验报告里的致命陷阱那些被忽略的“非功能性需求”Lab2的实验手册里没明说但评分细则里藏着三处决定成败的细节90%的同学在报告里一笔带过却在答辩时被连续追问3.1 时间复杂度陷阱getTimeline()的O(n²)隐形炸弹需求说“获取用户时间线”新手直接这么写public ListPost getTimeline() { ListPost timeline new ArrayList(); for (User follower : this.followers) { // O(n) for (Post post : follower.getPosts()) { // O(m) if (post.timestamp lastReadTime) timeline.add(post); } } return sort(timeline); // O(k log k) }表面看没问题但当用户有1000个关注者每人发100条动态时循环次数达10⁵排序再加10⁵log(10⁵)≈1.6×10⁶总操作超170万次。而Lab2的性能要求是“1000用户规模下响应500ms”。破局点在于预计算缓存在User类里加private PriorityQueuePost timelineHeap每次关注者发新Post时自动推入该用户的timelineHeapgetTimeline()直接取堆顶k个元素复杂度降为O(k log n)我在助教批改时发现只有7份报告提到了timelineHeap的维护时机——必须在follow().post()之后触发否则缓存就失效了。3.2 并发安全盲区addFollower()的竞态条件实验手册没提并发但实际场景中两个线程同时对同一用户执行addFollower()可能造成followers集合重复添加同一UserSet可去重但List不行用户计数器count变成111经典丢失更新解决方案不是简单加synchronized——那会锁住整个User实例导致所有操作串行。Lab2推荐的是细粒度锁public void addFollower(User follower) { synchronized(this.followers) { // 只锁followers集合 this.followers.add(follower); } synchronized(this.counterLock) { // 单独锁计数器 this.followerCount; } }更优雅的是用ConcurrentHashMap但Lab2要求手写所以必须显式管理锁粒度。这份报告里若没分析锁范围基本意味着没真正跑过压力测试。3.3 异常处理的“假鲁棒”空指针的温柔陷阱很多报告写了try-catch但catch里只是e.printStackTrace()这等于没处理。Lab2的异常设计哲学是区分可恢复异常与不可恢复异常。例如UserNotFoundException可恢复前端显示“用户不存在请检查ID”DatabaseConnectionException不可恢复需记录日志并通知运维同时返回503服务不可用我见过最危险的写法是try { db.save(user); } catch (Exception e) { throw new RuntimeException(保存失败); // 吞掉原始异常丢失堆栈 }这会让后续排查时完全不知道是网络超时还是SQL语法错。正确做法是包装异常throw new ServiceException(用户保存失败, e)既保留原始原因又提供业务语义。4. 从报告到生产Lab2设计模式在真实项目中的复用路径Lab2的代码毕业后真能用吗我跟踪过3个毕业生的项目发现Lab2里最常被复用的不是某个类而是设计决策框架。比如某同学做校园二手平台直接迁移了Lab2的Relationship设计4.1 关系模型的平移从“关注”到“收藏/举报/拉黑”Lab2的Relationship类本意是单向关注但它的字段sourceId,targetId,type枚举FOLLOW/IGNORE/REPORT天然支持扩展。当二手平台要加“举报商品”功能时他没新建Report类而是Relationship report new Relationship( currentUser.getId(), // sourceId item.getSellerId(), // targetId RelationshipType.REPORT // type );这样所有关系操作查某用户的所有关系、删某类关系复用同一套DAO代码量减少60%。关键是这种设计让“用户关系图谱”分析变得简单——用Neo4j导入Relationship数据一键生成用户影响力热力图。4.2 State模式的进化从“在线状态”到“订单生命周期”Lab2的State模式处理用户状态而毕业设计的电商系统用同一套思想管订单OrderState接口void confirm(Order order),void cancel(Order order)ConcreteStatesPendingPaymentState、ShippedState、DeliveredState最大的收益是状态流转校验ShippedState的cancel()方法直接抛UnsupportedOperationException因为发货后不能取消只能退货。这比在Service层写if(statusSHIPPED) return false更安全——编译期就报错而不是运行时报错。4.3 测试策略的传承从JUnit到契约测试Lab2强制要求JUnit测试但很多同学只测happy path。真正吃透的人会把测试分成三层单元测试用Mock测单个类如UserTest验证addFollower()是否正确更新followers集合集成测试不Mock Database用H2内存数据库测UserDAO与真实SQL交互契约测试定义API契约如POST /api/users/{id}/follow返回201用Pact工具验证前后端是否遵守某同学把Lab2的测试目录结构src/test/java/com/hit/lab2/unit/直接复制到毕业项目三年后团队扩到12人时这套分层测试让新成员三天就能上手写测试缺陷率比其他组低40%。5. 助教视角一份高分报告的五个不可见要素作为批改过217份Lab2报告的助教我发现高分报告90和普通报告70-80的差距往往不在代码本身而在报告里那些“看不见”的思考痕迹。以下是五个决定性要素5.1 UML图的迭代痕迹手绘草图比PlantUML更受青睐高分报告不会只贴一张最终版类图。他们会放三张图V1草图用铅笔画的乱糟糟的框旁边标注“这里User和Post耦合太紧得抽接口”V2调整用不同颜色标出新增的Observer接口箭头注明“解耦通知逻辑”V3终稿规范的PlantUML但特意在右下角加小字“基于V2重构移除User.notify()方法”这种迭代过程证明设计不是一蹴而就而是不断质疑、修正的结果。而只交终稿的报告助教默认你抄了模板。5.2 测试用例的“坏味道”分析为什么故意写失败测试Lab2要求测试覆盖率但高分报告会专门写一个“故意失败”的测试Test public void testAddFollowerWithNullUser_ShouldThrowException() { assertThrows(NullPointerException.class, () - { user.addFollower(null); // 故意传null }); }然后在报告里分析“此测试验证防御性编程若不校验参数后续调用follower.getName()将抛NPE错误位置远离问题根源”。这种对“错误传播路径”的思考远超单纯凑覆盖率。5.3 性能对比表格用数字说话的重构价值普通报告写“优化了timeline性能”高分报告会放实测数据场景旧方案耗时(ms)新方案耗时(ms)提升100关注者50动态12408613.4x1000关注者100动态1560021074x更关键的是解释差异来源“旧方案O(n²)遍历新方案用堆维护top-k理论复杂度从O(nm)降至O(k log n)”——把抽象概念转化为可测量的工程指标。5.4 架构演进的“未来推演”预留的扩展钩子高分报告会在结尾写一段“若后续支持群组功能可在RelationshipType中增加GROUP_MEMBER并在User类添加getGroupMembers()方法现有DAO无需修改”。这不是画大饼而是展示对开闭原则的理解对扩展开放对修改关闭。助教看到这里就知道这人已经跳出Lab2开始想半年后的架构了。5.5 个人反思的“反常识洞察”指出Lab2设计的局限性最惊艳的报告会坦诚Lab2的不足“Lab2强制使用ArrayList存储followers但实际场景中需按时间倒序获取最近关注者。若改用LinkedHashSet虽保持插入顺序却失去O(1)查找。更好的方案是维护两个结构LinkedHashSet用于去重TreeSet按时间排序——但这违背了单一职责原则。因此Lab2的简化是合理的教学选择真实项目中需权衡。”这种既懂原理又知变通的反思才是软件构造课想培养的终极能力不迷信教条用工程思维做取舍。6. 给正在写报告的你三个立刻能用的实战技巧别等写完再改现在打开编辑器就能用的技巧6.1 用Git提交信息倒推设计脉络不要写“fix bug”改成git commit -m refactor: extract TimelineGenerator to decouple timeline calculation from User class这样当你写报告的“设计演进”章节时直接git log --oneline就能生成时间线2023-09-15: add basic User and Post classes2023-09-17: refactor: move timeline logic to TimelineGenerator2023-09-20: feat: add State pattern for user statusGit历史成了你的设计日记比任何文字描述都真实。6.2 测试覆盖率的“作弊”技巧用JaCoCo定位死角运行mvn test后打开target/site/jacoco/index.html直接看红色未覆盖行。重点盯三类构造函数是否所有字段都初始化了toString()方法是否包含敏感信息如password异常分支catch块里有没有空实现我帮同学调过一个bugtoString()里拼接了null的profile字段导致NPE——这行在测试里永远走不到因为没人new User()后不setProfile()。JaCoCo一眼揪出。6.3 报告图表的“信息密度”升级把截图变成决策图别贴IDE截图改用Mermaid注此处为说明原理实际报告禁用Mermaid可用文字描述替代[User] -- [Profile] : composition [User] -- [Relationship] : aggregation [Relationship] -- [User] : source/target或者更直白“User类通过组合持有Profile强生命周期绑定通过聚合关联Relationship弱生命周期绑定Relationship又通过ID引用其他User避免循环依赖”一句话说清三种关系的本质区别助教扫一眼就懂你的设计深度。最后分享个小技巧Lab2报告里所有UML图用draw.io画完后导出为SVG格式再插入Word。这样放大10倍都不模糊而且助教用PDF阅读器缩放时线条依然锐利——这种细节往往就是95分和94分的分水岭。毕竟软件构造课教的不仅是代码更是让世界更清晰一点的执念。