PR Details

• I have checked the PRs for upcoming features/bug fixes.

What you've changed

• Developer-facing library
• Internal Code
• Documentation

Closes #0

Description

Added a new decoding and encoding system for discord.jar. This system is designed for better:

• Readability
• Consistency
• DRY

The main difference here is the removal of existing #decompile and #compile methods. These are replaced by a system built with Java Reflection to prevent repeated code and errors.

Documentation

When creating an object, you must implement the DiscordObject interface. Then, for each of your fields, you must annotate them with @DiscordObjectParameter (you can customize the values to your liking). If you want one of your fields to automatically be filled with the DiscordJar instance, you can annotate it with @DiscordJarParameter, alongside the previous annotation. You must have a constructor annotated with @DiscordObjectConstructor with the same types as the fields, in the same order.

To assign custom values to a key, you may create a static method that takes a JSONObject and returns a HashMap<String, Object> that's annotated with @DiscordObjectCustomAssignations.

To decompile a JSON payload, use
discordJar.getParser().decompileObject(jsonObject, ExampleObject.class);

An example object might look like this, meaning there's no need for a decompile or compile method:

@ToString
public class PizzaObject implements DiscordObject {

    @Getter
    @DiscordObjectParameter(excludable = false, nullable = false)
    private final String name;

    @Getter
    @DiscordObjectParameter(excludable = false, nullable = false)
    private final int size;

    @DiscordObjectParameter(excludable = false, nullable = false)
    private final String[] labels;
    
    @DiscordObjectConstructor
    public PizzaObject(String name, int size, String[] labels) {
        this.name = name;
        this.size = size;
        this.labels = labels;
    }

    @DiscordObjectCustomAssignationsMethod
    public static HashMap<String, Object> customAssignations(JSONObject data) {
        return new HashMap<>(){{
            put("name", "hi im a pizza :)");
        }};
    }
}

Status

• Create decompile system
• Implement compile method
• Implement into all existing model objects
• HashMap implementation
• Simple array decomplication