1. 添加联想乐云直链解析 2. 优化代码逻辑

parser/src/main/java/cn/qaiu/parser/PanBase.java

@@ -1,6 +1,7 @@
 package cn.qaiu.parser;
 
 import cn.qaiu.WebClientVertxInit;
+import cn.qaiu.util.CommonUtils;
 import io.vertx.core.Handler;
 import io.vertx.core.Promise;
 import io.vertx.ext.web.client.WebClient;
@@ -8,24 +9,61 @@ import io.vertx.ext.web.client.WebClientOptions;
 import org.slf4j.Logger;
 import org.slf4j.LoggerFactory;
 
+/**
+ * 解析器抽象类包含promise, HTTP Client, 默认失败方法等;
+ * 新增网盘解析器需要继承该类.
+ */
 public abstract class PanBase {
     protected Logger log = LoggerFactory.getLogger(this.getClass());
 
     protected Promise<String> promise = Promise.promise();
 
+    /**
+     * Http client
+     */
     protected WebClient client = WebClient.create(WebClientVertxInit.get());
-    protected WebClient clientNoRedirects = WebClient.create(WebClientVertxInit.get(), OPTIONS);
-    private static final WebClientOptions OPTIONS = new WebClientOptions().setFollowRedirects(false);
 
+    /**
+     * Http client 不自动跳转
+     */
+    protected WebClient clientNoRedirects = WebClient.create(WebClientVertxInit.get(),
+            new WebClientOptions().setFollowRedirects(false));
 
+    /**
+     * 分享key 可以是整个URL; 如果是URL实现该类时要
+     * 使用{@link CommonUtils#adaptShortPaths(String urlPrefix, String key)}获取真实的分享key
+     */
     protected String key;
+
+    /**
+     * 分享密码
+     */
     protected String pwd;
 
+    /**
+     * 子类重写此构造方法不需要添加额外逻辑
+     * 如:
+     * <blockquote><pre>
+     *  public XxTool(String key, String pwd) {
+     *      super(key, pwd);
+     *  }
+     * </pre></blockquote>
+     *
+     * @param key 分享key/url
+     * @param pwd 分享密码
+     */
     protected PanBase(String key, String pwd) {
         this.key = key;
         this.pwd = pwd;
     }
 
+    /**
+     * 失败时生成异常消息
+     *
+     * @param t        异常实例
+     * @param errorMsg 提示消息
+     * @param args     log参数变量
+     */
     protected void fail(Throwable t, String errorMsg, Object... args) {
         try {
             String s = String.format(errorMsg.replaceAll("\\{}", "%s"), args);
@@ -38,6 +76,12 @@ public abstract class PanBase {
         }
     }
 
+    /**
+     * 失败时生成异常消息
+     *
+     * @param errorMsg 提示消息
+     * @param args     log参数变量
+     */
     protected void fail(String errorMsg, Object... args) {
         try {
             String s = String.format(errorMsg.replaceAll("\\{}", "%s"), args);
@@ -50,6 +94,12 @@ public abstract class PanBase {
         }
     }
 
+    /**
+     * 生成失败Future的处理器
+     *
+     * @param errorMsg 提示消息
+     * @return Handler
+     */
     protected Handler<Throwable> handleFail(String errorMsg) {
         return t -> fail(this.getClass().getSimpleName() + " - 请求异常 {}: -> {}", errorMsg, t.fillInStackTrace());
     }