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

net.imadz.util.StringUtil Maven / Gradle / Ivy

Go to download

Lifecycle AOP Framework. Enabling describe enhanced State Diagram with Java language, and processing relational Lifecycle constraints(including: state validations, transitions validations), concurrency, lifecycle callbacks, lifecycle events implicitely with Lifecycle Engine. This engine can be used by class load time (Java Instrumentation) or compile time (Lifecycle-StaticWeaver-maven-plugin).

There is a newer version: 0.9.13
Show newest version
/*
 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS HEADER.
 * 
 * Copyright (c) 2013-2020 Madz. All rights reserved.
 * 
 * The contents of this file are subject to the terms of either the GNU
 * General Public License Version 2 only ("GPL") or the Common Development
 * and Distribution License("CDDL") (collectively, the "License"). You
 * may not use this file except in compliance with the License. You can
 * obtain a copy of the License at
 * https://raw.github.com/zhongdj/Lifecycle/master/License.txt
 * . See the License for the specific
 * language governing permissions and limitations under the License.
 * 
 * When distributing the software, include this License Header Notice in each
 * file and include the License file at packager/legal/LICENSE.txt.
 * 
 * Modifications:
 * If applicable, add the following below the License Header, with the fields
 * enclosed by brackets [] replaced by your own identifying information:
 * "Portions Copyright [year] [name of copyright owner]"
 * 
 * Contributor(s):
 * If you wish your version of this file to be governed by only the CDDL or
 * only the GPL Version 2, indicate your decision by adding "[Contributor]
 * elects to include this software in this distribution under the [CDDL or GPL
 * Version 2] license." If you don't indicate a single choice of license, a
 * recipient has the option to distribute your version of this file under
 * either the CDDL, the GPL Version 2 or to extend the choice of license to
 * its licensees as provided above. However, if you add GPL Version 2 code
 * and therefore, elected the GPL Version 2 license, then the option applies
 * only if the new code is made subject to such option by the copyright
 * holder.
 */
package net.imadz.util;

import java.nio.charset.Charset;
import java.nio.charset.CharsetEncoder;
import java.util.ArrayList;
import java.util.Collection;
import java.util.List;
import java.util.Map;
import java.util.Map.Entry;

import net.imadz.common.Formatter;

public class StringUtil {

    public static final Charset UTF8 = Charset.forName("UTF-8");
    private static final CharsetEncoder UTF8_ENCODER = UTF8.newEncoder(); // used

    /**
     * only for escapeXml - no actual encoding
     */
    public static String escapeXml(String string) {
        return escapeXml(string, UTF8);
    }

