/*
 *  RapidMiner
 *
 *  Copyright (C) 2001-2008 by Rapid-I and the contributors
 *
 *  Complete list of developers available at our web site:
 *
 *       http://rapid-i.com
 *
 *  This program is free software: you can redistribute it and/or modify
 *  it under the terms of the GNU Affero 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 Affero General Public License for more details.
 *
 *  You should have received a copy of the GNU Affero General Public License
 *  along with this program.  If not, see http://www.gnu.org/licenses/.
 */
package com.rapidminer.operator.preprocessing;

import java.io.BufferedReader;
import java.io.File;
import java.io.FileReader;
import java.io.IOException;
import java.util.HashMap;
import java.util.Iterator;
import java.util.List;
import java.util.Map;

import com.rapidminer.example.Attribute;
import com.rapidminer.example.ExampleSet;
import com.rapidminer.example.Tools;
import com.rapidminer.operator.IOObject;
import com.rapidminer.operator.Operator;
import com.rapidminer.operator.OperatorDescription;
import com.rapidminer.operator.OperatorException;
import com.rapidminer.operator.UserError;
import com.rapidminer.parameter.ParameterType;
import com.rapidminer.parameter.ParameterTypeFile;


/**
 * This operator takes an <code>ExampleSet</code> as input and maps all
 * nominal values to randomly created strings. The names and the construction
 * descriptions of all attributes will also replaced by random strings. This
 * operator can be used to anonymize your data. It is possible to save the
 * obfuscating map into a file which can be used to remap the old values and
 * names. Please use the operator <code>Deobfuscator</code> for this purpose.
 * The new example set can be written with an <code>ExampleSetWriter</code>.
 * 
 * @author Ingo Mierswa
 * @version $Id: Deobfuscator.java,v 1.6 2008/07/07 07:06:42 ingomierswa Exp $
 */
public class Deobfuscator extends Operator {


	/** The parameter name for "File where the obfuscator map was written to." */
	public static final String PARAMETER_OBFUSCATION_MAP_FILE = "obfuscation_map_file";
	public Deobfuscator(OperatorDescription description) {
		super(description);
	}

	public IOObject[] apply() throws OperatorException {
		// init
		ExampleSet exampleSet = getInput(ExampleSet.class);
		File file = getParameterAsFile(PARAMETER_OBFUSCATION_MAP_FILE);
		Map<String, String> obfuscatorMap = null;
		try {
			obfuscatorMap = readObfuscatorMap(file);
		} catch (IOException e) {
			throw new UserError(this, 302, getParameterAsString(PARAMETER_OBFUSCATION_MAP_FILE), e.getMessage());
		}

		// de-obfuscate attributes
		Iterator<Attribute> i = exampleSet.getAttributes().allAttributes();
		while (i.hasNext()) {
			deObfuscateAttribute(i.next(), obfuscatorMap);
		}

		return new IOObject[] { exampleSet };
	}

	private void deObfuscateAttribute(Attribute attribute, Map<String, String> obfuscatorMap) {
		String obfuscatedName = attribute.getName();
		String newName = obfuscatorMap.get(obfuscatedName);
		if (newName != null) {
			attribute.setName(newName);
			attribute.getConstruction().clear();
		} else {
			logWarning("No name found in obfuscating map for attribute '" + obfuscatedName + "'.");
		}

		if (attribute.isNominal()) {
			Iterator<String> v = attribute.getMapping().getValues().iterator();
			while (v.hasNext()) {
				String obfuscatedValue = v.next();
				String newValue = obfuscatorMap.get(newName + ":" + obfuscatedValue);
				if (newValue != null) {
					Tools.replaceValue(attribute, obfuscatedValue, newValue);
				} else {
					logWarning("No value found in obfuscating map for value '" + obfuscatedValue + "' of attribute '" + attribute.getName() + "'.");
				}
			}
		}
	}

	private Map<String, String> readObfuscatorMap(File file) throws IOException {
		Map<String, String> map = new HashMap<String, String>();
		BufferedReader in = null;
		try {
			in = new BufferedReader(new FileReader(file));
			String line = null;
			while ((line = in.readLine()) != null) {
				String[] parts = line.trim().split("\\s");
				map.put(parts[0], parts[1]);
			}
		} catch (IOException e) {
			throw e;
		} finally {
			if (in != null) {
				in.close();
			}
		}
		return map;
	}

	public Class<?>[] getInputClasses() {
		return new Class[] { ExampleSet.class };
	}

	public Class<?>[] getOutputClasses() {
		return new Class[] { ExampleSet.class };
	}

	public List<ParameterType> getParameterTypes() {
		List<ParameterType> types = super.getParameterTypes();
		ParameterType type = new ParameterTypeFile(PARAMETER_OBFUSCATION_MAP_FILE, "File where the obfuscator map was written to.", "obf", false);
		type.setExpert(false);
		types.add(type);
		return types;
	}
}