1700453460
*/
1700453461
1700453462
public static native int trylock（long mutex）；
1700453463
1700453464
}
1700453465
1700453466
（4）TODO注释
1700453467
1700453468
对于一些未完成的任务，则增加上TODO提示，并标明是什么事情没有做完，以方便下次看到这个TODO标记时还能记忆起要做什么事情，比如在DBCP源代码中有这样的TODO注释：
1700453469
1700453470
public class DelegatingStatement extends……implements……{
1700453471
1700453472
/*
1700453473
1700453474
*Note was protected prior to JDBC 4
1700453475
1700453476
*TODO Consider adding build fags to make this protected
1700453477
1700453478
*unless we are using JDBC 4.
1700453479
1700453480
*/
1700453481
1700453482
public boolean isClosed（）throws SQLException{
1700453483
1700453484
return_closed；
1700453485
1700453486
}
1700453487
1700453488
}
1700453489
1700453490
注释只是代码阅读的辅助信息，如果代码的表达能力足够清晰，根本就不需要注释，注释能够帮助我们更好地理解代码，但它所重视的是质量而不是数量。如果一段代码写得很糟糕，即使注解写得再漂亮，也不能解决腐烂代码带来的种种问题，记住，注释不是美化剂，不能美化你的代码，它只是一副催化剂，可以让优秀的代码更加优秀，让拙劣的代码更加腐朽。
1700453491
1700453492
注意 注释不是美化剂，而是催化剂，或为优秀加分，或为拙劣减分。
1700453493
1700453494
1700453495
1700453496
1700453498
编写高质量代码：改善Java程序的151个建议 建议147：让接口的职责保持单一
1700453499
1700453500
一个类所对应的需求功能越多，引起变化的可能性就越大，单一职责原则（Single Responsibility Principle，简称SRP）就是要求我们的接口（或类）尽可能保持单一，它的定义是说“一个类有且仅有一个变化的原因（There should never be more than one reason for a class to change）”，那问题是什么是职责呢？
1700453501
1700453502
职责是一个接口（或类）要承担的业务含义，或是接口（或类）表现出的意图，例如一个User类可以包含写入用户信息到数据库、删除用户、修改用户密码等职责，而一个密码工具类则可以包含解密职责和加密职责。明白了什么是类的职责单一，再来看看它有什么好处。单一职责有以下三个优点：
1700453503
1700453504
（1）类的复杂性降低
1700453505
1700453506
职责单一，在实现什么职责时都有清晰明确的定义，那么接口（或类）的代码量就会减少，复杂度也就会减少。当然，接口（或类）的数量会增加上去，相互间的关系也会更复杂，这就需要适当把握了。
1700453507
1700453508
（2）可读性和可维护性提高
1700453509
[
上一页 ]
[ :1.70045346e+09 ]
[
下一页 ]