转载自  http://macrochen.iteye.com/blog/1393502

每天在写Java程序,其实里面有一些细节大家可能没怎么注意,这不,有人总结了一个我们编程中常见的问题。虽然一般没有什么大问题,但是最好别这样做。另外这里提到的很多问题其实可以通过Findbugs( http://findbugs.sourceforge.net/ )来帮我们进行检查出来。

字符串连接误用

错误的写法:

  1. String s = "";
  2. for (Person p : persons) {
  3. s += ", " + p.getName();
  4. }
  5. s = s.substring(2); //remove first comma

正确的写法:

  1. StringBuilder sb = new StringBuilder(persons.size() * 16); // well estimated buffer
  2. for (Person p : persons) {
  3. if (sb.length() > 0) sb.append(", ");
  4. sb.append(p.getName);
  5. }

错误的使用StringBuffer

错误的写法:

  1. StringBuffer sb = new StringBuffer();
  2. sb.append("Name: ");
  3. sb.append(name + '\n');
  4. sb.append("!");
  5. ...
  6. String s = sb.toString();

问题在第三行,append char比String性能要好,另外就是初始化StringBuffer没有指定size,导致中间append时可能重新调整内部数组大小。如果是 JDK1.5最好用StringBuilder取代StringBuffer,除非有线程安全的要求。还有一种方式就是可以直接连接字符串。缺点就是无法 初始化时指定长度。

正确的写法:

  1. StringBuilder sb = new StringBuilder(100);
  2. sb.append("Name: ");
  3. sb.append(name);
  4. sb.append("\n!");
  5. String s = sb.toString();

或者这样写:

  1. String s = "Name: " + name + "\n!";

测试字符串相等性

错误的写法:

  1. if (name.compareTo("John") == 0) ...
  2. if (name == "John") ...
  3. if (name.equals("John")) ...
  4. if ("".equals(name)) ...

上面的代码没有错,但是不够好。compareTo不够简洁,==原义是比较两个对象是否一样。另外比较字符是否为空,最好判断它的长度。

正确的写法:

  1. if ("John".equals(name)) ...
  2. if (name.length() == 0) ...
  3. if (name.isEmpty()) ...

数字转换成字符串

错误的写法:

  1. "" + set.size()
  2. new Integer(set.size()).toString()

正确的写法:

  1. String.valueOf(set.size())

利用不可变对象(Immutable)

错误的写法:

  1. zero = new Integer(0);
  2. return Boolean.valueOf("true");

正确的写法:

  1. zero = Integer.valueOf(0);
  2. return Boolean.TRUE;

请使用XML解析器

错误的写法:

  1. int start = xml.indexOf("<name>") + "<name>".length();
  2. int end = xml.indexOf("</name>");
  3. String name = xml.substring(start, end);

正确的写法:

  1. SAXBuilder builder = new SAXBuilder(false);
  2. Document doc = doc = builder.build(new StringReader(xml));
  3. String name = doc.getRootElement().getChild("name").getText();

请使用JDom组装XML

错误的写法:

  1. String name = ...
  2. String attribute = ...
  3. String xml = "<root>"
  4. +"<name att=\""+ attribute +"\">"+ name +"</name>"
  5. +"</root>";

正确的写法:

  1. Element root = new Element("root");
  2. root.setAttribute("att", attribute);
  3. root.setText(name);
  4. Document doc = new Documet();
  5. doc.setRootElement(root);
  6. XmlOutputter out = new XmlOutputter(Format.getPrettyFormat());
  7. String xml = out.outputString(root);

XML编码陷阱

错误的写法:

  1. String xml = FileUtils.readTextFile("my.xml");

因为xml的编码在文件中指定的,而在读文件的时候必须指定编码。另外一个问题不能一次就将一个xml文件用String保存,这样对内存会造成不必要的浪费,正确的做法用InputStream来边读取边处理。为了解决编码的问题, 最好使用XML解析器来处理。

未指定字符编码

错误的写法:

  1. Reader r = new FileReader(file);
  2. Writer w = new FileWriter(file);
  3. Reader r = new InputStreamReader(inputStream);
  4. Writer w = new OutputStreamWriter(outputStream);
  5. String s = new String(byteArray); // byteArray is a byte[]
  6. byte[] a = string.getBytes();

这样的代码主要不具有跨平台可移植性。因为不同的平台可能使用的是不同的默认字符编码。

正确的写法:

  1. Reader r = new InputStreamReader(new FileInputStream(file), "ISO-8859-1");
  2. Writer w = new OutputStreamWriter(new FileOutputStream(file), "ISO-8859-1");
  3. Reader r = new InputStreamReader(inputStream, "UTF-8");
  4. Writer w = new OutputStreamWriter(outputStream, "UTF-8");
  5. String s = new String(byteArray, "ASCII");
  6. byte[] a = string.getBytes("ASCII");

未对数据流进行缓存

错误的写法:

  1. InputStream in = new FileInputStream(file);
  2. int b;
  3. while ((b = in.read()) != -1) {
  4. ...
  5. }

上面的代码是一个byte一个byte的读取,导致频繁的本地JNI文件系统访问,非常低效,因为调用本地方法是非常耗时的。最好用 BufferedInputStream包装一下。曾经做过一个测试,从/dev/zero下读取1MB,大概花了1s,而用 BufferedInputStream包装之后只需要60ms,性能提高了94%! 这个也适用于output stream操作以及socket操作。

正确的写法:

  1. InputStream in = new BufferedInputStream(new FileInputStream(file));

无限使用heap内存

错误的写法:

  1. byte[] pdf = toPdf(file);

这里有一个前提,就是文件大小不能讲JVM的heap撑爆。否则就等着OOM吧,尤其是在高并发的服务器端代码。最好的做法是采用Stream的方式边读取边存储(本地文件或database)。

正确的写法:

  1. File pdf = toPdf(file);

另外,对于服务器端代码来说,为了系统的安全,至少需要对文件的大小进行限制。

不指定超时时间

错误的代码:

  1. Socket socket = ...
  2. socket.connect(remote);
  3. InputStream in = socket.getInputStream();
  4. int i = in.read();

这种情况在工作中已经碰到不止一次了。个人经验一般超时不要超过20s。这里有一个问题,connect可以指定超时时间,但是read无法指定超时时间。但是可以设置阻塞(block)时间。

正确的写法:

  1. Socket socket = ...
  2. socket.connect(remote, 20000); // fail after 20s
  3. InputStream in = socket.getInputStream();
  4. socket.setSoTimeout(15000);
  5. int i = in.read();

另外,文件的读取(FileInputStream, FileChannel, FileDescriptor, File)没法指定超时时间, 而且IO操作均涉及到本地方法调用, 这个更操作了JVM的控制范围,在分布式文件系统中,对IO的操作内部实际上是网络调用。一般情况下操作60s的操作都可以认为已经超时了。为了解决这些 问题,一般采用缓存和异步/消息队列处理。

频繁使用计时器

错误代码:

  1. for (...) {
  2. long t = System.currentTimeMillis();
  3. long t = System.nanoTime();
  4. Date d = new Date();
  5. Calendar c = new GregorianCalendar();
  6. }

每次new一个Date或Calendar都会涉及一次本地调用来获取当前时间(尽管这个本地调用相对其他本地方法调用要快)。
如果对时间不是特别敏感,这里使用了clone方法来新建一个Date实例。这样相对直接new要高效一些。

正确的写法:

  1. Date d = new Date();
  2. for (E entity : entities) {
  3. entity.doSomething();
  4. entity.setUpdated((Date) d.clone());
  5. }

如果循环操作耗时较长(超过几ms),那么可以采用下面的方法,立即创建一个Timer,然后定期根据当前时间更新时间戳,在我的系统上比直接new一个时间对象快200倍:

  1. private volatile long time;
  2. Timer timer = new Timer(true);
  3. try {
  4. time = System.currentTimeMillis();
  5. timer.scheduleAtFixedRate(new TimerTask() {
  6. public void run() {
  7. time = System.currentTimeMillis();
  8. }
  9. }, 0L, 10L); // granularity 10ms
  10. for (E entity : entities) {
  11. entity.doSomething();
  12. entity.setUpdated(new Date(time));
  13. }
  14. } finally {
  15. timer.cancel();
  16. }

捕获所有的异常

错误的写法:

  1. Query q = ...
  2. Person p;
  3. try {
  4. p = (Person) q.getSingleResult();
  5. } catch(Exception e) {
  6. p = null;
  7. }

这是EJB3的一个查询操作,可能出现异常的原因是:结果不唯一;没有结果;数据库无法访问,而捕获所有的异常,设置为null将掩盖各种异常情况。

正确的写法:

  1. Query q = ...
  2. Person p;
  3. try {
  4. p = (Person) q.getSingleResult();
  5. } catch(NoResultException e) {
  6. p = null;
  7. }

忽略所有异常

错误的写法:

  1. try {
  2. doStuff();
  3. } catch(Exception e) {
  4. log.fatal("Could not do stuff");
  5. }
  6. doMoreStuff();

这个代码有两个问题, 一个是没有告诉调用者, 系统调用出错了. 第二个是日志没有出错原因, 很难跟踪定位问题。

正确的写法:

  1. try {
  2. doStuff();
  3. } catch(Exception e) {
  4. throw new MyRuntimeException("Could not do stuff because: "+ e.getMessage, e);
  5. }

重复包装RuntimeException

错误的写法:

  1. try {
  2. doStuff();
  3. } catch(Exception e) {
  4. throw new RuntimeException(e);
  5. }

正确的写法:

  1. try {
  2. doStuff();
  3. } catch(RuntimeException e) {
  4. throw e;
  5. } catch(Exception e) {
  6. throw new RuntimeException(e.getMessage(), e);
  7. }
  8. try {
  9. doStuff();
  10. } catch(IOException e) {
  11. throw new RuntimeException(e.getMessage(), e);
  12. } catch(NamingException e) {
  13. throw new RuntimeException(e.getMessage(), e);
  14. }

不正确的传播异常

错误的写法:

  1. try {
  2. } catch(ParseException e) {
  3. throw new RuntimeException();
  4. throw new RuntimeException(e.toString());
  5. throw new RuntimeException(e.getMessage());
  6. throw new RuntimeException(e);
  7. }

主要是没有正确的将内部的错误信息传递给调用者. 第一个完全丢掉了内部错误信息, 第二个错误信息依赖toString方法, 如果没有包含最终的嵌套错误信息, 也会出现丢失, 而且可读性差. 第三个稍微好一些, 第四个跟第二个一样。

正确的写法:

  1. try {
  2. } catch(ParseException e) {
  3. throw new RuntimeException(e.getMessage(), e);
  4. }

用日志记录异常

错误的写法:

  1. try {
  2. ...
  3. } catch(ExceptionA e) {
  4. log.error(e.getMessage(), e);
  5. throw e;
  6. } catch(ExceptionB e) {
  7. log.error(e.getMessage(), e);
  8. throw e;
  9. }

一般情况下在日志中记录异常是不必要的, 除非调用方没有记录日志。

异常处理不彻底

错误的写法:

  1. try {
  2. is = new FileInputStream(inFile);
  3. os = new FileOutputStream(outFile);
  4. } finally {
  5. try {
  6. is.close();
  7. os.close();
  8. } catch(IOException e) {
  9. /* we can't do anything */
  10. }
  11. }

is可能close失败, 导致os没有close

正确的写法:

  1. try {
  2. is = new FileInputStream(inFile);
  3. os = new FileOutputStream(outFile);
  4. } finally {
  5. try { if (is != null) is.close(); } catch(IOException e) {/* we can't do anything */}
  6. try { if (os != null) os.close(); } catch(IOException e) {/* we can't do anything */}
  7. }

捕获不可能出现的异常

错误的写法:

  1. try {
  2. ... do risky stuff ...
  3. } catch(SomeException e) {
  4. // never happens
  5. }
  6. ... do some more ...

正确的写法:

  1. try {
  2. ... do risky stuff ...
  3. } catch(SomeException e) {
  4. // never happens hopefully
  5. throw new IllegalStateException(e.getMessage(), e); // crash early, passing all information
  6. }
  7. ... do some more ...

transient的误用

错误的写法:

  1. public class A implements Serializable {
  2. private String someState;
  3. private transient Log log = LogFactory.getLog(getClass());
  4. public void f() {
  5. log.debug("enter f");
  6. ...
  7. }
  8. }

这里的本意是不希望Log对象被序列化. 不过这里在反序列化时, 会因为log未初始化, 导致f()方法抛空指针, 正确的做法是将log定义为静态变量或者定位为具备变量。

正确的写法:

  1. public class A implements Serializable {
  2. private String someState;
  3. private static final Log log = LogFactory.getLog(A.class);
  4. public void f() {
  5. log.debug("enter f");
  6. ...
  7. }
  8. }
  9. public class A implements Serializable {
  10. private String someState;
  11. public void f() {
  12. Log log = LogFactory.getLog(getClass());
  13. log.debug("enter f");
  14. ...
  15. }
  16. }

不必要的初始化

错误的写法:

  1. public class B {
  2. private int count = 0;
  3. private String name = null;
  4. private boolean important = false;
  5. }

这里的变量会在初始化时使用默认值:0, null, false, 因此上面的写法有些多此一举。

正确的写法:

  1. public class B {
  2. private int count;
  3. private String name;
  4. private boolean important;
  5. }

最好用静态final定义Log变量

  1. private static final Log log = LogFactory.getLog(MyClass.class);

这样做的好处有三:

  • 可以保证线程安全
  • 静态或非静态代码都可用
  • 不会影响对象序列化

选择错误的类加载器

错误的代码:

  1. Class clazz = Class.forName(name);
  2. Class clazz = getClass().getClassLoader().loadClass(name);

这里本意是希望用当前类来加载希望的对象, 但是这里的getClass()可能抛出异常, 特别在一些受管理的环境中, 比如应用服务器, web容器, Java WebStart环境中, 最好的做法是使用当前应用上下文的类加载器来加载。

正确的写法:

  1. ClassLoader cl = Thread.currentThread().getContextClassLoader();
  2. if (cl == null) cl = MyClass.class.getClassLoader(); // fallback
  3. Class clazz = cl.loadClass(name);

反射使用不当

错误的写法:

  1. Class beanClass = ...
  2. if (beanClass.newInstance() instanceof TestBean) ...

这里的本意是检查beanClass是否是TestBean或是其子类, 但是创建一个类实例可能没那么简单, 首先实例化一个对象会带来一定的消耗, 另外有可能类没有定义默认构造函数. 正确的做法是用Class.isAssignableFrom(Class) 方法。

正确的写法:

  1. Class beanClass = ...
  2. if (TestBean.class.isAssignableFrom(beanClass)) ...

不必要的同步

错误的写法:

  1. Collection l = new Vector();
  2. for (...) {
  3. l.add(object);
  4. }

Vector是ArrayList同步版本。

正确的写法:

  1. Collection l = new ArrayList();
  2. for (...) {
  3. l.add(object);
  4. }

错误的选择List类型

根据下面的表格数据来进行选择

  ArrayList LinkedList
add (append) O(1) or ~O(log(n)) if growing O(1)
insert (middle) O(n) or ~O(n*log(n)) if growing O(n)
remove (middle) O(n) (always performs complete copy) O(n)
iterate O(n) O(n)
get by index O(1) O(n)

 HashMap size陷阱

错误的写法:

  1. Map map = new HashMap(collection.size());
  2. for (Object o : collection) {
  3. map.put(o.key, o.value);
  4. }

这里可以参考guava的Maps.newHashMapWithExpectedSize的实现. 用户的本意是希望给HashMap设置初始值, 避免扩容(resize)的开销. 但是没有考虑当添加的元素数量达到HashMap容量的75%时将出现resize。

正确的写法:

  1. Map map = new HashMap(1 + (int) (collection.size() / 0.75));

对Hashtable, HashMap 和 HashSet了解不够

这里主要需要了解HashMap和Hashtable的内部实现上, 它们都使用Entry包装来封装key/value, Entry内部除了要保存Key/Value的引用, 还需要保存hash桶中next Entry的应用, 因此对内存会有不小的开销, 而HashSet内部实现其实就是一个HashMap. 有时候IdentityHashMap可以作为一个不错的替代方案. 它在内存使用上更有效(没有用Entry封装, 内部采用Object[]). 不过需要小心使用. 它的实现违背了Map接口的定义. 有时候也可以用ArrayList来替换HashSet.

这一切的根源都是由于JDK内部没有提供一套高效的Map和Set实现。

对List的误用

建议下列场景用Array来替代List:

  • list长度固定,比如一周中的每一天
  • 对list频繁的遍历,比如超过1w次
  • 需要对数字进行包装(主要JDK没有提供基本类型的List)

比如下面的代码。

错误的写法:

  1. List<Integer> codes = new ArrayList<Integer>();
  2. codes.add(Integer.valueOf(10));
  3. codes.add(Integer.valueOf(20));
  4. codes.add(Integer.valueOf(30));
  5. codes.add(Integer.valueOf(40));

正确的写法:

  1. int[] codes = { 10, 20, 30, 40 };

错误的写法:

  1. // horribly slow and a memory waster if l has a few thousand elements (try it yourself!)
  2. List<Mergeable> l = ...;
  3. for (int i=0; i < l.size()-1; i++) {
  4. Mergeable one = l.get(i);
  5. Iterator<Mergeable> j = l.iterator(i+1); // memory allocation!
  6. while (j.hasNext()) {
  7. Mergeable other = l.next();
  8. if (one.canMergeWith(other)) {
  9. one.merge(other);
  10. other.remove();
  11. }
  12. }
  13. }

正确的写法:

  1. // quite fast and no memory allocation
  2. Mergeable[] l = ...;
  3. for (int i=0; i < l.length-1; i++) {
  4. Mergeable one = l[i];
  5. for (int j=i+1; j < l.length; j++) {
  6. Mergeable other = l[j];
  7. if (one.canMergeWith(other)) {
  8. one.merge(other);
  9. l[j] = null;
  10. }
  11. }
  12. }

实际上Sun也意识到这一点, 因此在JDK中, Collections.sort()就是将一个List拷贝到一个数组中然后调用Arrays.sort方法来执行排序。

用数组来描述一个结构

错误用法:

  1. /**
  2. * @returns [1]: Location, [2]: Customer, [3]: Incident
  3. */
  4. Object[] getDetails(int id) {...

这里用数组+文档的方式来描述一个方法的返回值. 虽然很简单, 但是很容易误用, 正确的做法应该是定义个类。

正确的写法:

  1. Details getDetails(int id) {...}
  2. private class Details {
  3. public Location location;
  4. public Customer customer;
  5. public Incident incident;
  6. }

对方法过度限制

错误用法:

  1. public void notify(Person p) {
  2. ...
  3. sendMail(p.getName(), p.getFirstName(), p.getEmail());
  4. ...
  5. }
  6. class PhoneBook {
  7. String lookup(String employeeId) {
  8. Employee emp = ...
  9. return emp.getPhone();
  10. }
  11. }

第一个例子是对方法参数做了过多的限制, 第二个例子对方法的返回值做了太多的限制。

正确的写法:

  1. public void notify(Person p) {
  2. ...
  3. sendMail(p);
  4. ...
  5. }
  6. class EmployeeDirectory {
  7. Employee lookup(String employeeId) {
  8. Employee emp = ...
  9. return emp;
  10. }
  11. }

对POJO的setter方法画蛇添足

错误的写法:

  1. private String name;
  2. public void setName(String name) {
  3. this.name = name.trim();
  4. }
  5. public void String getName() {
  6. return this.name;
  7. }

有时候我们很讨厌字符串首尾出现空格, 所以在setter方法中进行了trim处理, 但是这样做的结果带来的副作用会使getter方法的返回值和setter方法不一致, 如果只是将JavaBean当做一个数据容器, 那么最好不要包含任何业务逻辑. 而将业务逻辑放到专门的业务层或者控制层中处理。

正确的做法:

  1. person.setName(textInput.getText().trim());

日历对象(Calendar)误用

错误的写法:

  1. Calendar cal = new GregorianCalender(TimeZone.getTimeZone("Europe/Zurich"));
  2. cal.setTime(date);
  3. cal.add(Calendar.HOUR_OF_DAY, 8);
  4. date = cal.getTime();

这里主要是对date, time, calendar和time zone不了解导致. 而在一个时间上增加8小时, 跟time zone没有任何关系, 所以没有必要使用Calendar, 直接用Date对象即可, 而如果是增加天数的话, 则需要使用Calendar, 因为采用不同的时令制可能一天的小时数是不同的(比如有些DST是23或者25个小时)

正确的写法:

  1. date = new Date(date.getTime() + 8L * 3600L * 1000L); // add 8 hrs

TimeZone的误用

错误的写法:

  1. Calendar cal = new GregorianCalendar();
  2. cal.setTime(date);
  3. cal.set(Calendar.HOUR_OF_DAY, 0);
  4. cal.set(Calendar.MINUTE, 0);
  5. cal.set(Calendar.SECOND, 0);
  6. Date startOfDay = cal.getTime();

这里有两个错误, 一个是没有没有将毫秒归零, 不过最大的错误是没有指定TimeZone, 不过一般的桌面应用没有问题, 但是如果是服务器端应用则会有一些问题, 比如同一时刻在上海和伦敦就不一样, 因此需要指定的TimeZone.

正确的写法:

  1. Calendar cal = new GregorianCalendar(user.getTimeZone());
  2. cal.setTime(date);
  3. cal.set(Calendar.HOUR_OF_DAY, 0);
  4. cal.set(Calendar.MINUTE, 0);
  5. cal.set(Calendar.SECOND, 0);
  6. cal.set(Calendar.MILLISECOND, 0);
  7. Date startOfDay = cal.getTime();

时区(Time Zone)调整的误用

错误的写法:

  1. public static Date convertTz(Date date, TimeZone tz) {
  2. Calendar cal = Calendar.getInstance();
  3. cal.setTimeZone(TimeZone.getTimeZone("UTC"));
  4. cal.setTime(date);
  5. cal.setTimeZone(tz);
  6. return cal.getTime();
  7. }

这个方法实际上没有改变时间, 输入和输出是一样的. 关于时间的问题可以参考这篇文章: http://www.odi.ch/prog/design/datetime.php 这里主要的问题是Date对象并不包含Time Zone信息. 它总是使用UTC(世界统一时间). 而调用Calendar的getTime/setTime方法会自动在当前时区和UTC之间做转换。

Calendar.getInstance()的误用

错误的写法:

  1. Calendar c = Calendar.getInstance();
  2. c.set(2009, Calendar.JANUARY, 15);

Calendar.getInstance()依赖local来选择一个Calendar实现, 不同实现的2009年是不同的, 比如有些Calendar实现就没有January月份。

正确的写法:

  1. Calendar c = new GregorianCalendar(timeZone);
  2. c.set(2009, Calendar.JANUARY, 15);

Date.setTime()的误用

错误的写法:

  1. account.changePassword(oldPass, newPass);
  2. Date lastmod = account.getLastModified();
  3. lastmod.setTime(System.currentTimeMillis());

在更新密码之后, 修改一下最后更新时间, 这里的用法没有错,但是有更好的做法: 直接传Date对象. 因为Date是Value Object, 不可变的. 如果更新了Date的值, 实际上是生成一个新的Date实例. 这样其他地方用到的实际上不在是原来的对象, 这样可能出现不可预知的异常. 当然这里又涉及到另外一个OO设计的问题, 对外暴露Date实例本身就是不好的做法(一般的做法是在setter方法中设置Date引用参数的clone对象). 另外一种比较好的做法就是直接保存long类型的毫秒数。

正确的做法:

  1. account.changePassword(oldPass, newPass);
  2. account.setLastModified(new Date());

SimpleDateFormat非线程安全误用

错误的写法:

  1. public class Constants {
  2. public static final SimpleDateFormat date = new SimpleDateFormat("dd.MM.yyyy");
  3. }

SimpleDateFormat不是线程安全的. 在多线程并行处理的情况下, 会得到非预期的值. 这个错误非常普遍! 如果真要在多线程环境下公用同一个SimpleDateFormat, 那么做好做好同步(cache flush, lock contention), 但是这样会搞得更复杂, 还不如直接new一个实在。

使用全局参数配置常量类/接口

  1. public interface Constants {
  2. String version = "1.0";
  3. String dateFormat = "dd.MM.yyyy";
  4. String configFile = ".apprc";
  5. int maxNameLength = 32;
  6. String someQuery = "SELECT * FROM ...";
  7. }

很多应用都会定义这样一个全局常量类或接口, 但是为什么这种做法不推荐? 因为这些常量之间基本没有任何关联, 只是因为公用才定义在一起. 但是如果其他组件需要使用这些全局变量, 则必须对该常量类产生依赖, 特别是存在server和远程client调用的场景。

比较好的做法是将这些常量定义在组件内部. 或者局限在一个类库内部。

忽略造型溢出(cast overflow)

错误的写法:

  1. public int getFileSize(File f) {
  2. long l = f.length();
  3. return (int) l;
  4. }

这个方法的本意是不支持传递超过2GB的文件. 最好的做法是对长度进行检查, 溢出时抛出异常。

正确的写法:

  1. public int getFileSize(File f) {
  2. long l = f.length();
  3. if (l > Integer.MAX_VALUE) throw new IllegalStateException("int overflow");
  4. return (int) l;
  5. }

另一个溢出bug是cast的对象不对, 比如下面第一个println. 正确的应该是下面的那个。

  1. long a = System.currentTimeMillis();
  2. long b = a + 100;
  3. System.out.println((int) b-a);
  4. System.out.println((int) (b-a));

对float和double使用==操作

错误的写法:

  1. for (float f = 10f; f!=0; f-=0.1) {
  2. System.out.println(f);
  3. }

上面的浮点数递减只会无限接近0而不会等于0, 这样会导致上面的for进入死循环. 通常绝不要对float和double使用==操作. 而采用大于和小于操作. 如果java编译器能针对这种情况给出警告. 或者在java语言规范中不支持浮点数类型的==操作就最好了。

正确的写法:

  1. for (float f = 10f; f>0; f-=0.1) {
  2. System.out.println(f);
  3. }

用浮点数来保存money

错误的写法:

  1. float total = 0.0f;
  2. for (OrderLine line : lines) {
  3. total += line.price * line.count;
  4. }
  5. double a = 1.14 * 75; // 85.5 将表示为 85.4999...
  6. System.out.println(Math.round(a)); // 输出值为85
  7. BigDecimal d = new BigDecimal(1.14); //造成精度丢失

这个也是一个老生常谈的错误. 比如计算100笔订单, 每笔0.3元, 最终的计算结果是29.9999971. 如果将float类型改为double类型, 得到的结果将是30.000001192092896. 出现这种情况的原因是, 人类和计算的计数方式不同. 人类采用的是十进制, 而计算机是二进制.二进制对于计算机来说非常好使, 但是对于涉及到精确计算的场景就会带来误差. 比如银行金融中的应用。

因此绝不要用浮点类型来保存money数据. 采用浮点数得到的计算结果是不精确的. 即使与int类型做乘法运算也会产生一个不精确的结果.那是因为在用二进制存储一个浮点数时已经出现了精度丢失. 最好的做法就是用一个string或者固定点数来表示. 为了精确, 这种表示方式需要指定相应的精度值.
BigDecimal就满足了上面所说的需求. 如果在计算的过程中精度的丢失超出了给定的范围, 将抛出runtime exception.

正确的写法:

  1. BigDecimal total = BigDecimal.ZERO;
  2. for (OrderLine line : lines) {
  3. BigDecimal price = new BigDecimal(line.price);
  4. BigDecimal count = new BigDecimal(line.count);
  5. total = total.add(price.multiply(count)); // BigDecimal is immutable!
  6. }
  7. total = total.setScale(2, RoundingMode.HALF_UP);
  8. BigDecimal a = (new BigDecimal("1.14")).multiply(new BigDecimal(75)); // 85.5 exact
  9. a = a.setScale(0, RoundingMode.HALF_UP); // 86
  10. System.out.println(a); // correct output: 86
  11. BigDecimal a = new BigDecimal("1.14");

不使用finally块释放资源

错误的写法:

  1. public void save(File f) throws IOException {
  2. OutputStream out = new BufferedOutputStream(new FileOutputStream(f));
  3. out.write(...);
  4. out.close();
  5. }
  6. public void load(File f) throws IOException {
  7. InputStream in = new BufferedInputStream(new FileInputStream(f));
  8. in.read(...);
  9. in.close();
  10. }

上面的代码打开一个文件输出流, 操作系统为其分配一个文件句柄, 但是文件句柄是一种非常稀缺的资源, 必须通过调用相应的close方法来被正确的释放回收. 而为了保证在异常情况下资源依然能被正确回收, 必须将其放在finally block中. 上面的代码中使用了BufferedInputStream将file stream包装成了一个buffer stream, 这样将导致在调用close方法时才会将buffer stream写入磁盘. 如果在close的时候失败, 将导致写入数据不完全. 而对于FileInputStream在finally block的close操作这里将直接忽略。

如果BufferedOutputStream.close()方法执行顺利则万事大吉, 如果失败这里有一个潜在的bug(http://bugs.sun.com/view_bug.do?bug_id=6335274): 在close方法内部调用flush操作的时候, 如果出现异常, 将直接忽略. 因此为了尽量减少数据丢失, 在执行close之前显式的调用flush操作。

下面的代码有一个小小的瑕疵: 如果分配file stream成功, 但是分配buffer stream失败(OOM这种场景), 将导致文件句柄未被正确释放. 不过这种情况一般不用担心, 因为JVM的gc将帮助我们做清理。

  1. // code for your cookbook
  2. public void save() throws IOException {
  3. File f = ...
  4. OutputStream out = new BufferedOutputStream(new FileOutputStream(f));
  5. try {
  6. out.write(...);
  7. out.flush(); // don't lose exception by implicit flush on close
  8. } finally {
  9. out.close();
  10. }
  11. }
  12. public void load(File f) throws IOException {
  13. InputStream in = new BufferedInputStream(new FileInputStream(f));
  14. try {
  15. in.read(...);
  16. } finally {
  17. try { in.close(); } catch (IOException e) { }
  18. }
  19. }

数据库访问也涉及到类似的情况:

  1. Car getCar(DataSource ds, String plate) throws SQLException {
  2. Car car = null;
  3. Connection c = null;
  4. PreparedStatement s = null;
  5. ResultSet rs = null;
  6. try {
  7. c = ds.getConnection();
  8. s = c.prepareStatement("select make, color from cars where plate=?");
  9. s.setString(1, plate);
  10. rs = s.executeQuery();
  11. if (rs.next()) {
  12. car = new Car();
  13. car.make = rs.getString(1);
  14. car.color = rs.getString(2);
  15. }
  16. } finally {
  17. if (rs != null) try { rs.close(); } catch (SQLException e) { }
  18. if (s != null) try { s.close(); } catch (SQLException e) { }
  19. if (c != null) try { c.close(); } catch (SQLException e) { }
  20. }
  21. return car;
  22. }

finalize方法误用

错误的写法:

  1. public class FileBackedCache {
  2. private File backingStore;
  3. ...
  4. protected void finalize() throws IOException {
  5. if (backingStore != null) {
  6. backingStore.close();
  7. backingStore = null;
  8. }
  9. }
  10. }

这个问题Effective Java这本书有详细的说明. 主要是finalize方法依赖于GC的调用, 其调用时机可能是立马也可能是几天以后, 所以是不可预知的. 而JDK的API文档中对这一点有误导:建议在该方法中来释放I/O资源。

正确的做法是定义一个close方法, 然后由外部的容器来负责调用释放资源。

  1. public class FileBackedCache {
  2. private File backingStore;
  3. ...
  4. public void close() throws IOException {
  5. if (backingStore != null) {
  6. backingStore.close();
  7. backingStore = null;
  8. }
  9. }
  10. }

在JDK 1.7 (Java 7)中已经引入了一个AutoClosable接口. 当变量(不是对象)超出了try-catch的资源使用范围, 将自动调用close方法。

  1. try (Writer w = new FileWriter(f)) { // implements Closable
  2. w.write("abc");
  3. // w goes out of scope here: w.close() is called automatically in ANY case
  4. } catch (IOException e) {
  5. throw new RuntimeException(e.getMessage(), e);
  6. }

Thread.interrupted方法误用

错误的写法:

  1. try {
  2. Thread.sleep(1000);
  3. } catch (InterruptedException e) {
  4. // ok
  5. }
  6. or
  7. while (true) {
  8. if (Thread.interrupted()) break;
  9. }

这里主要是interrupted静态方法除了返回当前线程的中断状态, 还会将当前线程状态复位。

正确的写法:

  1. try {
  2. Thread.sleep(1000);
  3. } catch (InterruptedException e) {
  4. Thread.currentThread().interrupt();
  5. }
  6. or
  7. while (true) {
  8. if (Thread.currentThread().isInterrupted()) break;
  9. }

在静态变量初始化时创建线程

错误的写法:

  1. class Cache {
  2. private static final Timer evictor = new Timer();
  3. }

Timer构造器内部会new一个thread, 而该thread会从它的父线程(即当前线程)中继承各种属性。比如context classloader, threadlocal以及其他的安全属性(访问权限)。 而加载当前类的线程可能是不确定的,比如一个线程池中随机的一个线程。如果你需要控制线程的属性,最好的做法就是将其初始化操作放在一个静态方法中,这样 初始化将由它的调用者来决定。

正确的做法:

  1. class Cache {
  2. private static Timer evictor;
  3. public static setupEvictor() {
  4. evictor = new Timer();
  5. }
  6. }

已取消的定时器任务依然持有状态

错误的写法:

  1. final MyClass callback = this;
  2. TimerTask task = new TimerTask() {
  3. public void run() {
  4. callback.timeout();
  5. }
  6. };
  7. timer.schedule(task, 300000L);
  8. try {
  9. doSomething();
  10. } finally {
  11. task.cancel();
  12. }

上面的task内部包含一个对外部类实例的应用, 这将导致该引用可能不会被GC立即回收. 因为Timer将保留TimerTask在指定的时间之后才被释放. 因此task对应的外部类实例将在5分钟后被回收。

正确的写法:

    1. TimerTask task = new Job(this);
    2. timer.schedule(task, 300000L);
    3. try {
    4. doSomething();
    5. } finally {
    6. task.cancel();
    7. }
    8. static class Job extends TimerTask {
    9. private MyClass callback;
    10. public Job(MyClass callback) {
    11. this.callback = callback;
    12. }
    13. public boolean cancel() {
    14. callback = null;
    15. return super.cancel();
    16. }
    17. public void run() {
    18. if (callback == null) return;
    19. callback.timeout();
    20. }
    21. }

Java编程最差实践(常见编程错误典范)的更多相关文章

  1. Java编程最差实践常见问题详细说明(1)转

    Java编程最差实践常见问题详细说明(1)转     原文地址:http://www.odi.ch/prog/design/newbies.php 每天在写Java程序, 其实里面有一些细节大家可能没 ...

  2. Java编程最差实践常见问题详细说明(2)转

    Java编程最差实践常见问题详细说明(2)转 2012-12-13 13:57:20|  分类: JAVA |  标签:java  |举报|字号 订阅     反射使用不当  错误的写法: Java代 ...

  3. Java编程最差实践

    原文地址:http://www.odi.ch/prog/design/newbies.php 每天在写Java程序, 其实里面有一些细节大家可能没怎么注意, 这不, 有人总结了一个我们编程中常见的问题 ...

  4. .NET中的异步编程——常见的错误和最佳实践

    在这篇文章中,我们将通过使用异步编程的一些最常见的错误来给你们一些参考. 背景 在之前的文章<.NET中的异步编程——动机和单元测试>中,我们开始分析.NET世界中的异步编程.在那篇文章中 ...

  5. (转载)android开发常见编程错误总结

    首页 › 安卓开发 › android开发 android开发常见编程错误总结 泡在网上的日子 / 文 发表于2013-09-07 13:07  第771次阅读 android,异常 0 编辑推荐:稀 ...

  6. [Java并发编程(四)] Java volatile 的理论实践

    [Java并发编程(四)] Java volatile 的理论实践 摘要 Java 语言中的 volatile 变量可以被看作是一种 "程度较轻的 synchronized":与 ...

  7. javascript编程的最佳实践推荐

    推荐的javascript编程的最佳实践,摘要记录在这里: 可维护的代码保证代码的性能部署代码 1 可维护的代码1.1什么是维护的代码:可理解性——其他人可以接手代码并理解它的意图和一般途径,而无需原 ...

  8. JAVA第十周《网络编程》学习内容总结

    JAVA第十周<网络编程>学习内容总结 学习内容总结 1.初听到网络编程四个字可能会觉得很困难,实际上网络编程就是在两个或两个以上的设备(例如计算机)之间传输数据,把数据发送到指定的位置, ...

  9. Scala函数式编程(五) 函数式的错误处理

    前情提要 Scala函数式编程指南(一) 函数式思想介绍 scala函数式编程(二) scala基础语法介绍 Scala函数式编程(三) scala集合和函数 Scala函数式编程(四)函数式的数据结 ...

随机推荐

  1. C++ code:prime decision

    1 判断一个数是否为素数 对于判断一个数m是否为素数,最朴素的方式是按照素数的定义,试除以从2开始到m-1的整数,倘若无一例外地不能整除,则该数必为素数. #include<iostream&g ...

  2. TensorFlow 框架

    TensorFlow TensorFlow核心程序由2个独立部分组成:   a:Building the computational graph构建计算图   b:Running the comput ...

  3. C#获取路径

    System.Diagnostics.Process.GetCurrentProcess().MainModule.FileName -获取模块的完整路径. System.Environment.Cu ...

  4. poj 3461 (模式串T在主串S中出现的次数)

    求模式串在主串中出现的次数Sample Input 3BAPCBAPCAZAAZAZAZAVERDIAVERDXIVYERDIANSample Output 130 #include <iost ...

  5. Struts2(接受表单参数)请求数据自动封装和数据类型转换

    Struts2请求数据自动封装: (1)实现原理:参数拦截器 (2)方式1:jsp表单数据填充到action中的属性:        普通的成员变量,必须给set,get可以不给的.    注意点,A ...

  6. java加密工具类,可设置对应的加解密key

    public class AesEncryptUtil { //使用AES-128-CBC加密模式,key需要为16位,key和iv可以相同! private static String KEY =& ...

  7. JavaScript开发区块链只需200行代码

    用JavaScript开发实现一个简单区块链.通过这一开发过程,你将理解区块链技术是什么:区块链就是一个分布式数据库,存储结构是一个不断增长的链表,链表中包含着许多有序的记录. 然而,在通常情况下,当 ...

  8. 洛谷 P1135 奇怪的电梯 【基础BFS】

    题目链接:https://www.luogu.org/problemnew/show/P1135 题目描述 呵呵,有一天我做了一个梦,梦见了一种很奇怪的电梯.大楼的每一层楼都可以停电梯,而且第 i 层 ...

  9. IdentityServer4-前后端分离的授权验证(六)

    上两节介绍完Hybrid模式在MVC下的使用,包括验证从数据获取的User和Claim对MVC的身份授权.本节将介绍Implicit模式在JavaScript应用程序中的使用,使用Node.js+Ex ...

  10. Springboot 2.0.x 引入链路跟踪Sleuth及Zipkin

    Zipkin是一种分布式跟踪系统,它有助于收集解决微服务架构中得延迟问题所需的时序数据,它管理这些数据的收集和查找. 1. 架构概述 跟踪器存在于您的应用程序中,并记录有关发生的操作的时间和元数据.他 ...