java中assert的用法理解

本文详细介绍了Java 1.4引入的断言(assertion)机制,包括其语法、使用场景及注意事项。阐述了如何通过断言确保程序的基本正确性,并探讨了断言在不同阶段的启用与禁用策略。

摘要生成于 C知道 ,由 DeepSeek-R1 满血版支持, 前往体验 >

一、assertion的意义和用法
J2SE 1.4在语言上提供了一个新特性,就是assertion功能,它是该版本在Java语言方面最大的革新。
从理论上来说,通过 assertion方式可以证明程序的正确性,但是这是一项相当复杂的工作,目前还没有太多的实践意义。
在实现中,assertion就是在程序中的一条语句,它对一个boolean表达式进行检查,一个正确程序必须保证这个boolean表达式的值为true;如果该值为false,说明程序已经处于不正确的状态下, 系统将给出警告或退出。
一般来说,assertion用于保证程序最基本、关键的正确性。assertion检查通常在开发和测试时开启。为了提高性能,在软件发布后,assertion检查通常是关闭的。
1、语法表示
在语法上,为了支持assertion,Java增加了一个关键字assert。它包括两种表达式,分别如下:
        assert  expression1;
        assert  expression1:expression2;
在两种表达式中,expression1表示一个boolean表达式, expression2表示一个基本类型或者是一个对象(Object),基本类型包括boolean,char,double,float,int和 long。由于所有类都为Object的子类,因此这个参数可以用于所有对象。
2、含义
在运行时,如果关闭了assertion功能,这些语句将不起任何作用。如果打开了assertion功能,那么expression1的值将被计算,如果它的值为false,该语句强抛出一个AssertionError对象。
如果assertion语句包括expression2参数,程序将计算出 expression2的结果,然后将这个结果作为AssertionError的构造函数的参数,来创建AssertionError对象,并抛出该对 象;如果expression1值为true,expression2将不被计算。
一种特殊情况是,如果在计算表达式时,表达式本身抛出Exception,那么assert将停止运行,而抛出这个Exception。
3、编译
由于assert是一个新关键字,使用老版本的JDK是无法编译带有assert的 源程序。因此,我们必须使用JDK1.4(或者更新)的Java编译器,在使用Javac命令时,我们必须加上-source 1.4作为参数。-source 1.4表示使用JDK 1.4版本的方式来编译源代码,否则编译就不能通过,因为缺省的Javac编译器使用JDK1.3的语法规则。
大家在使用eclipse,jbuilder等IDE工具的时候,要注意编译器的版本,使用的jre,不等于是javac 的版本
一个简单的例子如下: javac -source 1.4 AssertTest.java 
4、运行
由于我们可以选择开启assertion功能,或者不开启,另外我们还可以开启一部 分类或包的assertion功能。通过这些选项,我们可以过滤所有我们不关心的类,只选择我们关心的类或包来观察。
          参数 -esa 和 -dsa:
它们含义为开启(关闭) 系统类的assertion功能。由于新版本的Java的系统类中,也使了assertion语句,因此如果用户需要观察它们的运行情况,就需要打开系统类的assertion功能 ,我们可使用-esa参数打开,使用 -dsa参数关闭。
-esa和-dsa的全名为-enablesystemassertions和-disenablesystemassertions,全名和缩写名有同样的功能。
参数 -ea和-ea:
它们含义为开启(关闭) 用户类的assertion功能:通过这个参数,用户可以打 开某些类或包的assertion功能,同样用户也可以关闭某些类和包的assertion功能。打开assertion功能参数为-ea;如果不带任何 参数,表示打开所有用户类;如果带有包名称或者类名称,表示打开这些类或包;如果包名称后面跟有三个点,代表这个包及其子包;如果只有三个点,代表无名 包。关闭assertion功能参数为-da,使用方法与-ea类似。
-ea和-da的全名为-enableassertions和-disenableassertions,全名和缩写名有同样的功能。下面表示了参数及其含义。
参数 例子 说明
-ea java -ea 打开所有用户类的assertion
-da java -da 关闭所有用户类的assertion
-ea: java -ea:MyClass1 打开MyClass1的assertion
-da: java -da: MyClass1 关闭MyClass1的assertion
-ea: java -ea:pkg1 打开pkg1包的assertion
-da: java -da:pkg1 关闭pkg1包的assertion
-ea:... java -ea:... 打开缺省包(无名包)的assertion
-da:... java -da:... 关闭缺省包(无名包)的assertion
-ea:... java -ea:pkg1... 打开pkg1包和其子包的assertion
-da:... java -da:pkg1... 关闭pkg1包和其子包的assertion
-esa java -esa 打开系统类的assertion
-dsa java -dsa 关闭系统类的assertion
综合使用 java -dsa:MyClass1:pkg1 关闭MyClass1和pkg1包的assertion
其中...代表,此包和其子包的含义。例如我们有两个包为pkg1和pkg1.subpkg。
那么pkg1...就代表pkg1和pkg1.subpkg两个包。
另外,Java为了让程序也能够动态开启和关闭某些类和包的assertion功能,Java修该了Class和ClassLoader的实现,增加了几个用于操作assert的API。下面简单说明一下几个API的作用。
ClassLoader类中的几个相关的API:
setDefaultAssertionStatus:
用于开启/关闭assertion功能
  setPackageAssertionStatus:
