core/com.nokia.carbide.cpp.codescanner/src/com/nokia/carbide/cpp/internal/codescanner/ui/CSPropertyPage.java
author stechong
Fri, 03 Apr 2009 09:33:43 -0500
branchRCL_2_0
changeset 33 2d1c891725ea
parent 2 d760517a8095
child 677 d13345e153e8
permissions -rw-r--r--
Added support for IAD rules; fix for Bug 8251.

/*
* Copyright (c) 2009 Nokia Corporation and/or its subsidiary(-ies). 
* All rights reserved.
* This component and the accompanying materials are made available
* under the terms of the License "Eclipse Public License v1.0"
* which accompanies this distribution, and is available
* at the URL "http://www.eclipse.org/legal/epl-v10.html".
*
* Initial Contributors:
* Nokia Corporation - initial contribution.
*
* Contributors:
*
* Description: 
*
*/

package com.nokia.carbide.cpp.internal.codescanner.ui;

import java.io.File;
import java.util.HashMap;
import java.util.Map;

import org.eclipse.core.resources.IProject;
import org.eclipse.core.runtime.IAdaptable;
import org.eclipse.jface.dialogs.IDialogSettings;
import org.eclipse.jface.dialogs.MessageDialog;
import org.eclipse.swt.SWT;
import org.eclipse.swt.events.SelectionAdapter;
import org.eclipse.swt.events.SelectionEvent;
import org.eclipse.swt.layout.GridData;
import org.eclipse.swt.layout.GridLayout;
import org.eclipse.swt.widgets.Button;
import org.eclipse.swt.widgets.Composite;
import org.eclipse.swt.widgets.Control;
import org.eclipse.swt.widgets.FileDialog;
import org.eclipse.swt.widgets.Label;
import org.eclipse.swt.widgets.Link;
import org.eclipse.swt.widgets.TabFolder;
import org.eclipse.swt.widgets.TabItem;
import org.eclipse.ui.IWorkbenchWindow;
import org.eclipse.ui.PlatformUI;
import org.eclipse.ui.dialogs.PreferencesUtil;
import org.eclipse.ui.dialogs.PropertyPage;

import com.nokia.carbide.cpp.internal.codescanner.CSBuilder;
import com.nokia.carbide.cpp.internal.codescanner.CSPlugin;
import com.nokia.carbide.cpp.internal.codescanner.Messages;
import com.nokia.carbide.cpp.internal.codescanner.config.CSProjectSettings;


/**
 * A class to create and control the CodeScanner project property page.
 */
public class CSPropertyPage extends PropertyPage {

	// private members for various controls of this property page
	private Composite settingsGroup = null;
	private Link workspaceSettingsLink = null;
	private Button projSettingsButton = null;
	private Button importButton = null;
	private Button exportButton = null;
	private TabFolder optionsTabFolder = null;
	private CSGeneralTabPage generalTabPage = null;
	private TabItem fileFiltersTab = null;
	private TabItem rulesTab = null;
	private CSFileFiltersTabPage fileFiltersTabPage = null;
	private CSRulesTabPage rulesTabPage = null;
	private TabItem generalTab = null;
	private CSProjectSettings projectSettings = null;
	@SuppressWarnings("unchecked")
	private Map pageData = null;
	
	private static String dialogFilterPath = null;

	private final int generalTabIndex = 0;
	private final int fileFiltersTabIndex = 1;
	private final int rulesTabIndex = 2;

	/**
	 * Create an instance of CSPropertyPage.
	 */
	public CSPropertyPage() {
		super();
	}
	
