BaseStructureAspectDescriptor.java

/*
 * Copyright 2003-2014 JetBrains s.r.o.
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 * http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */
package jetbrains.mps.smodel.runtime;

import jetbrains.mps.smodel.adapter.ids.SConceptId;
import jetbrains.mps.util.annotation.ToRemove;

import java.util.Collection;
import java.util.Map;
import java.util.concurrent.ConcurrentHashMap;

/**
 * Base implementation generated code shall use to facilitate future changes in {@link jetbrains.mps.smodel.runtime.StructureAspectDescriptor}.
 */
public abstract class BaseStructureAspectDescriptor implements StructureAspectDescriptor {
  private static final Object LOCK = new Object();

  private volatile Map<SConceptId, ConceptDescriptor> myDescriptors;

  public abstract Collection<ConceptDescriptor> getDescriptors();

  @Deprecated
  @ToRemove(version = 3.4)
  //this is needed only because in 3.3 there's overriding method with @Override annotation
  public ConceptDescriptor getDescriptor(String fqName) {
    throw new UnsupportedOperationException();
  }

  @Override
  public ConceptDescriptor getDescriptor(SConceptId id) {
    ensureInitialized();
    return myDescriptors.get(id);
  }

  protected void ensureInitialized() {
    if (myDescriptors != null) {
      return;
    }
    synchronized (LOCK) {
      if (myDescriptors != null) {
        return;
      }

      Collection<ConceptDescriptor> ds = getDescriptors();
      Map<SConceptId, ConceptDescriptor> descriptors = new ConcurrentHashMap<SConceptId, ConceptDescriptor>(ds.size());
      for (ConceptDescriptor d : ds) {
        descriptors.put(d.getId(), d);
      }
      myDescriptors = descriptors;
    }
  }
}