Java 断言整理

　 编写代码时，我们总是会做出一些假设，断言就是用于在代码中捕捉这些假设 断言表示为一些布尔表达式，程序员相信在程序中的某个特定点该表达式值为真 可以在任何时候启用和禁用断言验证，因此可以在测试时启用断言而在部署时禁用断言。同样，程序投入运行后，最终用户在遇到问题时可以重新起用断言。　使用断言可以创建更稳定，品质更好且易于除错的代码[color=red] 当需要在一个值为FALSE时中断当前操作的话，可以使用断言，单元测试必须使用断言（Junit/JunitX）　，除了类型检查和单元测试外，断言还提供了一种确定各种特性是否在程序中得到维护的极好的方法， [/color]使用断言使我们向按契约式设计更近了一步。

[b]常见的断言特性[/b]

前置条件断言：代码执行之前必须具备的特性　　
后置条件断言：代码执行之后必须具备的特性　　
前后不变断言：代码执行前后不能变化的特性

[b]断言使用方式[/b]

断言可以有两种形式　　
[quote]1、assert Expression1　　
2.assert Expression1:Expression2　[/quote]

　 其中Expression1应该总是一个布尔值，Expression2是断言失败时输出的失败消息的字符串。如果Expression1为假，则抛出一个 AssertionError，这是一个错误，而不是一个异常，也就是说是一个不可控制异常（unchecked Exception),AssertionError由于是错误，所以可以不捕获，但不推荐这样做，因为那样会使你的系统进入不稳定状态。

[b]启用断言[/b]

　　断言在默认情况下是关闭的，要在编译时启用断言，需要使用source1.4标记 既javac source1.4 Test.java ,在运行时启用断言需要使用 -ea参数 。要在系统类中启用和禁用断言可以使用 -esa 和 -dsa参数。

例如：　　

public class AssertExampleOne{　
	　public AssertExampleOne(){}　　
            public static void main(String args[]){　
	　        int x=10;　　
    		  System.out.println("Testing Assertion that x==100");
	　　      assert x=100："Out assertion failed!";
	　　     System.out.println("Test passed!");
	　　}
	　}　

　如果编译时未加 -source1.4,则编译通不过
　在执行时未加 -ea 时输出为
　[quote]
Testing Assertion that x==100
　Test passed[/quote]
　jre忽略了断言的旧代码，而使用了该参数就会输出为
[quote]
Testing Assertion that x==100
　Exception in thread "main" java.lang.AssertionError:
Out assertion failed!
at AssertExampleOne.main(AssertExampleOne.java:6) [/quote]

[b]断言的副作用[/b]

　　由于程序员的问题，断言的使用可能会带来副作用 ，例如：
　　

        boolean isEnable=false;
	//...　　assert isEnable=true;

这个断言的副作用是因为它修改了程序中变量的值并且未抛出错误，这样的错误如果不细心的检查是很难发现的。但是同时我们可以根据以上的副作用得到一个有用的特性，根据它来测试断言是否打开。
　

        public class AssertExampleTwo{
	　　public static void main(String args[]){
	　　	boolean isEnable=false;
	　	　//...　　
	        assert isEnable=true;
	　　    if(isEnable==false){
	　　	  throw new RuntimeException("Assertion shoule be enable!");
	　　    }
	　　}
	　} 

[b]何时需要使用断言[/b]

[quote]　1.可以在预计正常情况下程序不会到达的地方放置断言 ：assert false
　 2.断言可以用于检查传递给私有方法的参数。（对于公有方法，因为是提供给外部的接口，所以必须在方法中有相应的参数检验才能保证代码的健壮性）
　 3.使用断言测试方法执行的前置条件和后置条件
　 4.使用断言检查类的不变状态，确保任何情况下，某个变量的状态必须满足。（如age属性应大于0小于某个合适值）[/quote]

[b]什么地方不要使用断言[/b]

　断言语句不是永远会执行，可以屏蔽也可以启用
因此：
　　[quote]1.不要使用断言作为公共方法的参数检查，公共方法的参数永远都要执行
　　2.断言语句不可以有任何边界效应，不要使用断言语句去修改变量和改变方法的返回值 [/quote]




　Assert最好不要滥用，原因是assert并不一定都是enable的，下面两种情况就不应该用assert
　[color=red]1、不要再public的方法里面检查参数是不是为null之类的操作[/color]
　　例如
[quote]public int get(String s){
　　assert s != null;
}　[/quote]
如果需要检查也最好通过if s = null 抛出NullPointerException来检查

[color=red] 2、不要用assert来检查方法操作的返回值来判断方法操作的结果[/color]
　　 例如

 assert list.removeAll();

这样看起来好像没有问题 但是想想如果assert 被disable呢，那样他就不会被执行了 所以removeAll()操作就没有被执行
可以这样代替
　

　boolean boo = list.removeAl();
	　　assert boo; 

下面是我的测试代码：

      public class AssertTest{


     public static void main(String[] args){
      AssertTest at = new AssertTest();
      try {
    	at.assertMe(true);
    	at.assertMe(false);
      } catch (AssertionError e) {
	 e.printStackTrace(); 
    	System.out.println("断言为假！！！");
      }
    	System.out.println("go on !!!!");

     } 

     private  void assertMe(boolean boo){
	 int s = 0;
	 assert boo:++s;   //当boo 为真时，assert语句将被忽略，对应的++s 也不会执行，当boo为假时，assert中的第二个参数表达式将会被执行，并且将结果作为构造AssertError的参数，并且抛出AssertError错误
	 System.out.println(boo+"  condition   "+s);
     }

}