Merge branch 'documentation/JAL-3407_2.11.1_release' into releases/Release_2_11_1_Branch
[jalview.git] / src / jalview / util / JSONUtils.java
1 /*
2  * Jalview - A Sequence Alignment Editor and Viewer ($$Version-Rel$$)
3  * Copyright (C) $$Year-Rel$$ The Jalview Authors
4  * 
5  * This file is part of Jalview.
6  * 
7  * Jalview is free software: you can redistribute it and/or
8  * modify it under the terms of the GNU General Public License 
9  * as published by the Free Software Foundation, either version 3
10  * of the License, or (at your option) any later version.
11  *  
12  * Jalview is distributed in the hope that it will be useful, but 
13  * WITHOUT ANY WARRANTY; without even the implied warranty 
14  * of MERCHANTABILITY or FITNESS FOR A PARTICULAR 
15  * PURPOSE.  See the GNU General Public License for more details.
16  * 
17  * You should have received a copy of the GNU General Public License
18  * along with Jalview.  If not, see <http://www.gnu.org/licenses/>.
19  * The Jalview Authors are detailed in the 'AUTHORS' file.
20  */
21 package jalview.util;
22
23 import org.json.simple.JSONArray;
24
25 public class JSONUtils
26 {
27
28   /**
29    * Converts a JSONArray of values to a string as a comma-separated list.
30    * Answers null if the array is null or empty.
31    * 
32    * @param jsonArray
33    * @return
34    */
35   public static String arrayToList(JSONArray jsonArray)
36   {
37     if (jsonArray == null)
38     {
39       return null;
40     }
41
42     StringBuilder sb = new StringBuilder();
43     for (int i = 0; i < jsonArray.size(); i++)
44     {
45       if (i > 0)
46       {
47         sb.append(",");
48       }
49       sb.append(jsonArray.get(i).toString());
50     }
51     return sb.length() == 0 ? null : sb.toString();
52   }
53
54 }