X-Git-Url: https://git.pterodactylus.net/?a=blobdiff_plain;ds=sidebyside;f=src%2Fmain%2Fjava%2Fnet%2Fpterodactylus%2Fsone%2Ftext%2FParser.java;h=06eed37458b63c0933f3296ccb799883bac7775e;hb=64740709990291688170ebd1f192af5eb9090618;hp=ccec36a74e37e6f73c6d1b7698b56cdc226a46a8;hpb=31b4f988a9c7cc2b36006e3249e3ba644beb99f6;p=Sone.git
diff --git a/src/main/java/net/pterodactylus/sone/text/Parser.java b/src/main/java/net/pterodactylus/sone/text/Parser.java
index ccec36a..06eed37 100644
--- a/src/main/java/net/pterodactylus/sone/text/Parser.java
+++ b/src/main/java/net/pterodactylus/sone/text/Parser.java
@@ -1,5 +1,5 @@
/*
- * Sone - Parser.java - Copyright © 2010 David Roden
+ * Sone - Parser.java - Copyright © 2010â2020 David Roden
*
* This program is free software: you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
@@ -17,26 +17,29 @@
package net.pterodactylus.sone.text;
-import java.io.IOException;
import java.io.Reader;
+import javax.annotation.Nonnull;
+import javax.annotation.Nullable;
/**
* Interface for parsers that can create {@link Part}s from a text source
* (usually a {@link Reader}).
*
- * @author David âBombeâ Roden
+ * @param
+ * The type of the parser context
*/
-public interface Parser {
+public interface Parser {
/**
- * Create a {@link Part} from the given text source.
+ * Create one or more {@link Part}s from the given text source.
*
* @param source
* The text source
- * @return The parsed part
- * @throws IOException
- * if an I/O error occurs
+ * @param context
+ * The parser context (may be {@code null})
+ * @return The parsed parts
*/
- public Part parse(Reader source) throws IOException;
+ @Nonnull
+ Iterable parse(@Nonnull String source, @Nullable C context);
}