/*
 * JBoss, Home of Professional Open Source.
 * See the COPYRIGHT.txt file distributed with this work for information
 * regarding copyright ownership.  Some portions may be licensed
 * to Red Hat, Inc. under one or more contributor license agreements.
 * 
 * This library 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 2.1 of the License, or (at your option) any later version.
 * 
 * This library 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 library; if not, write to the Free Software
 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
 * 02110-1301 USA.
 * Modified by
 * @author  Data Virtuality GmbH
 * @date    $Date$
 *  
 */

package org.teiid.core.util;

import java.util.Iterator;
import java.util.Map;
import java.util.Properties;

/**
 * <p>This is a simple utility class to help keep password values from being
 * printed out, primarily from java.util.Properties object, into
 * MetaMatrix log files.  This is <i>not</i> a robust security solution
 * for protecting passwords, and is only good insofar as we get all
 * other code to use this when necessary.  When passwords are properly
 * encrypted in the database, this class will be no longer necessary.</p>
 *
 * <p>This class can be used in one of two ways.  First, a Properties object
 * can be wrapped in an instance of this class - the properties object,
 * wrapped in this instance, can then be safely sent to LogManager to be
 * logged, or can otherwise be printed out.  This instance will basically
 * duplicate the toString() method of a normal Properties object, but will
 * obfuscate any property values whose names end in any of the well-known
 * {@link #PASSWORD_PROP_SUFFIXES password property suffixes}.</p>
 *
 * <p>The second way is to just use this class's static
 * {@link #doesNameEndWithPasswordSuffix doesNameEndWithPasswordSuffix}
 * utility method by hand, passing in a String property name to
 * see if it ends with any of the well-known
 * {@link #PASSWORD_PROP_SUFFIXES password property suffixes}.</p>
 */
public final class PasswordMaskUtil {

    /**
     * The known String suffixes that MetaMatrix property names end in.
     * Each of these is checked.
     */
    public static final String[] PASSWORD_PROP_SUFFIXES = new String[]{"password", "Password"}; //$NON-NLS-1$ //$NON-NLS-2$

    /**
     * The "mask" String that is printed out of the
     * {@link #toString} method, instead of the actual password value.
     */
    public static final String MASK_STRING = "*****"; //$NON-NLS-1$

    private Properties properties;

    /**
     * A Properties object can be wrapped by this class before, say,
     * being sent to LogManager.  If this {@link #toString} method
     * is called, password properties will be printed out as
     * a {@link #MASK_STRING masked string}.
     * @param propertiesWithPassword Properties object that has
     * password property values inside it
     */
    public PasswordMaskUtil(Properties propertiesWithPassword){
        this.properties = propertiesWithPassword;
    }

    /**
     * This toString() method is basically the same as the
     * java.util.Properties class's toString() method, except that
     * if any of the properties in this class end with any of the
     * well-known {@link #PASSWORD_PROP_SUFFIXES password suffixes},
     * then the value will
     * be printed out as {@link #MASK_STRING}
     */
    public String toString(){
        int max = properties.size() - 1;
        StringBuffer buf = new StringBuffer();
        Iterator it = properties.entrySet().iterator();

        buf.append("{"); //$NON-NLS-1$
        String key = null;
        for (int i = 0; i <= max; i++) {
            Map.Entry e = (Map.Entry) (it.next());
            key = (String)e.getKey();
            if (doesNameEndWithPasswordSuffix(key)){
                buf.append(key + "=" + MASK_STRING); //$NON-NLS-1$
            } else {
                buf.append(key + "=" + e.getValue()); //$NON-NLS-1$
            }
            if (i < max)
            buf.append(", "); //$NON-NLS-1$
        }
        buf.append("}"); //$NON-NLS-1$
        return buf.toString();
    }

    /**
     * Indicates if the String propName ends in any of the well-known
     * {@link #PASSWORD_PROP_SUFFIXES password property suffixes}.</p>
     */
    public static boolean doesNameEndWithPasswordSuffix(String propName){
        for (int i=0; i<PASSWORD_PROP_SUFFIXES.length; i++){
            if (propName.endsWith(PASSWORD_PROP_SUFFIXES[i])){
                return true;
            }
        }
        return false;
    }

}
