v3.6.0 | Manager Rewrite, Improved Documentation

In this release we are replacing the old and clunky updatable manager pattern with a new and flashy rest action extension pattern.

Legacy

channel.getManagerUpdatable()
    .getNameField().setValue("testing")
    .getTopicField().setValue("testing channel")
    .update().queue();

New

channel.getManager()
    .setName("testing") // returns ChannelManager
    .setTopic("testing channel") // returns ChannelManager
    .queue();

Documentation

The event documentation got a complete rewrite and should now be a lot cleaner and (hopefully) more understandable than before.

See: javadoc

Pull Requests

PR	Description
#595	Add sharded listener provider
#608	Manager rewrite
#611	Store color with raw RGB value
#613	Support for parsing more presences
#627	Fallback body parsing for http response
#628	Add Japan region
#630	Added Guild#retrieveRegions
#633	Enhancement for Permissions/CacheView/ErrorResponseException
#634	Make mentions distinct
#636	First pass on new event docs
#644	Return RequestFuture for PaginationAction async iterations
#645	WebSocketClient optimization/enhancement
#646	Added support for bulk updating permission overrides

Thank you all for your contributions!

Versions

Latest verison:

The latest release build: 3.6.0_354

Changelog

Additions

+++ New managers
++ UpdateEvent for generic update events
+ Support for bulk updating permission overrides in channels
+ ShardManager event listener provider
+ Guild#retrieveRegions
+ Japan voice region
+ Role#getColorRaw etc

Changes

- Mentions in Message#getMentionedUsers and getMentionedRoles are now distinct
- Now returning RequestFuture in PaginationAction#forEachAsync and similar
- Color values are now stored as ints rather than java.awt.Color
- WebSocketClient now uses the same buffer for all received payloads
- Spotify presences are now parsed properly
- Renamed UserXUpdateEvent to UserUpdateXEvent for consistency
- UserUpdateNameEvent has been split into name and discriminator update events

Fixes

- ErrorResponseException now gives more details again

Deprecation

+ Marked old updatable managers and associated classes/methods deprecated
+ Marked several old methods in events as deprecated to be replaced by new consistent method names

---

Downloads for this version are available from the build server:
http://home.dv8tion.net:8080/job/JDA/ or below.

Gradle

repositories {
    jcenter()
}

dependencies {
    compile 'net.dv8tion:JDA:3.6.0_354'
}

Maven

<dependency>
    <groupId>net.dv8tion</groupId>
    <artifactId>JDA</artifactId>
    <version>3.6.0_354</version>
</dependency>


<repository>
    <id>jcenter</id>
    <name>jcenter-bintray</name>
    <url>http://jcenter.bintray.com</url>
</repository>