API implementation for updating current user's status (fix #6)

This class is capable of setting a custom user status via zulip API.

Author: Markus Keunecke

src/main/java/io/taliox/zulip/calls/users/PostUserStatus.java

@@ -0,0 +1,50 @@
+package io.taliox.zulip.calls.users;
+
+import io.taliox.zulip.ZulipRestExecutor;
+import io.taliox.zulip.calls.ZulipRestAPICall;
+import org.apache.http.client.methods.HttpPost;
+
+/**
+ * Updates the status for the currently authenticated user. See the API description for details on updating the status.
+ *
+ * @see <a href=
+ *       "https://zulip.com/api/update-status">https://zulip.com/api/update-status</a>
+ */
+public class PostUserStatus extends ZulipRestAPICall {
+
+    /**
+     * The content of the status message.
+     * @see <a href=
+     *  "https://zulip.com/api/update-status#parameter-status_text">API description</a>
+     */
+    private final String statusText;
+    /**
+     * The name of the status emoji.
+     * @see <a href=
+     *  "https://zulip.com/api/update-status#parameter-emoji_name">API description</a>
+     */
+    private final String emojiName;
+
+    /**
+     * Instantiate a new {@link PostUserStatus}.
+     *
+     * @param statusText
+     *              The content of the status message. If left empty, the status message will be cleared.
+     * @param emojiName
+     *              The name of the status emoji for display in the client.
+     */
+    public PostUserStatus(String statusText, String emojiName) {
+        this.statusText = statusText;
+        this.emojiName = emojiName;
+        setZulipAPIUrl("/api/v1/users/me/status");
+    }
+
+    @Override
+    public String execute(ZulipRestExecutor executor) {
+        setHttpController(executor.httpController);
+        HttpPost post = new HttpPost(this.httpController.getServer() + getZulipAPIUrl());
+        getParameters().put("status_text", this.statusText);
+        getParameters().put("emoji_name", this.emojiName);
+        return performRequest(getParameters(), post);
+    }
+}