Java DiscordWebhook class to easily execute Discord Webhooks

DiscordWebhook.java

import javax.net.ssl.HttpsURLConnection;
import java.awt.Color;
import java.io.IOException;
import java.io.OutputStream;
import java.lang.reflect.Array;
import java.net.URL;
import java.util.ArrayList;
import java.util.HashMap;
import java.util.List;
import java.util.Map;
import java.util.Set;

/**
 * Class used to execute Discord Webhooks with low effort
 */
public class DiscordWebhook {

    private final String url;
    private String content;
    private String username;
    private String avatarUrl;
    private boolean tts;
    private List<EmbedObject> embeds = new ArrayList<>();

    /**
     * Constructs a new DiscordWebhook instance
     *
     * @param url The webhook URL obtained in Discord
     */
    public DiscordWebhook(String url) {
        this.url = url;
    }

    public void setContent(String content) {
        this.content = content;
    }

    public void setUsername(String username) {
        this.username = username;
    }

    public void setAvatarUrl(String avatarUrl) {
        this.avatarUrl = avatarUrl;
    }

    public void setTts(boolean tts) {
        this.tts = tts;
    }

    public void addEmbed(EmbedObject embed) {
        this.embeds.add(embed);
    }

    public void execute() throws IOException {
        if (this.content == null && this.embeds.isEmpty()) {
            throw new IllegalArgumentException("Set content or add at least one EmbedObject");
        }

        JSONObject json = new JSONObject();

        json.put("content", this.content);
        json.put("username", this.username);
        json.put("avatar_url", this.avatarUrl);
        json.put("tts", this.tts);

        if (!this.embeds.isEmpty()) {
            List<JSONObject> embedObjects = new ArrayList<>();

            for (EmbedObject embed : this.embeds) {
                JSONObject jsonEmbed = new JSONObject();

                jsonEmbed.put("title", embed.getTitle());
                jsonEmbed.put("description", embed.getDescription());
                jsonEmbed.put("url", embed.getUrl());

                if (embed.getColor() != null) {
                    Color color = embed.getColor();
                    int rgb = color.getRed();
                    rgb = (rgb << 8) + color.getGreen();
                    rgb = (rgb << 8) + color.getBlue();

                    jsonEmbed.put("color", rgb);
                }

                EmbedObject.Footer footer = embed.getFooter();
                EmbedObject.Image image = embed.getImage();
                EmbedObject.Thumbnail thumbnail = embed.getThumbnail();
                EmbedObject.Author author = embed.getAuthor();
                List<EmbedObject.Field> fields = embed.getFields();

                if (footer != null) {
                    JSONObject jsonFooter = new JSONObject();

                    jsonFooter.put("text", footer.getText());
                    jsonFooter.put("icon_url", footer.getIconUrl());
                    jsonEmbed.put("footer", jsonFooter);
                }

                if (image != null) {
                    JSONObject jsonImage = new JSONObject();

                    jsonImage.put("url", image.getUrl());
                    jsonEmbed.put("image", jsonImage);
                }

                if (thumbnail != null) {
                    JSONObject jsonThumbnail = new JSONObject();

                    jsonThumbnail.put("url", thumbnail.getUrl());
                    jsonEmbed.put("thumbnail", jsonThumbnail);
                }

                if (author != null) {
                    JSONObject jsonAuthor = new JSONObject();

                    jsonAuthor.put("name", author.getName());
                    jsonAuthor.put("url", author.getUrl());
                    jsonAuthor.put("icon_url", author.getIconUrl());
                    jsonEmbed.put("author", jsonAuthor);
                }

                List<JSONObject> jsonFields = new ArrayList<>();
                for (EmbedObject.Field field : fields) {
                    JSONObject jsonField = new JSONObject();

                    jsonField.put("name", field.getName());
                    jsonField.put("value", field.getValue());
                    jsonField.put("inline", field.isInline());

                    jsonFields.add(jsonField);
                }

                jsonEmbed.put("fields", jsonFields.toArray());
                embedObjects.add(jsonEmbed);
            }

            json.put("embeds", embedObjects.toArray());
        }

        URL url = new URL(this.url);
        HttpsURLConnection connection = (HttpsURLConnection) url.openConnection();
        connection.addRequestProperty("Content-Type", "application/json");
        connection.addRequestProperty("User-Agent", "Java-DiscordWebhook-BY-Gelox_");
        connection.setDoOutput(true);
        connection.setRequestMethod("POST");

        OutputStream stream = connection.getOutputStream();
        stream.write(json.toString().getBytes());
        stream.flush();
        stream.close();

        connection.getInputStream().close(); //I'm not sure why but it doesn't work without getting the InputStream
        connection.disconnect();
    }

