Add @Notnull annotations

mirai-japt/src/main/java/net/mamoe/mirai/japt/BlockingBot.java

@@ -16,6 +16,7 @@ import org.jetbrains.annotations.Nullable;
 
 import java.util.List;
 
+@SuppressWarnings("unused")
 public interface BlockingBot {
     /**
      * 账号信息
@@ -46,6 +47,7 @@ public interface BlockingBot {
     /**
      * 获取缓存的 QQ 对象. 若没有对应的缓存, 则会线程安全地创建一个.
      */
+    @NotNull
     BlockingQQ getQQ(long id);
 
     /**

mirai-japt/src/main/java/net/mamoe/mirai/japt/BlockingContacts.java

@@ -1,5 +1,6 @@
 package net.mamoe.mirai.japt;
 
+import net.mamoe.mirai.Bot;
 import net.mamoe.mirai.contact.Group;
 import net.mamoe.mirai.contact.Member;
 import net.mamoe.mirai.contact.QQ;
@@ -19,4 +20,8 @@ public final class BlockingContacts {
     public static BlockingMember createBlocking(Member member) {
         return new BlockingMemberImpl(member);
     }
+
+    public static BlockingBotImpl createBlocking(Bot bot) {
+        return new BlockingBotImpl(bot);
+    }
 }

mirai-japt/src/main/java/net/mamoe/mirai/japt/BlockingGroup.java

@@ -1,6 +1,7 @@
 package net.mamoe.mirai.japt;
 
 import net.mamoe.mirai.data.GroupInfo;
+import org.jetbrains.annotations.NotNull;
 
 import java.util.Map;
 
@@ -15,18 +16,21 @@ public interface BlockingGroup extends BlockingContact {
      * 群主 (同步事件更新)
      * 进行 [updateGroupInfo] 时将会更新这个值.
      */
+    @NotNull
     BlockingMember getOwner();
 
     /**
      * 群名称 (同步事件更新)
      * 进行 [updateGroupInfo] 时将会更新这个值.
      */
+    @NotNull
     String getName();
 
     /**
      * 入群公告, 没有时为空字符串. (同步事件更新)
      * 进行 [updateGroupInfo] 时将会更新这个值.
      */
+    @NotNull
     String getAnnouncement();
 
     /**
@@ -34,11 +38,13 @@ public interface BlockingGroup extends BlockingContact {
      * <p>
      * **注意**: 获得的列表仅为这一时刻的成员列表的镜像. 它将不会被更新
      */
+    @NotNull
     Map<Long, BlockingMember> getMembers();
 
     /**
      * 获取群成员. 若此 ID 的成员不存在, 则会抛出 [kotlin.NoSuchElementException]
      */
+    @NotNull
     BlockingMember getMember(long id);
 
     /**
@@ -46,6 +52,7 @@ public interface BlockingGroup extends BlockingContact {
      *
      * @return 这一时刻的群资料
      */
+    @NotNull
     GroupInfo updateGroupInfo();
 
     /**
@@ -53,5 +60,6 @@ public interface BlockingGroup extends BlockingContact {
      */
     boolean quit();
 
+    @NotNull
     String toFullString();
 }

mirai-japt/src/main/java/net/mamoe/mirai/japt/BlockingMember.java

@@ -1,17 +1,20 @@
 package net.mamoe.mirai.japt;
 
 import net.mamoe.mirai.contact.MemberPermission;
+import org.jetbrains.annotations.NotNull;
 
 @SuppressWarnings("unused")
 public interface BlockingMember {
     /**
      * 所在的群
      */
+    @NotNull
     BlockingGroup getGroup();
 
     /**
      * 权限
      */
+    @NotNull
     MemberPermission getPermission();
 
     /**
@@ -20,7 +23,7 @@ public interface BlockingMember {
      * @param durationSeconds 持续时间. 精确到秒. 范围区间表示为 `(0s, 30days]`. 超过范围则会抛出异常.
      * @return 若机器人无权限禁言这个群成员, 返回 `false`
      */
-    Boolean mute(int durationSeconds);
+    boolean mute(int durationSeconds);
 
     /**
      * 解除禁言

mirai-japt/src/main/kotlin/net/mamoe/mirai/japt/BlockingContacts.kt

@@ -2,10 +2,12 @@
 
 package net.mamoe.mirai.japt
 
+import net.mamoe.mirai.Bot
 import net.mamoe.mirai.contact.Group
 import net.mamoe.mirai.contact.Member
 import net.mamoe.mirai.contact.QQ
 
 inline fun Group.blocking(): BlockingGroup = BlockingContacts.createBlocking(this)
 inline fun QQ.blocking(): BlockingQQ = BlockingContacts.createBlocking(this)
-inline fun Member.blocking(): BlockingMember = BlockingContacts.createBlocking(this)
+inline fun Member.blocking(): BlockingMember = BlockingContacts.createBlocking(this)
+inline fun Bot.blocking(): BlockingBot = BlockingContacts.createBlocking(this)