ManifestHeaderUtils.java

/*
 * Licensed to the Apache Software Foundation (ASF) under one
 * or more contributor license agreements.  See the NOTICE file
 * distributed with this work for additional information
 * regarding copyright ownership.  The ASF licenses this file
 * to you 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 WARRANTIESOR CONDITIONS OF ANY
 * KIND, either express or implied.  See the License for the
 * specific language governing permissions and limitations
 * under the License.
 */
package org.apache.aries.util;

import java.util.ArrayList;
import java.util.List;

import org.apache.aries.util.internal.MessageUtil;



public class ManifestHeaderUtils {

     /**
     * 
     * Splits a delimiter separated string, tolerating presence of non separator commas
     * within double quoted segments.
     * 
     * Eg.
     * com.ibm.ws.eba.helloWorldService;version="[1.0.0, 1.0.0]" &
     * com.ibm.ws.eba.helloWorldService;version="1.0.0"
     * com.ibm.ws.eba.helloWorld;version="2";bundle-version="[2,30)"
     * com.acme.foo;weirdAttr="one;two;three";weirdDir:="1;2;3"
     *  @param value          the value to be split
     *  @param delimiter      the delimiter string such as ',' etc.
     *  @return List<String>  the components of the split String in a list
     */
    public static List<String> split(String value, String delimiter)
    {
      List<String> result = new ArrayList<String>();
      if (value != null) {
        String[] packages = value.split(delimiter);
        
        for (int i = 0; i < packages.length; ) {
          String tmp = packages[i++].trim();
          // if there is a odd number of " in a string, we need to append
          while (count(tmp, "\"") % 2 != 0) {
            // check to see if we need to append the next package[i++]          
              if (i<packages.length)
                tmp = tmp + delimiter + packages[i++].trim();
              else 
                // oops. The double quotes are not paired up. We have reached to the end of the string.
                throw new IllegalArgumentException(MessageUtil.getMessage("UTIL0008E",tmp));        
          }
          
          result.add(tmp);
          
        }
      }
      return result;
    }  
   
    /**
     * count the number of characters in a string
     * @param parent The string to be searched
     * @param subString The substring to be found
     * @return the number of occurrence of the subString
     */
     private static int count(String parent, String subString) {
       
       int count = 0 ;
       int i = parent.indexOf(subString);
       while (i > -1) {
         if (parent.length() >= i+1)
           parent = parent.substring(i+1);
         count ++;
         i = parent.indexOf(subString);
       }
       return count;
     }
}