diff --git a/dubbo-common/src/main/java/com/alibaba/dubbo/common/URL.java b/dubbo-common/src/main/java/com/alibaba/dubbo/common/URL.java
index 2d07f8be4c..ad5c13bef0 100644
--- a/dubbo-common/src/main/java/com/alibaba/dubbo/common/URL.java
+++ b/dubbo-common/src/main/java/com/alibaba/dubbo/common/URL.java
@@ -31,21 +31,37 @@ import com.alibaba.dubbo.common.utils.CollectionUtils;
/**
* URL - Uniform Resource Locator (Immutable, ThreadSafe)
- *
+ *
* url example:
*
- * - http://www.facebook.com/friends?param=value1
+ *
- http://www.facebook.com/friends?param1=value1¶m2=value2
*
- http://username:password@10.20.130.230:8080/list?version=1.0.0
- *
- registry://192.168.1.7:9090/com.alibaba.service1?param1=value1¶m2=value2
*
- ftp://username:password@192.168.1.7:21/1/read.txt
+ *
- registry://192.168.1.7:9090/com.alibaba.service1?param1=value1¶m2=value2
+ *
+ *
+ * Some strange example below:
+ *
+ * - 192.168.1.3:20880
+ * for this case, url protocol = null, url host = 192.168.1.3, port = 20880, url path = null
* - file:///home/user1/router.js?type=script
- * for this case, url protocol = null, url host = null, url path = /home/user1/router.js
+ * for this case, url protocol = null, url host = null, url path = home/user1/router.js
+ * - file://home/user1/router.js?type=script
+ * for this case, url protocol = file, url host = home, url path = user1/router.js
* - file:///D:/1/router.js?type=script
- * for this case, url protocol = null, url host = null, url path = /D:/1/router.js
+ * for this case, url protocol = file, url host = null, url path = D:/1/router.js
+ * - file:/D:/1/router.js?type=script
+ * same as above file:///D:/1/router.js?type=script
+ * - /home/user1/router.js?type=script
+ * for this case, url protocol = null, url host = null, url path = home/user1/router.js
+ * - home/user1/router.js?type=script
+ * for this case, url protocol = null, url host = home, url path = user1/router.js
*
*
* @author william.liangf
* @author ding.lid
+ * @see java.net.URL
+ * @see java.net.URI
*/
public final class URL implements Serializable {
@@ -357,6 +373,7 @@ public final class URL implements Serializable {
*
* @param url URL string
* @return URL instance
+ * @see URL
*/
public static URL valueOf(String url) {
if (url == null || (url = url.trim()).length() == 0) {
diff --git a/dubbo-rpc/src/main/java/com/alibaba/dubbo/rpc/filter/AccessLogFilter.java b/dubbo-rpc/src/main/java/com/alibaba/dubbo/rpc/filter/AccessLogFilter.java
index 04495eee69..37ed703c08 100644
--- a/dubbo-rpc/src/main/java/com/alibaba/dubbo/rpc/filter/AccessLogFilter.java
+++ b/dubbo-rpc/src/main/java/com/alibaba/dubbo/rpc/filter/AccessLogFilter.java
@@ -46,11 +46,11 @@ import com.alibaba.dubbo.rpc.Result;
/**
* 记录Service的Access Log。
*
- * 使用的Logger key是DUBBO.ACCESS-LOG。
- * 如果要配置Access Log只出现在指定的Appender中,在Log4j中注意配置上additivity。配置示例:
+ * 使用的Logger key是dubbo.accesslog。
+ * 如果想要配置Access Log只出现在指定的Appender中,可以在Log4j中注意配置上additivity。配置示例:
*
*
- * <logger name="DUBBO.ACCESS-LOG" additivity="false">
+ * <logger name="dubbo.accesslog" additivity="false">
* <level value="info" />
* <appender-ref ref="foo" />
* </logger>