修改Magic说明文档

Author: qiujiayu

doc/magic.md

@@ -99,12 +99,29 @@ public interface UserMapper {
 
 使用Magic模式后，如果上面ids有10条记录，最差情况需要访问1次缓存、1数据源以及1次写缓存操作；最好的情况只需要访问1次缓存。但使用Magic模式后，就不允许使用自动加载(autoload设置为true也不会生效)、不支持“拿来主义”、异步刷新等功能。
 
+从7.0.4版本开始Magic模式也可用于无参函数，但此时只能从数据源加载数据，并批量写入缓存。
+
 有时我们也需要动态精确批量删除缓存，比如更新一批商品信息后，也要批量删除缓存，在7.0.1版本之前需要在业务代码中使用循环操作来实现。
 
-7.0.3版本在@CacheDeleteKey 增加 iterableArgIndex 属性，当它大于等于0时开启Magic模式。
+7.0.4版本中增加@CacheDeleteMagicKey 用于开启Magic模式，并支持对参数或返回值进行分割，然后生成多个Cache key进行批量删除缓存。如下例子所示：
 
 ```java
-    @CacheDelete(@CacheDeleteKey(value = "'user-byid-' + #args[0]", iterableArgIndex = 0))
-    void deleteByIds(@Param("ids") List<Long> ids);
+@CacheDelete(magic = {
+        @CacheDeleteMagicKey(value = "'user-testMagic-' + #args[0] + '-' + #args[1] + '-' + #args[2]", iterableArgIndex = 2, iterableReturnValue = false)
+})
+public void testDeleteMagicForArg(String name, String password, Long... ids) {
+
+}
+
+@CacheDelete(magic = {
+        @CacheDeleteMagicKey(value = "'user-testMagic-' + #args[0] + '-' + #args[1] + '-' + #retVal.id", iterableArgIndex = -1, iterableReturnValue = true)
+})
+public List<UserDO> testDeleteMagicForRetVal(String name, String password, Long... ids) {
+    List<UserDO> list = new ArrayList<>(ids.length);
+    for (Long id : ids) {
+        list.add(new UserDO(id, name, password));
+    }
+    return list;
+}
 ```