X-Git-Url: https://git.pterodactylus.net/?a=blobdiff_plain;f=src%2Fmain%2Fjava%2Fnet%2Fpterodactylus%2Fsone%2Ftext%2FParser.java;h=ca26a790a3aba92b1ce63a202163c30b76709c8a;hb=16b7ecd68873178d79b81023fc702d61d7696e13;hp=e43ed47566f490f2aa850f41d2bcfb0a919b5280;hpb=f4ea1e1b3526175e255831c975d6eea813589f25;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 e43ed47..ca26a79 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–2015 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 @@ -19,6 +19,8 @@ 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 @@ -31,16 +33,15 @@ import java.io.Reader; 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 context - * The parser context + * The parser context (may be {@code null}) * @param source * The text source - * @return The parsed part - * @throws IOException - * if an I/O error occurs + * @return The parsed parts */ - public Part parse(C context, Reader source) throws IOException; + @Nonnull + Iterable parse(@Nullable C context, @Nonnull String source); }