用于开启/关闭某些包的assertion功能
  setClassAssertionStatus:
用于开启/关闭某些类的assertion功能
  clearAssertionStatus:
用于关闭assertion功能
二、assertion的设计问题
首先,我们认为assertion是必要的。因为,如果没有统一的assertion机制,Java程序通常使用if-then-else或者switch-case语句进行assertion检查,而且检查的数据类型也不完全相同。
assertion机制让Java程序员用统一的方式处理assertion问题, 而不是按自己的方式处理。另外,如果用户使用自己的方式进行检查,那么这些代码在发布以后仍然将起作用,这可能会影响程序的性能。而从语言言层次支持 assertion功能,这将把assertion对性能带来的负面影响降到最小。
Java是通过增强一个关键字assert实现支持assertion,而不是 使用一个库函数支持,这说明Java认为assertion对于语言本身来说是非常重要的。C语言就是 通过Assert.h函数库实现断言的支持。
Java的assertion的开启也和C语言不太一样,我们都知道在C语言中,assertion的开启是在编译时候决定的。当我们使用debug方式编译程序时候,assertion被开启,而使用release方式编译时候,assertion自动被关闭。
而 Java的assertion却是在运行的时候进行决定的。其实,这两种方式是各有优缺点。如果采用编译时决定方式,开发人员将处理两种类型的目标码,debug版本和release版本,这加大了文档管理的难度,但是提高了代码的运行效率。
Java采用运行时决定的方式,这样所有的assertion信息将置于目标代码 中,同一目标代码可以选择不同方式运行,增强目标代码的灵活性,但是它将牺牲因为assertion而引起一部分性能损失。
另外,我们注意到AssertionError作为Error的一个子类,而不 是RuntimeException。Error代表一些异常的错误,通常是不可以恢复的,而 RuntimeException强调该错误在运行时才发生的特点。AssertionError通常为非常关键的错误,这些错误往往是不容易恢复的,而且assertion机制也不鼓励程序员对这种错误进行恢复。
三、assertion与继承
如果一个assert语句在父类,而当它的子类调用它时,该assert为false。 父类的assert语句将只有在父类的assert开启才起作用,如果仅仅开启子类的assert,父类的assert仍然不运行。 因此,assert语句不具有继承功能。
四、assertion的使用
assertion的使用是一个复杂的问题,通常来说, assertion用于检查一些关键的值,并且这些值对整个程序,或者局部功能的完成有很大的影响,并且这种错误不容易恢复的。
assertion表达式应该短小、易懂,如果需要评估复杂的表达式,应该使用函数计算。以下是一些使用assertion的情况的例子,这些方式可以让java程序的可靠性更高。
检查控制流; 在if-then-else和swith-case语句中,我们可以在不应该发生的控制支流上加上assert false语句。如果这种情况发生了,assert能够检查出来。
在私有函数计算前,检查输入参数是否有效;对于一私有些函数,要求输入满足一些特定的条件,那么我们可以在函数开始处使用assert进行参数检查。
对于公共函数,我们通常不使用assertion检查,因为一般来说,公共函数必须对无效的参数进行检查和处理。而私有函数往往是直接使用的。例如:某函数可能要求输入的参数必须不为null。那么我们可以在函数的一开始加上:
assert parameter1!=null : 
"paramerter is null in test method";
在函数计算后,检查函数结果是否有效;对于一些计算函数,函数运行完成后,某些值需要保证一定的性质,因此我们可以通过assert检查该值。例如,我们有一个计算绝对值的函数,那么我们就可以在函数的结果处,加上一个语句:
assert  value>=0:
"Value should be bigger than 0:"+value;
通过这种方式,我们可以对函数计算完的结果进行检查。检查程序不变量;有些程序中,存在一些不变量,在程序的运行生命周期,这些不变量的值都是不变的。这些不变量可能是一个简单表达式,也可能是一个复杂的表达式。
对于一些 关键的不变量,我们可以通过assert进行检查。例如,在一个财会系统中,公司的支出和收入必须保持一定的平衡关系,因此我们可以编写一个表达式检查这种平衡关系,如下表示:
private boolean isBalance() 
{
……
}
在这个系统中,在一些可能影响这种平衡关系的方法的前后,我们都可以加上assert验证:
assert isBalance():"balance is destoried";
五、补充
必须清楚AssertionError是继承自Error得,因此你可以不再程序中catch它的,当然你也可以在程序中catch它然后程序可以继续执行。
  1. 不要再public的方法里面检查参数是不是为null之类的操作
    例如public int get(String s)
       {
           assert s != null;
       }
    如果需要检查也最好通过if s = null 抛出NullPointerException来检查
  2. 不要用assert来检查方法操作的返回值来判断方法操作的结果   
    例如 assert list.removeAll();这样看起来好像没有问题 但是想想如果assert 被disable呢,那样他就不会被执行了 所以removeAll()操作就没有被执行  可以这样代替
    boolean boo = list.removeAl();
    assert boo;

