From dd5d771904ab748ed362a083eee56c8fbf994dc6 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E6=9D=9C=E7=90=A8?= <dukun@taobao.com>
Date: Thu, 8 Mar 2018 14:36:02 +0800
Subject: [PATCH] =?UTF-8?q?=E6=8F=90=E4=BA=A41.0.15-SNAPSHOT=EF=BC=8C?=
 =?UTF-8?q?=E4=BC=98=E5=8C=96=E9=83=A8=E5=88=86API?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 pom.xml                                       |  4 +--
 sandbox-agent/pom.xml                         |  2 +-
 sandbox-api/pom.xml                           |  2 +-
 .../api/listener/ext/EventWatchBuilder.java   | 36 +++++++++++++++++++
 .../api/resource/LoadedClassDataSource.java   | 11 ++++++
 sandbox-common-api/pom.xml                    |  2 +-
 sandbox-core/pom.xml                          |  2 +-
 .../manager/CoreLoadedClassDataSource.java    |  2 --
 sandbox-debug-module/pom.xml                  |  2 +-
 sandbox-mgr-module/pom.xml                    |  2 +-
 sandbox-mgr-provider/pom.xml                  |  2 +-
 sandbox-module-starter/pom.xml                |  2 +-
 sandbox-provider-api/pom.xml                  |  2 +-
 sandbox-spy/pom.xml                           |  2 +-
 14 files changed, 59 insertions(+), 14 deletions(-)

diff --git a/pom.xml b/pom.xml
index def146c6..5ad697d0 100644
--- a/pom.xml
+++ b/pom.xml
@@ -5,14 +5,14 @@
 
     <groupId>com.alibaba.jvm.sandbox</groupId>
     <artifactId>sandbox</artifactId>
-    <version>1.0.14</version>
+    <version>1.0.15-SNAPSHOT</version>
     <packaging>pom</packaging>
 
     <name>sandbox ${sandbox.version}</name>
 
     <properties>
         <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
-        <sandbox.version>1.0.14</sandbox.version>
+        <sandbox.version>1.0.15-SNAPSHOT</sandbox.version>
     </properties>
 
     <build>
diff --git a/sandbox-agent/pom.xml b/sandbox-agent/pom.xml
index 82ccae0f..8c957475 100755
--- a/sandbox-agent/pom.xml
+++ b/sandbox-agent/pom.xml
@@ -6,7 +6,7 @@
     <parent>
         <groupId>com.alibaba.jvm.sandbox</groupId>
         <artifactId>sandbox</artifactId>
-        <version>1.0.14</version>
+        <version>1.0.15-SNAPSHOT</version>
     </parent>
     <artifactId>sandbox-agent</artifactId>
     <name>sandbox-agent ${sandbox.version}</name>
diff --git a/sandbox-api/pom.xml b/sandbox-api/pom.xml
index e998624e..d87f4038 100755
--- a/sandbox-api/pom.xml
+++ b/sandbox-api/pom.xml
@@ -6,7 +6,7 @@
     <parent>
         <groupId>com.alibaba.jvm.sandbox</groupId>
         <artifactId>sandbox</artifactId>
-        <version>1.0.14</version>
+        <version>1.0.15-SNAPSHOT</version>
     </parent>
     <artifactId>sandbox-api</artifactId>
     <name>sandbox-api ${sandbox.version}</name>
