1 // Copyright 2015 The Chromium Authors 2 // Use of this source code is governed by a BSD-style license that can be 3 // found in the LICENSE file. 4 5 #ifndef BASE_ANDROID_JAVA_EXCEPTION_REPORTER_H_ 6 #define BASE_ANDROID_JAVA_EXCEPTION_REPORTER_H_ 7 8 #include <jni.h> 9 10 #include "base/android/scoped_java_ref.h" 11 #include "base/base_export.h" 12 #include "base/functional/callback_forward.h" 13 14 namespace base { 15 namespace android { 16 17 using JavaExceptionCallback = void (*)(const char* exception); 18 19 // Install the exception handler. This should only be called once per process. 20 BASE_EXPORT void InitJavaExceptionReporter(); 21 22 // Same as above except the handler ensures child process exists immediately 23 // after an unhandled exception. This is used for child processes because 24 // DumpWithoutCrashing does not work for child processes on Android. 25 BASE_EXPORT void InitJavaExceptionReporterForChildProcess(); 26 27 // Sets a callback to be called with the contents of a Java exception, which may 28 // be nullptr. 29 BASE_EXPORT void SetJavaExceptionCallback(JavaExceptionCallback callback); 30 31 // Returns the value last passed to SetJavaException(), or nullptr if it has 32 // not been called. 33 BASE_EXPORT JavaExceptionCallback GetJavaExceptionCallback(); 34 35 // Calls the Java exception callback, if any, with exception. 36 void SetJavaException(const char* exception); 37 38 // Sets a filter that determines whether a java exception should cause a crash 39 // report. |java_exception_filter| should return true if a crash report should 40 // be generated. 41 BASE_EXPORT void SetJavaExceptionFilter( 42 base::RepeatingCallback<bool(const JavaRef<jthrowable>&)> 43 java_exception_filter); 44 45 } // namespace android 46 } // namespace base 47 48 #endif // BASE_ANDROID_JAVA_EXCEPTION_REPORTER_H_ 49