annotate truffle/com.oracle.truffle.api/src/com/oracle/truffle/api/utilities/CyclicAssumption.java @ 22157:dc83cc1f94f2

Using fully qualified imports
author Jaroslav Tulach <jaroslav.tulach@oracle.com>
date Wed, 16 Sep 2015 11:33:22 +0200
parents f410818cdec8
children a1b3b7894611
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
13322
f28ea693056f New assumption utilities.
Chris Seaton <chris.seaton@oracle.com>
parents:
diff changeset
1 /*
f28ea693056f New assumption utilities.
Chris Seaton <chris.seaton@oracle.com>
parents:
diff changeset
2 * Copyright (c) 2013, Oracle and/or its affiliates. All rights reserved.
f28ea693056f New assumption utilities.
Chris Seaton <chris.seaton@oracle.com>
parents:
diff changeset
3 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
f28ea693056f New assumption utilities.
Chris Seaton <chris.seaton@oracle.com>
parents:
diff changeset
4 *
f28ea693056f New assumption utilities.
Chris Seaton <chris.seaton@oracle.com>
parents:
diff changeset
5 * This code is free software; you can redistribute it and/or modify it
f28ea693056f New assumption utilities.
Chris Seaton <chris.seaton@oracle.com>
parents:
diff changeset
6 * under the terms of the GNU General Public License version 2 only, as
f28ea693056f New assumption utilities.
Chris Seaton <chris.seaton@oracle.com>
parents:
diff changeset
7 * published by the Free Software Foundation. Oracle designates this
f28ea693056f New assumption utilities.
Chris Seaton <chris.seaton@oracle.com>
parents:
diff changeset
8 * particular file as subject to the "Classpath" exception as provided
f28ea693056f New assumption utilities.
Chris Seaton <chris.seaton@oracle.com>
parents:
diff changeset
9 * by Oracle in the LICENSE file that accompanied this code.
f28ea693056f New assumption utilities.
Chris Seaton <chris.seaton@oracle.com>
parents:
diff changeset
10 *
f28ea693056f New assumption utilities.
Chris Seaton <chris.seaton@oracle.com>
parents:
diff changeset
11 * This code is distributed in the hope that it will be useful, but WITHOUT
f28ea693056f New assumption utilities.
Chris Seaton <chris.seaton@oracle.com>
parents:
diff changeset
12 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
f28ea693056f New assumption utilities.
Chris Seaton <chris.seaton@oracle.com>
parents:
diff changeset
13 * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
f28ea693056f New assumption utilities.
Chris Seaton <chris.seaton@oracle.com>
parents:
diff changeset
14 * version 2 for more details (a copy is included in the LICENSE file that
f28ea693056f New assumption utilities.
Chris Seaton <chris.seaton@oracle.com>
parents:
diff changeset
15 * accompanied this code).
f28ea693056f New assumption utilities.
Chris Seaton <chris.seaton@oracle.com>
parents:
diff changeset
16 *
f28ea693056f New assumption utilities.
Chris Seaton <chris.seaton@oracle.com>
parents:
diff changeset
17 * You should have received a copy of the GNU General Public License version
f28ea693056f New assumption utilities.
Chris Seaton <chris.seaton@oracle.com>
parents:
diff changeset
18 * 2 along with this work; if not, write to the Free Software Foundation,
f28ea693056f New assumption utilities.
Chris Seaton <chris.seaton@oracle.com>
parents:
diff changeset
19 * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
f28ea693056f New assumption utilities.
Chris Seaton <chris.seaton@oracle.com>
parents:
diff changeset
20 *
f28ea693056f New assumption utilities.
Chris Seaton <chris.seaton@oracle.com>
parents:
diff changeset
21 * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
f28ea693056f New assumption utilities.
Chris Seaton <chris.seaton@oracle.com>
parents:
diff changeset
22 * or visit www.oracle.com if you need additional information or have any
f28ea693056f New assumption utilities.
Chris Seaton <chris.seaton@oracle.com>
parents:
diff changeset
23 * questions.
f28ea693056f New assumption utilities.
Chris Seaton <chris.seaton@oracle.com>
parents:
diff changeset
24 */
f28ea693056f New assumption utilities.
Chris Seaton <chris.seaton@oracle.com>
parents:
diff changeset
25 package com.oracle.truffle.api.utilities;
f28ea693056f New assumption utilities.
Chris Seaton <chris.seaton@oracle.com>
parents:
diff changeset
26
22157
dc83cc1f94f2 Using fully qualified imports
Jaroslav Tulach <jaroslav.tulach@oracle.com>
parents: 22010
diff changeset
27 import com.oracle.truffle.api.Assumption;
22010
f410818cdec8 add missing truffle boundaries
Andreas Woess <andreas.woess@oracle.com>
parents: 21951
diff changeset
28 import com.oracle.truffle.api.CompilerDirectives.TruffleBoundary;
22157
dc83cc1f94f2 Using fully qualified imports
Jaroslav Tulach <jaroslav.tulach@oracle.com>
parents: 22010
diff changeset
29 import com.oracle.truffle.api.Truffle;
dc83cc1f94f2 Using fully qualified imports
Jaroslav Tulach <jaroslav.tulach@oracle.com>
parents: 22010
diff changeset
30 import java.util.concurrent.atomic.AtomicReference;
13322
f28ea693056f New assumption utilities.
Chris Seaton <chris.seaton@oracle.com>
parents:
diff changeset
31
f28ea693056f New assumption utilities.
Chris Seaton <chris.seaton@oracle.com>
parents:
diff changeset
32 /**
f28ea693056f New assumption utilities.
Chris Seaton <chris.seaton@oracle.com>
parents:
diff changeset
33 * Holds an {@link Assumption}, and knows how to recreate it with the same properties on
f28ea693056f New assumption utilities.
Chris Seaton <chris.seaton@oracle.com>
parents:
diff changeset
34 * invalidation. Used so that mutability is isolated in this class, and all other classes that need
f28ea693056f New assumption utilities.
Chris Seaton <chris.seaton@oracle.com>
parents:
diff changeset
35 * an assumption that may be recreated can have a final reference to an object of this class. Note
f28ea693056f New assumption utilities.
Chris Seaton <chris.seaton@oracle.com>
parents:
diff changeset
36 * that you should be careful that repeated invalidations do not cause a deoptimization loop in that
f28ea693056f New assumption utilities.
Chris Seaton <chris.seaton@oracle.com>
parents:
diff changeset
37 * same way that you would with any other assumption.
f28ea693056f New assumption utilities.
Chris Seaton <chris.seaton@oracle.com>
parents:
diff changeset
38 */
f28ea693056f New assumption utilities.
Chris Seaton <chris.seaton@oracle.com>
parents:
diff changeset
39 public class CyclicAssumption {
f28ea693056f New assumption utilities.
Chris Seaton <chris.seaton@oracle.com>
parents:
diff changeset
40
f28ea693056f New assumption utilities.
Chris Seaton <chris.seaton@oracle.com>
parents:
diff changeset
41 private final String name;
19706
dc7189b2bb5f CyclicAssumption: Use an AtomicReference to ensure invalidation.
Benoit Daloze <benoit.daloze@jku.at>
parents: 13322
diff changeset
42 private final AtomicReference<Assumption> assumption;
13322
f28ea693056f New assumption utilities.
Chris Seaton <chris.seaton@oracle.com>
parents:
diff changeset
43
f28ea693056f New assumption utilities.
Chris Seaton <chris.seaton@oracle.com>
parents:
diff changeset
44 public CyclicAssumption(String name) {
f28ea693056f New assumption utilities.
Chris Seaton <chris.seaton@oracle.com>
parents:
diff changeset
45 this.name = name;
19706
dc7189b2bb5f CyclicAssumption: Use an AtomicReference to ensure invalidation.
Benoit Daloze <benoit.daloze@jku.at>
parents: 13322
diff changeset
46 this.assumption = new AtomicReference<>(Truffle.getRuntime().createAssumption(name));
13322
f28ea693056f New assumption utilities.
Chris Seaton <chris.seaton@oracle.com>
parents:
diff changeset
47 }
f28ea693056f New assumption utilities.
Chris Seaton <chris.seaton@oracle.com>
parents:
diff changeset
48
22010
f410818cdec8 add missing truffle boundaries
Andreas Woess <andreas.woess@oracle.com>
parents: 21951
diff changeset
49 @TruffleBoundary
13322
f28ea693056f New assumption utilities.
Chris Seaton <chris.seaton@oracle.com>
parents:
diff changeset
50 public void invalidate() {
19706
dc7189b2bb5f CyclicAssumption: Use an AtomicReference to ensure invalidation.
Benoit Daloze <benoit.daloze@jku.at>
parents: 13322
diff changeset
51 Assumption newAssumption = Truffle.getRuntime().createAssumption(name);
dc7189b2bb5f CyclicAssumption: Use an AtomicReference to ensure invalidation.
Benoit Daloze <benoit.daloze@jku.at>
parents: 13322
diff changeset
52 Assumption oldAssumption = assumption.getAndSet(newAssumption);
dc7189b2bb5f CyclicAssumption: Use an AtomicReference to ensure invalidation.
Benoit Daloze <benoit.daloze@jku.at>
parents: 13322
diff changeset
53 oldAssumption.invalidate();
13322
f28ea693056f New assumption utilities.
Chris Seaton <chris.seaton@oracle.com>
parents:
diff changeset
54 }
f28ea693056f New assumption utilities.
Chris Seaton <chris.seaton@oracle.com>
parents:
diff changeset
55
f28ea693056f New assumption utilities.
Chris Seaton <chris.seaton@oracle.com>
parents:
diff changeset
56 public Assumption getAssumption() {
19706
dc7189b2bb5f CyclicAssumption: Use an AtomicReference to ensure invalidation.
Benoit Daloze <benoit.daloze@jku.at>
parents: 13322
diff changeset
57 return assumption.get();
13322
f28ea693056f New assumption utilities.
Chris Seaton <chris.seaton@oracle.com>
parents:
diff changeset
58 }
f28ea693056f New assumption utilities.
Chris Seaton <chris.seaton@oracle.com>
parents:
diff changeset
59
f28ea693056f New assumption utilities.
Chris Seaton <chris.seaton@oracle.com>
parents:
diff changeset
60 }