diff --git a/sandbox-api/src/main/java/com/alibaba/jvm/sandbox/api/listener/ext/EventWatchBuilder.java b/sandbox-api/src/main/java/com/alibaba/jvm/sandbox/api/listener/ext/EventWatchBuilder.java
index 8749f687..50081398 100644
--- a/sandbox-api/src/main/java/com/alibaba/jvm/sandbox/api/listener/ext/EventWatchBuilder.java
+++ b/sandbox-api/src/main/java/com/alibaba/jvm/sandbox/api/listener/ext/EventWatchBuilder.java
@@ -47,6 +47,16 @@ public interface IBuildingForClass {
          */
         IBuildingForClass includeBootstrap();
 
+        /**
+         * 是否包含被Bootstrap所加载的类
+         *
+         * @param isIncludeBootstrap TRUE:包含Bootstrap;FALSE:不包含Bootstrap;
+         * @return IBuildingForClass
+         * @see #includeBootstrap()
+         * @since {@code sandbox-api:1.0.15}
+         */
+        IBuildingForClass isIncludeBootstrap(boolean isIncludeBootstrap);
+
         /**
          * {@link #onClass}所指定的类，检索路径是否包含子类（实现类）
          * <ul>
@@ -58,6 +68,16 @@ public interface IBuildingForClass {
          */
         IBuildingForClass includeSubClasses();
 
+        /**
+         * 是否包含被Bootstrap所加载的类
+         *
+         * @param isIncludeSubClasses TRUE:包含子类（实现类）;FALSE:不包含子类（实现类）;
+         * @return IBuildingForClass
+         * @see #includeSubClasses()
+         * @since {@code sandbox-api:1.0.15}
+         */
+        IBuildingForClass isIncludeSubClasses(boolean isIncludeSubClasses);
+
         /**
          * 类修饰匹配
          *
@@ -335,12 +355,28 @@ public IBuildingForClass includeBootstrap() {
             return this;
         }
 
+        @Override
+        public IBuildingForClass isIncludeBootstrap(boolean isIncludeBootstrap) {
+            if (isIncludeBootstrap) {
+                includeBootstrap();
+            }
+            return this;
+        }
+
         @Override
         public IBuildingForClass includeSubClasses() {
             this.isIncludeSubClasses = true;
             return this;
         }
 
+        @Override
+        public IBuildingForClass isIncludeSubClasses(boolean isIncludeSubClasses) {
+            if (isIncludeSubClasses) {
+                includeSubClasses();
+            }
+            return this;
+        }
+
         @Override
         public IBuildingForClass withAccess(final int access) {
             withAccess |= access;
diff --git a/sandbox-api/src/main/java/com/alibaba/jvm/sandbox/api/resource/LoadedClassDataSource.java b/sandbox-api/src/main/java/com/alibaba/jvm/sandbox/api/resource/LoadedClassDataSource.java
index ac9db5f6..07fd1a47 100755
--- a/sandbox-api/src/main/java/com/alibaba/jvm/sandbox/api/resource/LoadedClassDataSource.java
+++ b/sandbox-api/src/main/java/com/alibaba/jvm/sandbox/api/resource/LoadedClassDataSource.java
@@ -2,6 +2,7 @@
 
 import com.alibaba.jvm.sandbox.api.filter.Filter;
 
+import java.util.Iterator;
 import java.util.Set;
 
 /**
@@ -26,4 +27,14 @@ public interface LoadedClassDataSource {
      */
     Set<Class<?>> find(Filter filter);
 
+    /**
+     * 获取所有已加载类的集合迭代器
+     * <p>
+     * 对比 {@link #list()} 而言，有更优的内存、CPU开销
+     *
+     * @return 所有已加载的类集合迭代器
+     * @since {@code sandbox-api:1.0.15}
+     */
+    Iterator<Class<?>> iteratorForLoadedClasses();
+
 }
diff --git a/sandbox-common-api/pom.xml b/sandbox-common-api/pom.xml
index f1378bd8..5c99ab6b 100644
--- a/sandbox-common-api/pom.xml
+++ b/sandbox-common-api/pom.xml
@@ -6,7 +6,7 @@
     <parent>
         <artifactId>sandbox</artifactId>
         <groupId>com.alibaba.jvm.sandbox</groupId>
-        <version>1.0.14</version>
+        <version>1.0.15-SNAPSHOT</version>
     </parent>
     <artifactId>sandbox-common-api</artifactId>
     <name>sandbox-common-api ${sandbox.version}</name>
diff --git a/sandbox-core/pom.xml b/sandbox-core/pom.xml
index 4b794632..a3dba02b 100755
--- a/sandbox-core/pom.xml
+++ b/sandbox-core/pom.xml
@@ -6,7 +6,7 @@
     <parent>
         <groupId>com.alibaba.jvm.sandbox</groupId>
         <artifactId>sandbox</artifactId>
-        <version>1.0.14</version>
+        <version>1.0.15-SNAPSHOT</version>
     </parent>
     <artifactId>sandbox-core</artifactId>
     <name>sandbox-core ${sandbox.version}</name>