	/**
	 * Create contents of this property page.
	 * @param parent - the parent composite
	 */
	protected Control createContents(Composite parent) {
		initProjectSettings();

		final Composite content = new Composite(parent, SWT.NONE);
		content.setLayout(new GridLayout());
		content.setLayoutData(new GridData(GridData.FILL_BOTH));
		
		settingsGroup = new Composite(content, SWT.NONE);
		GridData gridData = new GridData(SWT.FILL, SWT.CENTER, true, false);
		gridData.widthHint = 460;
		settingsGroup.setLayoutData(gridData);
		GridLayout gridLayout = new GridLayout();
		gridLayout.numColumns = 2;
		settingsGroup.setLayout(gridLayout);

		// enable Project specific settings?
		projSettingsButton = new Button(settingsGroup, SWT.CHECK);
		projSettingsButton.setText(Messages.getString("CSPropertyPage.ProjSettingsLabel"));
		gridData = new GridData(SWT.FILL, SWT.CENTER, true, false);
		gridData.widthHint = 460;
		projSettingsButton.setLayoutData(gridData);
		projSettingsButton.addSelectionListener(new SelectionAdapter() {
			public void widgetSelected(SelectionEvent arg0) {
				boolean enabled = projSettingsButton.getSelection();
				enableWidgets(enabled);
			}
		});

		// link to CodeScanner workspace preference page
		if (offerLink()) {
			workspaceSettingsLink = new Link(settingsGroup, SWT.NONE);
			workspaceSettingsLink.setText(Messages.getString("CSPropertyPage.WorkspaceSettingslabel"));
			workspaceSettingsLink.addSelectionListener(new SelectionAdapter() {
				@SuppressWarnings("unchecked")
				public void widgetSelected(SelectionEvent e) {
					Map data= new HashMap();
					data.put(CSPreferenceConstants.NO_LINK, Boolean.TRUE);
					PreferencesUtil.createPreferenceDialogOn(content.getShell(), CSPreferenceConstants.PREFERENCE_PAGE_ID, null, data).open();
				}
			});
		}

		Label horizontalLine= new Label(content, SWT.SEPARATOR | SWT.HORIZONTAL);
		horizontalLine.setLayoutData(new GridData(SWT.FILL, SWT.FILL, true, false, 2, 1));

		// tab folder for various CodeScanner options
		optionsTabFolder = new TabFolder(content, SWT.TOP);
		gridData = new GridData(SWT.FILL, SWT.FILL, true, true);
		gridData.heightHint = 360;
		gridData.widthHint = 460;
		optionsTabFolder.setLayoutData(gridData);
		optionsTabFolder.setLayout(new GridLayout());

		// general CodeScanner options
		generalTabPage = new CSGeneralTabPage(optionsTabFolder);
		generalTabPage.setVisibleAutoscan(true);
		generalTab = new TabItem(optionsTabFolder, SWT.NONE, generalTabIndex);
		generalTab.setText(Messages.getString("CSPreferencPage.GeneralTabLabel"));
		generalTab.setToolTipText(Messages.getString("CSPreferencPage.GeneralTabMessage"));
		generalTab.setControl(generalTabPage);

		// CodeScanner file filters
		fileFiltersTabPage = new CSFileFiltersTabPage(optionsTabFolder);
		fileFiltersTab = new TabItem(optionsTabFolder, SWT.NONE, fileFiltersTabIndex);
		fileFiltersTab.setText(Messages.getString("CSPreferencPage.FileFiltersTabLabel"));
		fileFiltersTab.setToolTipText(Messages.getString("CSPreferencPage.FileFiltersTabMessage"));
		fileFiltersTab.setControl(fileFiltersTabPage);

		// CodeScanner rules
		rulesTabPage = new CSRulesTabPage(optionsTabFolder);
		rulesTab = new TabItem(optionsTabFolder, SWT.NONE, rulesTabIndex);
		rulesTab.setText(Messages.getString("CSPreferencPage.RulesTabLabel"));
		rulesTab.setToolTipText(Messages.getString("CSPreferencPage.RulesTabMessage"));
		rulesTab.setControl(rulesTabPage);

		getPageStoredValues();
		PlatformUI.getWorkbench().getHelpSystem().setHelp(parent, CSUIHelpIds.CODESCANNER_PROPERTY_PAGE);
		content.setFocus();
		return content;
	}

	/**
	 * Add buttons to the property page.
	 * @param parent - the parent composite
	 */
	protected void contributeButtons(Composite parent) {
		// import configuration settings
		importButton = new Button(parent, SWT.NONE);
		importButton.setText(Messages.getString("CSPreferencPage.ImportSettingsLabel"));
		importButton.setToolTipText(Messages.getString("CSPreferencPage.ImportSettingsMessage"));
		importButton.addSelectionListener(new SelectionAdapter() {
			public void widgetSelected(SelectionEvent arg0) {
				handleImport();
			}
		});

		// export configuration settings
		exportButton = new Button(parent, SWT.NONE);
		exportButton.setText(Messages.getString("CSPreferencPage.ExportSettingsLabel"));
		exportButton.setToolTipText(Messages.getString("CSPreferencPage.ExportSettingsMessage"));
		exportButton.addSelectionListener(new SelectionAdapter() {
			public void widgetSelected(SelectionEvent arg0) {
				handleExport();
			}
		});

		// add two columns to the parent's layout
		((GridLayout) parent.getLayout()).numColumns += 2;
	}