本文出自 “小小菜的java学习日志” 博客,请务必保留此出处http://arthennala.blog.51cto.com/287631/56996

<think>好的,用户想了解JavaAssert.assertEquals的用法。首先,我需要确认用户是否有JUnit的基础知识,因为assertEquals是JUnit框架中的一个方法。不过用户直接问的是用法,所以应该先介绍基本用法,再逐步深入。 我应该从方法的作用开始,说明它是用来比较预期值和实际值是否相等的。然后,区分不同参数类型的情况,比如基本数据类型和对象的情况。对于对象比较,要提到使用的是equals方法,所以需要正确重写equals方法。 接下来,需要给出具体的代码示例,这样用户能更直观地理解。比如用两个int值的比较,或者字符串的比较。可能用户会遇到比较失败的情况,这时候要说明断言失败时抛出的异常,以及如何查看错误信息。 另外,用户可能在使用JUnit的不同版本,比如JUnit 4和5,所以需要提到方法所在的不同包,以及JUnit 5中可能的改变,比如方法移到org.junit.jupiter.api.Assertions类下。这可能帮助用户避免导入错误的问题。 还要注意常见的错误场景,比如比较两个对象时没有重写equals方法,导致断言失败的情况。这时候需要提醒用户检查对象的equals实现。此外,参数顺序是否正确,因为第一个参数是期望值,第二个是实际值,顺序颠倒可能导致混淆错误信息。 可能用户在使用其他测试框架,比如TestNG,但问题明确提到的是JUnit的Assert.assertEquals,所以需要专注于这个范围。不过可以稍微提一下其他框架中的类似方法,但重点放在JUnit上。 最后,需要总结一下正确的使用步骤,并给出使用时的注意事项,比如确保测试类导入了正确的Assert类,处理可能的浮点数精度问题,或者使用delta参数的情况。这些细节能帮助用户更全面地理解和避免常见错误。</think>在Java单元测试中,`Assert.assertEquals()`是JUnit框架最常用的断言方法之一,用于验证预期值与实际值是否相等。以下是详细使用说明: --- ### 一、基本用法 ```java import static org.junit.Assert.assertEquals; // 基本数据类型比较 @Test public void testAddition() { int expected = 5; int actual = 2 + 3; assertEquals(expected, actual); // 断言通过 } // 对象比较(使用equals()方法) @Test public void testString() { String expected = "hello"; String actual = "HELLO".toLowerCase(); assertEquals(expected, actual); // 断言通过 } ``` --- ### 二、方法重载 JUnit提供多个重载版本: 1. **基本类型**(避免自动装箱问题) ```java assertEquals(long expected, long actual) assertEquals(double expected, double actual, double delta) // 带误差范围 ``` 2. **对象类型**(依赖equals()方法) ```java assertEquals(Object expected, Object actual) ``` 3. **自定义失败信息** ```java assertEquals("测试失败时的提示信息", expected, actual) ``` --- ### 三、关键注意事项 1. **浮点数比较必须指定delta** ```java assertEquals(0.333, 1.0/3, 0.001) // 第三个参数为允许的误差范围 ``` 2. **数组比较特殊** ```java assertArrayEquals(new int[]{1,2}, new int[]{1,2}) // 必须使用专用方法 ``` 3. **对象比较依赖equals()** ```java // 如果自定义类未重写equals(),比较的是对象地址 class Person { String name; // 必须重写equals()和hashCode()才能使断言生效 } ``` --- ### 四、错误处理示例 ```java @Test public void testFailure() { // 预期3,实际2+3=5,断言失败 assertEquals("计算结果不符合预期", 3, 2 + 3); } ``` 控制台会输出: ``` java.lang.AssertionError: 计算结果不符合预期 Expected :3 Actual :5 ``` --- ### 五、JUnit版本差异 - **JUnit 4**:方法位于`org.junit.Assert` - **JUnit 5**:改用`org.junit.jupiter.api.Assertions`,推荐使用静态导入: ```java import static org.junit.jupiter.api.Assertions.assertEquals; ``` --- **建议实践**:在断言失败信息中始终添加有意义的描述,便于快速定位问题。例如`assertEquals("用户ID校验失败", 12345, user.getId())`。
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值