com.feilong.security.oneway.MD5Util Maven / Gradle / Ivy

Show more of this group Show more artifacts with this name
Show all versions of feilong Show documentation
feilong is a suite of core and expanded libraries that include utility classes, http, excel,cvs, io classes, and much much more.
There is a newer version: 4.0.8
Show newest version
/*
 * Copyright (C) 2008 feilong
 *
 * 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 com.feilong.security.oneway;

import com.feilong.core.CharsetType;

/**
 * Message Digest algorithm 5,信息摘要算法.
 * 
 * 
 * 将任意长度的"字节串"变换成一个128bit的大整数.
 * 
 * 
 * 
 * MD5加密非常不安全,建议使用 {@link SHA1Util}
 * 
 * 
 *  * 检验你的实现是否正确:
 * MD5Util.encode("") = d41d8cd98f00b204e9800998ecf8427e
 * MD5Util.encode("a") = 0cc175b9c0f1b6a831c399e269772661
 * 
 * 
 * @author 腾讯通
 * @author feilong
 * @version 1.0.0 2010年10月26日 17:13:58
 * @version 1.0.1 2011-10-18 16:49
 * @version 1.0.7 2014-7-10 14:28 update javadoc and remove extends
 * 
 * @see MD5解密网站
 * @see com.feilong.security.oneway.OnewayEncryption
 * @see com.feilong.security.oneway.OnewayType
 * @see com.feilong.lib.codec.digest.DigestUtils#md5Hex(String)
 * @see "org.springframework.util.DigestUtils"
 * @since 1.0.0
 */
public final class MD5Util{

    /** The oneway type. */
    private static final OnewayType ONEWAYTYPE = OnewayType.MD5;

    //---------------------------------------------------------------

    /** Don't let anyone instantiate this class. */
    private MD5Util(){
        //AssertionError不是必须的. 但它可以避免不小心在类的内部调用构造器. 保证该类在任何情况下都不会被实例化.
        //see 《Effective Java》 2nd
        throw new AssertionError("No " + getClass().getName() + " instances for you!");
    }

    //---------------------------------------------------------------

    /**
     * 使用md5算法 单向加密字符串.
     * 
     * 
     * 加密之后的转成小写的16进制,长度32位的字符串
     * 
     * 
     * 示例:
     * 
     * 
     *     MD5Util.encode("") = "d41d8cd98f00b204e9800998ecf8427e"
    MD5Util.encode("123456") = "e10adc3949ba59abbe56e057f20f883e"
     * 
     * 
     * 
     *
     * @param origin
     *            原始字符串,将使用默认的 {@link String#getBytes()} 转成字节数组

     * @return 加密之后的转成小写的16进制字符串
     * @see OnewayEncryption#encode(OnewayType, String)
     * @see com.feilong.lib.codec.digest.DigestUtils#md5Hex(String)
     */
    public static String encode(String origin){
        return OnewayEncryption.encode(ONEWAYTYPE, origin);
    }

    /**
     * 使用md5算法 单向加密字符串.
     * 
     * 
     * 加密之后的转成小写的16进制,长度32位的字符串
     * 
     * 
     * 示例:
     * 
     * 
     * 
     *      * assertEquals("7eca689f0d3389d9dea66ae112e5cfd7", MD5Util.encode("你好", UTF8));
     * assertEquals("670b14728ad9902aecba32e22fa4f6bd", MD5Util.encode("000000", UTF8));
     * 
     * 
     * 
     *
     * @param origin
     *            原始字符串,将使用默认的 value.getBytes() 转成字节数组

     *            如果需要string 转码,请自行调用value.getBytes(string chartsetname),再调用{@link #encode(String, String)}
     * @param charsetName
     *            受支持的 {@link CharsetType} 名称,比如 utf-8
     * @return 加密之后的转成 小写的16进制字符串
     * @see OnewayEncryption#encode(OnewayType, String, String)
     * @see com.feilong.lib.codec.digest.DigestUtils#md5Hex(byte[])
     */
    public static String encode(String origin,String charsetName){
        return OnewayEncryption.encode(ONEWAYTYPE, origin, charsetName);
    }

    //---------------------------------------------------------------

    /**
     * 计算文件的单向加密值.
     *
     * @param location
     *            
     *            支持全路径, 比如. "file:C:/test.dat".
     *            支持classpath 伪路径, e.g. "classpath:test.dat".
     *            支持相对路径, e.g. "WEB-INF/test.dat".
     *            如果上述都找不到,会再次转成FileInputStream,比如 "/Users/feilong/feilong-io/src/test/resources/readFileToString.txt"
     *            
     * @return 如果 location 是null,抛出 {@link NullPointerException}

     *         如果 location 是blank,抛出 {@link IllegalArgumentException}

     * @see OnewayEncryption#encodeFile(OnewayType, String)
     * @see com.feilong.lib.codec.digest.DigestUtils#md5Hex(java.io.InputStream)
     */
    public static String encodeFile(String location){
        return OnewayEncryption.encodeFile(ONEWAYTYPE, location);
    }
}