diff --git a/sandbox-core/src/main/java/com/alibaba/jvm/sandbox/core/manager/CoreLoadedClassDataSource.java b/sandbox-core/src/main/java/com/alibaba/jvm/sandbox/core/manager/CoreLoadedClassDataSource.java
index d3f503e5..c7bd59c6 100644
--- a/sandbox-core/src/main/java/com/alibaba/jvm/sandbox/core/manager/CoreLoadedClassDataSource.java
+++ b/sandbox-core/src/main/java/com/alibaba/jvm/sandbox/core/manager/CoreLoadedClassDataSource.java
@@ -13,8 +13,6 @@
  */
 public interface CoreLoadedClassDataSource extends LoadedClassDataSource {
 
-    Iterator<Class<?>> iteratorForLoadedClasses();
-
     /**
      * 使用{@link Matcher}来完成类的检索
      * <p>
diff --git a/sandbox-debug-module/pom.xml b/sandbox-debug-module/pom.xml
index dce8140a..5a64f2fd 100755
--- a/sandbox-debug-module/pom.xml
+++ b/sandbox-debug-module/pom.xml
@@ -6,7 +6,7 @@
     <parent>
         <groupId>com.alibaba.jvm.sandbox</groupId>
         <artifactId>sandbox-module-starter</artifactId>
-        <version>1.0.14</version>
+        <version>1.0.15-SNAPSHOT</version>
         <relativePath>../sandbox-module-starter/pom.xml</relativePath>
     </parent>
     <artifactId>sandbox-debug-module</artifactId>
diff --git a/sandbox-mgr-module/pom.xml b/sandbox-mgr-module/pom.xml
index da94ad94..0e4b99ee 100755
--- a/sandbox-mgr-module/pom.xml
+++ b/sandbox-mgr-module/pom.xml
@@ -6,7 +6,7 @@
     <parent>
         <artifactId>sandbox</artifactId>
         <groupId>com.alibaba.jvm.sandbox</groupId>
-        <version>1.0.14</version>
+        <version>1.0.15-SNAPSHOT</version>
     </parent>
     <artifactId>sandbox-mgr-module</artifactId>
     <name>sandbox-mgr-module ${sandbox.version}</name>
diff --git a/sandbox-mgr-provider/pom.xml b/sandbox-mgr-provider/pom.xml
index fe1dd25e..8717ee3f 100644
--- a/sandbox-mgr-provider/pom.xml
+++ b/sandbox-mgr-provider/pom.xml
@@ -6,7 +6,7 @@
     <parent>
         <artifactId>sandbox</artifactId>
         <groupId>com.alibaba.jvm.sandbox</groupId>
-        <version>1.0.14</version>
+        <version>1.0.15-SNAPSHOT</version>
     </parent>
     <artifactId>sandbox-mgr-provider</artifactId>
     <name>sandbox-mgr-provider ${sandbox.version}</name>
diff --git a/sandbox-module-starter/pom.xml b/sandbox-module-starter/pom.xml
index 397ea238..97a50855 100644
--- a/sandbox-module-starter/pom.xml
+++ b/sandbox-module-starter/pom.xml
@@ -6,7 +6,7 @@
     <parent>
         <groupId>com.alibaba.jvm.sandbox</groupId>
         <artifactId>sandbox</artifactId>
-        <version>1.0.14</version>
+        <version>1.0.15-SNAPSHOT</version>
     </parent>
     <artifactId>sandbox-module-starter</artifactId>
     <name>sandbox-module-starter ${sandbox.version}</name>
diff --git a/sandbox-provider-api/pom.xml b/sandbox-provider-api/pom.xml
index 0a2122e9..169a9d1f 100644
--- a/sandbox-provider-api/pom.xml
+++ b/sandbox-provider-api/pom.xml
@@ -6,7 +6,7 @@
     <parent>
         <artifactId>sandbox</artifactId>
         <groupId>com.alibaba.jvm.sandbox</groupId>
-        <version>1.0.14</version>
+        <version>1.0.15-SNAPSHOT</version>
     </parent>
     <artifactId>sandbox-provider-api</artifactId>
     <name>sandbox-provider-api ${sandbox.version}</name>
diff --git a/sandbox-spy/pom.xml b/sandbox-spy/pom.xml
index 199cb062..7ed3d626 100755
--- a/sandbox-spy/pom.xml
+++ b/sandbox-spy/pom.xml
@@ -6,7 +6,7 @@
     <parent>
         <groupId>com.alibaba.jvm.sandbox</groupId>
         <artifactId>sandbox</artifactId>
-        <version>1.0.14</version>
+        <version>1.0.15-SNAPSHOT</version>
     </parent>
     <artifactId>sandbox-spy</artifactId>
     <name>sandbox-spy ${sandbox.version}</name>