    public static class EmbedObject {
        private String title;
        private String description;
        private String url;
        private Color color;

        private Footer footer;
        private Thumbnail thumbnail;
        private Image image;
        private Author author;
        private List<Field> fields = new ArrayList<>();

        public String getTitle() {
            return title;
        }

        public String getDescription() {
            return description;
        }

        public String getUrl() {
            return url;
        }

        public Color getColor() {
            return color;
        }

        public Footer getFooter() {
            return footer;
        }

        public Thumbnail getThumbnail() {
            return thumbnail;
        }

        public Image getImage() {
            return image;
        }

        public Author getAuthor() {
            return author;
        }

        public List<Field> getFields() {
            return fields;
        }

        public EmbedObject setTitle(String title) {
            this.title = title;
            return this;
        }

        public EmbedObject setDescription(String description) {
            this.description = description;
            return this;
        }

        public EmbedObject setUrl(String url) {
            this.url = url;
            return this;
        }

        public EmbedObject setColor(Color color) {
            this.color = color;
            return this;
        }

        public EmbedObject setFooter(String text, String icon) {
            this.footer = new Footer(text, icon);
            return this;
        }

        public EmbedObject setThumbnail(String url) {
            this.thumbnail = new Thumbnail(url);
            return this;
        }

        public EmbedObject setImage(String url) {
            this.image = new Image(url);
            return this;
        }

        public EmbedObject setAuthor(String name, String url, String icon) {
            this.author = new Author(name, url, icon);
            return this;
        }

        public EmbedObject addField(String name, String value, boolean inline) {
            this.fields.add(new Field(name, value, inline));
            return this;
        }

        private class Footer {
            private String text;
            private String iconUrl;

            private Footer(String text, String iconUrl) {
                this.text = text;
                this.iconUrl = iconUrl;
            }

            private String getText() {
                return text;
            }

            private String getIconUrl() {
                return iconUrl;
            }
        }

        private class Thumbnail {
            private String url;

            private Thumbnail(String url) {
                this.url = url;
            }

            private String getUrl() {
                return url;
            }
        }

        private class Image {
            private String url;

            private Image(String url) {
                this.url = url;
            }

            private String getUrl() {
                return url;
            }
        }

        private class Author {
            private String name;
            private String url;
            private String iconUrl;

            private Author(String name, String url, String iconUrl) {
                this.name = name;
                this.url = url;
                this.iconUrl = iconUrl;
            }

            private String getName() {
                return name;
            }

            private String getUrl() {
                return url;
            }

            private String getIconUrl() {
                return iconUrl;
            }
        }

        private class Field {
            private String name;
            private String value;
            private boolean inline;

            private Field(String name, String value, boolean inline) {
                this.name = name;
                this.value = value;
                this.inline = inline;
            }

            private String getName() {
                return name;
            }

            private String getValue() {
                return value;
            }

            private boolean isInline() {
                return inline;
            }
        }
    }

    private class JSONObject {

        private final HashMap<String, Object> map = new HashMap<>();

        void put(String key, Object value) {
            if (value != null) {
                map.put(key, value);
            }
        }

        @Override
        public String toString() {
            StringBuilder builder = new StringBuilder();
            Set<Map.Entry<String, Object>> entrySet = map.entrySet();
            builder.append("{");

            int i = 0;
            for (Map.Entry<String, Object> entry : entrySet) {
                Object val = entry.getValue();
                builder.append(quote(entry.getKey())).append(":");

                if (val instanceof String) {
                    builder.append(quote(String.valueOf(val)));
                } else if (val instanceof Integer) {
                    builder.append(Integer.valueOf(String.valueOf(val)));
                } else if (val instanceof Boolean) {
                    builder.append(val);
                } else if (val instanceof JSONObject) {
                    builder.append(val.toString());
                } else if (val.getClass().isArray()) {
                    builder.append("[");
                    int len = Array.getLength(val);
                    for (int j = 0; j < len; j++) {
                        builder.append(Array.get(val, j).toString()).append(j != len - 1 ? "," : "");
                    }
                    builder.append("]");
                }

                builder.append(++i == entrySet.size() ? "}" : ",");
            }

            return builder.toString();
        }

        private String quote(String string) {
            return "\"" + string + "\"";
        }
    }

}

