All Downloads are FREE. Search and download functionalities are using the official Maven repository.

src-main.org.awakefw.commons.codec.binary.AwakeStringUtils Maven / Gradle / Ivy

Go to download

Awake FILE is a secure Open Source framework that allows to program very easily file uploads/downloads and RPC through http. File transfers include powerful features like file chunking and automatic recovery mechanism. Security has been taken into account from the design: server side allows to specify strong security rules in order to protect the files and to secure the RPC calls.

There is a newer version: 3.0
Show newest version
/*
 * This file is part of Awake FILE. 
 * Awake FILE: Easy file upload & download over HTTP with Java.                                    
 * Copyright (C) 2014,  KawanSoft SAS
 * (http://www.kawansoft.com). All rights reserved.                                
 *                                                                               
 * Awake FILE 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.            
 *                                                                               
 * Awake FILE 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
 *
 * Any modifications to this file must keep this entire header
 * intact.
 */
package org.awakefw.commons.codec.binary;

import java.io.UnsupportedEncodingException;

import org.awakefw.commons.codec.CharEncoding;

/**
 * Converts String to and from bytes using the encodings required by the Java specification. These encodings are specified in Standard charsets
 * 
 * @see CharEncoding
 * @see Standard charsets
 * @author Gary Gregory
 * @version $Id: StringUtils.java 801391 2009-08-05 19:55:54Z ggregory $
 * @since 1.4
 */
public class AwakeStringUtils {

    /**
     * Encodes the given string into a sequence of bytes using the ISO-8859-1 charset, storing the result into a new
     * byte array.
     * 
     * @param string
     *            the String to encode
     * @return encoded bytes
     * @throws IllegalStateException
     *             Thrown when the charset is missing, which should be never according the the Java specification.
     * @see Standard charsets
     * @see #getBytesUnchecked(String, String)
     */
    public static byte[] getBytesIso8859_1(String string) {
        return AwakeStringUtils.getBytesUnchecked(string, CharEncoding.ISO_8859_1);
    }

    /**
     * Encodes the given string into a sequence of bytes using the US-ASCII charset, storing the result into a new byte
     * array.
     * 
     * @param string
     *            the String to encode
     * @return encoded bytes
     * @throws IllegalStateException
     *             Thrown when the charset is missing, which should be never according the the Java specification.
     * @see Standard charsets
     * @see #getBytesUnchecked(String, String)
     */
    public static byte[] getBytesUsAscii(String string) {
        return AwakeStringUtils.getBytesUnchecked(string, CharEncoding.US_ASCII);
    }

    /**
     * Encodes the given string into a sequence of bytes using the UTF-16 charset, storing the result into a new byte
     * array.
     * 
     * @param string
     *            the String to encode
     * @return encoded bytes
     * @throws IllegalStateException
     *             Thrown when the charset is missing, which should be never according the the Java specification.
     * @see Standard charsets
     * @see #getBytesUnchecked(String, String)
     */
    public static byte[] getBytesUtf16(String string) {
        return AwakeStringUtils.getBytesUnchecked(string, CharEncoding.UTF_16);
    }

    /**
     * Encodes the given string into a sequence of bytes using the UTF-16BE charset, storing the result into a new byte
     * array.
     * 
     * @param string
     *            the String to encode
     * @return encoded bytes
     * @throws IllegalStateException
     *             Thrown when the charset is missing, which should be never according the the Java specification.
     * @see Standard charsets
     * @see #getBytesUnchecked(String, String)
     */
    public static byte[] getBytesUtf16Be(String string) {
        return AwakeStringUtils.getBytesUnchecked(string, CharEncoding.UTF_16BE);
    }

    /**
     * Encodes the given string into a sequence of bytes using the UTF-16LE charset, storing the result into a new byte
     * array.
     * 
     * @param string
     *            the String to encode
     * @return encoded bytes
     * @throws IllegalStateException
     *             Thrown when the charset is missing, which should be never according the the Java specification.
     * @see Standard charsets
     * @see #getBytesUnchecked(String, String)
     */
    public static byte[] getBytesUtf16Le(String string) {
        return AwakeStringUtils.getBytesUnchecked(string, CharEncoding.UTF_16LE);
    }

    /**
     * Encodes the given string into a sequence of bytes using the UTF-8 charset, storing the result into a new byte
     * array.
     * 
     * @param string
     *            the String to encode
     * @return encoded bytes
     * @throws IllegalStateException
     *             Thrown when the charset is missing, which should be never according the the Java specification.
     * @see Standard charsets
     * @see #getBytesUnchecked(String, String)
     */
    public static byte[] getBytesUtf8(String string) {
        return AwakeStringUtils.getBytesUnchecked(string, CharEncoding.UTF_8);
    }

