1a3f6a49ab37290eeeb8db0f41ec0f1cb74a68be7Torne (Richard Coles)// Copyright 2012 The Chromium Authors. All rights reserved. 25821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// Use of this source code is governed by a BSD-style license that can be 35821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// found in the LICENSE file. 45821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 55821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)package org.chromium.base; 65821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 75821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)import java.lang.annotation.ElementType; 85821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)import java.lang.annotation.Retention; 95821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)import java.lang.annotation.RetentionPolicy; 105821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)import java.lang.annotation.Target; 115821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 125821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)/** 135821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * @CalledByNativeUnchecked is used to generate JNI bindings that do not check for exceptions. 145821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * It only makes sense to use this annotation on methods that declare a throws... spec. 155821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * However, note that the exception received native side maybe an 'unchecked' (RuntimeExpception) 165821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * such as NullPointerException, so the native code should differentiate these cases. 175821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * Usage of this should be very rare; where possible handle exceptions in the Java side and use a 185821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * return value to indicate success / failure. 195821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 205821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)@Target(ElementType.METHOD) 212a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)@Retention(RetentionPolicy.CLASS) 225821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)public @interface CalledByNativeUnchecked { 235821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) /* 245821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) * If present, tells which inner class the method belongs to. 255821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) */ 265821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) public String value() default ""; 275821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)} 28