Defines output that will be processed by actions.

diff --git a/src/main/java/net/pterodactylus/reactor/output/Output.java b/src/main/java/net/pterodactylus/reactor/output/Output.java
new file mode 100644 (file)
index 0000000..b3e26c7
--- /dev/null
+++ b/src/main/java/net/pterodactylus/reactor/output/Output.java
@@ -0,0 +1,56 @@
+/*
+ * Reactor - Output.java - Copyright © 2013 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
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program.  If not, see <http://www.gnu.org/licenses/>.
+ */
+
+package net.pterodactylus.reactor.output;
+
+import net.pterodactylus.reactor.Trigger;
+
+/**
+ * Defines the output of a {@link Trigger}. As different output has to be
+ * generated for different media, the {@link #text(String, int)} method takes as
+ * an argument the MIME type of the desired output.
+ *
+ * @author <a href="mailto:bombe@pterodactylus.net">David ‘Bombe’ Roden</a>
+ */
+public interface Output {
+
+       /**
+        * Returns a short summary that can be included e. g. in the subject of an
+        * email.
+        *
+        * @return A short summary of the output
+        */
+       String summary();
+
+       /**
+        * Returns the text for the given MIME type and the given maximum length.
+        * Note that the maximum length does not need to be enforced at all costs;
+        * implementation are free to return texts longer than the given number of
+        * characters.
+        *
+        * @param mimeType
+        *            The MIME type of the text (“text/plain” and “text/html” should
+        *            be supported by all {@link Trigger}s)
+        * @param maxLength
+        *            The maximum length of the returned text (may be &lt; {@code 0}
+        *            to indicate no length restriction)
+        * @return The text for the given MIME type, or {@code null} if there is no
+        *         text defined for the given MIME type
+        */
+       String text(String mimeType, int maxLength);
+
+}