    /**
     * Encodes the given string into a sequence of bytes using the named charset, storing the result into a new byte
     * array.
     * 

* This method catches {@link UnsupportedEncodingException} and rethrows it as {@link IllegalStateException}, which * should never happen for a required charset name. Use this method when the encoding is required to be in the JRE. *

* * @param string * the String to encode * @param charsetName * The name of a required {@link java.nio.charset.Charset} * @return encoded bytes * @throws IllegalStateException * Thrown when a {@link UnsupportedEncodingException} is caught, which should never happen for a * required charset name. * @see CharEncoding * @see String#getBytes(String) */ public static byte[] getBytesUnchecked(String string, String charsetName) { if (string == null) { return null; } try { return string.getBytes(charsetName); } catch (UnsupportedEncodingException e) { throw AwakeStringUtils.newIllegalStateException(charsetName, e); } } private static IllegalStateException newIllegalStateException(String charsetName, UnsupportedEncodingException e) { return new IllegalStateException(charsetName + ": " + e); } /** * Constructs a new String by decoding the specified array of bytes using the given charset. *

* This method catches {@link UnsupportedEncodingException} and re-throws it as {@link IllegalStateException}, which * should never happen for a required charset name. Use this method when the encoding is required to be in the JRE. *

* * @param bytes * The bytes to be decoded into characters * @param charsetName * The name of a required {@link java.nio.charset.Charset} * @return A new String decoded from the specified array of bytes using the given charset. * @throws IllegalStateException * Thrown when a {@link UnsupportedEncodingException} is caught, which should never happen for a * required charset name. * @see CharEncoding * @see String#String(byte[], String) */ public static String newString(byte[] bytes, String charsetName) { if (bytes == null) { return null; } try { return new String(bytes, charsetName); } catch (UnsupportedEncodingException e) { throw AwakeStringUtils.newIllegalStateException(charsetName, e); } } /** * Constructs a new String by decoding the specified array of bytes using the ISO-8859-1 charset. * * @param bytes * The bytes to be decoded into characters * @return A new String decoded from the specified array of bytes using the given charset. * @throws IllegalStateException * Thrown when a {@link UnsupportedEncodingException} is caught, which should never happen since the * charset is required. */ public static String newStringIso8859_1(byte[] bytes) { return AwakeStringUtils.newString(bytes, CharEncoding.ISO_8859_1); } /** * Constructs a new String by decoding the specified array of bytes using the US-ASCII charset. * * @param bytes * The bytes to be decoded into characters * @return A new String decoded from the specified array of bytes using the given charset. * @throws IllegalStateException * Thrown when a {@link UnsupportedEncodingException} is caught, which should never happen since the * charset is required. */ public static String newStringUsAscii(byte[] bytes) { return AwakeStringUtils.newString(bytes, CharEncoding.US_ASCII); } /** * Constructs a new String by decoding the specified array of bytes using the UTF-16 charset. * * @param bytes * The bytes to be decoded into characters * @return A new String decoded from the specified array of bytes using the given charset. * @throws IllegalStateException * Thrown when a {@link UnsupportedEncodingException} is caught, which should never happen since the * charset is required. */ public static String newStringUtf16(byte[] bytes) { return AwakeStringUtils.newString(bytes, CharEncoding.UTF_16); } /** * Constructs a new String by decoding the specified array of bytes using the UTF-16BE charset. * * @param bytes * The bytes to be decoded into characters * @return A new String decoded from the specified array of bytes using the given charset. * @throws IllegalStateException * Thrown when a {@link UnsupportedEncodingException} is caught, which should never happen since the * charset is required. */ public static String newStringUtf16Be(byte[] bytes) { return AwakeStringUtils.newString(bytes, CharEncoding.UTF_16BE); } /** * Constructs a new String by decoding the specified array of bytes using the UTF-16LE charset. * * @param bytes * The bytes to be decoded into characters * @return A new String decoded from the specified array of bytes using the given charset. * @throws IllegalStateException * Thrown when a {@link UnsupportedEncodingException} is caught, which should never happen since the * charset is required. */ public static String newStringUtf16Le(byte[] bytes) { return AwakeStringUtils.newString(bytes, CharEncoding.UTF_16LE); } /** * Constructs a new String by decoding the specified array of bytes using the UTF-8 charset. * * @param bytes * The bytes to be decoded into characters * @return A new String decoded from the specified array of bytes using the given charset. * @throws IllegalStateException * Thrown when a {@link UnsupportedEncodingException} is caught, which should never happen since the * charset is required. */ public static String newStringUtf8(byte[] bytes) { return AwakeStringUtils.newString(bytes, CharEncoding.UTF_8); } }




© 2015 - 2024 Weber Informatics LLC | Privacy Policy