Assertions - Revision history

Suhridk: /* Running with assertions */

2011-09-09T17:27:49Z

Running with assertions

2011-09-06T09:28:34Z

Running with assertions

2011-09-02T17:40:42Z

Running with assertions

2011-09-02T17:37:04Z

Running with assertions

2011-09-02T17:22:36Z

Running with assertions

2011-08-26T12:49:42Z

Correctly using Assertions

2011-07-21T07:57:16Z

2011-07-20T10:34:59Z

2011-07-20T10:32:20Z

2011-07-20T10:30:32Z

@@ Line 52: / Line 52: @@
 * Assertions are disabled by default.
 * To enable use the -ea flag.
 * To disable use the -da flag. This is useful to disable assertions for specific classes/packages.

@@ Line 65: / Line 65: @@
 * -dsa disables system assertions
 * For packages the ... notation '''has''' to be used.
 == Correctly using Assertions ==

@@ Line 59: / Line 59: @@
 * java -ea -da:net.suhrid.Foo //Enable for all exception of the net.suhrid.Foo class ('''NOTE THE ':'''')
 * java -ea:net.suhrid.Bar //Enable only for the net.suhrid.Bar class
-* java -ea -da:net.suhrid.util...  //Disable assertions for the net.suhrid.util and all packages below it in the hierarchy.
+* java -ea -da:net.suhrid.util...  //Enable assertions in general, but disable assertions for the net.suhrid.util and all packages below it in the hierarchy.
 * java -ea -da:net.suhrid.util... -ea:net.suhrid.util.Test2 //Disable assertions for the net.suhrid.util and all packages below it in the hierarchy, but enable it for net.suhrid.util.Test2 class.
 * java -da -ea:... Test1 //Disable assertions in general but enable assertions in the unnamed package in the current working directory.

@@ Line 59: / Line 59: @@
 * java -ea -da:net.suhrid.Foo //Enable for all exception of the net.suhrid.Foo class ('''NOTE THE ':'''')
 * java -ea:net.suhrid.Bar //Enable only for the net.suhrid.Bar class
-* java -ea -da:net.suhrid.util... //Disable assertions for the net.suhrid.util and all packages below it in the hierarchy.
+* java -ea -da:net.suhrid.util...  //Disable assertions for the net.suhrid.util and all packages below it in the hierarchy.
 * -esa enables assertions in system classes (java.lang). This '''has to be specifically used''', with only -ea systemassertions will still be disabled.
 * -dsa disables system assertions

@@ Line 57: / Line 57: @@
 Examples:
-* java -ea -da:net.suhrid.Foo //Enable for all exception of the net.suhrid.Foo class
+* java -ea -da:net.suhrid.Foo //Enable for all exception of the net.suhrid.Foo class ('''NOTE THE ':'''')
 * java -ea:net.suhrid.Bar //Enable only for the net.suhrid.Bar class
 * java -ea -da:net.suhrid.util... //Disable assertions for the net.suhrid.util and all packages below it in the hierarchy.
 * -esa enables assertions in system classes (java.lang). This '''has to be specifically used''', with only -ea systemassertions will still be disabled.
 * -dsa disables system assertions
 * For packages the ... notation '''has''' to be used.
 == Correctly using Assertions ==

@@ Line 68: / Line 68: @@
 * Use assertions to validate arguments to a private method.
 * But not to a public one! Use IllegalArgumentException instead. This is because assertions are optional, so it may or may not work.
 * Can use assertions in public methods to check for cases that are never supposed to happen. e.g. if we know a switch default must never be reached.
 * Don't use asserts that causes values of variables to change - side effects!
 [[Category:OCPJP]]