- /**
- * A type of {@link BasicReader}.
- *
- * @author niki
- */
- public enum ReaderType {
- /** Simple reader that outputs everything on the console */
- CLI,
- /** Reader that starts local programs to handle the stories */
- GUI,
- /** A text (UTF-8) reader with menu and text windows */
- TUI,
-
- ;
-
- /**
- * Return the full class name of a type that implements said
- * {@link ReaderType}.
- *
- * @return the class name
- */
- public String getTypeName() {
- String pkg = "be.nikiroo.fanfix.reader.";
- switch (this) {
- case CLI:
- return pkg + "CliReader";
- case TUI:
- return pkg + "TuiReader";
- case GUI:
- return pkg + "GuiReader";
- }
-
- return null;
- }
- }
-
- private static BasicLibrary defaultLibrary = Instance.getLibrary();
- private static ReaderType defaultType = ReaderType.GUI;
-
- private BasicLibrary lib;
- private Story story;
- private ReaderType type;
-
- /**
- * Take the default reader type configuration from the config file.
- */
- static {
- String typeString = Instance.getConfig().getString(Config.READER_TYPE);
- if (typeString != null && !typeString.isEmpty()) {
- try {
- ReaderType type = ReaderType.valueOf(typeString.toUpperCase());
- defaultType = type;
- } catch (IllegalArgumentException e) {
- // Do nothing
- }
- }
- }
-
- /**
- * The type of this reader.
- *
- * @return the type
- */
- public ReaderType getType() {
- return type;
- }
-
- /**
- * The type of this reader.
- *
- * @param type
- * the new type
- *
- * @return the type
- */
- protected BasicReader setType(ReaderType type) {
- this.type = type;
- return this;
- }
-
- /**
- * Return the current {@link Story}.
- *
- * @return the {@link Story}
- */
- public Story getStory() {
- return story;
- }
-
- /**
- * The {@link LocalLibrary} to load the stories from (by default, takes the
- * default {@link LocalLibrary}).
- *
- * @return the {@link LocalLibrary}
- */
- public BasicLibrary getLibrary() {
- if (lib == null) {
- lib = defaultLibrary;
- }
-
- return lib;
- }
-
- /**
- * Change the {@link LocalLibrary} that will be managed by this
- * {@link BasicReader}.
- *
- * @param lib
- * the new {@link LocalLibrary}
- */
- public void setLibrary(LocalLibrary lib) {
- this.lib = lib;
- }
-
- /**
- * Create a new {@link BasicReader} for a {@link Story} in the
- * {@link LocalLibrary}.
- *
- * @param luid
- * the {@link Story} ID
- * @param pg
- * the optional progress reporter
- *
- * @throws IOException
- * in case of I/O error
- */
- public void setStory(String luid, Progress pg) throws IOException {
- story = lib.getStory(luid, pg);
- if (story == null) {
- throw new IOException("Cannot retrieve story from library: " + luid);
- }
- }
-
- /**
- * Create a new {@link BasicReader} for an external {@link Story}.
- *
- * @param source
- * the {@link Story} {@link URL}
- * @param pg
- * the optional progress reporter
- *
- * @throws IOException
- * in case of I/O error
- */
- public void setStory(URL source, Progress pg) throws IOException {
- BasicSupport support = BasicSupport.getSupport(source);
- if (support == null) {
- throw new IOException("URL not supported: " + source.toString());
- }
-
- story = support.process(source, pg);
- if (story == null) {
- throw new IOException(
- "Cannot retrieve story from external source: "
- + source.toString());
-
- }
- }
-
- /**
- * Start the {@link Story} Reading.
- *
- * @throws IOException
- * in case of I/O error or if the {@link Story} was not
- * previously set
- */
- public abstract void read() throws IOException;
-
- /**
- * Read the selected chapter (starting at 1).
- *
- * @param chapter
- * the chapter
- *
- * @throws IOException
- * in case of I/O error or if the {@link Story} was not
- * previously set
- */
- public abstract void read(int chapter) throws IOException;
-
- /**
- * Start the reader in browse mode for the given source (or pass NULL for
- * all sources).
- *
- * @param source
- * the type of {@link Story} to take into account, or NULL for
- * all
- */
- public abstract void browse(String source);
-
- /**
- * Return a new {@link BasicReader} ready for use if one is configured.
- * <p>
- * Can return NULL if none are configured.
- *
- * @return a {@link BasicReader}, or NULL if none configured
- */
- public static BasicReader getReader() {
- try {
- if (defaultType != null) {
- return ((BasicReader) SerialUtils.createObject(defaultType
- .getTypeName())).setType(defaultType);
- }
- } catch (Exception e) {
- Instance.syserr(new Exception("Cannot create a reader of type: "
- + defaultType + " (Not compiled in?)", e));
- }
-
- return null;
- }
-
- /**
- * The default {@link ReaderType} used when calling
- * {@link BasicReader#getReader()}.
- *
- * @return the default type
- */
- public static ReaderType getDefaultReaderType() {
- return defaultType;
- }
-
- /**
- * The default {@link ReaderType} used when calling
- * {@link BasicReader#getReader()}.
- *
- * @param defaultType
- * the new default type
- */
- public static void setDefaultReaderType(ReaderType defaultType) {
- BasicReader.defaultType = defaultType;
- }
-
- /**
- * Change the default {@link LocalLibrary} to open with the
- * {@link BasicReader}s.
- *
- * @param lib
- * the new {@link LocalLibrary}
- */
- public static void setDefaultLibrary(BasicLibrary lib) {
- BasicReader.defaultLibrary = lib;
- }
-