2 * Jalview - A Sequence Alignment Editor and Viewer ($$Version-Rel$$)
3 * Copyright (C) $$Year-Rel$$ The Jalview Authors
5 * This file is part of Jalview.
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.
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.
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.
23 import java.util.ArrayList;
24 import java.util.HashSet;
25 import java.util.LinkedHashMap;
26 import java.util.List;
27 import java.util.Locale;
32 * A singleton registry of alignment file formats known to Jalview. On startup,
33 * the 'built-in' formats are added (from the FileFormat enum). Additional
34 * formats can be registered (or formats deregistered) programmatically, for
35 * example with a Groovy script.
40 public class FileFormats
42 private static FileFormats instance = new FileFormats();
45 * A lookup map of file formats by upper-cased name
47 private static Map<String, FileFormatI> formats;
50 * Formats in this set are capable of being identified by IdentifyFile
52 private static Set<FileFormatI> identifiable;
54 public static FileFormats getInstance()
60 * Private constructor registers Jalview's built-in file formats
68 * Reset to just the built-in file formats packaged with Jalview. These are
69 * added (and will be shown in menus) in the order of their declaration in the
72 public synchronized void reset()
74 formats = new LinkedHashMap<String, FileFormatI>();
75 identifiable = new HashSet<FileFormatI>();
76 for (FileFormat format : FileFormat.values())
78 registerFileFormat(format, format.isIdentifiable());
83 * Answers true if the format is one that can be identified by IdentifyFile.
84 * Answers false for a null value.
86 public boolean isIdentifiable(FileFormatI f)
88 return identifiable.contains(f);
92 * Registers a file format for case-insensitive lookup by name
96 public void registerFileFormat(FileFormatI format)
98 boolean isIdentifiable = format instanceof FileFormat
99 && ((FileFormat) format).isIdentifiable();
100 registerFileFormat(format, isIdentifiable);
103 protected void registerFileFormat(FileFormatI format,
104 boolean isIdentifiable)
106 String name = format.getName().toUpperCase(Locale.ROOT);
107 if (formats.containsKey(name))
109 System.err.println("Overwriting file format: " + format.getName());
111 formats.put(name, format);
114 identifiable.add(format);
119 * Deregisters a file format so it is no longer shown in menus
123 public void deregisterFileFormat(String name)
125 FileFormatI ff = formats.remove(name.toUpperCase(Locale.ROOT));
126 identifiable.remove(ff);
130 * Answers a list of writeable file formats (as strings, corresponding to the
131 * getName() and forName() methods)
134 * if true, only text (not binary) formats are included
137 public List<String> getWritableFormats(boolean textOnly)
139 List<String> l = new ArrayList<String>();
140 for (FileFormatI ff : formats.values())
142 if (ff.isWritable() && (!textOnly || ff.isTextFormat()))
151 * Answers a list of readable file formats (as strings, corresponding to the
152 * getName() and forName() methods)
156 public List<String> getReadableFormats()
158 List<String> l = new ArrayList<String>();
159 for (FileFormatI ff : formats.values())
170 * Returns the file format with the given name, or null if format is null or
171 * invalid. This is not case-sensitive.
176 public FileFormatI forName(String format)
178 return format == null ? null : formats.get(format.toUpperCase(Locale.ROOT));
182 * Returns an iterable collection of registered file formats (in the order in
183 * which they were registered)
187 public Iterable<FileFormatI> getFormats()
189 return formats.values();