org.sonar.plugins.csharp.squid.CSharpResourcesBridge Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of sonar-csharp-plugin Show documentation
Enable analysis and reporting on C# projects.
There is a newer version: 4.0
/*
 * Sonar C# Plugin :: Core
 * Copyright (C) 2010 Jose Chillan, Alexandre Victoor and SonarSource
 * [email protected]
 *
 * This program is free software; you can redistribute it and/or
 * modify it under the terms of the GNU Lesser General Public
 * License as published by the Free Software Foundation; either
 * version 3 of the License, or (at your option) any later version.
 *
 * This program is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
 * Lesser General Public License for more details.
 *
 * You should have received a copy of the GNU Lesser General Public
 * License along with this program; if not, write to the Free Software
 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02
 */
package org.sonar.plugins.csharp.squid;

import com.google.common.collect.Maps;
import org.apache.commons.lang.StringUtils;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.sonar.api.BatchExtension;
import org.sonar.api.resources.File;
import org.sonar.api.resources.Resource;
import org.sonar.plugins.csharp.api.CSharpConstants;
import org.sonar.plugins.dotnet.api.DotNetResourceBridge;
import org.sonar.squid.api.SourceCode;
import org.sonar.squid.api.SourceFile;

import java.util.Map;
import java.util.Set;

/**
 * Class that gives links between logical resources (C# types and members) and their enclosing source files. 

 * It is useful when parsing third-party tool reports that contain references to the logical structure of the code: it is then necessary to
 * find to which physical file a given logical item belongs to, so that it is possible to save measure or violations to the correct Sonar
 * resource.
 */
public class CSharpResourcesBridge implements BatchExtension, DotNetResourceBridge {

  private static final Logger LOG = LoggerFactory.getLogger(CSharpResourcesBridge.class);
  private Map> logicalToPhysicalResourcesMap = Maps.newHashMap();

  private boolean canIndexFiles = true;

  public CSharpResourcesBridge() {
  }

  /**
   * After invoking this method, the {@link CSharpResourcesBridge} class won't be able to index files anymore: if
   * {@link #indexFile(SourceFile, File)} is called, a {@link IllegalStateException} will be thrown.
   */
  public void lock() {
    this.canIndexFiles = false;
  }

  /**
   * Method used to populate the map with the logical resources found in the Squid file and link them to the Sonar file. 

   * This method must be called only by plugins that have the ability to populate this bridge (e.g. C# Squid Plugin).

   * 

   * Note: If the CSharpResourcesBridge has been locked (see {@link #lock()}), an {@link IllegalStateException} will be thrown if
   * this method is called.
   * 
   * @param squidFile
   *          the Squid file
   * @param sonarFile
   *          the Sonar file
   * @throws IllegalStateException
   *           if the CSharpResourcesBridge is locked and cannot index more files
   */
  public void indexFile(SourceFile squidFile, File sonarFile) {
    if (canIndexFiles) {
      LOG.debug("C# BRIDGE is indexing {}:", squidFile.getKey());
      indexChildren(squidFile.getChildren(), sonarFile);
    } else {
      throw new IllegalStateException(
          "The CSharpResourcesBridge has been locked to prevent future modifications. It is impossible to index new files.");
    }
  }

  private void indexChildren(Set sourceCodes, File sonarFile) {
    if (sourceCodes != null) {
      for (SourceCode children : sourceCodes) {
        LOG.debug("  - {}", children.getKey());
        logicalToPhysicalResourcesMap.put(children.getKey(), sonarFile);
        indexChildren(children.getChildren(), sonarFile);
      }
    }
  }

  /**
   * {@inheritDoc}
   */
  public String getLanguageKey() {
    return CSharpConstants.LANGUAGE_KEY;
  }

  /**
   * {@inheritDoc}
   */
  public Resource getFromTypeName(String namespaceName, String typeName) {
    StringBuilder typeFullName = new StringBuilder();
    if (!StringUtils.isEmpty(namespaceName)) {
      typeFullName.append(namespaceName);
      typeFullName.append(".");
    }
    typeFullName.append(typeName);
    return getFromTypeName(typeFullName.toString());
  }

  /**
   * {@inheritDoc}
   */
  public Resource getFromTypeName(String typeFullName) {
    return logicalToPhysicalResourcesMap.get(typeFullName);
  }

  /**
   * {@inheritDoc}
   */
  public Resource getFromMemberName(String memberFullName) {
    return logicalToPhysicalResourcesMap.get(memberFullName);
  }

}