	/**
	 * Apply the data to the receiver.
	 * @param data - incoming data
	 */
	@SuppressWarnings("unchecked")
	public void applyData(Object data) {
		if (data instanceof Map) {
			pageData = (Map)data;
		}
		if (workspaceSettingsLink != null) {
			if (!offerLink()) {
				workspaceSettingsLink.setVisible(false);
			}
		}
 	}
	
	/**
	 * Things to do when user hit the "OK" button.
	 */
	public boolean performOk() {
		boolean result = setPageStoredValues();
		if (result) {
			return super.performOk();
		}
		else {
			return result;
		}
	}
	
	/**
	 * Things to do when user hit the "Default" button.
	 */
	protected void performDefaults() {
		int selection = optionsTabFolder.getSelectionIndex();
		switch (selection) {
			case generalTabIndex:
				generalTabPage.setDefaults();
				break;
			case fileFiltersTabIndex:
				fileFiltersTabPage.setDefaults();
				break;
			case rulesTabIndex:
				rulesTabPage.setDefaults();
				break;
		};
		super.performDefaults();
	}

	/**
	 * Initialize project settings.
	 */
	private void initProjectSettings(){
		IProject project = getProject();
		projectSettings = CSPlugin.getConfigManager().getProjectSettings(project);
		if (dialogFilterPath == null) {
			dialogFilterPath = getProject().getLocation().toOSString();			
		}
	}
	
	/**
	 * Retrieve the project associated with this page.
	 * @return project associated with this page if found
	 */
	private IProject getProject() {
		IAdaptable adaptable = getElement();
		if (adaptable != null) {
			IProject project = (IProject)adaptable.getAdapter(IProject.class);
			return project;
		}
		return null;
	}

	/**
	 * Retrieve the dialog settings for this page; create one if none is found.
	 * @return dialog settings for this page
	 */
	private IDialogSettings getSettings() {
		IDialogSettings cSettings = projectSettings.getDialogSettings();
		IDialogSettings pageSettings = cSettings.getSection(CSPreferenceConstants.PROPERTY_SETTINGS_ID);
		if (pageSettings == null) {
			pageSettings = cSettings.addNewSection(CSPreferenceConstants.PROPERTY_SETTINGS_ID);
			pageSettings.put(CSPreferenceConstants.PROJ_SETTINGS, false);
			CSGeneralTabPage.initializePropertyValues(pageSettings);
			CSFileFiltersTabPage.initializePropertyValues(pageSettings);
			CSRulesTabPage.initializePropertyValues(pageSettings);
		}
		return pageSettings;
	}

	/**
	 * Retrieve the stored values for this property page.
	 */
	private void getPageStoredValues() {
		IDialogSettings pageSettings = getSettings();
		boolean enableProjSettings = pageSettings.getBoolean(CSPreferenceConstants.PROJ_SETTINGS);
		projSettingsButton.setSelection(enableProjSettings);
		if (enableProjSettings) {
			// use project specific settings value
			generalTabPage.getStoredPropertyValues(pageSettings);
			fileFiltersTabPage.getStoredPropertyValues(pageSettings);
			rulesTabPage.getStoredPropertyValues(pageSettings);
		}
		else {
			// use workspace settings value
			generalTabPage.getStoredPreferenceValues();
			fileFiltersTabPage.getStoredPreferenceValues();
			rulesTabPage.getStoredPreferenceValues();
		}
		enableWidgets(enableProjSettings);
	}

