3 import java.util.ArrayList;
4 import java.util.HashSet;
5 import java.util.LinkedHashMap;
11 * A singleton registry of alignment file formats known to Jalview. On startup,
12 * the 'built-in' formats are added (from the FileFormat enum). Additional
13 * formats can be registered (or formats deregistered) programmatically, for
14 * example with a Groovy script.
19 public class FileFormats
21 private static FileFormats instance = new FileFormats();
24 * A lookup map of file formats by upper-cased name
26 private static Map<String, FileFormatI> formats;
29 * Formats in this set are capable of being identified by IdentifyFile
31 private static Set<FileFormatI> identifiable;
33 public static FileFormats getInstance()
39 * Private constructor registers Jalview's built-in file formats
47 * Reset to just the built-in file formats packaged with Jalview. These are
48 * added (and will be shown in menus) in the order of their declaration in the
51 public synchronized void reset()
53 formats = new LinkedHashMap<String, FileFormatI>();
54 identifiable = new HashSet<FileFormatI>();
55 for (FileFormat format : FileFormat.values())
57 registerFileFormat(format, format.isIdentifiable());
62 * Answers true if the format is one that can be identified by IdentifyFile.
63 * Answers false for a null value.
65 public boolean isIdentifiable(FileFormatI f)
67 return identifiable.contains(f);
71 * Registers a file format for case-insensitive lookup by name
75 public void registerFileFormat(FileFormatI format)
77 registerFileFormat(format, false);
80 protected void registerFileFormat(FileFormatI format,
81 boolean isIdentifiable)
83 String name = format.getName().toUpperCase();
84 if (formats.containsKey(name))
86 System.err.println("Overwriting file format: " + format.getName());
88 formats.put(name, format);
91 identifiable.add(format);
96 * Deregisters a file format so it is no longer shown in menus
100 public void deregisterFileFormat(String name)
102 FileFormatI ff = formats.remove(name.toUpperCase());
103 identifiable.remove(ff);
107 * Answers a list of writeable file formats (as strings, corresponding to the
108 * getName() and forName() methods)
111 * if true, only text (not binary) formats are included
114 public List<String> getWritableFormats(boolean textOnly)
116 List<String> l = new ArrayList<String>();
117 for (FileFormatI ff : formats.values())
119 if (ff.isWritable() && (!textOnly || ff.isTextFormat()))
128 * Answers a list of readable file formats (as strings, corresponding to the
129 * getName() and forName() methods)
133 public List<String> getReadableFormats()
135 List<String> l = new ArrayList<String>();
136 for (FileFormatI ff : formats.values())
147 * Returns the file format with the given name, or null if format is null or
148 * invalid. This is not case-sensitive.
153 public FileFormatI forName(String format)
155 return format == null ? null : formats.get(format.toUpperCase());
159 * Returns an iterable collection of registered file formats (in the order in
160 * which they were registered)
164 public Iterable<FileFormatI> getFormats()
166 return formats.values();