com.squarespace.less.exec.SymbolTable Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of less-compiler Show documentation
Squarespace LESS compiler
The newest version!
/**
 * Copyright (c) 2014 SQUARESPACE, Inc.
 *
 * 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 com.squarespace.less.exec;

import java.util.HashMap;
import java.util.Map;

import com.squarespace.less.core.LessInternalException;


/**
 * Generic table mapping symbol strings to values. Raises an error when an attempt
 * is made to register a symbol more than once.
 */
public abstract class SymbolTable {

  /**
   * Mapping of symbol to implementation.
   */
  private final Map table;

  /**
   * Flag to indicate whether this symbol table is in use. If the symbol table
   * is marked "in use", any attempt to modify it will throw an exception.
   */
  private boolean inUse = false;

  /**
   * Constructs a table that accepts implementations of type V and sets the
   * initial number of {@link HashMap} buckets.
   */
  public SymbolTable(int numBuckets) {
    this.table = new HashMap<>(numBuckets);
  }

  /**
   * Mark this table as being in use.
   */
  public void setInUse() {
    this.inUse = true;
  }

  public V get(String symbol) {
    return table.get(symbol);
  }

  /**
   * Override extraction of the symbol name from the given implementation.
   * @param implementation
   */
  public abstract void add(Object implementation);

  /**
   * Maps a symbol to its value.
   */
  protected void put(String symbol, V value) {
    if (inUse) {
      throw new LessInternalException("Attempt to add a symbol after table in use.");
    }
    if (table.containsKey(symbol)) {
      throw new LessInternalException("A symbol named '" + symbol + "' is already registered!");
    }
    table.put(symbol, value);
  }

}