it.scoppelletti.programmerpower.security.spi.RC5ParameterSpecFactory.java Source code

Introduction

Here is the source code for it.scoppelletti.programmerpower.security.spi.RC5ParameterSpecFactory.java

Source

/*
 * Copyright (C) 2010 Dario Scoppelletti, <http://www.scoppelletti.it/>.
 * 
 * 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 it.scoppelletti.programmerpower.security.spi;

import java.util.*;
import java.security.spec.*;
import javax.crypto.spec.*;
import org.apache.commons.codec.*;
import org.apache.commons.codec.binary.*;
import it.scoppelletti.programmerpower.*;
import it.scoppelletti.programmerpower.security.*;
import it.scoppelletti.programmerpower.types.*;

/**
 * Classe di factory dell&rsquo;insieme dei parametri dell&rsquo;algoritmo
 * <ACRONYM TITLE="Rivest Cipher 5">RC5</ACRONYM>.
 *
 * <P><TABLE WIDTH="100%" BORDER="1" CELLPADDING="5">
 * <THEAD>
 * <TR>
 *     <TH>Propriet&agrave;</TH>
 *     <TH>Descrizione</TH>     
 * </TR>
 * </THEAD>
 * <TBODY>
 * <TR>
 *      <TD>{@code version}</TD>
 *      <TD>Numero di versione.</TD>
 * </TR> 
 * <TR>
 *      <TD>{@code rounds}</TD>
 *      <TD>Numero di arrotondamenti.</TD>
 * </TR> 
 * <TR>
 *      <TD>{@code word.size}</TD>
 *      <TD>Dimensione della parola (numero di bit).</TD>
 * </TR>      
 * <TR>
 *      <TD>{@code iv}</TD>
 *      <TD>Eventuale vettore di inizializzazione in formato esadecimale per la
 *      modalit&agrave; di feedback; il vettore deve essere costituito da un
 *      numero di byte doppio rispetto alla dimensione della parola:<BR>
 *      sizeof({@code iv}) = 2 * {@code word.size} / 8</TD>
 * </TR>
 * </TBODY>
 * </TABLE></P>
 * 
 * @see   it.scoppelletti.programmerpower.security.CryptoUtils#getCipher
 * @see   <A HREF="{@docRoot}/it/scoppelletti/programmerpower/security/CryptoUtils.html#idMode">Modalit&agrave;
 *        degli algoritmi di cifratura</A>
 * @see   <A HREF="http://www.ietf.org/rfc/rfc2040.txt" TARGET="_blank">RFC
 *        2040: The RC5, RC5-CBC, RC5-CBC-Pad, and RC5-CTS Algorithms</A>                  
 * @since 1.0.0
 */
public final class RC5ParameterSpecFactory implements AlgorithmParameterSpecFactory {

    /**
     * Codice dell&rsquo;algoritmo di crittografia RC5. Il valore della costante
     * &egrave; <CODE>{@value}</CODE>. 
     */
    public static final String ALGORITHM = "RC5";

    /**
     * Nome della propriet&agrave; sulla quale deve essere impostato il numero
     * di versione. Il valore della costante &egrave; <CODE>{@value}</CODE>.  
     */
    public static final String PROP_VERSION = "version";

    /**
     * Nome della propriet&agrave; sulla quale deve essere impostato il numero
     * di arrotondamenti. Il valore della costante &egrave;
     * <CODE>{@value}</CODE>.  
     */
    public static final String PROP_ROUNDS = "rounds";

    /**
     * Nome della propriet&agrave; sulla quale deve essere impostata la
     * dimensione della parola in numero di bit. Il valore della costante
     * &egrave; <CODE>{@value}</CODE>.  
     */
    public static final String PROP_WORDSIZE = "word.size";

    /**
     * Nome della propriet&agrave; sulla quale pu&ograve; essere impostato il
     * vettore di inizializzazione. Il valore della costante &egrave;
     * <CODE>{@value}</CODE>.
     */
    public static final String PROP_IV = "iv";

    /**
     * Costruttore.
     */
    public RC5ParameterSpecFactory() {
    }

    public AlgorithmParameterSpec newInstance(Properties props, String prefix) {
        int rounds, version, wordSize;
        String name, value;
        byte[] iv;
        AlgorithmParameterSpec param;

        name = Strings.concat(prefix, RC5ParameterSpecFactory.PROP_VERSION);
        value = props.getProperty(name);
        if (Strings.isNullOrEmpty(value)) {
            throw new ArgumentNullException(name);
        }

        version = Integer.parseInt(value);

        name = Strings.concat(prefix, RC5ParameterSpecFactory.PROP_ROUNDS);
        value = props.getProperty(name);
        if (Strings.isNullOrEmpty(value)) {
            throw new ArgumentNullException(name);
        }

        rounds = Integer.parseInt(value);

        name = Strings.concat(prefix, RC5ParameterSpecFactory.PROP_WORDSIZE);
        value = props.getProperty(name);
        if (Strings.isNullOrEmpty(value)) {
            throw new ArgumentNullException(name);
        }

        wordSize = Integer.parseInt(value);

        name = Strings.concat(prefix, RC5ParameterSpecFactory.PROP_IV);
        value = props.getProperty(name);
        if (Strings.isNullOrEmpty(value)) {
            iv = null;
        } else {
            try {
                iv = Hex.decodeHex(value.toCharArray());
            } catch (DecoderException ex) {
                throw SecurityUtils.toSecurityException(ex);
            }
        }

        if (iv != null) {
            param = new RC5ParameterSpec(version, rounds, wordSize, iv);
        } else {
            param = new RC5ParameterSpec(version, rounds, wordSize);
        }

        return param;
    }
}