何处有秋香 發表於 2025-8-12 16:14:00

一个表示金额的数字是 100000000L,这是多少米(多少钱)?【代码可读性实践】

<blockquote>
<p>易读的代码(Readable Code)是高质量软件开发的核心要素之一</p>
</blockquote>
<br>
<p>今天下午,我在CR时,注意到下面的银行付款程序中的<code>100000000L</code>。如果不数零,谁能直观看出来这个庞大的数字代表多少钱呢?</p>
<pre><code class="language-java">...
bb1payopx1.setTrsAmt(bankOrder.getAmt() + "");
if (bankOrder.getAmt() &lt; 100000000L) {
    bb1payopx1.setStlChn(CmbCloudSettlementTypeEnum.REAL_TIME.getCode());
} else {
    bb1payopx1.setStlChn(CmbCloudSettlementTypeEnum.EXPRESS.getCode());
}
...
</code></pre>
<br>
<p>有同学会说,不就是一个数字嘛,管它是多少呢?总之就是作为一个判断条件而已。</p>
<p>持这种想法的同学,估计这半辈子注定是一个码农。</p>
<p>作为应用开发者,我们要关注业务。这段代码所体现的业务逻辑是,转账交易金额低于 100w 时,银行会实时结算;而超过 100w 时,会走快速转账方式,结算时效会下降。</p>
<p>银行不同的结算通道,会直接影响到交易的时效。掌握了这一点,转账交易的业务层就可以调整相应的产品策略,以满足结算时效。</p>
<br>
<p>那么,从代码可读性的角度来看,怎么能让人一眼就能看出来<code>100000000L</code>表示的是 1百万 呢?</p>
<br>
<p>有同学说了,使用javadoc加个注释。</p>
<pre><code class="language-java">bb1payopx1.setTrsAmt(bankOrder.getAmt() + "");
// 100 万以下走 R-实时转账,≥100 万走 Q-快速转账
if (bankOrder.getAmt() &lt; 100000000L) {
    ...
</code></pre>
<p>或者定义一个常量。</p>
<pre><code class="language-java">public static final long ONE_MILLION_YUAN = 1000000L; // 或命名为 YUAN_100W

...
bb1payopx1.setTrsAmt(bankOrder.getAmt() + "");
if (bankOrder.getAmt() &lt; ONE_MILLION_YUAN * 100) {
    ...
</code></pre>
<br>
<p>当然, 除此之外,你还有什么更好的实践?</p>
<p><img src="https://img2024.cnblogs.com/blog/202192/202504/202192-20250422211833634-1817607181.png" alt="image" loading="lazy"></p>
<p><br><br><br></p>
<hr>
<p>分享我的good-practice。</p>
<p><strong>实践一:使用Java 7 开始引入的“语法糖”——数字分隔符,告别数零(数是数羊的数)。</strong></p>
<pre><code class="language-java">bb1payopx1.setTrsAmt(bankOrder.getAmt() + "");
if (bankOrder.getAmt() &lt; 100 * 1_000_000) {
    ...
</code></pre>
<p><strong>实践二:使用Money类,一目了然。</strong></p>
<pre><code class="language-java">bb1payopx1.setTrsAmt(bankOrder.getAmt() + "");
if (bankOrder.getAmt() &lt; Money.ofYuan(1_000_000).fen()) {
    ...
</code></pre>


</div>
<div id="MySignature" role="contentinfo">
    <hr class="signhr"><p style="text-indent:2em;font-size:12px;text-align:center">当看到一些不好的代码时,会发现我还算优秀;当看到优秀的代码时,也才意识到持续学习的重要!--buguge<br>本文来自博客园,转载请注明原文链接:https://www.cnblogs.com/buguge/p/19034109</p><hr class="signhr">
<style>hr.signhr{width:80%;margin:0 auto;border: 0;height: 4px;background-image: linear-gradient(to right, rgba(0, 0, 0, 0), rgba(0, 0, 0, 0.75), rgba(0, 0, 0, 0))}</style><br><br>
来源:https://www.cnblogs.com/buguge/p/19034109
頁: [1]
查看完整版本: 一个表示金额的数字是 100000000L,这是多少米(多少钱)?【代码可读性实践】