You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@isis.apache.org by ah...@apache.org on 2020/01/13 13:20:29 UTC
[isis] 01/02: ISIS-2262: adds missing java doc to the new service
This is an automated email from the ASF dual-hosted git repository.
ahuber pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/isis.git
commit abc0f118d8c599ee9b2bdc6b78c2e06e42f9fd3c
Author: Andi Huber <ah...@apache.org>
AuthorDate: Mon Jan 13 13:38:04 2020 +0100
ISIS-2262: adds missing java doc to the new service
---
.../services/exceprecog/ExceptionRecognizerService.java | 14 +++++++++++++-
1 file changed, 13 insertions(+), 1 deletion(-)
diff --git a/api/applib/src/main/java/org/apache/isis/applib/services/exceprecog/ExceptionRecognizerService.java b/api/applib/src/main/java/org/apache/isis/applib/services/exceprecog/ExceptionRecognizerService.java
index 8c6cf6f..a25350d 100644
--- a/api/applib/src/main/java/org/apache/isis/applib/services/exceprecog/ExceptionRecognizerService.java
+++ b/api/applib/src/main/java/org/apache/isis/applib/services/exceprecog/ExceptionRecognizerService.java
@@ -32,12 +32,24 @@ public interface ExceptionRecognizerService {
/**
*
- * @return all ExceptionRecognizer implementations as discovered by the IoC container.
+ * @return all ExceptionRecognizer implementations as discovered by the IoC container,
+ * honoring order of precedence.
*/
Can<ExceptionRecognizer> getExceptionRecognizers();
+ /**
+ * @param ex
+ * @return optionally a recognition object, that describes both the category and reason,
+ * that will be included with the user-friendly message.
+ */
Optional<Recognition> recognize(Exception ex);
+ /**
+ * Extends {@link #recognize(Exception)} with additional recognizers to be taken into consideration,
+ * with least precedence order.
+ * @param ex
+ * @param additionalRecognizers
+ */
Optional<Recognition> recognize(Exception ex, Can<ExceptionRecognizer> additionalRecognizers);
}