- * Will output stories to the console. + * All the readers should be accessed via {@link BasicReader#getReader()}. * * @author niki */ -public abstract class BasicReader { - public enum ReaderType { - /** Simple reader that outputs everything on the console */ - CLI, - /** Reader that starts local programs to handle the stories */ - LOCAL - } +public abstract class BasicReader implements Reader { + private static BasicLibrary defaultLibrary = Instance.getLibrary(); + private static ReaderType defaultType = ReaderType.GUI; - private static ReaderType defaultType; + private BasicLibrary lib; + private MetaData meta; private Story story; - private ReaderType type; + private int chapter; + /** + * Take the default reader type configuration from the config file. + */ static { - // TODO: default type from config + 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 + } + } + } + + @Override + public synchronized Story getStory(Progress pg) { + if (story == null) { + story = getLibrary().getStory(meta.getLuid(), pg); + } + + return story; + } + + @Override + public BasicLibrary getLibrary() { + if (lib == null) { + lib = defaultLibrary; + } + + return lib; + } + + @Override + public void setLibrary(BasicLibrary lib) { + this.lib = lib; + } + + @Override + public synchronized MetaData getMeta() { + return meta; + } + + @Override + public synchronized void setMeta(MetaData meta) throws IOException { + setMeta(meta == null ? null : meta.getLuid()); // must check the library + } + + @Override + public synchronized void setMeta(String luid) throws IOException { + story = null; + meta = getLibrary().getInfo(luid); + + if (meta == null) { + throw new IOException("Cannot retrieve story from library: " + luid); + } + } + + @Override + public synchronized void setMeta(URL url, Progress pg) throws IOException { + BasicSupport support = BasicSupport.getSupport(url); + if (support == null) { + throw new IOException("URL not supported: " + url.toString()); + } + + story = support.process(pg); + if (story == null) { + throw new IOException( + "Cannot retrieve story from external source: " + + url.toString()); + } + + meta = story.getMeta(); + } + + @Override + public int getChapter() { + return chapter; + } + + @Override + public void setChapter(int chapter) { + this.chapter = chapter; } /** - * The type of this reader. + * Return a new {@link BasicReader} ready for use if one is configured. + *
+ * Can return NULL if none are configured.
*
- * @return the type
+ * @return a {@link BasicReader}, or NULL if none configured
*/
- public ReaderType getType() {
- return type;
+ public static Reader getReader() {
+ try {
+ if (defaultType != null) {
+ return (Reader) SerialUtils.createObject(defaultType
+ .getTypeName());
+ }
+ } catch (Exception e) {
+ Instance.getTraceHandler().error(
+ new Exception("Cannot create a reader of type: "
+ + defaultType + " (Not compiled in?)", e));
+ }
+
+ return null;
}
/**
- * The type of this reader.
+ * The default {@link Reader.ReaderType} used when calling
+ * {@link BasicReader#getReader()}.
*
- * @param type
- * the new type
+ * @return the default type
*/
- protected BasicReader setType(ReaderType type) {
- this.type = type;
- return this;
+ public static ReaderType getDefaultReaderType() {
+ return defaultType;
}
/**
- * Return the current {@link Story}.
+ * The default {@link Reader.ReaderType} used when calling
+ * {@link BasicReader#getReader()}.
*
- * @return the {@link Story}
+ * @param defaultType
+ * the new default type
*/
- public Story getStory() {
- return story;
+ public static void setDefaultReaderType(ReaderType defaultType) {
+ BasicReader.defaultType = defaultType;
}
/**
- * Create a new {@link BasicReader} for a {@link Story} in the
- * {@link Library} .
+ * Change the default {@link LocalLibrary} to open with the
+ * {@link BasicReader}s.
*
- * @param luid
- * the {@link Story} ID
- * @throws IOException
- * in case of I/O error
+ * @param lib
+ * the new {@link LocalLibrary}
*/
- public void setStory(String luid) throws IOException {
- story = Instance.getLibrary().getStory(luid);
- if (story == null) {
- throw new IOException("Cannot retrieve story from library: " + luid);
- }
+ public static void setDefaultLibrary(BasicLibrary lib) {
+ BasicReader.defaultLibrary = lib;
}
/**
- * Create a new {@link BasicReader} for an external {@link Story}.
+ * Return an {@link URL} from this {@link String}, be it a file path or an
+ * actual {@link URL}.
*
- * @param source
- * the {@link Story} {@link URL}
- * @throws IOException
- * in case of I/O error
+ * @param sourceString
+ * the source
+ *
+ * @return the corresponding {@link URL}
+ *
+ * @throws MalformedURLException
+ * if this is neither a file nor a conventional {@link URL}
*/
- public void setStory(URL source) throws IOException {
- BasicSupport support = BasicSupport.getSupport(source);
- if (support == null) {
- throw new IOException("URL not supported: " + source.toString());
+ public static URL getUrl(String sourceString) throws MalformedURLException {
+ if (sourceString == null || sourceString.isEmpty()) {
+ throw new MalformedURLException("Empty url");
}
- story = support.process(source);
- if (story == null) {
- throw new IOException(
- "Cannot retrieve story from external source: "
- + source.toString());
-
+ URL source = null;
+ try {
+ source = new URL(sourceString);
+ } catch (MalformedURLException e) {
+ File sourceFile = new File(sourceString);
+ source = sourceFile.toURI().toURL();
}
+
+ return source;
}
/**
- * Start the {@link Story} Reading.
+ * Describe a {@link Story} from its {@link MetaData} and return a list of
+ * title/value that represent this {@link Story}.
*
- * @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 meta
+ * the {@link MetaData} to represent
*
- * @param chapter
- * the chapter
+ * @return the information
*/
- public abstract void read(int chapter);
+ public static Map