json/src/main/java/org/netbeans/html/json/spi/Observers.java
author Jaroslav Tulach <jtulach@netbeans.org>
Tue, 26 Aug 2014 18:13:30 +0200
changeset 838 bdc3d696dd4a
parent 785 json/src/main/java/org/apidesign/html/json/spi/Observers.java@929f1192819c
child 1092 9329156bb5d4
permissions -rw-r--r--
During the API review process (bug 246133) the reviewers decided that in order to include html4j to NetBeans Platform, we need to stop using org.apidesign namespace and switch to NetBeans one. Repackaging all SPI packages into org.netbeans.html.smthng.spi.
     1 /**
     2  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS HEADER.
     3  *
     4  * Copyright 2013-2014 Oracle and/or its affiliates. All rights reserved.
     5  *
     6  * Oracle and Java are registered trademarks of Oracle and/or its affiliates.
     7  * Other names may be trademarks of their respective owners.
     8  *
     9  * The contents of this file are subject to the terms of either the GNU
    10  * General Public License Version 2 only ("GPL") or the Common
    11  * Development and Distribution License("CDDL") (collectively, the
    12  * "License"). You may not use this file except in compliance with the
    13  * License. You can obtain a copy of the License at
    14  * http://www.netbeans.org/cddl-gplv2.html
    15  * or nbbuild/licenses/CDDL-GPL-2-CP. See the License for the
    16  * specific language governing permissions and limitations under the
    17  * License.  When distributing the software, include this License Header
    18  * Notice in each file and include the License file at
    19  * nbbuild/licenses/CDDL-GPL-2-CP.  Oracle designates this
    20  * particular file as subject to the "Classpath" exception as provided
    21  * by Oracle in the GPL Version 2 section of the License file that
    22  * accompanied this code. If applicable, add the following below the
    23  * License Header, with the fields enclosed by brackets [] replaced by
    24  * your own identifying information:
    25  * "Portions Copyrighted [year] [name of copyright owner]"
    26  *
    27  * Contributor(s):
    28  *
    29  * The Original Software is NetBeans. The Initial Developer of the Original
    30  * Software is Oracle. Portions Copyright 2013-2014 Oracle. All Rights Reserved.
    31  *
    32  * If you wish your version of this file to be governed by only the CDDL
    33  * or only the GPL Version 2, indicate your decision by adding
    34  * "[Contributor] elects to include this software in this distribution
    35  * under the [CDDL or GPL Version 2] license." If you do not indicate a
    36  * single choice of license, a recipient has the option to distribute
    37  * your version of this file under either the CDDL, the GPL Version 2 or
    38  * to extend the choice of license to its licensees as provided above.
    39  * However, if you add GPL Version 2 code and therefore, elected the GPL
    40  * Version 2 license, then the option applies only if the new code is
    41  * made subject to such option by the copyright holder.
    42  */
    43 package org.netbeans.html.json.spi;
    44 
    45 import java.lang.ref.WeakReference;
    46 import java.util.ArrayList;
    47 import java.util.Iterator;
    48 import java.util.LinkedList;
    49 import java.util.List;
    50 
    51 /**
    52  *
    53  * @author Jaroslav Tulach
    54  */
    55 final class Observers {
    56     private static final LinkedList<Watcher> GLOBAL = new LinkedList<Watcher>();
    57     private final List<Watcher> watchers = new ArrayList<Watcher>();
    58     private final List<Ref> observers = new ArrayList<Ref>();
    59 
    60     Observers() {
    61         assert Thread.holdsLock(GLOBAL);
    62     }
    63     
    64     static void beginComputing(Proto p, String name) {
    65         synchronized (GLOBAL) {
    66             verifyUnlocked(p);
    67             final Watcher nw = new Watcher(p, name);
    68             GLOBAL.push(nw);
    69         }
    70     }
    71     
    72     static void verifyUnlocked(Proto p) {
    73         synchronized (GLOBAL) {
    74             for (Watcher w : GLOBAL) {
    75                 if (w.proto == p) {
    76                     throw new IllegalStateException("Re-entrant attempt to access " + p);
    77                 }
    78             }
    79         }        
    80     }
    81 
    82     static void accessingValue(Proto p, String propName) {
    83         synchronized (GLOBAL) {
    84             verifyUnlocked(p);
    85             for (Watcher w : GLOBAL) {
    86                 Observers mine = p.observers(true);
    87                 mine.add(w, new Ref(w, propName));
    88             }
    89         }
    90     }
    91     
    92     static void finishComputing(Proto p) {
    93         synchronized (GLOBAL) {
    94             Watcher w = GLOBAL.pop();
    95             if (w.proto != p) {
    96                 throw new IllegalStateException("Inconsistency: " + w.proto + " != " + p);
    97             }
    98             if (w.prop != null) {
    99                 Observers mine = p.observers(true);
   100                 mine.add(w);
   101             }
   102         }
   103     }
   104     
   105     private static final class Ref extends WeakReference<Watcher> {
   106         private final String prop;
   107         
   108         public Ref(Watcher ref, String prop) {
   109             super(ref);
   110             this.prop = prop;
   111         }
   112         
   113         final Watcher watcher() {
   114             Watcher w = get();
   115             if (w == null) {
   116                 return null;
   117             }
   118             final Observers o = w.proto.observers(false);
   119             if (o == null) {
   120                 return null;
   121             }
   122             if (o.find(w.prop) == w) {
   123                 return w;
   124             }
   125             return null;
   126         }
   127     }
   128     
   129     private Watcher find(String prop) {
   130         if (prop == null) {
   131             return null;
   132         }
   133         for (Watcher w : watchers) {
   134             if (prop.equals(w.prop)) {
   135                 return w;
   136             }
   137         }
   138         return null;
   139     }
   140 
   141         final void add(Watcher w) {
   142         for (int i = 0; i < watchers.size(); i++) {
   143             Watcher ith = watchers.get(i);
   144             if (w.prop == null) {
   145                 if (ith.prop == null) {
   146                     watchers.set(i, w);
   147                     return;
   148                 }
   149             } else if (w.prop.equals(ith.prop)) {
   150                 watchers.set(i, w);
   151                 return;
   152             }
   153         }
   154         watchers.add(w);
   155     }
   156 
   157     static final void valueHasMutated(Proto p, String propName) {
   158         List<Watcher> mutated = new LinkedList<Watcher>();
   159         synchronized (GLOBAL) {
   160             Observers mine = p.observers(false);
   161             if (mine == null) {
   162                 return;
   163             }
   164             Iterator<Ref> it = mine.observers.iterator();
   165             while (it.hasNext()) {
   166                 Ref ref = it.next();
   167                 if (ref.get() == null) {
   168                     it.remove();
   169                     continue;
   170                 }
   171                 if (ref.prop.equals(propName)) {
   172                     Watcher w = ref.watcher();
   173                     if (w != null) {
   174                         mutated.add(w);
   175                     }
   176                 }
   177             }
   178         }
   179         for (Watcher w : mutated) {
   180             w.proto.valueHasMutated(w.prop);
   181         }
   182     }
   183 
   184     void add(Watcher w, Ref r) {
   185         Thread.holdsLock(GLOBAL);
   186         if (w == null) {
   187             return;
   188         }
   189         Iterator<Ref> it = observers.iterator();
   190         while (it.hasNext()) {
   191             Ref ref = it.next();
   192             if (r == ref) {
   193                 return;
   194             }
   195             final Watcher rw = ref.get();
   196             if (rw == null) {
   197                 it.remove();
   198                 continue;
   199             }
   200             if (rw == w && r.prop.equals(r.prop)) {
   201                 return;
   202             }
   203         }
   204         observers.add(r);
   205     }
   206     
   207     private static final class Watcher {
   208         final Proto proto;
   209         final String prop;
   210 
   211         Watcher(Proto proto, String prop) {
   212             this.proto = proto;
   213             this.prop = prop;
   214         }
   215         
   216         @Override
   217         public String toString() {
   218             return "Watcher: " + proto + ", " + prop;
   219         }
   220     }
   221 }