1
// Copyright 2008, Google Inc.
3
// Redistribution and use in source and binary forms, with or without
4
// modification, are permitted provided that the following conditions are met:
6
// 1. Redistributions of source code must retain the above copyright notice,
7
// this list of conditions and the following disclaimer.
8
// 2. Redistributions in binary form must reproduce the above copyright notice,
9
// this list of conditions and the following disclaimer in the documentation
10
// and/or other materials provided with the distribution.
11
// 3. Neither the name of Google Inc. nor the names of its contributors may be
12
// used to endorse or promote products derived from this software without
13
// specific prior written permission.
15
// THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR IMPLIED
16
// WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
17
// MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO
18
// EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
19
// SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
20
// PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS;
21
// OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
22
// WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
23
// OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF
24
// ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
26
#ifndef GEARS_BASE_ANDROID_JAVA_EXCEPTION_SCOPE_H__
27
#define GEARS_BASE_ANDROID_JAVA_EXCEPTION_SCOPE_H__
29
// Java exception scope wrapper. This is used to reset any uncaught
30
// exceptions that may have been throwed during the lifetime of this
31
// object. On destruction, any exceptions are cleared. JNI will
32
// complain and possibly abort if we call another method while an
33
// exception is raised. Sample usage:
35
// JavaExceptionScope ex;
36
// bool ok = env->CallBooleanMethod(...); // throws an exception
39
// // Exception is cleared when leaving the block.
41
class JavaExceptionScope {
43
JavaExceptionScope() {
44
// Work around compiler warning about this object being unused.
48
// The destructor logs a message if an exception is pending. It also
49
// clears the exception to allow future JNI calls.
50
~JavaExceptionScope();
51
// Returns true if an exception occurred. No side-effect.
52
static bool Occurred();
53
// Check and clear any thrown exception. Returns true if an
54
// exception occurred. Also prints a LOG message when an exception
55
// occurs for convenience.
59
#endif // GEARS_BASE_ANDROID_JAVA_EXCEPTION_SCOPE_H__