Network Android

/*
 * 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();
  }
}