/*
* Funambol is a mobile platform developed by Funambol, Inc.
* Copyright (C) 2003 - 2007 Funambol, Inc.
*
* This program is free software; you can redistribute it and/or modify it under
* the terms of the GNU Affero General Public License version 3 as published by
* the Free Software Foundation with the addition of the following permission
* added to Section 15 as permitted in Section 7(a): FOR ANY PART OF THE COVERED
* WORK IN WHICH THE COPYRIGHT IS OWNED BY FUNAMBOL, FUNAMBOL DISCLAIMS THE
* WARRANTY OF NON INFRINGEMENT OF THIRD PARTY RIGHTS.
*
* This program 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 General Public License for more
* details.
*
* You should have received a copy of the GNU Affero General Public License
* along with this program; if not, see http://www.gnu.org/licenses or write to
* the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston,
* MA 02110-1301 USA.
*
* You can contact Funambol, Inc. headquarters at 643 Bair Island Road, Suite
* 305, Redwood City, CA 94063, USA, or at email address info@funambol.com.
*
* The interactive user interfaces in modified source and object code versions
* of this program must display Appropriate Legal Notices, as required under
* Section 5 of the GNU Affero General Public License version 3.
*
* In accordance with Section 7(b) of the GNU Affero General Public License
* version 3, these Appropriate Legal Notices must retain the display of the
* "Powered by Funambol" logo. If the display of the logo is not reasonably
* feasible for technical reasons, the Appropriate Legal Notices must display
* the words "Powered by Funambol".
*/
//package com.funambol.util;
import java.util.Vector;
/**
* Utility class useful when dealing with string objects. This class is a
* collection of static functions, and the usage is:
*
* StringUtil.method()
*
* it is not allowed to create instances of this class
*/
public class StringUtil {
private static final String HT = "\t";
private static final String CRLF = "\r\n";
// This class cannot be instantiated
private StringUtil() {
}
/**
* Split the string into an array of strings using one of the separator in
* 'sep'.
*
* @param s
* the string to tokenize
* @param sep
* a list of separator to use
*
* @return the array of tokens (an array of size 1 with the original string
* if no separator found)
*/
public static String[] split(final String s, final String sep) {
// convert a String s to an Array, the elements
// are delimited by sep
final Vector tokenIndex = new Vector(10);
final int len = s.length();
int i;
// Find all characters in string matching one of the separators in 'sep'
for (i = 0; i < len; i++)
if (sep.indexOf(s.charAt(i)) != -1)
tokenIndex.addElement(new Integer(i));
final int size = tokenIndex.size();
final String[] elements = new String[size + 1];
// No separators: return the string as the first element
if (size == 0)
elements[0] = s;
else {
// Init indexes
int start = 0;
int end = (tokenIndex.elementAt(0)).intValue();
// Get the first token
elements[0] = s.substring(start, end);
// Get the mid tokens
for (i = 1; i < size; i++) {
// update indexes
start = (tokenIndex.elementAt(i - 1)).intValue() + 1;
end = (tokenIndex.elementAt(i)).intValue();
elements[i] = s.substring(start, end);
}
// Get last token
start = (tokenIndex.elementAt(i - 1)).intValue() + 1;
elements[i] = (start < s.length()) ? s.substring(start) : "";
}
return elements;
}
/**
* Builds a list of the recipients email addresses each on a different line,
* starting just from the second line with an HT ("\t") separator at the
* head of the line. This is an implementation of the 'folding' concept from
* the RFC 2822 (par. 2.2.3)
*
* @param recipients
* A string containing all recipients comma-separated
* @return A string containing the email list of the recipients spread over
* more lines, ended by CRLF and beginning from the second with the
* WSP defined in the RFC 2822
*/
public static String fold(final String recipients) {
final String[] list = StringUtil.split(recipients, ",");
final StringBuffer buffer = new StringBuffer();
for (int i = 0; i < list.length; i++) {
final String address = list[i] + (i != list.length - 1 ? "," : "");
buffer.append(i == 0 ? address + StringUtil.CRLF : StringUtil.HT
+ address + StringUtil.CRLF);
}
return buffer.toString();
}
}