	/**
	 * Store the values for this property page.
	 */
	private boolean setPageStoredValues() {
		IDialogSettings pageSettings = getSettings();
		boolean enableProjSettings = projSettingsButton.getSelection();
		pageSettings.put(CSPreferenceConstants.PROJ_SETTINGS, enableProjSettings);
		if (enableProjSettings) {
			// store project specific settings value
			if (!generalTabPage.setStoredPropertyValues(pageSettings)) {
				return false;
			}
			if (!fileFiltersTabPage.setStoredPropertyValues(pageSettings)) {
				return false;
			}
			if (!rulesTabPage.setStoredPropertyValues(pageSettings)) {
				return false;
			}
			handleAutoscan(generalTabPage.autoscanSelected());
		}
		projectSettings.saveDialogSettings();
		return true;
	}

	/**
	 * Enables various widgets used in this property page if the argument is true, 
	 * and disables them otherwise.
	 * @param enabled - the new enable state.
	 */
	private void enableWidgets(boolean enabled) {
		optionsTabFolder.setEnabled(enabled);
		generalTabPage.setEnabled(enabled);
		fileFiltersTabPage.setEnabled(enabled);
		rulesTabPage.setEnabled(enabled);
	}

	private void handleAutoscan(boolean enabled) {
		IProject project = getProject();
		if (enabled) {
			CSBuilder.addBuilderToProject(project);
		}
	}

	/**
     * Things to do when user hit the "Import Settings" button.
     */
    private void handleImport() {
    	String filePath = selectConfigFile(importButton, false);
    	if (filePath != null && filePath.length() > 0) {
    		File configFile = new File(filePath);
    		if (configFile.exists()) {
        		IDialogSettings pageSettings = getSettings();
        		CSPlugin.getConfigManager().loadProjectConfigFile(filePath, pageSettings);
        		// import CodeScanner file filters and rules only
        		fileFiltersTabPage.getStoredPropertyValues(pageSettings);
        		rulesTabPage.getStoredPropertyValues(pageSettings);
    		}
    		else {
    			importConfigFileError(filePath);
    		}
    	}
    }

    /**
     * Things to do when user hit the "Export Settings" button.
     */
	private void handleExport() {
    	String filePath = selectConfigFile(exportButton, true);
    	if (filePath != null && filePath.length() > 0) {
    		IDialogSettings pageSettings = getSettings();
    		// export CodeScanner file filters and rules only
    		fileFiltersTabPage.setStoredPropertyValues(pageSettings);
    		rulesTabPage.setStoredPropertyValues(pageSettings);
	    	CSPlugin.getConfigManager().createProjectConfigFile(getProject(), filePath);
    	}
	}

	/**
	 * Create and open a dialog to allow selection of a configuration settings file
	 * for import/export.
	 * @param button - the button widget associated with this dialog
	 * @param export - indicate whether the dialog is used to export a file
	 * @return the path of the selected file
	 */
	private String selectConfigFile(Button button, boolean export) {
        FileDialog dialog;
        if (export) {
        	dialog = new FileDialog(button.getShell(), SWT.SAVE);
            dialog.setText(Messages.getString("CSPreferencPage.SelectExportSettingsMessage"));
            dialog.setFileName(Messages.getString("CSPreferencPage.ExportDefaultFilename"));
        }
        else {
        	dialog = new FileDialog(button.getShell(), SWT.OPEN);
            dialog.setText(Messages.getString("CSPreferencPage.SelectImportSettingsMessage"));
        }
        String[] extensions = new String[] {"*.xml"};
        dialog.setFilterExtensions(extensions);
		dialog.setFilterPath(dialogFilterPath);
		String configFilePath = dialog.open();
		dialogFilterPath = dialog.getFilterPath();
        return configFilePath;
	}

	/**
	 * Generate error if an import config file cannot be found.
	 * @param fileName - impoert Config file name
	 */
	private void importConfigFileError(String fileName) {
		IWorkbenchWindow workbenchWindow = PlatformUI.getWorkbench().getActiveWorkbenchWindow();
		if (workbenchWindow != null) {
			MessageDialog.openError(workbenchWindow.getShell(), 
				Messages.getString("CSPreferencPage.ImportConfigFileErrorTitle"), 
				Messages.getString("CSPreferencPage.ImportConfigFileErrorMessage") + fileName);
		}
	}

	/**
	 * Determine whether to create a link to CodeScanner workspace preference page.
	 * @return true if a link to CodeScanner workspace preference page is to be created
	 */
	private boolean offerLink() {
		return pageData == null || !Boolean.TRUE.equals(pageData.get(CSPreferenceConstants.NO_LINK));
	}

}