summaryrefslogtreecommitdiff
path: root/base/android/java/src/org/chromium/base/annotations/CalledByNativeUnchecked.java
diff options
context:
space:
mode:
authorHidehiko Abe <hidehiko@google.com>2018-04-24 01:37:19 +0900
committerHidehiko Abe <hidehiko@google.com>2018-04-24 03:09:01 +0900
commitb268b43ac6fdbc4f3a2ed1429b99ace424906090 (patch)
treebd2d04362f66c36d4279f7a9735ba21ea3a2a021 /base/android/java/src/org/chromium/base/annotations/CalledByNativeUnchecked.java
parent4a54b98aa445f521c6945e4f4a1e0ea788fa7da8 (diff)
downloadlibchrome-b268b43ac6fdbc4f3a2ed1429b99ace424906090.tar.gz
Migrate libmojo repository into libchrome, part 2.
This CL moves following files. - .gitignore - Android.bp is merged into libchrome's Android.bp. - base/android/* - build/* except build_config.h which is exactly same with libchrome's. - ipc/* - mojo/* except mojo/public/tools/bindings/generators/__init__.py which is unused and not in chrome repository. - soong/* into libchrome_tools/ - third_party/{catapult,jinja2,markupsafe,ply}/* - ui/gfx/{geometry,range}/mojo/* Then, update several paths/build rules to be adapted. Bug: 73606903 Test: Built locally. Ran on DUT. Change-Id: I2a532a42aa68dcb215dbd71d8673192311509726
Diffstat (limited to 'base/android/java/src/org/chromium/base/annotations/CalledByNativeUnchecked.java')
-rw-r--r--base/android/java/src/org/chromium/base/annotations/CalledByNativeUnchecked.java27
1 files changed, 27 insertions, 0 deletions
diff --git a/base/android/java/src/org/chromium/base/annotations/CalledByNativeUnchecked.java b/base/android/java/src/org/chromium/base/annotations/CalledByNativeUnchecked.java
new file mode 100644
index 0000000000..c0abcbe649
--- /dev/null
+++ b/base/android/java/src/org/chromium/base/annotations/CalledByNativeUnchecked.java
@@ -0,0 +1,27 @@
+// Copyright 2012 The Chromium Authors. All rights reserved.
+// Use of this source code is governed by a BSD-style license that can be
+// found in the LICENSE file.
+
+package org.chromium.base.annotations;
+
+import java.lang.annotation.ElementType;
+import java.lang.annotation.Retention;
+import java.lang.annotation.RetentionPolicy;
+import java.lang.annotation.Target;
+
+/**
+ * @CalledByNativeUnchecked is used to generate JNI bindings that do not check for exceptions.
+ * It only makes sense to use this annotation on methods that declare a throws... spec.
+ * However, note that the exception received native side maybe an 'unchecked' (RuntimeExpception)
+ * such as NullPointerException, so the native code should differentiate these cases.
+ * Usage of this should be very rare; where possible handle exceptions in the Java side and use a
+ * return value to indicate success / failure.
+ */
+@Target(ElementType.METHOD)
+@Retention(RetentionPolicy.CLASS)
+public @interface CalledByNativeUnchecked {
+ /*
+ * If present, tells which inner class the method belongs to.
+ */
+ public String value() default "";
+}