理解 Java 中的 NumberFormatException 异常

如果我在 Java 中对字符串和数字直接进行类型转换的话,我们有可能会遇到 NumberFormatException
异常。

介绍

当 Java 在将 String 字符串转换为数字的时候,如果遇到没有办法转换的情况,Java 将会抛出一个 NumberFormatException 异常。

NumberFormatException 这个异常是 Java 中的一个 unchecked 类型异常,因此程序不会被要求强制进行处理。

在本页面中,我们对 NumberFormatException 这个异常进行一些简要说明和我们应该如何避免这个异常。

如何导致 NumberFormatException 异常的

在实际编码过程中,有一些构造方法或者类型转换方法,将会导致这个异常。

对导致这个异常的常见情况,我们在下面的页面中进行一些说明和讨论。

构造函数中

如果我们在构造函数中对不是数字的字符串进行类型转换的话,将会有可能抛出这个异常。

例如我们尝试将一个字符串转换为 IntegerDouble 对象,但是输入的字符串不是数字。

下面 2 个句子将会抛出 NumberFormatException 异常:

Integer aIntegerObj = new Integer("one");
Double doubleDecimalObj = new Double("two.2");

我们如果运行上面的代码,我们可以看到 JDK 将会提示我们没有办法将输入的字符串转换为整数类型。

Exception in thread "main" java.lang.NumberFormatException: For input string: "one"
	at java.lang.NumberFormatException.forInputString(NumberFormatException.java:65)
	at java.lang.Integer.parseInt(Integer.java:580)
	at java.lang.Integer.<init>(Integer.java:867)
	at MainClass.main(MainClass.java:11)

上面的构造方法将会抛出无法将字符串转换为数字的异常。

在调用 parseInt() 内部方法的时候将会提示无法转换的错误。

上面的修改也非常简单,这是因为 Java 的 Number API 不能处理字符串导致的,我们只需要将输入的字符串进行调整,保持为数字类型即可。

使用下面的代码就没有问题了。

Integer aIntegerObj = new Integer("1");
Double doubleDecimalObj = new Double("2.2");

处理非数字类型的方法

与构造方法的错误类似,有些方法在处理的时候也会导致异常。

比如说我们常常会用到的下面的一些方法 par seInt(), parseDouble(), valueOf(), 和 decode()

例如,我们尝试进行下面的一些类型的转换的话,我们有可能遇到与上面相同的方法:

int aIntPrim = Integer.parseInt("two");
double aDoublePrim = Double.parseDouble("two.two");
Integer aIntObj = Integer.valueOf("three");
Long decodedLong = Long.decode("64403L");

这个错误与在上面构造方法中出现的错误是相同的。

我们可以简单的按照错误提示修改输入参数就可以了:

int aIntPrim = Integer.parseInt("2");
double aDoublePrim = Double.parseDouble("2.2");
Integer aIntObj = Integer.valueOf("3");
Long decodedLong = Long.decode("64403");

输入字符串参数有一些奇怪字符

另外,不仅仅是输入字符串本身不是数字的问题,有可能输入的字符串可能有一些奇怪的字符,包括有空格,下划线等。

类型转换函数或者构造函数,本身是不会对输入字符串进行处理的。

Short shortInt = new Short("2 ");
int bIntPrim = Integer.parseInt("_6000");

上面我们代码执行的时候也会遇到相同的问题。

例如第一行代码的主要原因就是因为有空格,我们可以首先对空格进行清理。

针对这种情况,我们首先需要对输入的字符串进行格式化处理,处理掉错误的字符。

Short shortInt = new Short("2 ".trim());
int bIntPrim = Integer.parseInt("_6000".replaceAll("_", ""));
int bIntPrim = Integer.parseInt("-6000");

需要注意的是,上面代码中的第 3 行,我们给出的是一个负数。

在 Java 中,负数是允许的,但是你不能使用下划线,你只能使用中划线。

语言特性的数字格式化

这里我们说的语言特性数字格式化主要是因为不同地区和国家对数字的表达方式是不一样的。

例如,在一些国家 “4000,1 ” 可能也会被用来表示一个小数“4000.1”。

如果你不对你的程序进行配置的话,在默认情况下,你还是会得到一个 NumberFormatException 异常,因为我们的程序没有办法处理以逗号表示为小数点:

double aDoublePrim = Double.parseDouble("4000,1");

因此,我们需要让我们的程序明白,这里的逗号是小数点才能避免这个类型转换错误。

例如,我们可以使用 NumberFormat 将数字处理的地区设置为欧洲地区,那么你的程序将不会提示格式字符的错误。

请考察下面的代码,我们设置为法国以后,就可以运行了:

NumberFormat numberFormat = NumberFormat.getInstance(Locale.FRANCE);
Number parsedNumber = numberFormat.parse("4000,1");
assertEquals(4000.1, parsedNumber.doubleValue());
assertEquals(4000, parsedNumber.intValue());

最佳实践

让我们来看看有可能导致 NumberFormatException 异常的一些原因,和我们应该如何来应对:

  1. Java Number API 不能处理特殊字符,因此不要尝试转换特殊字符。
  2. 你可以使用正则表达式对需要转换的字符串中的特殊字符进行过滤。
  3. 对需要转换的字符串进行一些处理,包括删除空格和对特殊字符串进行替换,删除等。
  4. 在一些特定的情况下,我们还是可以对特殊字符串进行处理的,这个时候你可以使用 NumberFormat 来先进行标记格式。
  5. 使用工具类,例如 NumberUtils.isNumber() 先对字符串进行检查。

总结

在这个页面中,我们对将 String 格式化为数字类型,使用 Java Number API 的方法和可能出现的异常进行了一些说明。

在这里我们看到了常见的导致异常的原因和我们可以避免的办法。

测试源代码

相关的测试源代码,请访问链接:

您也可以 Fork 代码后提交更新。