It's very nice class, thank you! But I have a problem with sending cyrilic characters - it gives BAD REQUEST error qwo

nice

Works perfect, thank you!

For other users: be sure you creating the DiscordWebhook object (message) inside the method and you won't get errors like
Cannot resolve method 'addField' in '*Classname*'.

I can't get this to work? I wanted to use the example they provided, but I can't find where to put it, whatever I do, I just get the error Syntax error on token ".", @ expected after this token Does anyone know a fix for this?
Edit: Solved, I was being dumb and forgot to add main

God bless you

Hey there. What's the license on this code?

@Whanos

Hey there. What's the license on this code?

So, gists don't have licenses and if they aren't private, they can be used by everyone.
But in any case, it is most respectful to point to the source or the author :)

I love it! It works. But can this script also be called an "API"?

What?

…

On Fri, 6 Aug 2021, at 11:26, getQueryString wrote: ***@***.**** commented on this gist. I love it! It works. But can this script also be called an "API"? — You are receiving this because you were mentioned. Reply to this email directly, view it on GitHub <https://gist.github.com/fba6f6b37594eae3d6f9475330733bdb#gistcomment-3848619>, or unsubscribe <https://github.com/notifications/unsubscribe-auth/AG6FVV2BGGSUBTBQI6A67M3T3O2GDANCNFSM4HPVINDA>.

Thank you for the awesome Class, I am pretty new to Java and this insipred me to keep learning!

Hi, did lombok implementation and little code cleanup here. :) https://gist.github.com/itIsMaku/5e4edef950e0b83374f79c9675444866

HTTP Error 400 ... ????

same

Has anyone a fix for HTTP Error 400?
Error-Code:
java.io.IOException: Server returned HTTP response code: 400 for URL: https://discord.com/api/webhooks/XXX

No I have the error too
Server returned HTTP response code: 400 for URL

Has anyone a fix for HTTP Error 400? Error-Code: java.io.IOException: Server returned HTTP response code: 400 for URL: https://discord.com/api/webhooks/XXX

This error is caused by special characters, accents for example, to correct it just change line 148 this way:

before:
stream.write(json.toString().getBytes());

later:
stream.write(json.toString().getBytes("UTF-8"));

;)

Continuing from above comment
It's now line 150, and change it to

stream.write(json.toString().getBytes(StandardCharsets.UTF_8));

How to make a new line in setDescription?

I've tried using \n but without success.

new line

System.getProperty("line.separator")

new line

System.getProperty("line.separator")

Thanks!

What's the license on this code? According to this topic "Gists are considered like repositories with regards to licensing." And from this If you find software that doesn’t have a license, that generally means you have no permission from the creators of the software to use, modify, or share the software. Although a code host such as GitHub may allow you to view and fork the code, this does not imply that you are permitted to use, modify, or share the software for any purpose.

What's the license on this code? According to this topic "Gists are considered like repositories with regards to licensing." And from this If you find software that doesn’t have a license, that generally means you have no permission from the creators of the software to use, modify, or share the software. Although a code host such as GitHub may allow you to view and fork the code, this does not imply that you are permitted to use, modify, or share the software for any purpose.

Despite choosealicense.com saying otherwise, I'd assume that (as the original author hasn't said anything in regards to licensing) the author intended this to be able to be used and modified by all. I'd still credit it of course. It is up to you however.

Continuing from above comment It's now line 150, and change it to

stream.write(json.toString().getBytes(StandardCharsets.UTF_8));

Done but still got 404 Error

Continuing from above comment It's now line 150, and change it to

stream.write(json.toString().getBytes(StandardCharsets.UTF_8));

did this, still getting the same issue.
but now on connection.getInputStream().close();?

How can i make a new line in setContent?

new line

System.getProperty("line.separator")

Probably use this

Continuing from above comment It's now line 150, and change it to

stream.write(json.toString().getBytes(StandardCharsets.UTF_8));

did this, still getting the same issue. but now on connection.getInputStream().close();?

I have the same problem, did you find a fix?

Continuing from above comment It's now line 150, and change it to

stream.write(json.toString().getBytes(StandardCharsets.UTF_8));

did this, still getting the same issue. but now on connection.getInputStream().close();?

I have the same problem, did you find a fix?

send us your code so we can help u

i dont know anything about java or making my own code😭, does anyone know how I'm able to change the color of the messages in discord or if possible anyway to use discords embedded messages code

Thanks! very usefull