    public static String escapeXml(String string, Charset charset) {
        CharsetEncoder encoder = charset == UTF8 ? UTF8_ENCODER : charset.newEncoder();
        StringBuilder sb = new StringBuilder();
        for ( char c : string.toCharArray() ) {
            switch (c) {
                case '<':
                    sb.append("<");
                    break;
                case '>':
                    sb.append(">");
                    break;
                case '\'':
                    sb.append("'");
                    break;
                case '"':
                    sb.append(""");
                    break;
                case '&':
                    sb.append("&");
                    break;
                default:
                    if ( encoder.canEncode(c) ) {
                        sb.append(c);
                    } else {
                        String replacement = "&#" + ( (int) c ) + ";";
                        sb.append(replacement);
                    }
                    break;
            }
        }
        return sb.toString();
    }

    public static String toUppercaseFirstCharacter(String s) {
        if ( s == null || s.length() == 0 ) {
            return s;
        }
        return Character.toUpperCase(s.charAt(0)) + ( s.length() > 1 ? s.substring(1) : "" );
    }

    public static String toLowercaseFirstCharacter(String s) {
        if ( s == null || s.length() == 0 ) {
            return s;
        }
        return Character.toLowerCase(s.charAt(0)) + ( s.length() > 1 ? s.substring(1) : "" );
    }

    public static  String toString(Collection c, String delimiter) {
        return toString(c, delimiter, null, null, ToStringFormatter.getInstance());
    }

    public static  String toString(Collection c, String delimiter, Formatter formatter) {
        return toString(c, delimiter, null, null, formatter);
    }

    public static  String toString(Collection c, String delimiter, String before, String after) {
        return toString(c, delimiter, before, after, ToStringFormatter.getInstance());
    }

    public static  String toString(Collection c, String delimiter, String before, String after, Formatter formatter) {
        if ( c == null ) {
            return null;
        }
        StringBuilder sb = new StringBuilder();
        append(sb, c, delimiter, before, after, formatter);
        return sb.toString();
    }

    public static  void append(StringBuilder sb, Collection c, String delimiter) {
        append(sb, c, delimiter, null, null, ToStringFormatter.getInstance());
    }

    public static  void append(StringBuilder sb, Collection c, String delimiter, Formatter formatter) {
        append(sb, c, delimiter, null, null, formatter);
    }

    public static  void append(StringBuilder sb, Collection c, String delimiter, String before, String after) {
        append(sb, c, delimiter, before, after, ToStringFormatter.getInstance());
    }

    public static  void append(StringBuilder sb, Collection c, String delimiter, String before, String after, Formatter formatter) {
        if ( c.isEmpty() ) {
            return;
        }
        if ( before != null ) {
            sb.append(before);
        }
        boolean first = true;
        for ( E e : c ) {
            if ( first ) {
                first = false;
            } else {
                sb.append(delimiter);
            }
            sb.append(formatter.format(e));
        }
        if ( after != null ) {
            sb.append(after);
        }
    }

    public static  String toString(Map m, String delimiter) {
        return toString(m, delimiter, "=", true, null, null, ToStringFormatter.getInstance(), ToStringFormatter.getInstance());
    }

    public static  String toString(Map m, String delimiter, String entryDelimiter, boolean includeEntryDelimiterOnEmptyValue) {
        return toString(m, delimiter, entryDelimiter, includeEntryDelimiterOnEmptyValue, null, null, ToStringFormatter.getInstance(),
                ToStringFormatter.getInstance());
    }

    public static  String toString(Map m, String delimiter, String entryDelimiter, boolean includeEntryDelimiterOnEmptyValue, String before,
            String after) {
        return toString(m, delimiter, entryDelimiter, includeEntryDelimiterOnEmptyValue, before, after, ToStringFormatter.getInstance(),
                ToStringFormatter.getInstance());
    }

    public static  String toString(Map m, String delimiter, String entryDelimiter, boolean includeEntryDelimiterOnEmptyValue, String before,
            String after, Formatter keyFormatter, Formatter valueFormatter) {
        if ( m == null ) {
            return null;
        }
        StringBuilder sb = new StringBuilder();
        append(sb, m, delimiter, entryDelimiter, includeEntryDelimiterOnEmptyValue, before, after, keyFormatter, valueFormatter);
        return sb.toString();
    }

    public static  void append(StringBuilder sb, Map m, String delimiter) {
        append(sb, m, delimiter, "=", true, null, null, ToStringFormatter.getInstance(), ToStringFormatter.getInstance());
    }

    public static  void append(StringBuilder sb, Map m, String delimiter, String entryDelimiter, boolean includeEntryDelimiterOnEmptyValue) {
        append(sb, m, delimiter, entryDelimiter, includeEntryDelimiterOnEmptyValue, null, null, ToStringFormatter.getInstance(),
                ToStringFormatter.getInstance());
    }

    public static  void append(StringBuilder sb, Map m, String delimiter, String entryDelimiter, boolean includeEntryDelimiterOnEmptyValue,
            String before, String after) {
        append(sb, m, delimiter, entryDelimiter, includeEntryDelimiterOnEmptyValue, before, after, ToStringFormatter.getInstance(),
                ToStringFormatter.getInstance());
    }

    public static  void append(StringBuilder sb, Map m, String delimiter, String entryDelimiter, boolean includeEntryDelimiterOnEmptyValue,
            String before, String after, Formatter keyFormatter, Formatter valueFormatter) {
        if ( m.isEmpty() ) {
            return;
        }
        if ( before != null ) {
            sb.append(before);
        }
        boolean first = true;
        for ( Entry entry : m.entrySet() ) {
            if ( first ) {
                first = false;
            } else {
                sb.append(delimiter);
            }
            sb.append(keyFormatter.format(entry.getKey()));
            String valueString = valueFormatter.format(entry.getValue());
            if ( includeEntryDelimiterOnEmptyValue || !valueString.equals("") ) {
                sb.append(entryDelimiter);
                sb.append(valueString);
            }
        }
        if ( after != null ) {
            sb.append(after);
        }
    }

    /**
     * Simple split method that preserves empty-string tokens. Java's split
     * method strips out empty tokens.
     */
    public static List split(String s, char delimiter) {
        List tokens = new ArrayList();
        for ( int start = 0, index = 0;; start = index + 1 ) {
            index = s.indexOf(delimiter, start);
            if ( index != -1 ) {
                tokens.add(s.substring(start, index));
            } else {
                tokens.add(s.substring(start));
                break;
            }
        }
        return tokens;
    }

    public static String leftPad(String s, char pad, int length) {
        int padLength = s.length() - length;
        if ( padLength > 0 ) {
            StringBuilder sb = new StringBuilder();
            for ( ; padLength > 0; padLength-- ) {
                sb.append(pad);
            }
            sb.append(s);
            return sb.toString();
        }
        return s;
    }
}




© 2015 - 2025 Weber Informatics LLC | Privacy Policy