googleapis/google-cloud-java

[java-spanner] test: OptionsTest checks for fixed values being returned from hashCode()

Open

#12,268 创建于 2020年11月3日

在 GitHub 查看
 (0 评论) (0 反应) (0 负责人)Java (1,082 fork)batch import
api: spannergood first issuehelp wantedtype: cleanup

仓库指标

Star
 (1,763 star)
PR 合并指标
 (平均合并 2天 21小时) (30 天内合并 145 个 PR)

描述

The Options#hashCode() method does not guarantee to return a fixed value that is equal on all JVM's (at least; the documentation does not guarantee it). In reality it does, because the current implementation only uses hash codes that are guaranteed to be equal on all JVM's. The method should either be documented to have this behavior, or these tests should be replaced with tests that assert that the hashCode and equals methods comply with the general contract regarding these methods.

贡献者指南

研究方向
检查 google cloud java 仓库 java spanner 模块中的 Options.java 和 OptionsTest.java。该问题建议，要么记录 hashCode() 方法的行为，要么更新测试以仅断言通用契约。查看当前实现，确认其是否在不同 JVM 间使用一致的哈希码。考虑将测试更新为使用 assertThat(options).isEqualTo(anotherOptions) 或类似的依赖 equals 的检查，因为这是测试 hashCode 合规性的标准方式。如果选择添加文档，则在类的 Javadoc 中添加说明，指出哈希码是确定性的，并且在不同 JVM 间相等。
技术栈
java
领域
testingbackend
议题类型
测试
难度面向新贡献者的预计实现难度，1 表示很小改动，5 表示专家级工作。
3
预计时间有经验贡献者完成调查、实现、测试并准备 pull request 的粗略时间范围。
1-3 小时
活动状态议题当前的可参与程度：新鲜、活跃、陈旧、阻塞或等待维护者输入。
较久未更新
清晰度议题是否清楚说明期望改动、验收标准和下一步。
基本清晰
前置要求
Understanding of equals/hashCode contractFamiliarity with Java testing
新手友好度1-100 的估计分数，表示该议题对首次贡献者的友好程度。
60