comparison src/annotations/gov/nasa/jpf/annotation/NoJPFExecution.java @ 17:e15b03204dc7

added a @NoJPFExecution annotation, which sets a NoJPFExec system attr on marked methods during class load time, which gets checked by ThreadInfo.enter(). Useful to flag methods which have to be intercepted/cut off when executing classes under JPF that can also be used outside. Especially useful to avoid the recursive JPF problem that can be caused by tests (which mix classpath and native_classpath). This currently throws a JPFException, but we could also turn this into a AssertionError in the SUT so that we get the SUT stack trace
author Peter Mehlitz <pcmehlitz@gmail.com>
date Mon, 23 Mar 2015 12:54:20 -0700
parents
children
comparison
equal deleted inserted replaced
16:08ca336d5928 17:e15b03204dc7
1 /*
2 * Copyright (C) 2015, United States Government, as represented by the
3 * Administrator of the National Aeronautics and Space Administration.
4 * All rights reserved.
5 *
6 * The Java Pathfinder core (jpf-core) platform is licensed under the
7 * Apache License, Version 2.0 (the "License"); you may not use this file except
8 * in compliance with the License. You may obtain a copy of the License at
9 *
10 * http://www.apache.org/licenses/LICENSE-2.0.
11 *
12 * Unless required by applicable law or agreed to in writing, software
13 * distributed under the License is distributed on an "AS IS" BASIS,
14 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
15 * See the License for the specific language governing permissions and
16 * limitations under the License.
17 */
18 package gov.nasa.jpf.annotation;
19
20 import java.lang.annotation.ElementType;
21 import java.lang.annotation.Retention;
22 import java.lang.annotation.RetentionPolicy;
23 import java.lang.annotation.Target;
24
25 /**
26 *
27 * annotation used to specify that a method is only supposed to be
28 * executed when running outside JPF
29 *
30 * This is useful for model classes that have methods which are intercepted
31 * or cut off by native peers, and we want to ensure that we never execute
32 * these when running under JPF. The standard case for such assertions is
33 * if we refer to JPF itself, and we don't want to get recursive when already
34 * executing under JPF
35 */
36 @Retention(RetentionPolicy.RUNTIME)
37 @Target({ElementType.METHOD})
38 public @interface NoJPFExecution {
39 }