inteligr8/alfresco-community-repo
1
0
Fork 0
mirror of https://github.com/Alfresco/alfresco-community-repo.git synced 2025-08-07 17:49:17 +00:00
Code Issues Packages Projects Releases Wiki Activity

Added some javadoc to clarify that ExceptionUtils.expectedException doesn't try to work around checked exceptions.

Browse Source 
git-svn-id: https://svn.alfresco.com/repos/alfresco-enterprise/modules/recordsmanagement/HEAD@104391 c4b6b30b-aa2e-2d43-bbcb-ca4b014f7261
This commit is contained in:
Neil McErlean
2015-05-18 15:11:16 +00:00
parent f03e36ee91
commit 2c7885cfc6
1 changed files with 10 additions and 3 deletions
Download Patch File Download Diff File Expand all files Collapse all files

13
rm-server/unit-test/java/org/alfresco/module/org_alfresco_module_rm/test/util/ExceptionUtils.java
View File

@@ -75,12 +75,13 @@ public class ExceptionUtils
} }
/** /**
* Utility method to help with expected exceptions in test code. This can be used in place of {@code try/catch} * Utility method to help with expected exceptions (unchecked - see below) in test code. This can be used in place
* blocks within test code and can sometimes make code more readable. * of {@code try/catch} blocks within test code and can sometimes make code more readable.
* A single expected exception would usually be let escape from the test method and be handled e.g. by JUnit's * A single expected exception would usually be let escape from the test method and be handled e.g. by JUnit's
* {@code @Test(expected="Exception.class")} pattern. * {@code @Test(expected="Exception.class")} pattern.
* However if you have multiple expected exceptions in a sequence, you need to either add a sequence of * However if you have multiple expected exceptions in a sequence, you need to either add a sequence of
* {@code try/catch} or use this method. * {@code try/catch} or use this method. Likewise if you need to make assertions about state within the expected
* exception, such as root cause or other internal state, this method will be useful.
* <p/> * <p/>
* Examples: * Examples:
* <ul> * <ul>
@@ -119,6 +120,12 @@ public class ExceptionUtils
* </li> * </li>
* </ul> * </ul>
* *
* A note on checked exceptions: currently this method does not provide any support for working around the normal
* integration of Java 8 lambdas and checked exceptions. If your {@code code} block must deal with checked exceptions,
* you must add {@code try}/{@code catch} blocks within your lambda which obviously makes this method less useful.
* This may change in the future.
*
*
* @param expected the class of the expected throwable (subtypes will also match). * @param expected the class of the expected throwable (subtypes will also match).
* @param code a lambda containing the code block which should throw the expected throwable. * @param code a lambda containing the code block which should throw the expected throwable.
* @param <R> the return type of the code block (which should not matter as it should not complete). * @param <R> the return type of the code block (which should not matter as it should not complete).