From f199ae2f9213d5220145eb03db4975264aa0524c Mon Sep 17 00:00:00 2001 From: dieyi Date: Tue, 20 Nov 2018 17:17:53 +0800 Subject: [PATCH] Feat: continue work --- CHANGELOG.md | 23 ++ README.md | 383 ++++++++++++++++++ README_zh.md | 292 +++++++++++++ TODO.md | 7 + build.gradle | 156 +++++++ gradle.properties | 18 + gradle/wrapper/gradle-wrapper.jar | Bin 0 -> 53636 bytes gradle/wrapper/gradle-wrapper.properties | 7 + gradlew | 160 ++++++++ gradlew.bat | 90 ++++ lancet-base/.gitignore | 1 + lancet-base/build.gradle | 10 + .../dieyidezui/lancet/rt/AroundContext.java | 36 ++ .../dieyidezui/lancet/rt/AutoReplaced.java | 13 + .../com/dieyidezui/lancet/rt/Interceptor.java | 6 + .../java/com/dieyidezui/lancet/rt/Lancet.java | 31 ++ .../java/com/dieyidezui/lancet/rt/Scope.java | 12 + .../lancet/rt/annotations/ClassOf.java | 20 + .../rt/annotations/ImplementedInterface.java | 27 ++ .../lancet/rt/annotations/Insert.java | 30 ++ .../lancet/rt/annotations/Interceptable.java | 16 + .../lancet/rt/annotations/NameRegex.java | 18 + .../lancet/rt/annotations/Proxy.java | 24 ++ .../lancet/rt/annotations/TargetClass.java | 17 + .../rt/annotations/TryCatchHandler.java | 17 + .../lancet/rt/internal/AroundMethodChain.java | 81 ++++ .../dieyidezui/lancet/rt/internal/Util.java | 4 + .../rt/internal/codegen/CodegenHelper.java | 46 +++ .../codegen/GeneratedInterceptor.java | 24 ++ lancet-plugin/.gitignore | 1 + lancet-plugin/build.gradle | 30 ++ .../lancet/plugin/LancetTransform.java | 39 ++ .../me/ele/lancet/plugin/LancetExtension.java | 73 ++++ .../me/ele/lancet/plugin/LancetPlugin.java | 22 + .../me/ele/lancet/plugin/LancetTransform.java | 165 ++++++++ .../main/java/me/ele/lancet/plugin/Util.java | 21 + .../lancet/plugin/internal/GlobalContext.java | 22 + .../lancet/plugin/internal/LocalCache.java | 111 +++++ .../me/ele/lancet/plugin/internal/Metas.java | 45 ++ .../plugin/internal/TransformContext.java | 139 +++++++ .../plugin/internal/TransformProcessor.java | 129 ++++++ .../plugin/internal/context/ClassFetcher.java | 37 ++ .../context/ClassifiedContentProvider.java | 33 ++ .../internal/context/ContextReader.java | 135 ++++++ .../context/DirectoryContentProvider.java | 64 +++ .../internal/context/JarContentProvider.java | 45 ++ .../context/QualifiedContentProvider.java | 27 ++ .../context/StatusOverrideJarInput.java | 53 +++ .../TargetedQualifiedContentProvider.java | 18 + .../preprocess/AsmClassProcessorImpl.java | 20 + .../preprocess/MetaGraphGeneratorImpl.java | 78 ++++ .../preprocess/ParseFailureException.java | 21 + .../internal/preprocess/PreClassAnalysis.java | 160 ++++++++ .../preprocess/PreClassProcessor.java | 32 ++ .../preprocess/PreProcessClassVisitor.java | 65 +++ .../gradle-plugins/me.ele.lancet.properties | 1 + lancet-weaver/.gitignore | 1 + lancet-weaver/build.gradle | 23 ++ .../java/me/ele/lancet/weaver/ClassData.java | 31 ++ .../java/me/ele/lancet/weaver/MetaParser.java | 16 + .../java/me/ele/lancet/weaver/Weaver.java | 18 + .../ele/lancet/weaver/internal/AsmWeaver.java | 53 +++ .../weaver/internal/asm/ClassCollector.java | 83 ++++ .../weaver/internal/asm/ClassContext.java | 38 ++ .../weaver/internal/asm/ClassTransform.java | 63 +++ .../internal/asm/LinkedClassVisitor.java | 45 ++ .../weaver/internal/asm/MethodChain.java | 296 ++++++++++++++ .../asm/classvisitor/HookClassVisitor.java | 42 ++ .../asm/classvisitor/InsertClassVisitor.java | 102 +++++ .../asm/classvisitor/ProxyClassVisitor.java | 44 ++ .../TryCatchInfoClassVisitor.java | 47 +++ .../methodvisitor/AutoUnboxMethodVisitor.java | 128 ++++++ .../methodvisitor/ProxyMethodVisitor.java | 76 ++++ .../methodvisitor/TryCatchMethodVisitor.java | 42 ++ .../weaver/internal/entity/InsertInfo.java | 49 +++ .../weaver/internal/entity/ProxyInfo.java | 69 ++++ .../weaver/internal/entity/TransformInfo.java | 97 +++++ .../weaver/internal/entity/TryCatchInfo.java | 44 ++ .../exception/IllegalAnnotationException.java | 22 + .../exception/LoadClassException.java | 12 + .../UnsupportedAnnotationException.java | 11 + .../weaver/internal/graph/CheckFlow.java | 129 ++++++ .../weaver/internal/graph/ClassEntity.java | 49 +++ .../weaver/internal/graph/ClassNode.java | 36 ++ .../weaver/internal/graph/FieldEntity.java | 26 ++ .../lancet/weaver/internal/graph/Graph.java | 175 ++++++++ .../weaver/internal/graph/InterfaceNode.java | 35 ++ .../internal/graph/MetaGraphGenerator.java | 11 + .../weaver/internal/graph/MethodEntity.java | 26 ++ .../lancet/weaver/internal/graph/Node.java | 40 ++ .../lancet/weaver/internal/log/ILogger.java | 40 ++ .../weaver/internal/log/Impl/BaseLogger.java | 54 +++ .../internal/log/Impl/FileLoggerImpl.java | 55 +++ .../internal/log/Impl/SystemLoggerImpl.java | 43 ++ .../internal/log/Impl/SystemOutputImpl.java | 44 ++ .../ele/lancet/weaver/internal/log/Log.java | 119 ++++++ .../weaver/internal/meta/ClassMetaInfo.java | 48 +++ .../weaver/internal/meta/HookInfoLocator.java | 200 +++++++++ .../weaver/internal/meta/MethodMetaInfo.java | 20 + .../internal/parser/AcceptableAnnoParser.java | 9 + .../weaver/internal/parser/AnnoParser.java | 12 + .../internal/parser/AnnotationMeta.java | 17 + .../internal/parser/AopMethodAdjuster.java | 242 +++++++++++ .../weaver/internal/parser/AsmMetaParser.java | 194 +++++++++ .../internal/parser/anno/AcceptAny.java | 34 ++ .../parser/anno/ClassOfAnnoParser.java | 109 +++++ .../anno/DelegateAcceptableAnnoParser.java | 31 ++ .../anno/GatheredAcceptableAnnoParser.java | 37 ++ .../anno/ImplementedInterfaceAnnoParser.java | 86 ++++ .../parser/anno/InsertAnnoParser.java | 63 +++ .../parser/anno/NameRegexAnnoParser.java | 48 +++ .../internal/parser/anno/ProxyAnnoParser.java | 57 +++ .../parser/anno/TargetClassAnnoParser.java | 73 ++++ .../parser/anno/TryCatchAnnoParser.java | 30 ++ .../lancet/weaver/internal/util/AsmUtil.java | 18 + .../lancet/weaver/internal/util/Bitset.java | 88 ++++ .../weaver/internal/util/PrimitiveUtil.java | 103 +++++ .../weaver/internal/util/RefHolder.java | 21 + .../weaver/internal/util/TraceUtil.java | 76 ++++ .../lancet/weaver/internal/util/TypeUtil.java | 75 ++++ media/14948409810841/scope.png | Bin 0 -> 10395 bytes settings.gradle | 3 + 122 files changed, 7183 insertions(+) create mode 100644 CHANGELOG.md create mode 100644 README.md create mode 100644 README_zh.md create mode 100644 TODO.md create mode 100644 build.gradle create mode 100644 gradle.properties create mode 100644 gradle/wrapper/gradle-wrapper.jar create mode 100644 gradle/wrapper/gradle-wrapper.properties create mode 100755 gradlew create mode 100644 gradlew.bat create mode 100644 lancet-base/.gitignore create mode 100644 lancet-base/build.gradle create mode 100644 lancet-base/src/main/java/com/dieyidezui/lancet/rt/AroundContext.java create mode 100644 lancet-base/src/main/java/com/dieyidezui/lancet/rt/AutoReplaced.java create mode 100644 lancet-base/src/main/java/com/dieyidezui/lancet/rt/Interceptor.java create mode 100644 lancet-base/src/main/java/com/dieyidezui/lancet/rt/Lancet.java create mode 100644 lancet-base/src/main/java/com/dieyidezui/lancet/rt/Scope.java create mode 100644 lancet-base/src/main/java/com/dieyidezui/lancet/rt/annotations/ClassOf.java create mode 100644 lancet-base/src/main/java/com/dieyidezui/lancet/rt/annotations/ImplementedInterface.java create mode 100644 lancet-base/src/main/java/com/dieyidezui/lancet/rt/annotations/Insert.java create mode 100644 lancet-base/src/main/java/com/dieyidezui/lancet/rt/annotations/Interceptable.java create mode 100644 lancet-base/src/main/java/com/dieyidezui/lancet/rt/annotations/NameRegex.java create mode 100644 lancet-base/src/main/java/com/dieyidezui/lancet/rt/annotations/Proxy.java create mode 100644 lancet-base/src/main/java/com/dieyidezui/lancet/rt/annotations/TargetClass.java create mode 100644 lancet-base/src/main/java/com/dieyidezui/lancet/rt/annotations/TryCatchHandler.java create mode 100644 lancet-base/src/main/java/com/dieyidezui/lancet/rt/internal/AroundMethodChain.java create mode 100644 lancet-base/src/main/java/com/dieyidezui/lancet/rt/internal/Util.java create mode 100644 lancet-base/src/main/java/com/dieyidezui/lancet/rt/internal/codegen/CodegenHelper.java create mode 100644 lancet-base/src/main/java/com/dieyidezui/lancet/rt/internal/codegen/GeneratedInterceptor.java create mode 100644 lancet-plugin/.gitignore create mode 100644 lancet-plugin/build.gradle create mode 100644 lancet-plugin/src/main/java/com/dieyidezui/lancet/plugin/LancetTransform.java create mode 100644 lancet-plugin/src/main/java/me/ele/lancet/plugin/LancetExtension.java create mode 100644 lancet-plugin/src/main/java/me/ele/lancet/plugin/LancetPlugin.java create mode 100644 lancet-plugin/src/main/java/me/ele/lancet/plugin/LancetTransform.java create mode 100644 lancet-plugin/src/main/java/me/ele/lancet/plugin/Util.java create mode 100644 lancet-plugin/src/main/java/me/ele/lancet/plugin/internal/GlobalContext.java create mode 100644 lancet-plugin/src/main/java/me/ele/lancet/plugin/internal/LocalCache.java create mode 100644 lancet-plugin/src/main/java/me/ele/lancet/plugin/internal/Metas.java create mode 100644 lancet-plugin/src/main/java/me/ele/lancet/plugin/internal/TransformContext.java create mode 100644 lancet-plugin/src/main/java/me/ele/lancet/plugin/internal/TransformProcessor.java create mode 100644 lancet-plugin/src/main/java/me/ele/lancet/plugin/internal/context/ClassFetcher.java create mode 100644 lancet-plugin/src/main/java/me/ele/lancet/plugin/internal/context/ClassifiedContentProvider.java create mode 100644 lancet-plugin/src/main/java/me/ele/lancet/plugin/internal/context/ContextReader.java create mode 100644 lancet-plugin/src/main/java/me/ele/lancet/plugin/internal/context/DirectoryContentProvider.java create mode 100644 lancet-plugin/src/main/java/me/ele/lancet/plugin/internal/context/JarContentProvider.java create mode 100644 lancet-plugin/src/main/java/me/ele/lancet/plugin/internal/context/QualifiedContentProvider.java create mode 100644 lancet-plugin/src/main/java/me/ele/lancet/plugin/internal/context/StatusOverrideJarInput.java create mode 100644 lancet-plugin/src/main/java/me/ele/lancet/plugin/internal/context/TargetedQualifiedContentProvider.java create mode 100644 lancet-plugin/src/main/java/me/ele/lancet/plugin/internal/preprocess/AsmClassProcessorImpl.java create mode 100644 lancet-plugin/src/main/java/me/ele/lancet/plugin/internal/preprocess/MetaGraphGeneratorImpl.java create mode 100644 lancet-plugin/src/main/java/me/ele/lancet/plugin/internal/preprocess/ParseFailureException.java create mode 100644 lancet-plugin/src/main/java/me/ele/lancet/plugin/internal/preprocess/PreClassAnalysis.java create mode 100644 lancet-plugin/src/main/java/me/ele/lancet/plugin/internal/preprocess/PreClassProcessor.java create mode 100644 lancet-plugin/src/main/java/me/ele/lancet/plugin/internal/preprocess/PreProcessClassVisitor.java create mode 100644 lancet-plugin/src/main/resources/META-INF/gradle-plugins/me.ele.lancet.properties create mode 100644 lancet-weaver/.gitignore create mode 100644 lancet-weaver/build.gradle create mode 100644 lancet-weaver/src/main/java/me/ele/lancet/weaver/ClassData.java create mode 100644 lancet-weaver/src/main/java/me/ele/lancet/weaver/MetaParser.java create mode 100644 lancet-weaver/src/main/java/me/ele/lancet/weaver/Weaver.java create mode 100644 lancet-weaver/src/main/java/me/ele/lancet/weaver/internal/AsmWeaver.java create mode 100644 lancet-weaver/src/main/java/me/ele/lancet/weaver/internal/asm/ClassCollector.java create mode 100644 lancet-weaver/src/main/java/me/ele/lancet/weaver/internal/asm/ClassContext.java create mode 100644 lancet-weaver/src/main/java/me/ele/lancet/weaver/internal/asm/ClassTransform.java create mode 100644 lancet-weaver/src/main/java/me/ele/lancet/weaver/internal/asm/LinkedClassVisitor.java create mode 100644 lancet-weaver/src/main/java/me/ele/lancet/weaver/internal/asm/MethodChain.java create mode 100644 lancet-weaver/src/main/java/me/ele/lancet/weaver/internal/asm/classvisitor/HookClassVisitor.java create mode 100644 lancet-weaver/src/main/java/me/ele/lancet/weaver/internal/asm/classvisitor/InsertClassVisitor.java create mode 100644 lancet-weaver/src/main/java/me/ele/lancet/weaver/internal/asm/classvisitor/ProxyClassVisitor.java create mode 100644 lancet-weaver/src/main/java/me/ele/lancet/weaver/internal/asm/classvisitor/TryCatchInfoClassVisitor.java create mode 100644 lancet-weaver/src/main/java/me/ele/lancet/weaver/internal/asm/classvisitor/methodvisitor/AutoUnboxMethodVisitor.java create mode 100644 lancet-weaver/src/main/java/me/ele/lancet/weaver/internal/asm/classvisitor/methodvisitor/ProxyMethodVisitor.java create mode 100644 lancet-weaver/src/main/java/me/ele/lancet/weaver/internal/asm/classvisitor/methodvisitor/TryCatchMethodVisitor.java create mode 100644 lancet-weaver/src/main/java/me/ele/lancet/weaver/internal/entity/InsertInfo.java create mode 100644 lancet-weaver/src/main/java/me/ele/lancet/weaver/internal/entity/ProxyInfo.java create mode 100644 lancet-weaver/src/main/java/me/ele/lancet/weaver/internal/entity/TransformInfo.java create mode 100644 lancet-weaver/src/main/java/me/ele/lancet/weaver/internal/entity/TryCatchInfo.java create mode 100644 lancet-weaver/src/main/java/me/ele/lancet/weaver/internal/exception/IllegalAnnotationException.java create mode 100644 lancet-weaver/src/main/java/me/ele/lancet/weaver/internal/exception/LoadClassException.java create mode 100644 lancet-weaver/src/main/java/me/ele/lancet/weaver/internal/exception/UnsupportedAnnotationException.java create mode 100644 lancet-weaver/src/main/java/me/ele/lancet/weaver/internal/graph/CheckFlow.java create mode 100644 lancet-weaver/src/main/java/me/ele/lancet/weaver/internal/graph/ClassEntity.java create mode 100644 lancet-weaver/src/main/java/me/ele/lancet/weaver/internal/graph/ClassNode.java create mode 100644 lancet-weaver/src/main/java/me/ele/lancet/weaver/internal/graph/FieldEntity.java create mode 100644 lancet-weaver/src/main/java/me/ele/lancet/weaver/internal/graph/Graph.java create mode 100644 lancet-weaver/src/main/java/me/ele/lancet/weaver/internal/graph/InterfaceNode.java create mode 100644 lancet-weaver/src/main/java/me/ele/lancet/weaver/internal/graph/MetaGraphGenerator.java create mode 100644 lancet-weaver/src/main/java/me/ele/lancet/weaver/internal/graph/MethodEntity.java create mode 100644 lancet-weaver/src/main/java/me/ele/lancet/weaver/internal/graph/Node.java create mode 100644 lancet-weaver/src/main/java/me/ele/lancet/weaver/internal/log/ILogger.java create mode 100644 lancet-weaver/src/main/java/me/ele/lancet/weaver/internal/log/Impl/BaseLogger.java create mode 100644 lancet-weaver/src/main/java/me/ele/lancet/weaver/internal/log/Impl/FileLoggerImpl.java create mode 100644 lancet-weaver/src/main/java/me/ele/lancet/weaver/internal/log/Impl/SystemLoggerImpl.java create mode 100644 lancet-weaver/src/main/java/me/ele/lancet/weaver/internal/log/Impl/SystemOutputImpl.java create mode 100644 lancet-weaver/src/main/java/me/ele/lancet/weaver/internal/log/Log.java create mode 100644 lancet-weaver/src/main/java/me/ele/lancet/weaver/internal/meta/ClassMetaInfo.java create mode 100644 lancet-weaver/src/main/java/me/ele/lancet/weaver/internal/meta/HookInfoLocator.java create mode 100644 lancet-weaver/src/main/java/me/ele/lancet/weaver/internal/meta/MethodMetaInfo.java create mode 100644 lancet-weaver/src/main/java/me/ele/lancet/weaver/internal/parser/AcceptableAnnoParser.java create mode 100644 lancet-weaver/src/main/java/me/ele/lancet/weaver/internal/parser/AnnoParser.java create mode 100644 lancet-weaver/src/main/java/me/ele/lancet/weaver/internal/parser/AnnotationMeta.java create mode 100644 lancet-weaver/src/main/java/me/ele/lancet/weaver/internal/parser/AopMethodAdjuster.java create mode 100644 lancet-weaver/src/main/java/me/ele/lancet/weaver/internal/parser/AsmMetaParser.java create mode 100644 lancet-weaver/src/main/java/me/ele/lancet/weaver/internal/parser/anno/AcceptAny.java create mode 100644 lancet-weaver/src/main/java/me/ele/lancet/weaver/internal/parser/anno/ClassOfAnnoParser.java create mode 100644 lancet-weaver/src/main/java/me/ele/lancet/weaver/internal/parser/anno/DelegateAcceptableAnnoParser.java create mode 100644 lancet-weaver/src/main/java/me/ele/lancet/weaver/internal/parser/anno/GatheredAcceptableAnnoParser.java create mode 100644 lancet-weaver/src/main/java/me/ele/lancet/weaver/internal/parser/anno/ImplementedInterfaceAnnoParser.java create mode 100644 lancet-weaver/src/main/java/me/ele/lancet/weaver/internal/parser/anno/InsertAnnoParser.java create mode 100644 lancet-weaver/src/main/java/me/ele/lancet/weaver/internal/parser/anno/NameRegexAnnoParser.java create mode 100644 lancet-weaver/src/main/java/me/ele/lancet/weaver/internal/parser/anno/ProxyAnnoParser.java create mode 100644 lancet-weaver/src/main/java/me/ele/lancet/weaver/internal/parser/anno/TargetClassAnnoParser.java create mode 100644 lancet-weaver/src/main/java/me/ele/lancet/weaver/internal/parser/anno/TryCatchAnnoParser.java create mode 100644 lancet-weaver/src/main/java/me/ele/lancet/weaver/internal/util/AsmUtil.java create mode 100644 lancet-weaver/src/main/java/me/ele/lancet/weaver/internal/util/Bitset.java create mode 100644 lancet-weaver/src/main/java/me/ele/lancet/weaver/internal/util/PrimitiveUtil.java create mode 100644 lancet-weaver/src/main/java/me/ele/lancet/weaver/internal/util/RefHolder.java create mode 100644 lancet-weaver/src/main/java/me/ele/lancet/weaver/internal/util/TraceUtil.java create mode 100644 lancet-weaver/src/main/java/me/ele/lancet/weaver/internal/util/TypeUtil.java create mode 100644 media/14948409810841/scope.png create mode 100644 settings.gradle diff --git a/CHANGELOG.md b/CHANGELOG.md new file mode 100644 index 0000000..84c0c5c --- /dev/null +++ b/CHANGELOG.md @@ -0,0 +1,23 @@ +#Change Log + +## Version 1.0.4 +*2018-01-25 +* Fix: in rare case, lancet generate illegal bytecode because of multi-thread. + +## Version 1.0.3 +*2018-01-24* +* Fix: in rare case, lancet generate illegal bytecode because of multi-thread. +* Add an option to open/close incremental build. + +## Version 1.0.2 +*2017-9-11* +* Fix: fall back when runtime exception occurs during process class bytes. + +## Version 1.0.0 +*2017-07-14* +* Remove guava and android plugin dependency. +* Fix: when multiple proxy appear in one method, only one works. + +## Version 1.0.0-beta1 +*2017-05-31* +* Initial release. \ No newline at end of file diff --git a/README.md b/README.md new file mode 100644 index 0000000..6723610 --- /dev/null +++ b/README.md @@ -0,0 +1,383 @@ +# Lancet + +[Chinese README](README_zh.md) + +Lancet is a lightweight AOP framework for Android. + +It's fast and just take up a little time during compiling. Also, it supports incremental compiling. + +But it provides great api to help you coding in Android. + +It takes no runtime jar. + +In addition, not only App developers but also SDK developers can use Lancet. + +## Usage +### Installation + +Firstly, add following code in root **build.gradle** of your project. + +```groovy +dependencies{ + classpath 'me.ele:lancet-plugin:1.0.4' +} +``` +And then, add following code in your **application module's build.gradle** + +```groovy +apply plugin: 'me.ele.lancet' + +dependencies { + provided 'me.ele:lancet-base:1.0.4' +} +``` + +That's OK.Now you can follow our tutorial to learn how to use it. + +### Tutorial + +Lancet use annotation to indicate where to cut the code and focus on interacting with origin class's methods and fields; + +Firstly, let's see a example. +Look at the following code: + +```java +@Proxy("i") +@TargetClass("android.util.Log") +public static int anyName(String tag, String msg){ + msg = msg + "lancet"; + return (int) Origin.call(); +} +``` + +There are some key points: + +* ```@TargetClass``` directly locate the target ```android.util.Log``` +* ```@Proxy```locate the method name```i``` +* ```Origin.call()``` will be replaced by```Log.i()``` as we explained above +* so the influence is every ```Log.i```'s second parameter```msg``` will has a trailing **"lancet"** + + +### Choose target class + +```java +public @interface TargetClass { + String value(); + + Scope scope() default Scope.SELF; +} + +public @interface ImplementedInterface { + + String[] value(); + + Scope scope() default Scope.SELF; +} + +public enum Scope { + + SELF, + DIRECT, + ALL, + LEAF +} +``` +We use the three classes above to locate our targets. + +#### @TargetClass + + 1. **value** in ```@TargetClass``` should be a full class name. + 2. Scope.SELF means the target is the class named by **value** + 3. Scope.DIRECT locate the direct subclasses of **value** + 4. Scope.All indicates the all subclasses of **value** + 5. The Scope.LEAF is a little bit special, it means all leaf subclasses of **value**.For example: ```A <- B <- C, B <- D```, the leaf children of A are C and D. + +#### @ImplementedInterface + +1. **value** in ```@ImplementedInterface``` is a string array filled with full interface names and classes that satisfied all conditions will be chosen. +2. Scope.SELF : all classes implements interfaces **literally** +3. Scope.DIRECT : all classes implements interfaces or their children interfaces **literally** +4. Scope.ALL: all classes included in *Scope.DIRECT* and their childrens +5. Scope.LEAF: all classes in *Scope.ALL* with no children. + +Let's see a illustration. + +![scope](media/14948409810841/scope.png) + +When we use```@ImplementedInterface(value = "I", scope = ...)```, the targets are: + +* Scope.SELF -> A +* Scope.DIRECT -> A C +* Scope.ALL -> A B C D +* Scope.LEAF -> B D + + +### Choose target method + +#### Choose method name + +```java +public @interface Insert { + String value(); + boolean mayCreateSuper() default false; +} + +public @interface Proxy { + String value(); +} + +public @interface TryCatchHandler { +} + +public @interface NameRegex { + String value(); +} + +``` + +##### @TryCatchHandler + +This annotation is easy. + +```java +@TryCatchHandler +@NameRegex("(?!me/ele/).*") + public static Throwable catches(Throwable t){ + return t; + } +``` + +As the code above, it hook every try catch handle, you can deal with and return. And the control flow will jump to it's origin space. + +But with the ```@NameRegex```, something is different. + +##### @NameRegex + +@NameRegex is used to restrict hook method by match the class name.Be caution, the *dot* in class name will be replaced by *slash*. + +String value in @NameRegex will be compiled to pattern. the hook method only works if the pattern matches the class name where appear the cut point. + +Such as the above example, every class will be ignored if it's package name start with "me.ele."; + +@NameRegex can only be used with @Proxy or @TryCatchHandler. + +##### @Proxy and @Insert + +1. **Value** in ```@Proxy``` and ```@Insert``` is the target method name. +2. ```@Proxy``` means to hook every invoke point of the target method. + +3. ```@Insert``` means to hook the code inside the method. +4. In another word, if you use @Insert to hook a method, the running code in the target method will be changed.But ```@Proxy``` can control the scope by using it combined with ```@NameRegex```. +5. Another different is, classes in Android's ROM can't be touched as compiling time.So we can't use @Insert if we want to change the behavior of ROM's classes, but @Proxy can do it. + +@Insert has a special boolean parameter is ```mayCreateSuper```.Let's see a example. + +```java + +@TargetClass(value = "android.support.v7.app.AppCompatActivity", scope = Scope.LEAF) +@Insert(value = "onStop", mayCreateSuper = true) +protected void onStop(){ + System.out.println("hello world"); + Origin.callVoid(); +} +``` + +The goal method of the hook method is +every leaf child of AppcompatActivity ```void onStop()```. + +If a class ```MyActivity extends AppcompatActivity```do not override the onStop method, we will create a method for ```MyActivity``` like this: + +```java +protected void onStop() { + super.onStop(); +} +``` + +And then hook the method. + +If you open the flag, it will always create the method if target class has no matched method no matter it has the super method or doesn't. + +And the public/protected/private flag is inherited from above hook method.This is the flag's only use. + +Also be care that + +#### Choose method descriptor + +The example shown at first also indicates a important rule which is the strict match.The ```Log.i``` 's full descriptor is **"int Log.i(String, String)"**, more precisely "**"(Ljava/lang/String;Ljava/lang/String;)I"**". + +It means our hook method should have the same method descriptor and static flag with target method. + +It doesn't matter if you don't known method descriptor. You can have a look at [JVM Specification Chapter 4.3](https://docs.oracle.com/javase/specs/jvms/se7/html/jvms-4.html#jvms-4.3) if interested. + +We doesn't care if parameters' generic type are the same or not.In another word, we don't care signature of method, only descriptor. + +Also, exceptions declaration is also ignorable.You can write them for convenience. + +Any other access flag will be ignored except private/protected/public/static that we said above. + +##### @ClassOf + +Sometimes, we can't directly declare a class that we can't touch as parameter of our hook method. + +we can use ```@ClassOf``` to do this job. + +Take a look at the following example: + +```java +public class A { + protected int execute(B b){ + return b.call(); + } + + private class B { + + int call() { + return 0; + } + } +} + +@TargetClass("com.dieyidezui.demo.A") +@Insert("execute") +public int hookExecute(@ClassOf("com.dieyidezui.demo.A$B") Object o) { + System.out.println(o); + return (int) Origin.call(); +} +``` + +We use ```@ClassOf```to locate the parameter's actual type. + +And the parameter declared in method should be it's super class, such as ```java.lang.Object```; + +value in @ClassOf should be in the form of **"(package_name.)(outer_class_name$)class_name([]...)"**, such as: +* java.lang.Object +* java.lang.Integer[][] +* A[] +* A$B + +if no ```@ClassOf```, the hook method's descriptor is **"(Ljava/lang/Object;)I"**. But now it is **"(Lcom/dieyidezui/demo/A$B;)I"**. + +So the ```hookExecute``` method can match ```A.execute```. + +### API + +Till now, we have two classes to use, they are ```Origin``` and ```This```. + +#### Origin + +```Origin``` is used to call original method. +You can invoke its method zero or one more times if you like. + +##### Origin.call/callThrowOne/callThrowTwo/callThrowThree() +This group API is used for call the original method which has return value. +You should cast it to original type that the same with hook method descriptor's return type. + +##### Origin.callVoid/callVoidThrowOne/callVoidThrowTwo/callVoidThrowThree() + +Similar with above three methods, these methods are used for method without return value. + +By the way, the ```ThrowOne/ThrowTwo/ThrowThree``` are for deceiving the compiler if you want to catch some exceptions for some convenience. + +For example: + +```java +@TargetClass("java.io.InputStream") +@Proxy("read") +public int read(byte[] bytes) throws IOException { + try { + return (int) Origin.callThrowOne(); + } catch (IOException e) { + e.printStackTrace(); + throw e; + } +} +``` + +So that on every invoke point of ```int InputStream.read(byte[])```, if ```IOException``` happens, we will see its stacktrace. + +#### This + +##### get() + +This method is used for none static method to find this object. +You can cast it to its actual type. + +###### putField(Object, String) / getField(String) + +You can directly get or put a field in the target class even if the field is protected or private! + +What's more! If the field name is not exists, we will create it for you! + +Auto box and unbox are also supported. + +Also, we have some restricts: + +* These two methods only are only allowed to use with ```@Insert``` till now. +* You can't retrieve it's field of super class. When you try to get or put a field that it's super class has. We still will create the field for you. If the field of super class is private, it's OK. Otherwise, you will get a error at runtime. + +For example: + +```java +package me.ele; +public class Main { + private int a = 1; + + public void nothing(){ + + } + + public int getA(){ + return a; + } +} + +@TargetClass("me.ele.Main") +@Insert("nothing") +public void testThis() { + Log.e("debug", This.get().getClass().getName()); + This.putField(3, "a"); + Origin.callVoid(); +} + +``` + +Then we run the following codes: + +```java +Main main = new Main(); +main.nothing(); +Log.e("debug", "a = " + main.getA()); +``` + +We will see: + +``` +E/debug: me.ele.Main +E/debug: a = 3 +``` + +## Tips +1. Inner classes should be named like ```package.outer_class$inner_class``` +2. SDK developer needn't to apply plugin, just ```provided me.ele:lancet-base:x.y.z``` +3. Although we support incremental compilation. But when you use ```Scope.LEAF、Scope.ALL``` or edit the hook class, the incremental judgement will be a little special. It may cause full compilation. + +## License + +Licensed under the Apache License, Version 2.0 (the "License"); +you may not use this file except in compliance with the License. +You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + +Unless required by applicable law or agreed to in writing, software +distributed under the License is distributed on an "AS IS" BASIS, +WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +See the License for the specific language governing permissions and +limitations under the License. + + + + + + + diff --git a/README_zh.md b/README_zh.md new file mode 100644 index 0000000..a247707 --- /dev/null +++ b/README_zh.md @@ -0,0 +1,292 @@ +# Lancet + +Lancet 是一个轻量级Android AOP框架。 + ++ 编译速度快, 并且支持增量编译. ++ 简洁的 API, 几行 Java 代码完成注入需求. ++ 没有任何多余代码插入 apk. ++ 支持用于 SDK, 可以在SDK编写注入代码来修改依赖SDK的App. + +## 开始使用 +### 安装 + +在根目录的 `build.gradle` 添加: +```groovy +dependencies{ + classpath 'me.ele:lancet-plugin:1.0.4' +} +``` +在 app 目录的'build.gradle' 添加： +```groovy +apply plugin: 'me.ele.lancet' + +dependencies { + provided 'me.ele:lancet-base:1.0.4' +} +``` + + +### 示例 + +Lancet 使用注解来指定代码织入的规则与位置。 + +首先看看基础API使用: + +```java +@Proxy("i") +@TargetClass("android.util.Log") +public static int anyName(String tag, String msg){ + msg = msg + "lancet"; + return (int) Origin.call(); +} +``` + +这里有几个关键点: + +* ```@TargetClass``` 指定了将要被织入代码目标类 ```android.util.Log```. +* ```@Proxy``` 指定了将要被织入代码目标方法 ```i```. +* 织入方式为`Proxy`(将在后面介绍). +* ```Origin.call()``` 代表了 ```Log.i()``` 这个目标方法. + +所以这个示例Hook方法的作用就是 将代码里出现的所有 ```Log.i(tag,msg)``` 代码替换为```Log.i(tag,msg + "lancet")``` + +### 代码织入方式 + +#### @Proxy +```java +public @interface Proxy { + String value(); +} +``` + +`@Proxy` 将使用新的方法**替换**代码里存在的原有的目标方法. +比如代码里有10个地方调用了 `Dog.bark()`, 代理这个方法后，所有的10个地方的代码会变为`_Lancet.xxxx.bark()`. 而在这个新方法中会执行你在Hook方法中所写的代码. +`@Proxy` 通常用与对系统 API 的劫持。因为虽然我们不能注入代码到系统提供的库之中，但我们可以劫持掉所有调用系统API的地方。 + +##### @NameRegex +@NameRegex 用来限制范围操作的作用域. 仅用于`Proxy`模式中, 比如你只想代理掉某一个包名下所有的目标操作. 或者你在代理所有的网络请求时，不想代理掉自己发起的请求. 使用`NameRegex`对 `TargetClass` , `ImplementedInterface` 筛选出的class再进行一次匹配. + + + +#### @Insert +``` java +public @interface Insert { + String value(); + boolean mayCreateSuper() default false; +} +``` + +`@Insert` 将新代码插入到目标方法原有代码前后。 +`@Insert` 常用于操作App与library的类，并且可以通过`This`操作目标类的私有属性与方法(下文将会介绍)。 +`@Insert` 当目标方法不存在时，还可以使用`mayCreateSuper`参数来创建目标方法。 +比如下面将代码注入每一个Activity的`onStop`生命周期 + +```java + +@TargetClass(value = "android.support.v7.app.AppCompatActivity", scope = Scope.LEAF) +@Insert(value = "onStop", mayCreateSuper = true) +protected void onStop(){ + System.out.println("hello world"); + Origin.callVoid(); +} +``` + +`Scope` 将在后文介绍，这里的意为目标是 `AppCompatActivity` 的所有最终子类。 +如果一个类 `MyActivity extends AppcompatActivity` 没有重写 `onStop` 会自动创建`onStop`方法，而`Origin`在这里就代表了`super.onStop()`, 最后就是这样的效果： + +```java +protected void onStop() { + System.out.println("hello world"); + super.onStop(); +} +``` + +Note：public/protected/private 修饰符会完全照搬 Hook 方法的修饰符。 + + +### 匹配目标类 + +```java +public @interface TargetClass { + String value(); + + Scope scope() default Scope.SELF; +} + +public @interface ImplementedInterface { + + String[] value(); + + Scope scope() default Scope.SELF; +} + +public enum Scope { + + SELF, + DIRECT, + ALL, + LEAF +} +``` + +很多情况，我们不会仅匹配一个类，会有注入某各类所有子类，或者实现某个接口的所有类等需求。所以通过 `TargetClass` , `ImplementedInterface` 2个注解及 `Scope` 进行目标类匹配。 + +#### @TargetClass +通过类查找. + 1. `@TargetClass` 的 `value` 是一个类的全称. + 2. Scope.SELF 代表仅匹配 `value` 指定的目标类. + 3. Scope.DIRECT 代表匹配 `value` 指定类的直接子类. + 4. Scope.All 代表匹配 `value` 指定类的所有子类. + 5. Scope.LEAF 代表匹配 `value` 指定类的最终子类.众所周知java是单继承，所以继承关系是树形结构，所以这里代表了指定类为顶点的继承树的所有叶子节点. + +#### @ImplementedInterface +通过接口查找. 情况比通过类查找稍复杂一些. +1. `@ImplementedInterface` 的 `value` 可以填写多个接口的全名. +2. Scope.SELF : 代表直接实现所有指定接口的类. +3. Scope.DIRECT : 代表直接实现所有指定接口，以及指定接口的子接口的类. +4. Scope.ALL: 代表 `Scope.DIRECT` 指定的所有类及他们的所有子类. +5. Scope.LEAF: 代表 `Scope.ALL` 指定的森林结构中的所有叶节点. + +如下图： +![scope](media/14948409810841/scope.png) + +当我们使用`@ImplementedInterface(value = "I", scope = ...)`时, 目标类如下: + +* Scope.SELF -> A +* Scope.DIRECT -> A C +* Scope.ALL -> A B C D +* Scope.LEAF -> B D + + +### 匹配目标方法 +虽然在 `Proxy` , `Insert` 中我们指定了方法名, 但识别方法必须要更细致的信息. 我们会直接使用 Hook 方法的修饰符，参数类型来匹配方法. +所以一定要保持 Hook 方法的 `public/protected/private` `static` 信息与目标方法一致，参数类型，返回类型与目标方法一致. +返回类型可以用 Object 代替. +方法名不限. 异常声明也不限. + +但有时候我们并没有权限声明目标类. 这时候怎么办？ +##### @ClassOf +可以使用 `ClassOf` 注解来替代对类的直接 import. +比如下面这个例子： +```java +public class A { + protected int execute(B b){ + return b.call(); + } + + private class B { + + int call() { + return 0; + } + } +} + +@TargetClass("com.dieyidezui.demo.A") +@Insert("execute") +public int hookExecute(@ClassOf("com.dieyidezui.demo.A$B") Object o) { + System.out.println(o); + return (int) Origin.call(); +} +``` + +`ClassOf` 的 value 一定要按照 **`(package_name.)(outer_class_name$)inner_class_name([]...)`**的模板. +比如: +* java.lang.Object +* java.lang.Integer[][] +* A[] +* A$B + +### API +我们可以通过 `Origin` 与 `This` 与目标类进行一些交互. + +#### Origin +`Origin` 用来调用原目标方法. 可以被多次调用. +`Origin.call()` 用来调用有返回值的方法. +`Origin.callVoid()` 用来调用没有返回值的方法. +另外，如果你有捕捉异常的需求.可以使用 +`Origin.call/callThrowOne/callThrowTwo/callThrowThree()` +`Origin.callVoid/callVoidThrowOne/callVoidThrowTwo/callVoidThrowThree()` + +For example: + +```java +@TargetClass("java.io.InputStream") +@Proxy("read") +public int read(byte[] bytes) throws IOException { + try { + return (int) Origin.callThrowOne(); + } catch (IOException e) { + e.printStackTrace(); + throw e; + } +} +``` + + +#### This +仅用于`Insert` 方式的非静态方法的Hook中.(暂时) + +##### get() +返回目标方法被调用的实例化对象. + +###### putField & getField +你可以直接存取目标类的所有属性，无论是 `protected` or `private`. +另外，如果这个属性不存在，我们还会自动创建这个属性. Exciting! +自动装箱拆箱肯定也支持了. + +一些已知的缺陷: ++ `Proxy` 不能使用 `This` ++ 你不能存取你父类的属性. 当你尝试存取父类属性时，我们还是会创建新的属性. + +For example: + +```java +package me.ele; +public class Main { + private int a = 1; + + public void nothing(){ + + } + + public int getA(){ + return a; + } +} + +@TargetClass("me.ele.Main") +@Insert("nothing") +public void testThis() { + Log.e("debug", This.get().getClass().getName()); + This.putField(3, "a"); + Origin.callVoid(); +} + +``` + +## Tips +1. 内部类应该命名为 ```package.outer_class$inner_class``` +2. SDK 开发者不需要 `apply` 插件, 只需要 ```provided me.ele:lancet-base:x.y.z``` +3. 尽管我们支持增量编译. 但当我们使用 ```Scope.LEAF、Scope.ALL``` 覆盖的类有变动 或者修改 Hook 类时, 本次编译将会变成全量编译. + +## License + +Licensed under the Apache License, Version 2.0 (the "License"); +you may not use this file except in compliance with the License. +You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + +Unless required by applicable law or agreed to in writing, software +distributed under the License is distributed on an "AS IS" BASIS, +WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +See the License for the specific language governing permissions and +limitations under the License. + + + + + + + diff --git a/TODO.md b/TODO.md new file mode 100644 index 0000000..41449e2 --- /dev/null +++ b/TODO.md @@ -0,0 +1,7 @@ +# TODOList ++ meta.json in parser use json format and support version compatible ++ split PlaceHolder's function ++ support private field and method invoke. ++ support dynamically create field and method. ++ auto compile base and processor module ++ write unit test diff --git a/build.gradle b/build.gradle new file mode 100644 index 0000000..fd14310 --- /dev/null +++ b/build.gradle @@ -0,0 +1,156 @@ +// Top-level build file where you can add configuration options common to all sub-projects/modules. +apply plugin: 'base' +buildscript { + ext { + Properties properties = new Properties() + properties.load(project.rootProject.file('local.properties').newDataInputStream()) + + ele = true + ele = "true" == properties.getProperty("ele") + + if (!ele) { + bintrayUser = properties.getProperty('bintrayUser') + bintrayKey = properties.getProperty('bintrayKey') + } + lancet_group = 'me.ele' + lancet_version = '1.0.4' + //lancet_version = '0.0.1.8-SNAPSHOT' + + asm_version = '7.0' + //android_tools_version = '2.4.0-alpha6' + android_tools_version = '3.2.1' + guava_version = '20.0' + } + repositories { + jcenter() + mavenCentral() + maven { + if (ele) { + url "http://maven.dev.elenet.me/nexus/content/groups/public" + } else { + url "https://dl.bintray.com/eleme-mt-arch/maven" + } + } + } + dependencies { + if (ele) { + classpath 'me.ele:eradle:1.7.0' + } else { + classpath 'com.jfrog.bintray.gradle:gradle-bintray-plugin:1.7.3' + } + // NOTE: Do not place your application dependencies here; they belong + // in the individual module build.gradle files + } +} + +subprojects { pro -> + + repositories { + jcenter() + mavenCentral() + maven { + url 'https://maven.google.com' + } + } + + if (pro.name == 'sample-test')return + + version = lancet_version + group = lancet_group + + if (ele) { + apply plugin: 'eradle' + modifyPom { + project { + groupId lancet_group + artifactId pro.name + version lancet_version + packaging 'jar' + } + } + extraArchive { + sources = true + } + } else { + apply plugin: 'maven' + apply plugin: 'com.jfrog.bintray' + afterEvaluate { + task sourcesJar(type: Jar) { + from sourceSets.main.java.srcDirs + classifier = 'sources' + } + + task javadocJar(type: Jar, dependsOn: javadoc) { + classifier = 'javadoc' + from javadoc.destinationDir + } + + artifacts { + archives sourcesJar + archives javadocJar + } + tasks.install { + repositories.mavenInstaller { + pom { + project { + packaging 'jar' + licenses { + license { + name 'The Apache Software License, Version 2.0' + url 'http://www.apache.org/licenses/LICENSE-2.0.txt' + } + } + developers { + developer { + id 'dieyidezui' + name '耿万鹏' + email 'dieyidezui@gmail.com' + } + developer { + id 'jude95' + name '朱晨曦' + email '973829691@qq.com' + } + } + } + } + } + } + } + bintray { + user = bintrayUser + key = bintrayKey + configurations = ['archives'] + pkg { + userOrg = "eleme-mt-arch" + repo = "maven" + userOrg = "eleme-mt-arch" + name = pro.name //发布到JCenter上的项目名字 + websiteUrl = "https://github.com/eleme/lancet" + vcsUrl = "git@github.com:eleme/lancet.git" + licenses = ["Apache-2.0"] + publish = true + } + } + } + +} + +task uploadAll { task -> + + task.group = 'upload' + gradle.projectsEvaluated { + task.dependsOn project.tasks.clean + task.dependsOn project.tasks.build + + project.tasks.build.mustRunAfter project.tasks.clean + + project.subprojects { + if (it.name != 'sample-test') { + Task upload = !ele ? it.tasks.bintrayUpload : it.tasks.uploadArchives; + task.dependsOn upload + upload.mustRunAfter project.tasks.build + } + } + } +} diff --git a/gradle.properties b/gradle.properties new file mode 100644 index 0000000..89196d1 --- /dev/null +++ b/gradle.properties @@ -0,0 +1,18 @@ +# Project-wide Gradle settings. + +# IDE (e.g. Android Studio) users: +# Gradle settings configured through the IDE *will override* +# any settings specified in this file. + +# For more details on how to configure your build environment visit +# http://www.gradle.org/docs/current/userguide/build_environment.html + +# Specifies the JVM arguments used for the daemon process. +# The setting is particularly useful for tweaking memory settings. +org.gradle.jvmargs=-Xmx1536m + +# When configured, Gradle will run in incubating parallel mode. +# This option should only be used with decoupled projects. More details, visit +# http://www.gradle.org/docs/current/userguide/multi_project_builds.html#sec:decoupled_projects +# org.gradle.parallel=true + diff --git a/gradle/wrapper/gradle-wrapper.jar b/gradle/wrapper/gradle-wrapper.jar new file mode 100644 index 0000000000000000000000000000000000000000..13372aef5e24af05341d49695ee84e5f9b594659 GIT binary patch literal 53636 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ⅅ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 H-+%o-(+5aQ literal 0 HcmV?d00001 diff --git a/gradle/wrapper/gradle-wrapper.properties b/gradle/wrapper/gradle-wrapper.properties new file mode 100644 index 0000000..86a9f99 --- /dev/null +++ b/gradle/wrapper/gradle-wrapper.properties @@ -0,0 +1,7 @@ +#Mon Apr 10 15:23:45 CST 2017 +distributionBase=GRADLE_USER_HOME +distributionPath=wrapper/dists +zipStoreBase=GRADLE_USER_HOME +zipStorePath=wrapper/dists +distributionUrl=https\://services.gradle.org/distributions/gradle-4.10-all.zip + diff --git a/gradlew b/gradlew new file mode 100755 index 0000000..9d82f78 --- /dev/null +++ b/gradlew @@ -0,0 +1,160 @@ +#!/usr/bin/env bash + +############################################################################## +## +## Gradle start up script for UN*X +## +############################################################################## + +# Add default JVM options here. You can also use JAVA_OPTS and GRADLE_OPTS to pass JVM options to this script. +DEFAULT_JVM_OPTS="" + +APP_NAME="Gradle" +APP_BASE_NAME=`basename "$0"` + +# Use the maximum available, or set MAX_FD != -1 to use that value. +MAX_FD="maximum" + +warn ( ) { + echo "$*" +} + +die ( ) { + echo + echo "$*" + echo + exit 1 +} + +# OS specific support (must be 'true' or 'false'). +cygwin=false +msys=false +darwin=false +case "`uname`" in + CYGWIN* ) + cygwin=true + ;; + Darwin* ) + darwin=true + ;; + MINGW* ) + msys=true + ;; +esac + +# Attempt to set APP_HOME +# Resolve links: $0 may be a link +PRG="$0" +# Need this for relative symlinks. +while [ -h "$PRG" ] ; do + ls=`ls -ld "$PRG"` + link=`expr "$ls" : '.*-> \(.*\)$'` + if expr "$link" : '/.*' > /dev/null; then + PRG="$link" + else + PRG=`dirname "$PRG"`"/$link" + fi +done +SAVED="`pwd`" +cd "`dirname \"$PRG\"`/" >/dev/null +APP_HOME="`pwd -P`" +cd "$SAVED" >/dev/null + +CLASSPATH=$APP_HOME/gradle/wrapper/gradle-wrapper.jar + +# Determine the Java command to use to start the JVM. +if [ -n "$JAVA_HOME" ] ; then + if [ -x "$JAVA_HOME/jre/sh/java" ] ; then + # IBM's JDK on AIX uses strange locations for the executables + JAVACMD="$JAVA_HOME/jre/sh/java" + else + JAVACMD="$JAVA_HOME/bin/java" + fi + if [ ! -x "$JAVACMD" ] ; then + die "ERROR: JAVA_HOME is set to an invalid directory: $JAVA_HOME + +Please set the JAVA_HOME variable in your environment to match the +location of your Java installation." + fi +else + JAVACMD="java" + which java >/dev/null 2>&1 || die "ERROR: JAVA_HOME is not set and no 'java' command could be found in your PATH. + +Please set the JAVA_HOME variable in your environment to match the +location of your Java installation." +fi + +# Increase the maximum file descriptors if we can. +if [ "$cygwin" = "false" -a "$darwin" = "false" ] ; then + MAX_FD_LIMIT=`ulimit -H -n` + if [ $? -eq 0 ] ; then + if [ "$MAX_FD" = "maximum" -o "$MAX_FD" = "max" ] ; then + MAX_FD="$MAX_FD_LIMIT" + fi + ulimit -n $MAX_FD + if [ $? -ne 0 ] ; then + warn "Could not set maximum file descriptor limit: $MAX_FD" + fi + else + warn "Could not query maximum file descriptor limit: $MAX_FD_LIMIT" + fi +fi + +# For Darwin, add options to specify how the application appears in the dock +if $darwin; then + GRADLE_OPTS="$GRADLE_OPTS \"-Xdock:name=$APP_NAME\" \"-Xdock:icon=$APP_HOME/media/gradle.icns\"" +fi + +# For Cygwin, switch paths to Windows format before running java +if $cygwin ; then + APP_HOME=`cygpath --path --mixed "$APP_HOME"` + CLASSPATH=`cygpath --path --mixed "$CLASSPATH"` + JAVACMD=`cygpath --unix "$JAVACMD"` + + # We build the pattern for arguments to be converted via cygpath + ROOTDIRSRAW=`find -L / -maxdepth 1 -mindepth 1 -type d 2>/dev/null` + SEP="" + for dir in $ROOTDIRSRAW ; do + ROOTDIRS="$ROOTDIRS$SEP$dir" + SEP="|" + done + OURCYGPATTERN="(^($ROOTDIRS))" + # Add a user-defined pattern to the cygpath arguments + if [ "$GRADLE_CYGPATTERN" != "" ] ; then + OURCYGPATTERN="$OURCYGPATTERN|($GRADLE_CYGPATTERN)" + fi + # Now convert the arguments - kludge to limit ourselves to /bin/sh + i=0 + for arg in "$@" ; do + CHECK=`echo "$arg"|egrep -c "$OURCYGPATTERN" -` + CHECK2=`echo "$arg"|egrep -c "^-"` ### Determine if an option + + if [ $CHECK -ne 0 ] && [ $CHECK2 -eq 0 ] ; then ### Added a condition + eval `echo args$i`=`cygpath --path --ignore --mixed "$arg"` + else + eval `echo args$i`="\"$arg\"" + fi + i=$((i+1)) + done + case $i in + (0) set -- ;; + (1) set -- "$args0" ;; + (2) set -- "$args0" "$args1" ;; + (3) set -- "$args0" "$args1" "$args2" ;; + (4) set -- "$args0" "$args1" "$args2" "$args3" ;; + (5) set -- "$args0" "$args1" "$args2" "$args3" "$args4" ;; + (6) set -- "$args0" "$args1" "$args2" "$args3" "$args4" "$args5" ;; + (7) set -- "$args0" "$args1" "$args2" "$args3" "$args4" "$args5" "$args6" ;; + (8) set -- "$args0" "$args1" "$args2" "$args3" "$args4" "$args5" "$args6" "$args7" ;; + (9) set -- "$args0" "$args1" "$args2" "$args3" "$args4" "$args5" "$args6" "$args7" "$args8" ;; + esac +fi + +# Split up the JVM_OPTS And GRADLE_OPTS values into an array, following the shell quoting and substitution rules +function splitJvmOpts() { + JVM_OPTS=("$@") +} +eval splitJvmOpts $DEFAULT_JVM_OPTS $JAVA_OPTS $GRADLE_OPTS +JVM_OPTS[${#JVM_OPTS[*]}]="-Dorg.gradle.appname=$APP_BASE_NAME" + +exec "$JAVACMD" "${JVM_OPTS[@]}" -classpath "$CLASSPATH" org.gradle.wrapper.GradleWrapperMain "$@" diff --git a/gradlew.bat b/gradlew.bat new file mode 100644 index 0000000..aec9973 --- /dev/null +++ b/gradlew.bat @@ -0,0 +1,90 @@ +@if "%DEBUG%" == "" @echo off +@rem ########################################################################## +@rem +@rem Gradle startup script for Windows +@rem +@rem ########################################################################## + +@rem Set local scope for the variables with windows NT shell +if "%OS%"=="Windows_NT" setlocal + +@rem Add default JVM options here. You can also use JAVA_OPTS and GRADLE_OPTS to pass JVM options to this script. +set DEFAULT_JVM_OPTS= + +set DIRNAME=%~dp0 +if "%DIRNAME%" == "" set DIRNAME=. +set APP_BASE_NAME=%~n0 +set APP_HOME=%DIRNAME% + +@rem Find java.exe +if defined JAVA_HOME goto findJavaFromJavaHome + +set JAVA_EXE=java.exe +%JAVA_EXE% -version >NUL 2>&1 +if "%ERRORLEVEL%" == "0" goto init + +echo. +echo ERROR: JAVA_HOME is not set and no 'java' command could be found in your PATH. +echo. +echo Please set the JAVA_HOME variable in your environment to match the +echo location of your Java installation. + +goto fail + +:findJavaFromJavaHome +set JAVA_HOME=%JAVA_HOME:"=% +set JAVA_EXE=%JAVA_HOME%/bin/java.exe + +if exist "%JAVA_EXE%" goto init + +echo. +echo ERROR: JAVA_HOME is set to an invalid directory: %JAVA_HOME% +echo. +echo Please set the JAVA_HOME variable in your environment to match the +echo location of your Java installation. + +goto fail + +:init +@rem Get command-line arguments, handling Windowz variants + +if not "%OS%" == "Windows_NT" goto win9xME_args +if "%@eval[2+2]" == "4" goto 4NT_args + +:win9xME_args +@rem Slurp the command line arguments. +set CMD_LINE_ARGS= +set _SKIP=2 + +:win9xME_args_slurp +if "x%~1" == "x" goto execute + +set CMD_LINE_ARGS=%* +goto execute + +:4NT_args +@rem Get arguments from the 4NT Shell from JP Software +set CMD_LINE_ARGS=%$ + +:execute +@rem Setup the command line + +set CLASSPATH=%APP_HOME%\gradle\wrapper\gradle-wrapper.jar + +@rem Execute Gradle +"%JAVA_EXE%" %DEFAULT_JVM_OPTS% %JAVA_OPTS% %GRADLE_OPTS% "-Dorg.gradle.appname=%APP_BASE_NAME%" -classpath "%CLASSPATH%" org.gradle.wrapper.GradleWrapperMain %CMD_LINE_ARGS% + +:end +@rem End local scope for the variables with windows NT shell +if "%ERRORLEVEL%"=="0" goto mainEnd + +:fail +rem Set variable GRADLE_EXIT_CONSOLE if you need the _script_ return code instead of +rem the _cmd.exe /c_ return code! +if not "" == "%GRADLE_EXIT_CONSOLE%" exit 1 +exit /b 1 + +:mainEnd +if "%OS%"=="Windows_NT" endlocal + +:omega diff --git a/lancet-base/.gitignore b/lancet-base/.gitignore new file mode 100644 index 0000000..796b96d --- /dev/null +++ b/lancet-base/.gitignore @@ -0,0 +1 @@ +/build diff --git a/lancet-base/build.gradle b/lancet-base/build.gradle new file mode 100644 index 0000000..608c002 --- /dev/null +++ b/lancet-base/build.gradle @@ -0,0 +1,10 @@ +apply plugin: 'java' + +dependencies { + compile fileTree(dir: 'libs', include: ['*.jar']) + compile 'org.aspectj:aspectjrt:1.9.2' + compileOnly "com.google.code.findbugs:jsr305:3.0.2" +} + +sourceCompatibility = "1.7" +targetCompatibility = "1.7" diff --git a/lancet-base/src/main/java/com/dieyidezui/lancet/rt/AroundContext.java b/lancet-base/src/main/java/com/dieyidezui/lancet/rt/AroundContext.java new file mode 100644 index 0000000..dac042b --- /dev/null +++ b/lancet-base/src/main/java/com/dieyidezui/lancet/rt/AroundContext.java @@ -0,0 +1,36 @@ +package com.dieyidezui.lancet.rt; + +import com.sun.istack.internal.Nullable; + +public interface AroundContext { + + /** + * @return The Arguments of the methods, changes to it will affect {@link AroundContext#proceed()}'s arguments on Lancet.getGlobalInterceptor. + * But it doesn't works on hook method, because {@link AroundContext#proceed()} will collect your hook method's actual arguments as parameters. + */ + Object[] getArgs(); + + /** + * @return The context where your target method called. + * If static, return the class of method. + */ + Object getTarget(); + + /** + * @return The object when your target method executed. + * If static, return the class of method. + */ + Object getThis(); + + @Nullable + Object proceed(); + + @Nullable + Object proceedThrow1() throws T1; + + @Nullable + Object proceedThrow2() throws T1, T2; + + @Nullable + Object proceedThrow3() throws T1, T2, T3; +} diff --git a/lancet-base/src/main/java/com/dieyidezui/lancet/rt/AutoReplaced.java b/lancet-base/src/main/java/com/dieyidezui/lancet/rt/AutoReplaced.java new file mode 100644 index 0000000..0c39403 --- /dev/null +++ b/lancet-base/src/main/java/com/dieyidezui/lancet/rt/AutoReplaced.java @@ -0,0 +1,13 @@ +package com.dieyidezui.lancet.rt; + +import java.lang.annotation.*; + +/** + * Indicates that annotations will replace / move / transform their annotated methods' bytecode. + */ +@Documented +@Retention(RetentionPolicy.SOURCE) +@AutoReplaced +@Target({ElementType.METHOD, ElementType.ANNOTATION_TYPE}) +public @interface AutoReplaced { +} diff --git a/lancet-base/src/main/java/com/dieyidezui/lancet/rt/Interceptor.java b/lancet-base/src/main/java/com/dieyidezui/lancet/rt/Interceptor.java new file mode 100644 index 0000000..3192f84 --- /dev/null +++ b/lancet-base/src/main/java/com/dieyidezui/lancet/rt/Interceptor.java @@ -0,0 +1,6 @@ +package com.dieyidezui.lancet.rt; + +public interface Interceptor { + + Object intercept(AroundContext context); +} diff --git a/lancet-base/src/main/java/com/dieyidezui/lancet/rt/Lancet.java b/lancet-base/src/main/java/com/dieyidezui/lancet/rt/Lancet.java new file mode 100644 index 0000000..f2b7520 --- /dev/null +++ b/lancet-base/src/main/java/com/dieyidezui/lancet/rt/Lancet.java @@ -0,0 +1,31 @@ +package com.dieyidezui.lancet.rt; + +import javax.annotation.Nullable; + +public class Lancet { + + private static Lancet instance = new Lancet(); + + public static Lancet instance() { + return instance; + } + + private Interceptor global; + + /** + * Add Method Interceptor at runtime, use it carefully! + */ + public void setGlobalInterceptor(@Nullable Interceptor interceptor) { + this.global = interceptor; + } + + @Nullable + public Interceptor getGlobalInterceptor() { + return global; + } + + @AutoReplaced + public static AroundContext getContext() { + throw new AssertionError("Don't invoke it outside hook method!"); + } +} diff --git a/lancet-base/src/main/java/com/dieyidezui/lancet/rt/Scope.java b/lancet-base/src/main/java/com/dieyidezui/lancet/rt/Scope.java new file mode 100644 index 0000000..5c0a102 --- /dev/null +++ b/lancet-base/src/main/java/com/dieyidezui/lancet/rt/Scope.java @@ -0,0 +1,12 @@ +package com.dieyidezui.lancet.rt; + +/** + * Created by gengwanpeng on 17/5/3. + */ +public enum Scope { + + SELF, + DIRECT, + ALL, + LEAF +} diff --git a/lancet-base/src/main/java/com/dieyidezui/lancet/rt/annotations/ClassOf.java b/lancet-base/src/main/java/com/dieyidezui/lancet/rt/annotations/ClassOf.java new file mode 100644 index 0000000..4ebad36 --- /dev/null +++ b/lancet-base/src/main/java/com/dieyidezui/lancet/rt/annotations/ClassOf.java @@ -0,0 +1,20 @@ +package com.dieyidezui.lancet.rt.annotations; + +import java.lang.annotation.*; + +/** + * Annotates a parameter that its actual desc is the value(). + * The parameter should be instance of the desc of class. + * For example: + * void foo(@ClassOf("java.util.HashMap") HashMap map); // useless for @ClassOf + * void foo(@ClassOf("java.util.HashMap") Map map); // work + * void foo(@ClassOf("java.util.HashMap[]") Object obj); // work + * void foo(@ClassOf("java.util.HashMap[]") Map[] maps); // work + * void foo(@ClassOf("java.util.HashMap[]") Map map); // doesn't work + */ +@Documented +@Retention(RetentionPolicy.RUNTIME) +@Target(ElementType.PARAMETER) +public @interface ClassOf { + String value(); +} diff --git a/lancet-base/src/main/java/com/dieyidezui/lancet/rt/annotations/ImplementedInterface.java b/lancet-base/src/main/java/com/dieyidezui/lancet/rt/annotations/ImplementedInterface.java new file mode 100644 index 0000000..116bcc1 --- /dev/null +++ b/lancet-base/src/main/java/com/dieyidezui/lancet/rt/annotations/ImplementedInterface.java @@ -0,0 +1,27 @@ +package com.dieyidezui.lancet.rt.annotations; + +import com.dieyidezui.lancet.rt.Scope; + +import java.lang.annotation.ElementType; +import java.lang.annotation.Retention; +import java.lang.annotation.RetentionPolicy; +import java.lang.annotation.Target; + +/** + * Limit the target classes. + */ +@Retention(RetentionPolicy.RUNTIME) +@Target({ElementType.TYPE, ElementType.METHOD}) +public @interface ImplementedInterface { + + /** + * Interface array, java type name, $ for inner class. + * For example : a.b.c$d; + */ + String[] value(); + + /** + * The scope of interface array. + */ + Scope scope() default Scope.SELF; +} diff --git a/lancet-base/src/main/java/com/dieyidezui/lancet/rt/annotations/Insert.java b/lancet-base/src/main/java/com/dieyidezui/lancet/rt/annotations/Insert.java new file mode 100644 index 0000000..ba2349e --- /dev/null +++ b/lancet-base/src/main/java/com/dieyidezui/lancet/rt/annotations/Insert.java @@ -0,0 +1,30 @@ +package com.dieyidezui.lancet.rt.annotations; + +import com.dieyidezui.lancet.rt.AutoReplaced; + +import java.lang.annotation.*; + +/** + * Indicate the hook method. + */ +@Documented +@Retention(RetentionPolicy.RUNTIME) +@Target(ElementType.METHOD) +@AutoReplaced +public @interface Insert { + + /** + * The target method name. + */ + String value(); + + /** + * if true, create empty method which only invoke super if not exits + */ + boolean mayCreateSuper() default false; + + /** + * Priority to sort hook methods, the smaller, the higher. + */ + int priority() default 0; +} diff --git a/lancet-base/src/main/java/com/dieyidezui/lancet/rt/annotations/Interceptable.java b/lancet-base/src/main/java/com/dieyidezui/lancet/rt/annotations/Interceptable.java new file mode 100644 index 0000000..b376bb8 --- /dev/null +++ b/lancet-base/src/main/java/com/dieyidezui/lancet/rt/annotations/Interceptable.java @@ -0,0 +1,16 @@ +package com.dieyidezui.lancet.rt.annotations; + +import com.dieyidezui.lancet.rt.AutoReplaced; +import com.dieyidezui.lancet.rt.Lancet; + +import java.lang.annotation.*; + +/** + * Annotate a method to make it interceptable by {@link Lancet#getGlobalInterceptor()}. + */ +@Documented +@Retention(RetentionPolicy.RUNTIME) +@Target({ElementType.METHOD}) +@AutoReplaced +public @interface Interceptable { +} \ No newline at end of file diff --git a/lancet-base/src/main/java/com/dieyidezui/lancet/rt/annotations/NameRegex.java b/lancet-base/src/main/java/com/dieyidezui/lancet/rt/annotations/NameRegex.java new file mode 100644 index 0000000..01f3911 --- /dev/null +++ b/lancet-base/src/main/java/com/dieyidezui/lancet/rt/annotations/NameRegex.java @@ -0,0 +1,18 @@ +package com.dieyidezui.lancet.rt.annotations; + +import java.lang.annotation.ElementType; +import java.lang.annotation.Retention; +import java.lang.annotation.RetentionPolicy; +import java.lang.annotation.Target; + +/** + * Restrict {@link Proxy} and {@link TryCatchHandler}'s scope, only classes which matched the regex will add the hook code. + */ +@Retention(RetentionPolicy.RUNTIME) +@Target(ElementType.METHOD) +public @interface NameRegex { + /** + * The regex to match the class name, use the internal name, dot to slash + */ + String value(); +} diff --git a/lancet-base/src/main/java/com/dieyidezui/lancet/rt/annotations/Proxy.java b/lancet-base/src/main/java/com/dieyidezui/lancet/rt/annotations/Proxy.java new file mode 100644 index 0000000..0a899d6 --- /dev/null +++ b/lancet-base/src/main/java/com/dieyidezui/lancet/rt/annotations/Proxy.java @@ -0,0 +1,24 @@ +package com.dieyidezui.lancet.rt.annotations; + +import com.dieyidezui.lancet.rt.AutoReplaced; + +import java.lang.annotation.*; + +/** + * Indicate the hook method. + */ +@Documented +@Retention(RetentionPolicy.RUNTIME) +@Target(ElementType.METHOD) +@AutoReplaced +public @interface Proxy { + /** + * The target method name. + */ + String value(); + + /** + * Priority to sort hook methods, the smaller, the higher. + */ + int priority() default 0; +} diff --git a/lancet-base/src/main/java/com/dieyidezui/lancet/rt/annotations/TargetClass.java b/lancet-base/src/main/java/com/dieyidezui/lancet/rt/annotations/TargetClass.java new file mode 100644 index 0000000..4417daf --- /dev/null +++ b/lancet-base/src/main/java/com/dieyidezui/lancet/rt/annotations/TargetClass.java @@ -0,0 +1,17 @@ +package com.dieyidezui.lancet.rt.annotations; + +import com.dieyidezui.lancet.rt.Scope; + +import java.lang.annotation.*; + +/** + * Limit the target classes. + */ +@Documented +@Retention(RetentionPolicy.RUNTIME) +@Target({ElementType.TYPE, ElementType.METHOD}) +public @interface TargetClass { + String value(); + + Scope scope() default Scope.SELF; +} diff --git a/lancet-base/src/main/java/com/dieyidezui/lancet/rt/annotations/TryCatchHandler.java b/lancet-base/src/main/java/com/dieyidezui/lancet/rt/annotations/TryCatchHandler.java new file mode 100644 index 0000000..58abbf9 --- /dev/null +++ b/lancet-base/src/main/java/com/dieyidezui/lancet/rt/annotations/TryCatchHandler.java @@ -0,0 +1,17 @@ +package com.dieyidezui.lancet.rt.annotations; + +import com.dieyidezui.lancet.rt.AutoReplaced; + +import java.lang.annotation.*; + +/** + * Pre process the classes who extends {@link Throwable}. + * The method desc should like (A)A (A is a class that extends Throwable). + * Combine with {@link NameRegex} to restrict the scope. + */ +@Documented +@Retention(RetentionPolicy.RUNTIME) +@Target(ElementType.METHOD) +@AutoReplaced +public @interface TryCatchHandler { +} diff --git a/lancet-base/src/main/java/com/dieyidezui/lancet/rt/internal/AroundMethodChain.java b/lancet-base/src/main/java/com/dieyidezui/lancet/rt/internal/AroundMethodChain.java new file mode 100644 index 0000000..4688e9a --- /dev/null +++ b/lancet-base/src/main/java/com/dieyidezui/lancet/rt/internal/AroundMethodChain.java @@ -0,0 +1,81 @@ +package com.dieyidezui.lancet.rt.internal; + + +import com.dieyidezui.lancet.rt.AroundContext; +import com.dieyidezui.lancet.rt.Interceptor; + +import javax.annotation.Nullable; +import java.util.List; + +public class AroundMethodChain implements AroundContext { + + private final Object target; + private final Object thiz; + private final int index; + private final List interceptors; + private final Object[] args; + + public AroundMethodChain(Object target, Object thiz, int index, List interceptors, Object[] args) { + this.target = target; + this.thiz = thiz; + this.index = index; + this.interceptors = interceptors; + this.args = args; + } + + @Nullable + @Override + public Object getTarget() { + return target; + } + + @Nullable + @Override + public Object getThis() { + return thiz; + } + + @Override + public Object[] getArgs() { + return args; + } + + @Nullable + @Override + public Object proceedThrow1() throws T1 { + return proceed(); + } + + @Nullable + @Override + public Object proceedThrow2() throws T1, T2 { + return proceed(); + } + + @Nullable + @Override + public Object proceedThrow3() throws T1, T2, T3 { + return proceed(); + } + + @Nullable + @Override + public Object proceed() { + return proceed(args.clone()); + } + + /** + * public for generated code! + * + * @param args don't clone args + */ + @Nullable + public Object proceed(Object[] args) { + if (this.index > interceptors.size()) { + throw new AssertionError(); + } + // Clone args when pass to next! + AroundMethodChain next = new AroundMethodChain(target, thiz, index + 1, interceptors, args); + return interceptors.get(index).intercept(next); + } +} diff --git a/lancet-base/src/main/java/com/dieyidezui/lancet/rt/internal/Util.java b/lancet-base/src/main/java/com/dieyidezui/lancet/rt/internal/Util.java new file mode 100644 index 0000000..2eebf48 --- /dev/null +++ b/lancet-base/src/main/java/com/dieyidezui/lancet/rt/internal/Util.java @@ -0,0 +1,4 @@ +package com.dieyidezui.lancet.rt.internal; + +public class Util { +} diff --git a/lancet-base/src/main/java/com/dieyidezui/lancet/rt/internal/codegen/CodegenHelper.java b/lancet-base/src/main/java/com/dieyidezui/lancet/rt/internal/codegen/CodegenHelper.java new file mode 100644 index 0000000..e5c7cfd --- /dev/null +++ b/lancet-base/src/main/java/com/dieyidezui/lancet/rt/internal/codegen/CodegenHelper.java @@ -0,0 +1,46 @@ +package com.dieyidezui.lancet.rt.internal.codegen; + +import com.dieyidezui.lancet.rt.Interceptor; +import com.dieyidezui.lancet.rt.Lancet; +import com.dieyidezui.lancet.rt.AroundContext; +import com.dieyidezui.lancet.rt.annotations.TryCatchHandler; +import com.dieyidezui.lancet.rt.internal.AroundMethodChain; + +import javax.annotation.Nullable; +import java.util.ArrayList; +import java.util.Arrays; +import java.util.List; + +public class CodegenHelper { + + /** + * Invoked by generated code at hook point. + * @param interceptorArray sorted by priority + */ + public static void doAround(@Nullable Object target, @Nullable Object thiz, Object[] args, GeneratedInterceptor[] interceptorArray) { + + List interceptors = new ArrayList<>(interceptorArray.length + 1); + + Interceptor global = Lancet.instance().getGlobalInterceptor(); + if (global != null) { + interceptors.add(global); + } + interceptors.addAll(Arrays.asList(interceptorArray)); + // Optimize for first invoke, reduce clone args once + new AroundMethodChain(target, thiz, 0, interceptors, null).proceed(args); + } + + /** + * For {@link TryCatchHandler} + */ + public static Object onThrow(@Nullable Object target, Object[] args, GeneratedInterceptor[] interceptors) { + return new AroundMethodChain(target, null, 0, Arrays.asList(interceptors), null).proceed(args); + } + + /** + * Lancet.getContext() will redirect to this method + */ + public static AroundContext getContext(GeneratedInterceptor interceptor) { + return interceptor.getContext(); + } +} diff --git a/lancet-base/src/main/java/com/dieyidezui/lancet/rt/internal/codegen/GeneratedInterceptor.java b/lancet-base/src/main/java/com/dieyidezui/lancet/rt/internal/codegen/GeneratedInterceptor.java new file mode 100644 index 0000000..97285b7 --- /dev/null +++ b/lancet-base/src/main/java/com/dieyidezui/lancet/rt/internal/codegen/GeneratedInterceptor.java @@ -0,0 +1,24 @@ +package com.dieyidezui.lancet.rt.internal.codegen; + +import com.dieyidezui.lancet.rt.Interceptor; +import com.dieyidezui.lancet.rt.AroundContext; + +import javax.annotation.Nullable; + +public abstract class GeneratedInterceptor implements Interceptor { + + private AroundContext context; + + @Override + public final Object intercept(AroundContext context) { + this.context = context; + return intercept(context.getArgs()); + } + + final public AroundContext getContext() { + return context; + } + + @Nullable + protected abstract Object intercept(Object[] args); +} diff --git a/lancet-plugin/.gitignore b/lancet-plugin/.gitignore new file mode 100644 index 0000000..796b96d --- /dev/null +++ b/lancet-plugin/.gitignore @@ -0,0 +1 @@ +/build diff --git a/lancet-plugin/build.gradle b/lancet-plugin/build.gradle new file mode 100644 index 0000000..1c7d763 --- /dev/null +++ b/lancet-plugin/build.gradle @@ -0,0 +1,30 @@ +apply plugin: 'java' + +dependencies { + compile fileTree(dir: 'libs', include: ['*.jar']) + compile gradleApi() + compileOnly "com.android.tools.build:gradle:$android_tools_version" + compile "com.google.code.gson:gson:2.8.0" + compile project(':lancet-weaver') + testCompile gradleTestKit() + testCompile 'junit:junit:4.12' +} + +sourceCompatibility = "1.8" +targetCompatibility = "1.8" + +task createClasspathManifest { + def outputDir = file("$buildDir/$name") + + inputs.files sourceSets.main.runtimeClasspath + outputs.dir outputDir + + doLast { + outputDir.mkdirs() + file("$outputDir/plugin-classpath.txt").text = sourceSets.main.runtimeClasspath.join("\n") + } +} + +dependencies { + testRuntime files(createClasspathManifest) +} \ No newline at end of file diff --git a/lancet-plugin/src/main/java/com/dieyidezui/lancet/plugin/LancetTransform.java b/lancet-plugin/src/main/java/com/dieyidezui/lancet/plugin/LancetTransform.java new file mode 100644 index 0000000..8686ff1 --- /dev/null +++ b/lancet-plugin/src/main/java/com/dieyidezui/lancet/plugin/LancetTransform.java @@ -0,0 +1,39 @@ +package com.dieyidezui.lancet.plugin; + +import com.android.build.api.transform.QualifiedContent; +import com.android.build.api.transform.Transform; +import com.android.build.api.transform.TransformException; +import com.android.build.api.transform.TransformInvocation; +import com.android.build.gradle.internal.pipeline.TransformManager; + +import java.io.IOException; +import java.util.Set; + +public class LancetTransform extends Transform { + + + @Override + public String getName() { + return "lancet"; + } + + @Override + public Set getInputTypes() { + return TransformManager.CONTENT_CLASS; + } + + @Override + public Set getScopes() { + return TransformManager.SCOPE_FULL_PROJECT; + } + + @Override + public boolean isIncremental() { + return true; + } + + @Override + public void transform(TransformInvocation transformInvocation) throws TransformException, InterruptedException, IOException { + + } +} diff --git a/lancet-plugin/src/main/java/me/ele/lancet/plugin/LancetExtension.java b/lancet-plugin/src/main/java/me/ele/lancet/plugin/LancetExtension.java new file mode 100644 index 0000000..35f848a --- /dev/null +++ b/lancet-plugin/src/main/java/me/ele/lancet/plugin/LancetExtension.java @@ -0,0 +1,73 @@ + +package me.ele.lancet.plugin; + +import com.google.common.base.Strings; +import me.ele.lancet.weaver.internal.log.Log; + +import java.io.File; +import java.util.Objects; + +public class LancetExtension { + private Log.Level level = Log.Level.INFO; + private String fileName = null; + private boolean incremental = true; + + public void logLevel(Log.Level level) { + this.level = Objects.requireNonNull(level, "Log.Level is null"); + } + + public void logLevel(int level) { + this.level = Log.Level.values()[level]; + } + + public void logLevel(String logStr) { + logLevel(strToLog(logStr)); + } + + private static Log.Level strToLog(String logStr) { + logStr = logStr.toLowerCase(); + switch (logStr) { + case "d": + case "debug": + return Log.Level.DEBUG; + case "i": + case "info": + return Log.Level.INFO; + case "w": + case "warn": + return Log.Level.WARN; + case "e": + case "error": + return Log.Level.ERROR; + default: + throw new IllegalArgumentException("wrong log string: " + logStr); + } + } + + public void useFileLog(String fileName) { + if (Strings.isNullOrEmpty(fileName) || fileName.contains(File.separator)) { + throw new IllegalArgumentException("File name is illegal: " + fileName); + } + this.fileName = fileName; + } + + public void setIncremental(boolean incremental) { + this.incremental = incremental; + } + + public boolean getIncremental() { + return this.incremental; + } + + public void incremental(boolean incremental) { + this.incremental = incremental; + } + + public Log.Level getLogLevel() { + return level; + } + + public String getFileName() { + return fileName; + } +} \ No newline at end of file diff --git a/lancet-plugin/src/main/java/me/ele/lancet/plugin/LancetPlugin.java b/lancet-plugin/src/main/java/me/ele/lancet/plugin/LancetPlugin.java new file mode 100644 index 0000000..b70a145 --- /dev/null +++ b/lancet-plugin/src/main/java/me/ele/lancet/plugin/LancetPlugin.java @@ -0,0 +1,22 @@ +package me.ele.lancet.plugin; + + +import com.android.build.gradle.BaseExtension; +import org.gradle.api.Plugin; +import org.gradle.api.Project; +import org.gradle.api.ProjectConfigurationException; + +public class LancetPlugin implements Plugin { + + @Override + public void apply(Project project) { + if (project.getPlugins().findPlugin("com.android.application") == null + && project.getPlugins().findPlugin("com.android.library") == null) { + throw new ProjectConfigurationException("Need android application/library plugin to be applied first", null); + } + + BaseExtension baseExtension = (BaseExtension) project.getExtensions().getByName("android"); + LancetExtension lancetExtension = project.getExtensions().create("lancet", LancetExtension.class); + baseExtension.registerTransform(new LancetTransform(project, lancetExtension)); + } +} diff --git a/lancet-plugin/src/main/java/me/ele/lancet/plugin/LancetTransform.java b/lancet-plugin/src/main/java/me/ele/lancet/plugin/LancetTransform.java new file mode 100644 index 0000000..f6da027 --- /dev/null +++ b/lancet-plugin/src/main/java/me/ele/lancet/plugin/LancetTransform.java @@ -0,0 +1,165 @@ +package me.ele.lancet.plugin; + +import com.android.build.api.transform.QualifiedContent; +import com.android.build.api.transform.SecondaryFile; +import com.android.build.api.transform.Transform; +import com.android.build.api.transform.TransformException; +import com.android.build.api.transform.TransformInvocation; +import com.android.build.gradle.internal.pipeline.TransformManager; +import com.google.common.base.Joiner; +import com.google.common.base.Strings; +import com.google.common.io.Files; + +import org.gradle.api.Project; + +import java.io.File; +import java.io.IOException; +import java.net.MalformedURLException; +import java.net.URL; +import java.net.URLClassLoader; +import java.util.Collection; +import java.util.Collections; +import java.util.Set; +import java.util.stream.Collectors; +import java.util.stream.Stream; + +import me.ele.lancet.plugin.internal.GlobalContext; +import me.ele.lancet.plugin.internal.LocalCache; +import me.ele.lancet.plugin.internal.preprocess.PreClassAnalysis; +import me.ele.lancet.plugin.internal.TransformContext; +import me.ele.lancet.plugin.internal.TransformProcessor; +import me.ele.lancet.plugin.internal.context.ContextReader; +import me.ele.lancet.weaver.MetaParser; +import me.ele.lancet.weaver.Weaver; +import me.ele.lancet.weaver.internal.AsmWeaver; +import me.ele.lancet.weaver.internal.entity.TransformInfo; +import me.ele.lancet.weaver.internal.log.Impl.FileLoggerImpl; +import me.ele.lancet.weaver.internal.log.Log; +import me.ele.lancet.weaver.internal.parser.AsmMetaParser; + +class LancetTransform extends Transform { + + private final LancetExtension lancetExtension; + private final GlobalContext global; + private LocalCache cache; + + + public LancetTransform(Project project, LancetExtension lancetExtension) { + this.lancetExtension = lancetExtension; + this.global = new GlobalContext(project); + // load the LocalCache from disk + this.cache = new LocalCache(global.getLancetDir()); + } + + @Override + public String getName() { + return "lancet"; + } + + + @Override + public Set getInputTypes() { + return TransformManager.CONTENT_CLASS; + } + + + @Override + public Set getScopes() { + return TransformManager.SCOPE_FULL_PROJECT; + } + + @Override + public boolean isIncremental() { + return true; + } + + + /** + * @return Hook classes we found in last compilation. If they has been changed,gradle will auto go full compile. + */ + @Override + public Collection getSecondaryFiles() { + return cache.hookClassesInDir() + .stream() + .map(File::new) + .map(SecondaryFile::nonIncremental) + .collect(Collectors.toList()); + } + + @Override + public Collection getSecondaryDirectoryOutputs() { + return Collections.singletonList(global.getLancetDir()); + } + + @Override + public void transform(TransformInvocation transformInvocation) throws TransformException, InterruptedException, IOException { + initLog(); + + Log.i("start time: " + System.currentTimeMillis()); + + // collect the information this compile need + TransformContext context = new TransformContext(transformInvocation, global); + + Log.i("after android plugin, incremental: " + context.isIncremental()); + Log.i("now: " + System.currentTimeMillis()); + + boolean incremental = lancetExtension.getIncremental() && context.isIncremental(); + + PreClassAnalysis preClassAnalysis = new PreClassAnalysis(cache); + + incremental = preClassAnalysis.execute(incremental, context); + + Log.i("after pre analysis, incremental: " + incremental); + Log.i("now: " + System.currentTimeMillis()); + + MetaParser parser = createParser(context); + if (incremental && !context.getGraph().checkFlow()) { + incremental = false; + context.clear(); + } + Log.i("after check flow, incremental: " + incremental); + Log.i("now: " + System.currentTimeMillis()); + + context.getGraph().flow().clear(); + TransformInfo transformInfo = parser.parse(context.getHookClasses(), context.getGraph()); + + Weaver weaver = AsmWeaver.newInstance(transformInfo, context.getGraph()); + new ContextReader(context).accept(incremental, new TransformProcessor(context, weaver)); + Log.i("build successfully done"); + Log.i("now: " + System.currentTimeMillis()); + + cache.saveToLocal(); + Log.i("cache saved"); + Log.i("now: " + System.currentTimeMillis()); + } + + private AsmMetaParser createParser(TransformContext context) { + URL[] urls = Stream.concat(context.getAllJars().stream(), context.getAllDirs().stream()).map(QualifiedContent::getFile) + .map(File::toURI) + .map(u -> { + try { + return u.toURL(); + } catch (MalformedURLException e) { + throw new AssertionError(e); + } + }) + .toArray(URL[]::new); + Log.d("urls:\n" + Joiner.on("\n ").join(urls)); + ClassLoader cl = URLClassLoader.newInstance(urls, null); + return new AsmMetaParser(cl); + } + + private void initLog() throws IOException { + Log.setLevel(lancetExtension.getLogLevel()); + if (!Strings.isNullOrEmpty(lancetExtension.getFileName())) { + String name = lancetExtension.getFileName(); + if (name.contains(File.separator)) { + throw new IllegalArgumentException("Log file name can't contains file separator"); + } + File logFile = new File(global.getLancetDir(), "log_" + lancetExtension.getFileName()); + Files.createParentDirs(logFile); + Log.setImpl(FileLoggerImpl.of(logFile.getAbsolutePath())); + } + } +} + diff --git a/lancet-plugin/src/main/java/me/ele/lancet/plugin/Util.java b/lancet-plugin/src/main/java/me/ele/lancet/plugin/Util.java new file mode 100644 index 0000000..537b9e3 --- /dev/null +++ b/lancet-plugin/src/main/java/me/ele/lancet/plugin/Util.java @@ -0,0 +1,21 @@ +package me.ele.lancet.plugin; + +import com.android.utils.FileUtils; +import me.ele.lancet.weaver.internal.asm.ClassTransform; + +import java.io.File; + +/** + * Created by gengwanpeng on 17/5/4. + */ +public class Util { + + public static File toSystemDependentFile(File parent, String relativePath) { + return new File(parent, relativePath.replace('/', File.separatorChar)); + } + + public static File toSystemDependentHookFile(File relativeRoot, String relativePath) { + int index = relativePath.lastIndexOf('.'); + return toSystemDependentFile(relativeRoot, relativePath.substring(0, index) + ClassTransform.AID_INNER_CLASS_NAME + relativePath.substring(index)); + } +} diff --git a/lancet-plugin/src/main/java/me/ele/lancet/plugin/internal/GlobalContext.java b/lancet-plugin/src/main/java/me/ele/lancet/plugin/internal/GlobalContext.java new file mode 100644 index 0000000..e3fc881 --- /dev/null +++ b/lancet-plugin/src/main/java/me/ele/lancet/plugin/internal/GlobalContext.java @@ -0,0 +1,22 @@ +package me.ele.lancet.plugin.internal; + +import org.gradle.api.Project; + +import java.io.File; + +/** + * Created by gengwanpeng on 17/4/26. + */ +public class GlobalContext { + + private Project project; + + public GlobalContext(Project project) { + this.project = project; + } + + + public File getLancetDir() { + return new File(project.getBuildDir(), "lancet"); + } +} diff --git a/lancet-plugin/src/main/java/me/ele/lancet/plugin/internal/LocalCache.java b/lancet-plugin/src/main/java/me/ele/lancet/plugin/internal/LocalCache.java new file mode 100644 index 0000000..846f7cb --- /dev/null +++ b/lancet-plugin/src/main/java/me/ele/lancet/plugin/internal/LocalCache.java @@ -0,0 +1,111 @@ +package me.ele.lancet.plugin.internal; + +import com.android.build.api.transform.Status; +import com.google.common.io.Files; +import com.google.gson.Gson; +import com.google.gson.GsonBuilder; +import com.google.gson.JsonParseException; + +import org.apache.commons.io.Charsets; + +import java.io.File; +import java.io.IOException; +import java.io.Reader; +import java.io.Writer; +import java.util.List; +import java.util.stream.Stream; + +import me.ele.lancet.plugin.internal.preprocess.MetaGraphGeneratorImpl; +import me.ele.lancet.weaver.internal.graph.CheckFlow; +import me.ele.lancet.weaver.internal.graph.ClassEntity; + +/** + * Created by gengwanpeng on 17/4/26. + */ +public class LocalCache { + + // Persistent storage for metas + private File localCache; + private final Metas metas; + private Gson gson = new GsonBuilder().setPrettyPrinting().disableHtmlEscaping().create(); + + public LocalCache(File dir) { + localCache = new File(dir, "buildCache.json"); + metas = loadCache(); + } + + private Metas loadCache() { + if (localCache.exists() && localCache.isFile()) { + try { + Reader reader = Files.newReader(localCache, Charsets.UTF_8); + return gson.fromJson(reader, Metas.class).withoutNull(); + } catch (IOException e) { + throw new RuntimeException(e); + } catch (JsonParseException e) { + if (!localCache.delete()) { + throw new RuntimeException("cache file has been modified, but can't delete.", e); + } + } + } + return new Metas(); + } + + + public List hookClasses() { + return metas.hookClasses; + } + + public List hookClassesInDir() { + return metas.hookClassesInDir; + } + + public CheckFlow hookFlow() { + return metas.flow; + } + + + /** + * if hook class has modified. + * @param context TransformContext for this compile + * @return true if hook class hasn't modified. + */ + public boolean isHookClassModified(TransformContext context) { + List hookClasses = metas.jarsWithHookClasses; + return Stream.concat(context.getRemovedJars().stream(), context.getChangedJars().stream()) + .anyMatch(jarInput -> hookClasses.contains(jarInput.getFile().getAbsolutePath())); + } + + public void accept(MetaGraphGeneratorImpl graph) { + metas.classMetas.forEach(m -> graph.add(m, Status.NOTCHANGED)); + } + + public void saveToLocal() { + try { + Files.createParentDirs(localCache); + Writer writer = Files.newWriter(localCache, Charsets.UTF_8); + gson.toJson(metas.withoutNull(), Metas.class, writer); + writer.close(); + } catch (IOException e) { + throw new RuntimeException(e); + } + } + + public void clear() throws IOException { + if (localCache.exists() && localCache.isFile() && !localCache.delete()) { + throw new IOException("can't delete cache file"); + } + } + + public void savePartially(List classMetas) { + metas.classMetas = classMetas; + saveToLocal(); + } + + public void saveFully(List classMetas, List hookClasses, List hookClassesInDir, List jarWithHookClasses) { + metas.classMetas = classMetas; + metas.hookClasses = hookClasses; + metas.hookClassesInDir = hookClassesInDir; + metas.jarsWithHookClasses = jarWithHookClasses; + saveToLocal(); + } +} diff --git a/lancet-plugin/src/main/java/me/ele/lancet/plugin/internal/Metas.java b/lancet-plugin/src/main/java/me/ele/lancet/plugin/internal/Metas.java new file mode 100644 index 0000000..b54236b --- /dev/null +++ b/lancet-plugin/src/main/java/me/ele/lancet/plugin/internal/Metas.java @@ -0,0 +1,45 @@ +package me.ele.lancet.plugin.internal; + + +import java.util.Collections; +import java.util.List; + +import me.ele.lancet.weaver.internal.graph.CheckFlow; +import me.ele.lancet.weaver.internal.graph.ClassEntity; + +/** + * Created by gengwanpeng on 17/4/26. + */ +class Metas { + + public List hookClasses = Collections.emptyList(); + + public List hookClassesInDir = Collections.emptyList(); + + public List jarsWithHookClasses = Collections.emptyList(); + + public CheckFlow flow = new CheckFlow(); + + public List classMetas = Collections.emptyList(); + + + public Metas withoutNull() { + Metas shallowClone = new Metas(); + if (hookClasses != null) { + shallowClone.hookClasses = hookClasses; + } + if (hookClassesInDir != null) { + shallowClone.hookClassesInDir = hookClassesInDir; + } + if (jarsWithHookClasses != null) { + shallowClone.jarsWithHookClasses = jarsWithHookClasses; + } + if (classMetas != null) { + shallowClone.classMetas = classMetas; + } + if (flow != null) { + shallowClone.flow = flow; + } + return shallowClone; + } +} diff --git a/lancet-plugin/src/main/java/me/ele/lancet/plugin/internal/TransformContext.java b/lancet-plugin/src/main/java/me/ele/lancet/plugin/internal/TransformContext.java new file mode 100644 index 0000000..9480a85 --- /dev/null +++ b/lancet-plugin/src/main/java/me/ele/lancet/plugin/internal/TransformContext.java @@ -0,0 +1,139 @@ +package me.ele.lancet.plugin.internal; + +import com.android.build.api.transform.DirectoryInput; +import com.android.build.api.transform.Format; +import com.android.build.api.transform.JarInput; +import com.android.build.api.transform.QualifiedContent; +import com.android.build.api.transform.TransformInvocation; + +import java.io.File; +import java.io.IOException; +import java.util.ArrayList; +import java.util.Collection; +import java.util.Collections; +import java.util.List; + +import me.ele.lancet.weaver.internal.graph.Graph; +import me.ele.lancet.weaver.internal.log.Log; + +/** + * Created by gengwanpeng on 17/4/26. + * + * A data sets collect all jar info and pre-analysis result. + * + */ +public class TransformContext { + + private TransformInvocation invocation; + + private Collection allJars; + private Collection addedJars; + private Collection removedJars; + private Collection changedJars; + private Collection allDirs; + + private GlobalContext global; + private List hookClasses; + private Graph graph; + + public TransformContext(TransformInvocation invocation, GlobalContext global) { + this.global = global; + this.invocation = invocation; + init(); + } + + /** + * start collect. + */ + private void init() { + allJars = new ArrayList<>(invocation.getInputs().size()); + addedJars = new ArrayList<>(invocation.getInputs().size()); + changedJars = new ArrayList<>(invocation.getInputs().size()); + removedJars = new ArrayList<>(invocation.getInputs().size()); + allDirs = new ArrayList<>(invocation.getInputs().size()); + invocation.getInputs().forEach(it -> { + Log.d(it.toString()); + it.getJarInputs().forEach(j -> { + allJars.add(j); + if (invocation.isIncremental()) { + switch (j.getStatus()) { + case ADDED: + addedJars.add(j); + break; + case REMOVED: + removedJars.add(j); + break; + case CHANGED: + changedJars.add(j); + } + } + }); + allDirs.addAll(it.getDirectoryInputs()); + }); + } + + + public boolean isIncremental() { + return invocation.isIncremental(); + } + + public Collection getAllJars() { + return Collections.unmodifiableCollection(allJars); + } + + public Collection getAllDirs() { + return Collections.unmodifiableCollection(allDirs); + } + + public Collection getAddedJars() { + return Collections.unmodifiableCollection(addedJars); + } + + public Collection getChangedJars() { + return Collections.unmodifiableCollection(changedJars); + } + + public Collection getRemovedJars() { + return Collections.unmodifiableCollection(removedJars); + } + + public File getRelativeFile(QualifiedContent content) { + return invocation.getOutputProvider().getContentLocation(content.getName(), content.getContentTypes(), content.getScopes(), + (content instanceof JarInput ? Format.JAR : Format.DIRECTORY)); + } + + public void clear() throws IOException { + invocation.getOutputProvider().deleteAll(); + } + + public GlobalContext getGlobal() { + return global; + } + + public void setHookClasses(List hookClasses) { + this.hookClasses = hookClasses; + } + + public List getHookClasses() { + return hookClasses; + } + + public Graph getGraph() { + return graph; + } + + public void setGraph(Graph graph) { + this.graph = graph; + } + + @Override + public String toString() { + return "TransformContext{" + + "allJars=" + allJars + + ", addedJars=" + addedJars + + ", removedJars=" + removedJars + + ", changedJars=" + changedJars + + ", allDirs=" + allDirs + + '}'; + } +} diff --git a/lancet-plugin/src/main/java/me/ele/lancet/plugin/internal/TransformProcessor.java b/lancet-plugin/src/main/java/me/ele/lancet/plugin/internal/TransformProcessor.java new file mode 100644 index 0000000..dc263be --- /dev/null +++ b/lancet-plugin/src/main/java/me/ele/lancet/plugin/internal/TransformProcessor.java @@ -0,0 +1,129 @@ +package me.ele.lancet.plugin.internal; + +import com.android.build.api.transform.JarInput; +import com.android.build.api.transform.QualifiedContent; +import com.android.build.api.transform.Status; +import com.android.utils.FileUtils; +import com.google.common.io.Files; + +import java.io.BufferedOutputStream; +import java.io.Closeable; +import java.io.File; +import java.io.FileOutputStream; +import java.io.IOException; +import java.util.Map; +import java.util.concurrent.ConcurrentHashMap; +import java.util.jar.JarOutputStream; +import java.util.zip.ZipEntry; + +import me.ele.lancet.plugin.Util; +import me.ele.lancet.plugin.internal.context.ClassFetcher; +import me.ele.lancet.weaver.ClassData; +import me.ele.lancet.weaver.Weaver; +import me.ele.lancet.weaver.internal.log.Log; + +/** + * Created by gengwanpeng on 17/5/4. + */ +public class TransformProcessor implements ClassFetcher { + + private final TransformContext context; + private final Weaver weaver; + private final DirectoryRunner dirRunner = new DirectoryRunner(); + private Map map = new ConcurrentHashMap<>(); + + public TransformProcessor(TransformContext context, Weaver weaver) { + this.context = context; + this.weaver = weaver; + } + + @Override + public boolean onStart(QualifiedContent content) throws IOException { + if (content instanceof JarInput) { + JarInput jarInput = (JarInput) content; + File targetFile = context.getRelativeFile(content); + switch (jarInput.getStatus()) { + case REMOVED: + FileUtils.deleteIfExists(targetFile); + return false; + case CHANGED: + FileUtils.deleteIfExists(targetFile); + default: + Files.createParentDirs(targetFile); + map.put(content, new JarRunner(content, targetFile)); + } + } + return true; + } + + @Override + public void onClassFetch(QualifiedContent content, Status status, String relativePath, byte[] bytes) throws IOException { + if (content instanceof JarInput) { + JarRunner jarRunner = map.get(content); + jarRunner.run(relativePath, bytes); + } else { // directory, so must be class + File relativeRoot = context.getRelativeFile(content); + File target = Util.toSystemDependentFile(relativeRoot, relativePath); + File hookWithTarget = Util.toSystemDependentHookFile(relativeRoot, relativePath); + switch (status) { + case REMOVED: + FileUtils.deleteIfExists(target); + FileUtils.deleteIfExists(hookWithTarget); + break; + case CHANGED: + FileUtils.deleteIfExists(target); + FileUtils.deleteIfExists(hookWithTarget); + default: + dirRunner.run(relativeRoot, relativePath, bytes); + } + } + } + + @Override + public void onComplete(QualifiedContent content) throws IOException { + if (content instanceof JarInput && ((JarInput) content).getStatus() != Status.REMOVED) { + map.get(content).close(); + } + } + + class JarRunner implements Closeable { + + private final JarOutputStream jos; + private final QualifiedContent content; + + JarRunner(QualifiedContent content, File targetFile) throws IOException { + this.content = content; + this.jos = new JarOutputStream( + new BufferedOutputStream(new FileOutputStream(targetFile))); + } + + void run(String relativePath, byte[] bytes) throws IOException { + if (!relativePath.endsWith(".class")) { + ZipEntry entry = new ZipEntry(relativePath); + jos.putNextEntry(entry); + jos.write(bytes); + } else { + for (ClassData classData : weaver.weave(bytes, relativePath)) { + ZipEntry entry = new ZipEntry(classData.getClassName() + ".class"); + jos.putNextEntry(entry); + jos.write(classData.getClassBytes()); + } + } + } + + public void close() throws IOException { + jos.close(); + } + } + + class DirectoryRunner { + + void run(File relativeRoot, String relativePath, byte[] bytes) throws IOException { + for (ClassData data : weaver.weave(bytes, relativePath)) { + File target = Util.toSystemDependentFile(relativeRoot, data.getClassName() + ".class"); + Files.createParentDirs(target); + Files.write(data.getClassBytes(), target); + } + } + } +} diff --git a/lancet-plugin/src/main/java/me/ele/lancet/plugin/internal/context/ClassFetcher.java b/lancet-plugin/src/main/java/me/ele/lancet/plugin/internal/context/ClassFetcher.java new file mode 100644 index 0000000..52e729c --- /dev/null +++ b/lancet-plugin/src/main/java/me/ele/lancet/plugin/internal/context/ClassFetcher.java @@ -0,0 +1,37 @@ +package me.ele.lancet.plugin.internal.context; + +import com.android.build.api.transform.QualifiedContent; +import com.android.build.api.transform.Status; + +import java.io.IOException; + +/** + * The Fetcher to fetch each class in QualifiedContent + */ +public interface ClassFetcher { + + /** + * begin unzip a QualifiedContent. + * @param content the Jar or Dir QualifiedContent. + * @return whether the Fetcher can accept this QualifiedContent. + * @throws IOException + */ + boolean onStart(QualifiedContent content) throws IOException; + + /** + * fetch each class in QualifiedContent. each invoke will in one thread. + * @param content + * @param status + * @param relativePath + * @param bytes + * @throws IOException + */ + void onClassFetch(QualifiedContent content, Status status, String relativePath, byte[] bytes) throws IOException; + + /** + * has finished fetch class in this QualifiedContent + * @param content + * @throws IOException + */ + void onComplete(QualifiedContent content) throws IOException; +} \ No newline at end of file diff --git a/lancet-plugin/src/main/java/me/ele/lancet/plugin/internal/context/ClassifiedContentProvider.java b/lancet-plugin/src/main/java/me/ele/lancet/plugin/internal/context/ClassifiedContentProvider.java new file mode 100644 index 0000000..183c4c5 --- /dev/null +++ b/lancet-plugin/src/main/java/me/ele/lancet/plugin/internal/context/ClassifiedContentProvider.java @@ -0,0 +1,33 @@ +package me.ele.lancet.plugin.internal.context; + +import com.android.build.api.transform.QualifiedContent; + +import java.io.IOException; + +/** + * Created by gengwanpeng on 17/4/28. + * + * A QualifiedContentProvider proxy multiple ContentProviders. + * + */ +public class ClassifiedContentProvider implements QualifiedContentProvider { + + public static ClassifiedContentProvider newInstance(TargetedQualifiedContentProvider... providers) { + return new ClassifiedContentProvider(providers); + } + + private TargetedQualifiedContentProvider[] providers; + + private ClassifiedContentProvider(TargetedQualifiedContentProvider... providers) { + this.providers = providers; + } + + @Override + public void forEach(QualifiedContent content, ClassFetcher processor) throws IOException { + for (TargetedQualifiedContentProvider provider : providers) { + if(provider.accepted(content)){ + provider.forEach(content,processor); + } + } + } +} diff --git a/lancet-plugin/src/main/java/me/ele/lancet/plugin/internal/context/ContextReader.java b/lancet-plugin/src/main/java/me/ele/lancet/plugin/internal/context/ContextReader.java new file mode 100644 index 0000000..8d81574 --- /dev/null +++ b/lancet-plugin/src/main/java/me/ele/lancet/plugin/internal/context/ContextReader.java @@ -0,0 +1,135 @@ +package me.ele.lancet.plugin.internal.context; + +import com.android.build.api.transform.JarInput; +import com.android.build.api.transform.QualifiedContent; +import com.android.build.api.transform.Status; +import com.google.common.collect.ImmutableList; + +import java.io.IOException; +import java.util.ArrayList; +import java.util.Collection; +import java.util.List; +import java.util.concurrent.Callable; +import java.util.concurrent.ExecutionException; +import java.util.concurrent.ExecutorService; +import java.util.concurrent.Executors; +import java.util.concurrent.Future; +import java.util.concurrent.LinkedBlockingQueue; +import java.util.concurrent.ThreadPoolExecutor; +import java.util.concurrent.TimeUnit; +import java.util.concurrent.atomic.AtomicBoolean; +import java.util.stream.Collectors; +import java.util.stream.Stream; + +import me.ele.lancet.plugin.internal.TransformContext; +import me.ele.lancet.plugin.internal.preprocess.ParseFailureException; +import me.ele.lancet.weaver.internal.log.Log; + +/** + * Created by gengwanpeng on 17/5/2. + * + * This class will unzip all jars,and accept all class with input ClassFetcher in thread pool. + * Used in pre-analysis and formal analysis. + * + */ +public class ContextReader { + + private AtomicBoolean lock = new AtomicBoolean(false); + private TransformContext context; + private ClassifiedContentProvider provider; + private ExecutorService service = new ThreadPoolExecutor(Runtime.getRuntime().availableProcessors(), Runtime.getRuntime().availableProcessors(), + 0L, TimeUnit.MILLISECONDS, + new LinkedBlockingQueue<>(), (r, executor) -> { + Log.i("partial parse failed, executor has been shutdown"); + }); + + public ContextReader(TransformContext context) { + this.context = context; + } + + /** + * read the classes in thread pool and send class to fetcher. + * @param incremental is incremental compile + * @param fetcher the fetcher to visit classes + * @throws IOException + * @throws InterruptedException + */ + public void accept(boolean incremental, ClassFetcher fetcher) throws IOException, InterruptedException { + + provider = ClassifiedContentProvider.newInstance(new JarContentProvider(), new DirectoryContentProvider(incremental)); + // get all jars + Collection jars = !incremental ? context.getAllJars() : + ImmutableList.builder() + .addAll(context.getAddedJars()) + .addAll(context.getRemovedJars()) + .addAll(changedToDeleteAndAdd()) + .build(); + // accept the jar in thread pool + List> tasks = Stream.concat(jars.stream(), context.getAllDirs().stream()) + .map(q -> new QualifiedContentTask(q, fetcher)) + .map(t -> service.submit(t)) + .collect(Collectors.toList()); + + // block until all task has finish. + for (Future future : tasks) { + try { + future.get(); + } catch (ExecutionException e) { + if (incremental && e.getCause() instanceof ParseFailureException) { + shutDownAndRestart(); + continue; + } + Throwable cause = e.getCause(); + if (cause instanceof IOException) { + throw (IOException) cause; + } else if (cause instanceof InterruptedException) { + throw (InterruptedException) cause; + } else { + throw new RuntimeException(e.getCause()); + } + } + } + + } + + /** + * Transform the change operation to delete & add. + * @return + */ + private Collection changedToDeleteAndAdd(){ + List jarInputs = new ArrayList<>(); + context.getChangedJars().stream() + .peek(c -> jarInputs.add(new StatusOverrideJarInput(context,c, Status.REMOVED))) + .peek(c -> jarInputs.add(new StatusOverrideJarInput(context,c, Status.ADDED))); + return jarInputs; + } + + + + private void shutDownAndRestart() { + if (lock.compareAndSet(false, true)) { + service.shutdown(); + service = Executors.newFixedThreadPool(Runtime.getRuntime().availableProcessors()); + } + } + + /** + * Task to accept target QualifiedContent + */ + private class QualifiedContentTask implements Callable { + + private QualifiedContent content; + private ClassFetcher fetcher; + + QualifiedContentTask(QualifiedContent content, ClassFetcher fetcher) { + this.content = content; + this.fetcher = fetcher; + } + + @Override + public Void call() throws Exception { + provider.forEach(content, fetcher); + return null; + } + } +} diff --git a/lancet-plugin/src/main/java/me/ele/lancet/plugin/internal/context/DirectoryContentProvider.java b/lancet-plugin/src/main/java/me/ele/lancet/plugin/internal/context/DirectoryContentProvider.java new file mode 100644 index 0000000..c5a21b4 --- /dev/null +++ b/lancet-plugin/src/main/java/me/ele/lancet/plugin/internal/context/DirectoryContentProvider.java @@ -0,0 +1,64 @@ +package me.ele.lancet.plugin.internal.context; + +import com.android.build.api.transform.DirectoryInput; +import com.android.build.api.transform.QualifiedContent; +import com.android.build.api.transform.Status; +import com.google.common.io.Files; + +import java.io.File; +import java.io.IOException; +import java.net.URI; +import java.util.Map; + +import me.ele.lancet.weaver.internal.log.Log; + +/** + * Created by gengwanpeng on 17/4/28. + */ +public class DirectoryContentProvider extends TargetedQualifiedContentProvider { + + private final boolean incremental; + + public DirectoryContentProvider(boolean incremental) { + this.incremental = incremental; + } + + @Override + public void forEach(QualifiedContent content, ClassFetcher processor) throws IOException { + if (processor.onStart(content)) { + File root = content.getFile(); + URI base = root.toURI(); + if (!incremental) { + /** + * if this compile is full compilation. we traverse all classes as newly added classes + */ + for (File f : Files.fileTreeTraverser().preOrderTraversal(root)) { + if (f.isFile() && f.getName().endsWith(".class")) { + byte[] data = Files.toByteArray(f); + String relativePath = base.relativize(f.toURI()).toString(); + processor.onClassFetch(content, Status.ADDED, relativePath, data); + } + } + } else { + /** + * if this compile is incremental compilation. we traverse all changed classes. + */ + for (Map.Entry entry : ((DirectoryInput) content).getChangedFiles().entrySet()) { + Log.d(entry.getKey() + " " + entry.getValue()); + File f = entry.getKey(); + if (f.isFile() && f.getName().endsWith(".class")) { + byte[] data = Files.toByteArray(f); + String relativePath = base.relativize(f.toURI()).toString(); + processor.onClassFetch(content, entry.getValue(), relativePath, data); + } + } + } + } + processor.onComplete(content); + } + + @Override + public boolean accepted(QualifiedContent qualifiedContent) { + return qualifiedContent instanceof DirectoryInput; + } +} diff --git a/lancet-plugin/src/main/java/me/ele/lancet/plugin/internal/context/JarContentProvider.java b/lancet-plugin/src/main/java/me/ele/lancet/plugin/internal/context/JarContentProvider.java new file mode 100644 index 0000000..ce82179 --- /dev/null +++ b/lancet-plugin/src/main/java/me/ele/lancet/plugin/internal/context/JarContentProvider.java @@ -0,0 +1,45 @@ +package me.ele.lancet.plugin.internal.context; + +import com.android.build.api.transform.JarInput; +import com.android.build.api.transform.QualifiedContent; +import com.google.common.io.ByteStreams; + +import org.apache.commons.io.IOUtils; + +import java.io.BufferedInputStream; +import java.io.FileInputStream; +import java.io.IOException; +import java.util.zip.ZipEntry; +import java.util.zip.ZipInputStream; + +/** + * Created by gengwanpeng on 17/4/28. + */ +public class JarContentProvider extends TargetedQualifiedContentProvider { + + @Override + public void forEach(QualifiedContent content, ClassFetcher processor) throws IOException { + forActualInput((JarInput) content, processor); + } + + private void forActualInput(JarInput jarInput, ClassFetcher processor) throws IOException { + if (processor.onStart(jarInput)) { + ZipInputStream zis = new ZipInputStream(new BufferedInputStream(new FileInputStream(jarInput.getFile()))); + ZipEntry entry; + while ((entry = zis.getNextEntry()) != null) { + if (entry.isDirectory()) { + continue; + } + byte[] data = ByteStreams.toByteArray(zis); + processor.onClassFetch(jarInput, jarInput.getStatus(), entry.getName(), data); + } + IOUtils.closeQuietly(zis); + } + processor.onComplete(jarInput); + } + + @Override + public boolean accepted(QualifiedContent qualifiedContent) { + return qualifiedContent instanceof JarInput; + } +} diff --git a/lancet-plugin/src/main/java/me/ele/lancet/plugin/internal/context/QualifiedContentProvider.java b/lancet-plugin/src/main/java/me/ele/lancet/plugin/internal/context/QualifiedContentProvider.java new file mode 100644 index 0000000..39d3795 --- /dev/null +++ b/lancet-plugin/src/main/java/me/ele/lancet/plugin/internal/context/QualifiedContentProvider.java @@ -0,0 +1,27 @@ +package me.ele.lancet.plugin.internal.context; + +import com.android.build.api.transform.QualifiedContent; + +import java.io.IOException; + +/** + * Created by gengwanpeng on 17/4/28. + * + * Unzip QualifiedContent and provide single class for inout ClassFetcher. + * QualifiedContent may be one of {@link com.android.build.api.transform.JarInput} and {@link com.android.build.api.transform.DirectoryInput}. + * So there are tow child of QualifiedContentProvider {@link JarContentProvider} and {@link DirectoryContentProvider} + * + */ +public interface QualifiedContentProvider { + + /** + * start accept the classes + * @param content + * @param processor + * @throws IOException + */ + void forEach(QualifiedContent content, ClassFetcher processor) throws IOException; + + + +} diff --git a/lancet-plugin/src/main/java/me/ele/lancet/plugin/internal/context/StatusOverrideJarInput.java b/lancet-plugin/src/main/java/me/ele/lancet/plugin/internal/context/StatusOverrideJarInput.java new file mode 100644 index 0000000..845687e --- /dev/null +++ b/lancet-plugin/src/main/java/me/ele/lancet/plugin/internal/context/StatusOverrideJarInput.java @@ -0,0 +1,53 @@ +package me.ele.lancet.plugin.internal.context; + +import com.android.build.api.transform.JarInput; +import com.android.build.api.transform.Status; +import com.google.common.base.Charsets; +import com.google.common.hash.Hashing; + +import java.io.File; +import java.util.Set; + +import me.ele.lancet.plugin.internal.TransformContext; + +/** + * Created by Jude on 2017/7/14. + */ + +public class StatusOverrideJarInput implements JarInput { + private JarInput jarInput; + private File jar ; + private Status status; + + + public StatusOverrideJarInput(TransformContext context, JarInput jarInput,Status status) { + this.jarInput = jarInput; + this.jar = context.getRelativeFile(jarInput); + this.status = status; + } + + @Override + public Status getStatus() { + return status; + } + + @Override + public String getName() { + return Hashing.sha1().hashString(jar.getPath()+status, Charsets.UTF_16LE).toString(); + } + + @Override + public File getFile() { + return jar; + } + + @Override + public Set getContentTypes() { + return jarInput.getContentTypes(); + } + + @Override + public Set getScopes() { + return jarInput.getScopes(); + } +} \ No newline at end of file diff --git a/lancet-plugin/src/main/java/me/ele/lancet/plugin/internal/context/TargetedQualifiedContentProvider.java b/lancet-plugin/src/main/java/me/ele/lancet/plugin/internal/context/TargetedQualifiedContentProvider.java new file mode 100644 index 0000000..e5228b3 --- /dev/null +++ b/lancet-plugin/src/main/java/me/ele/lancet/plugin/internal/context/TargetedQualifiedContentProvider.java @@ -0,0 +1,18 @@ +package me.ele.lancet.plugin.internal.context; + +import com.android.build.api.transform.QualifiedContent; + +/** + * Created by gengwanpeng on 17/4/28. + * {@inheritDoc} + */ +public abstract class TargetedQualifiedContentProvider implements QualifiedContentProvider { + + /** + * Judge the QualifiedContent type + * @param qualifiedContent {@link com.android.build.api.transform.JarInput} or {@link com.android.build.api.transform.DirectoryInput} + * @return can this provider accept this QualifiedContent. + */ + public abstract boolean accepted(QualifiedContent qualifiedContent); + +} diff --git a/lancet-plugin/src/main/java/me/ele/lancet/plugin/internal/preprocess/AsmClassProcessorImpl.java b/lancet-plugin/src/main/java/me/ele/lancet/plugin/internal/preprocess/AsmClassProcessorImpl.java new file mode 100644 index 0000000..2d58383 --- /dev/null +++ b/lancet-plugin/src/main/java/me/ele/lancet/plugin/internal/preprocess/AsmClassProcessorImpl.java @@ -0,0 +1,20 @@ +package me.ele.lancet.plugin.internal.preprocess; + +import org.objectweb.asm.ClassReader; +import org.objectweb.asm.Opcodes; + +import java.io.IOException; + +/** + * Created by gengwanpeng on 17/4/27. + */ +public class AsmClassProcessorImpl implements PreClassProcessor { + + @Override + public PreClassProcessor.ProcessResult process(byte[] classBytes) { + ClassReader cr = new ClassReader(classBytes); + PreProcessClassVisitor cv = new PreProcessClassVisitor(Opcodes.ASM5); + cr.accept(cv, ClassReader.SKIP_CODE | ClassReader.SKIP_DEBUG | ClassReader.SKIP_FRAMES); + return cv.getProcessResult(); + } +} diff --git a/lancet-plugin/src/main/java/me/ele/lancet/plugin/internal/preprocess/MetaGraphGeneratorImpl.java b/lancet-plugin/src/main/java/me/ele/lancet/plugin/internal/preprocess/MetaGraphGeneratorImpl.java new file mode 100644 index 0000000..f93f4c7 --- /dev/null +++ b/lancet-plugin/src/main/java/me/ele/lancet/plugin/internal/preprocess/MetaGraphGeneratorImpl.java @@ -0,0 +1,78 @@ +package me.ele.lancet.plugin.internal.preprocess; + +import com.android.build.api.transform.Status; + +import org.objectweb.asm.Opcodes; + +import java.util.Collections; +import java.util.List; +import java.util.Map; +import java.util.concurrent.ConcurrentHashMap; +import java.util.stream.Collectors; + +import me.ele.lancet.weaver.internal.graph.CheckFlow; +import me.ele.lancet.weaver.internal.graph.ClassEntity; +import me.ele.lancet.weaver.internal.graph.ClassNode; +import me.ele.lancet.weaver.internal.graph.Graph; +import me.ele.lancet.weaver.internal.graph.InterfaceNode; +import me.ele.lancet.weaver.internal.graph.MetaGraphGenerator; +import me.ele.lancet.weaver.internal.graph.Node; + +/** + * Created by gengwanpeng on 17/4/26. + */ +public class MetaGraphGeneratorImpl implements MetaGraphGenerator { + + private final CheckFlow checkFlow; + // Key is class name. value is class node. + private Map nodeMap = new ConcurrentHashMap<>(512); + private Graph graph; + + public MetaGraphGeneratorImpl(CheckFlow checkFlow) { + this.checkFlow = checkFlow; + } + + // thread safe + public void add(ClassEntity entity, Status status) { + Node current = getOrPutEmpty((entity.access & Opcodes.ACC_INTERFACE) != 0, entity.name); + + ClassNode superNode = null; + List interfaceNodes = Collections.emptyList(); + if (entity.superName != null) { + superNode = (ClassNode) getOrPutEmpty(false, entity.superName); + } + if (entity.interfaces.size() > 0) { + interfaceNodes = entity.interfaces.stream().map(i -> (InterfaceNode) getOrPutEmpty(true, i)).collect(Collectors.toList()); + } + + current.entity = entity; + current.parent = superNode; + current.status = status; + current.interfaces = interfaceNodes; + } + + public void remove(String className) { + nodeMap.remove(className); + } + + // find node by name, if node is not exist then create and add it. + private Node getOrPutEmpty(boolean isInterface, String className) { + return nodeMap.computeIfAbsent(className, n -> isInterface ? + new InterfaceNode(n) : + new ClassNode(n)); + } + + + List toLocalNodes() { + return nodeMap.values().stream().filter(it -> it.parent != null).map(it -> it.entity).collect(Collectors.toList()); + } + + @Override + public Graph generate() { + if (graph == null) { + graph = new Graph(nodeMap, checkFlow); + graph.prepare(); + } + return graph; + } +} diff --git a/lancet-plugin/src/main/java/me/ele/lancet/plugin/internal/preprocess/ParseFailureException.java b/lancet-plugin/src/main/java/me/ele/lancet/plugin/internal/preprocess/ParseFailureException.java new file mode 100644 index 0000000..c7aecd1 --- /dev/null +++ b/lancet-plugin/src/main/java/me/ele/lancet/plugin/internal/preprocess/ParseFailureException.java @@ -0,0 +1,21 @@ +package me.ele.lancet.plugin.internal.preprocess; + +/** + * Created by gengwanpeng on 17/5/4. + */ +public class ParseFailureException extends RuntimeException { + public ParseFailureException() { + } + + public ParseFailureException(String message) { + super(message); + } + + public ParseFailureException(String message, Throwable cause) { + super(message, cause); + } + + public ParseFailureException(Throwable cause) { + super(cause); + } +} diff --git a/lancet-plugin/src/main/java/me/ele/lancet/plugin/internal/preprocess/PreClassAnalysis.java b/lancet-plugin/src/main/java/me/ele/lancet/plugin/internal/preprocess/PreClassAnalysis.java new file mode 100644 index 0000000..dba6436 --- /dev/null +++ b/lancet-plugin/src/main/java/me/ele/lancet/plugin/internal/preprocess/PreClassAnalysis.java @@ -0,0 +1,160 @@ +package me.ele.lancet.plugin.internal.preprocess; + +import com.android.build.api.transform.JarInput; +import com.android.build.api.transform.QualifiedContent; +import com.android.build.api.transform.Status; + +import java.io.IOException; +import java.util.ArrayList; +import java.util.HashSet; +import java.util.List; +import java.util.Set; + +import me.ele.lancet.plugin.Util; +import me.ele.lancet.plugin.internal.LocalCache; +import me.ele.lancet.plugin.internal.TransformContext; +import me.ele.lancet.plugin.internal.context.ClassFetcher; +import me.ele.lancet.plugin.internal.context.ContextReader; +import me.ele.lancet.weaver.internal.log.Log; + +/** + * Created by gengwanpeng on 17/4/26. + * + * When you see this class you may be as happy as me like this: + * + * + * PreClassAnalysis mainly records the dependency graph of all classes, + * and record the hook classes to judge if incremental compile available in next time. + * + */ +public class PreClassAnalysis { + + private LocalCache cache; + private MetaGraphGeneratorImpl graph; + private PreClassProcessor classProcessor = new AsmClassProcessorImpl(); + + + private ContextReader contextReader; + + + private volatile boolean partial = true; + + public PreClassAnalysis(LocalCache cache) { + this.cache = cache; + this.graph = new MetaGraphGeneratorImpl(cache.hookFlow()); + } + + /** + * start pre-analysis, the only API for pre-analysis. + * this method will block until pre-analysis finish. + * + * @param incremental + * @param context + * @return is incremental compile mode + * @throws IOException + * @throws InterruptedException + */ + public boolean execute(boolean incremental, TransformContext context) throws IOException, InterruptedException { + Log.d(context.toString()); + long duration = System.currentTimeMillis(); + + contextReader = new ContextReader(context); + + if (incremental && context.isIncremental() && !cache.isHookClassModified(context)){ + // can use incremental + partial = true; + + saveData(partialParse(context), context); + } else { + // must full compile + partial = false; + + // clear LocalCache and TransformContext + cache.clear(); + context.clear(); + + saveData(fullyParse(context), context); + + duration = System.currentTimeMillis() - duration; + Log.tag("Timer").i("pre parse cost: " + duration); + } + return partial; + } + + private PreAnalysisClassFetcher partialParse(TransformContext context) throws IOException, InterruptedException { + PreAnalysisClassFetcher preAnalysisClassFetcher = new PreAnalysisClassFetcher(); + // load cached full data into graph. + cache.accept(graph); + contextReader.accept(true, preAnalysisClassFetcher); + return preAnalysisClassFetcher; + } + + private PreAnalysisClassFetcher fullyParse(TransformContext context) throws IOException, InterruptedException { + PreAnalysisClassFetcher preAnalysisClassFetcher = new PreAnalysisClassFetcher(); + contextReader.accept(false, preAnalysisClassFetcher); + return preAnalysisClassFetcher; + } + + private void saveData(PreAnalysisClassFetcher preAnalysisClassFetcher, TransformContext context) { + if (partial) { + cache.savePartially(graph.toLocalNodes()); + } else { + cache.saveFully(graph.toLocalNodes(), preAnalysisClassFetcher.hookClasses, preAnalysisClassFetcher.hookClassesInDir, new ArrayList<>(preAnalysisClassFetcher.jarPathOfHookClasses)); + } + + context.setGraph(graph.generate()); + context.setHookClasses(cache.hookClasses()); + } + + + /** + * ClassFetcher to fetch all changed classed in this compilation. + */ + private class PreAnalysisClassFetcher implements ClassFetcher { + + List hookClasses = new ArrayList<>(4); + List hookClassesInDir = new ArrayList<>(4); + Set jarPathOfHookClasses = new HashSet<>(); + + @Override + public boolean onStart(QualifiedContent content) { + return true; + } + + @Override + public void onClassFetch(QualifiedContent content, Status status, String relativePath, byte[] bytes) { + if (relativePath.endsWith(".class")) { + PreClassProcessor.ProcessResult result = classProcessor.process(bytes); + + // if this time is incremental, the hook class won't be fetched. + if (partial && result.isHookClass) { + partial = false; + throw new ParseFailureException(result.toString()); + } + + // store hook classes for next compile + if (result.isHookClass) { + synchronized (this) { + hookClasses.add(result.entity.name); + if (content instanceof JarInput) { + jarPathOfHookClasses.add(content.getFile().getAbsolutePath()); + } else { + hookClassesInDir.add(Util.toSystemDependentFile(content.getFile(), relativePath).getAbsolutePath()); + } + } + } + + // update the graph + if (status != Status.REMOVED) { + graph.add(result.entity, status); + } else { + graph.remove(result.entity.name); + } + } + } + + @Override + public void onComplete(QualifiedContent content) { + } + } +} diff --git a/lancet-plugin/src/main/java/me/ele/lancet/plugin/internal/preprocess/PreClassProcessor.java b/lancet-plugin/src/main/java/me/ele/lancet/plugin/internal/preprocess/PreClassProcessor.java new file mode 100644 index 0000000..0b8d794 --- /dev/null +++ b/lancet-plugin/src/main/java/me/ele/lancet/plugin/internal/preprocess/PreClassProcessor.java @@ -0,0 +1,32 @@ +package me.ele.lancet.plugin.internal.preprocess; + + +import me.ele.lancet.weaver.internal.graph.ClassEntity; + +/** + * Created by gengwanpeng on 17/4/27. + */ +public interface PreClassProcessor { + + ProcessResult process(byte[] classBytes); + + class ProcessResult { + + + public ProcessResult(boolean isHookClass, ClassEntity entity) { + this.isHookClass = isHookClass; + this.entity = entity; + } + + public boolean isHookClass; + public ClassEntity entity; + + @Override + public String toString() { + return "ProcessResult{" + + "isHookClass=" + isHookClass + + ", entity=" + entity + + '}'; + } + } +} diff --git a/lancet-plugin/src/main/java/me/ele/lancet/plugin/internal/preprocess/PreProcessClassVisitor.java b/lancet-plugin/src/main/java/me/ele/lancet/plugin/internal/preprocess/PreProcessClassVisitor.java new file mode 100644 index 0000000..6c6f65b --- /dev/null +++ b/lancet-plugin/src/main/java/me/ele/lancet/plugin/internal/preprocess/PreProcessClassVisitor.java @@ -0,0 +1,65 @@ +package me.ele.lancet.plugin.internal.preprocess; + +import com.dieyidezui.lancet.rt.annotations.Insert; +import com.dieyidezui.lancet.rt.annotations.Proxy; +import com.dieyidezui.lancet.rt.annotations.TryCatchHandler; +import me.ele.lancet.weaver.internal.graph.ClassEntity; +import me.ele.lancet.weaver.internal.graph.FieldEntity; +import me.ele.lancet.weaver.internal.graph.MethodEntity; +import org.objectweb.asm.*; + +import java.util.Arrays; +import java.util.Collections; + +/** + * Created by gengwanpeng on 17/4/27. + */ +public class PreProcessClassVisitor extends ClassVisitor { + + private static final String PROXY = Type.getDescriptor(Proxy.class); + private static final String INSERT = Type.getDescriptor(Insert.class); + private static final String TRY_CATCH = Type.getDescriptor(TryCatchHandler.class); + + private boolean isHookClass; + private ClassEntity entity; + + PreProcessClassVisitor(int api) { + super(api, null); + } + + public PreClassProcessor.ProcessResult getProcessResult() { + return new PreClassProcessor.ProcessResult(isHookClass, entity); + } + + @Override + public void visit(int version, int access, String name, String signature, String superName, String[] interfaces) { + entity = new ClassEntity(access, name, superName, interfaces == null ? Collections.emptyList() : Arrays.asList(interfaces)); + } + + @Override + public FieldVisitor visitField(int access, String name, String desc, String signature, Object value) { + entity.fields.add(new FieldEntity(access, name, desc)); + return null; + } + + @Override + public MethodVisitor visitMethod(int access, String name, String desc, String signature, String[] exceptions) { + entity.methods.add(new MethodEntity(access, name, desc)); + if (!isHookClass) { + return new MethodVisitor(Opcodes.ASM5) { + @Override + public AnnotationVisitor visitAnnotation(String annoDesc, boolean visible) { + judge(annoDesc); + return null; + } + }; + } + return null; + } + + private void judge(String desc) { + if (!isHookClass && (INSERT.equals(desc) || PROXY.equals(desc) || TRY_CATCH.equals(desc))) { + isHookClass = true; + } + } +} diff --git a/lancet-plugin/src/main/resources/META-INF/gradle-plugins/me.ele.lancet.properties b/lancet-plugin/src/main/resources/META-INF/gradle-plugins/me.ele.lancet.properties new file mode 100644 index 0000000..a1e14d4 --- /dev/null +++ b/lancet-plugin/src/main/resources/META-INF/gradle-plugins/me.ele.lancet.properties @@ -0,0 +1 @@ +implementation-class=me.ele.lancet.plugin.LancetPlugin \ No newline at end of file diff --git a/lancet-weaver/.gitignore b/lancet-weaver/.gitignore new file mode 100644 index 0000000..796b96d --- /dev/null +++ b/lancet-weaver/.gitignore @@ -0,0 +1 @@ +/build diff --git a/lancet-weaver/build.gradle b/lancet-weaver/build.gradle new file mode 100644 index 0000000..3697028 --- /dev/null +++ b/lancet-weaver/build.gradle @@ -0,0 +1,23 @@ +apply plugin: 'java' + +dependencies { + testCompile "junit:junit:4.12" + testCompile 'com.squareup.okio:okio:1.11.0' + testCompile 'org.assertj:assertj-core:3.6.2' + + compileClasspath "com.android.tools.build:gradle:$android_tools_version" + compile "me.ele:lancet-base:1.0.4" + compile gradleApi() + compileClasspath "com.google.guava:guava:$guava_version" + compile "org.ow2.asm:asm:$asm_version" + compile 'org.ow2.asm:asm-tree:7.0' + compile 'org.ow2.asm:asm-util:7.0' + compile 'org.ow2.asm:asm-commons:7.0' + compile 'org.ow2.asm:asm-analysis:7.0' + compile 'org.ow2.asm:asm-test:7.0' +} + +sourceCompatibility = "1.8" +targetCompatibility = "1.8" + + diff --git a/lancet-weaver/src/main/java/me/ele/lancet/weaver/ClassData.java b/lancet-weaver/src/main/java/me/ele/lancet/weaver/ClassData.java new file mode 100644 index 0000000..79ed2e0 --- /dev/null +++ b/lancet-weaver/src/main/java/me/ele/lancet/weaver/ClassData.java @@ -0,0 +1,31 @@ +package me.ele.lancet.weaver; + +/** + * Created by Jude on 2017/4/25. + */ + +public class ClassData { + byte[] classBytes; + String className; + + public ClassData(byte[] classBytes, String className) { + this.classBytes = classBytes; + this.className = className; + } + + public byte[] getClassBytes() { + return classBytes; + } + + public void setClassBytes(byte[] classBytes) { + this.classBytes = classBytes; + } + + public String getClassName() { + return className; + } + + public void setClassName(String className) { + this.className = className; + } +} diff --git a/lancet-weaver/src/main/java/me/ele/lancet/weaver/MetaParser.java b/lancet-weaver/src/main/java/me/ele/lancet/weaver/MetaParser.java new file mode 100644 index 0000000..f5f39c1 --- /dev/null +++ b/lancet-weaver/src/main/java/me/ele/lancet/weaver/MetaParser.java @@ -0,0 +1,16 @@ +package me.ele.lancet.weaver; + +import java.util.List; + +import me.ele.lancet.weaver.internal.entity.TransformInfo; +import me.ele.lancet.weaver.internal.graph.Graph; + + +/** + * + * Created by gengwanpeng on 17/3/21. + */ +public interface MetaParser { + + TransformInfo parse(List classes, Graph graph); +} diff --git a/lancet-weaver/src/main/java/me/ele/lancet/weaver/Weaver.java b/lancet-weaver/src/main/java/me/ele/lancet/weaver/Weaver.java new file mode 100644 index 0000000..dacb93a --- /dev/null +++ b/lancet-weaver/src/main/java/me/ele/lancet/weaver/Weaver.java @@ -0,0 +1,18 @@ +package me.ele.lancet.weaver; + +/** + * Created by gengwanpeng on 17/3/21. + */ +public interface Weaver{ + + /** + * Transform input class with specified rules. + * Input one class may return two classes, because weaver may create multiple inner classes. + * this method will be invoke in multi-threaded and multi-process + * + * @param input the bytecode of the class want to transform. + * @param relativePath the file path of the class, end with .class, the new classes will output into the same path. + * @return the bytecode of transformed classes. + */ + ClassData[] weave(byte[] input, String relativePath); +} diff --git a/lancet-weaver/src/main/java/me/ele/lancet/weaver/internal/AsmWeaver.java b/lancet-weaver/src/main/java/me/ele/lancet/weaver/internal/AsmWeaver.java new file mode 100644 index 0000000..69409f6 --- /dev/null +++ b/lancet-weaver/src/main/java/me/ele/lancet/weaver/internal/AsmWeaver.java @@ -0,0 +1,53 @@ +package me.ele.lancet.weaver.internal; + +import me.ele.lancet.weaver.ClassData; +import me.ele.lancet.weaver.Weaver; +import me.ele.lancet.weaver.internal.asm.ClassTransform; +import me.ele.lancet.weaver.internal.entity.TransformInfo; +import me.ele.lancet.weaver.internal.graph.Graph; +import me.ele.lancet.weaver.internal.log.Log; + + +/** + * Created by gengwanpeng on 17/3/21. + */ +public class AsmWeaver implements Weaver { + + /** + * Create a AsmWeaver instance. In a compilation process, the AsmWeaver instance will only be created once. + * + * @param transformInfo the transformInfo for this compilation process. + * @param graph + * @return + */ + public static Weaver newInstance(TransformInfo transformInfo, Graph graph) { + return new AsmWeaver(transformInfo, graph); + } + + private final TransformInfo transformInfo; + private final Graph graph; + + private AsmWeaver(TransformInfo transformInfo, Graph graph) { + Log.d(transformInfo.toString()); + this.graph = graph; + this.transformInfo = transformInfo; + } + + /** + * {@inheritDoc} + */ + @Override + public ClassData[] weave(byte[] input, String relativePath) { + if(!relativePath.endsWith(".class")){ + throw new IllegalArgumentException("relativePath is not a class: " + relativePath); + } + String internalName = relativePath.substring(0, relativePath.lastIndexOf('.')); + try { + return ClassTransform.weave(transformInfo, graph, input, internalName); + }catch (RuntimeException e){ + Log.e("error in transform: " + relativePath, e); + return new ClassData[]{new ClassData(input, internalName)}; + } + } + +} diff --git a/lancet-weaver/src/main/java/me/ele/lancet/weaver/internal/asm/ClassCollector.java b/lancet-weaver/src/main/java/me/ele/lancet/weaver/internal/asm/ClassCollector.java new file mode 100644 index 0000000..ac03d22 --- /dev/null +++ b/lancet-weaver/src/main/java/me/ele/lancet/weaver/internal/asm/ClassCollector.java @@ -0,0 +1,83 @@ +package me.ele.lancet.weaver.internal.asm; + + +import me.ele.lancet.weaver.internal.graph.Graph; +import org.objectweb.asm.*; +import org.objectweb.asm.util.CheckClassAdapter; + +import java.util.HashMap; +import java.util.Map; + +import me.ele.lancet.weaver.ClassData; + +/** + * Created by Jude on 2017/4/25. + */ + +public class ClassCollector { + + // canonical name + String originClassName; + ClassWriter originClassWriter; + + ClassReader mClassReader; + Graph graph; + + // simple name of innerClass + Map mClassWriters = new HashMap<>(); + + public ClassCollector(ClassReader mClassReader, Graph graph) { + this.mClassReader = mClassReader; + this.graph = graph; + } + + void setOriginClassName(String originClassName) { + this.originClassName = originClassName; + } + + public ClassVisitor getOriginClassVisitor() { + if(originClassWriter ==null){ + originClassWriter = new ClassWriter(mClassReader, 0); + } + return originClassWriter; + } + + public ClassVisitor getInnerClassVisitor(String classSimpleName) { + ClassWriter writer = mClassWriters.get(classSimpleName); + if (writer == null) { + writer = new ClassWriter(ClassWriter.COMPUTE_MAXS); + initForWriter(writer, classSimpleName); + mClassWriters.put(classSimpleName, writer); + } + return writer; + } + + private void initForWriter(ClassVisitor visitor, String classSimpleName) { + visitor.visit(Opcodes.V1_7, Opcodes.ACC_SUPER, getCanonicalName(classSimpleName), null, "java/lang/Object", null); + MethodVisitor mv = visitor.visitMethod(Opcodes.ACC_PRIVATE, "", "()V", null, null); + mv.visitCode(); + mv.visitVarInsn(Opcodes.ALOAD, 0); + mv.visitMethodInsn(Opcodes.INVOKESPECIAL, "java/lang/Object", "", "()V", false); + mv.visitInsn(Opcodes.RETURN); + mv.visitMaxs(1, 1); + mv.visitEnd(); + } + + public ClassData[] generateClassBytes() { + for (String className : mClassWriters.keySet()) { + originClassWriter.visitInnerClass(getCanonicalName(className), originClassName, className, Opcodes.ACC_PRIVATE | Opcodes.ACC_STATIC); + } + ClassData[] classDataArray = new ClassData[mClassWriters.size() + 1]; + int index = 0; + for (Map.Entry entry : mClassWriters.entrySet()) { + classDataArray[index] = new ClassData(entry.getValue().toByteArray(), getCanonicalName(entry.getKey())); + index++; + } + classDataArray[index] = new ClassData(originClassWriter.toByteArray(), originClassName); + return classDataArray; + } + + public String getCanonicalName(String simpleName) { + return originClassName + "$" + simpleName; + } +} diff --git a/lancet-weaver/src/main/java/me/ele/lancet/weaver/internal/asm/ClassContext.java b/lancet-weaver/src/main/java/me/ele/lancet/weaver/internal/asm/ClassContext.java new file mode 100644 index 0000000..fd7f20f --- /dev/null +++ b/lancet-weaver/src/main/java/me/ele/lancet/weaver/internal/asm/ClassContext.java @@ -0,0 +1,38 @@ +package me.ele.lancet.weaver.internal.asm; + +import me.ele.lancet.weaver.internal.graph.Graph; +import org.objectweb.asm.ClassVisitor; + +import java.util.BitSet; + +/** + * Created by gengwanpeng on 17/5/12. + */ +public class ClassContext { + + private final Graph graph; + private final MethodChain chain; + private final ClassVisitor tail; + + public String name; + public String superName; + + public ClassContext(Graph graph, MethodChain chain, ClassVisitor tail) { + this.graph = graph; + this.chain = chain; + this.tail = tail; + } + + public ClassVisitor getTail() { + return tail; + } + + public Graph getGraph() { + return graph; + } + + public MethodChain getChain() { + return chain; + } + +} diff --git a/lancet-weaver/src/main/java/me/ele/lancet/weaver/internal/asm/ClassTransform.java b/lancet-weaver/src/main/java/me/ele/lancet/weaver/internal/asm/ClassTransform.java new file mode 100644 index 0000000..6c12929 --- /dev/null +++ b/lancet-weaver/src/main/java/me/ele/lancet/weaver/internal/asm/ClassTransform.java @@ -0,0 +1,63 @@ +package me.ele.lancet.weaver.internal.asm; + +import org.objectweb.asm.ClassReader; + +import me.ele.lancet.weaver.ClassData; +import me.ele.lancet.weaver.internal.asm.classvisitor.HookClassVisitor; +import me.ele.lancet.weaver.internal.asm.classvisitor.InsertClassVisitor; +import me.ele.lancet.weaver.internal.asm.classvisitor.ProxyClassVisitor; +import me.ele.lancet.weaver.internal.asm.classvisitor.TryCatchInfoClassVisitor; +import me.ele.lancet.weaver.internal.entity.TransformInfo; +import me.ele.lancet.weaver.internal.graph.Graph; + +/** + * Created by Jude on 2017/4/25. + */ + +public class ClassTransform { + + public static final String AID_INNER_CLASS_NAME = "_lancet"; + + public static ClassData[] weave(TransformInfo transformInfo, Graph graph, byte[] classByte, String internalName) { + ClassCollector classCollector = new ClassCollector(new ClassReader(classByte), graph); + + classCollector.setOriginClassName(internalName); + + MethodChain chain = new MethodChain(internalName, classCollector.getOriginClassVisitor(), graph); + ClassContext context = new ClassContext(graph, chain, classCollector.getOriginClassVisitor()); + + ClassTransform transform = new ClassTransform(classCollector, context); + transform.connect(new HookClassVisitor(transformInfo.hookClasses)); + transform.connect(new ProxyClassVisitor(transformInfo.proxyInfo)); + transform.connect(new InsertClassVisitor(transformInfo.executeInfo)); + transform.connect(new TryCatchInfoClassVisitor(transformInfo.tryCatchInfo)); + transform.startTransform(); + return classCollector.generateClassBytes(); + } + + private LinkedClassVisitor mHeadVisitor; + private LinkedClassVisitor mTailVisitor; + private ClassCollector mClassCollector; + private final ClassContext context; + + public ClassTransform(ClassCollector mClassCollector, ClassContext context) { + this.mClassCollector = mClassCollector; + this.context = context; + } + + void connect(LinkedClassVisitor visitor) { + if (mHeadVisitor == null) { + mHeadVisitor = visitor; + } else { + mTailVisitor.setNextClassVisitor(visitor); + } + mTailVisitor = visitor; + visitor.setClassCollector(mClassCollector); + visitor.setContext(context); + } + + void startTransform() { + mTailVisitor.setNextClassVisitor(mClassCollector.getOriginClassVisitor()); + mClassCollector.mClassReader.accept(mHeadVisitor, 0); + } +} diff --git a/lancet-weaver/src/main/java/me/ele/lancet/weaver/internal/asm/LinkedClassVisitor.java b/lancet-weaver/src/main/java/me/ele/lancet/weaver/internal/asm/LinkedClassVisitor.java new file mode 100644 index 0000000..55553f1 --- /dev/null +++ b/lancet-weaver/src/main/java/me/ele/lancet/weaver/internal/asm/LinkedClassVisitor.java @@ -0,0 +1,45 @@ +package me.ele.lancet.weaver.internal.asm; + +import me.ele.lancet.weaver.internal.graph.Graph; +import me.ele.lancet.weaver.internal.util.Bitset; +import org.objectweb.asm.ClassVisitor; +import org.objectweb.asm.MethodVisitor; +import org.objectweb.asm.Opcodes; + +/** + * Created by Jude on 2017/4/25. + */ + +public class LinkedClassVisitor extends ClassVisitor { + + + private ClassContext context; + private ClassCollector mClassCollector; + + + public LinkedClassVisitor() { + super(Opcodes.ASM5); + } + + public void setContext(ClassContext context) { + this.context = context; + } + + void setClassCollector(ClassCollector classCollector) { + this.mClassCollector = classCollector; + } + + public ClassContext getContext() { + return context; + } + + protected ClassCollector getClassCollector() { + return mClassCollector; + } + + public void setNextClassVisitor(ClassVisitor classVisitor) { + cv = classVisitor; + } + + +} diff --git a/lancet-weaver/src/main/java/me/ele/lancet/weaver/internal/asm/MethodChain.java b/lancet-weaver/src/main/java/me/ele/lancet/weaver/internal/asm/MethodChain.java new file mode 100644 index 0000000..d5c80c0 --- /dev/null +++ b/lancet-weaver/src/main/java/me/ele/lancet/weaver/internal/asm/MethodChain.java @@ -0,0 +1,296 @@ +package me.ele.lancet.weaver.internal.asm; + +import com.google.common.base.Preconditions; +import com.dieyidezui.lancet.rt.annotations.ClassOf; +import me.ele.lancet.weaver.internal.asm.classvisitor.methodvisitor.AutoUnboxMethodVisitor; +import me.ele.lancet.weaver.internal.graph.ClassEntity; +import me.ele.lancet.weaver.internal.graph.FieldEntity; +import me.ele.lancet.weaver.internal.graph.Graph; +import me.ele.lancet.weaver.internal.log.Log; +import me.ele.lancet.weaver.internal.parser.AopMethodAdjuster; +import me.ele.lancet.weaver.internal.util.Bitset; +import me.ele.lancet.weaver.internal.util.PrimitiveUtil; +import me.ele.lancet.weaver.internal.util.TypeUtil; +import org.objectweb.asm.*; +import org.objectweb.asm.tree.AbstractInsnNode; +import org.objectweb.asm.tree.FieldInsnNode; +import org.objectweb.asm.tree.MethodInsnNode; +import org.objectweb.asm.tree.MethodNode; + +import java.util.HashMap; +import java.util.Map; +import java.util.function.Consumer; +import java.util.stream.Collectors; + + +/** + * Created by gengwanpeng on 17/5/9. + */ +public class MethodChain { + + private static final String ACCESS = "access$"; + private static final String FORMAT = "access$%03d"; + private static final String CLASS_OF = Type.getDescriptor(ClassOf.class); + + private final String className; + private final ClassVisitor base; + private final Graph graph; + private Bitset bitset; + + private Invoker head; + + private Map fieldMap; + private Map invokerMap = new HashMap<>(); + + + public MethodChain(String className, ClassVisitor base, Graph graph) { + this.className = className; + this.base = base; + this.graph = graph; + this.bitset = new Bitset(); + this.bitset.setInitializer(b -> { + int len = ACCESS.length(); + ClassEntity entity = graph.get(className).entity; + entity.methods.forEach(m -> { + if (TypeUtil.isStatic(m.access) && m.name.startsWith(ACCESS)) { + bitset.tryAdd(m.name, len); + } + }); + }); + } + + private void head(int access, int opcode, String owner, String name, String desc) { + this.head = Invoker.forMethod( + new MethodInsnNode(opcode, owner, name, desc, opcode == Opcodes.INVOKEINTERFACE) + , !hasPermission(access, owner), className); + } + + private boolean hasPermission(int access, String owner) { + return TypeUtil.isPublic(access) || !TypeUtil.isPrivate(access) && owner.equals(className); + } + + public void headFromProxy(int opcode, String owner, String name, String desc) { + int access = Opcodes.ACC_PRIVATE; + if (opcode == Opcodes.INVOKEINTERFACE || opcode == Opcodes.INVOKEVIRTUAL) { + access = Opcodes.ACC_PUBLIC; + } + head(access, opcode, owner, name, desc); + } + + public void headFromInsert(int access, String owner, String name, String desc) { + head(access, TypeUtil.isStatic(access) ? Opcodes.INVOKESTATIC : Opcodes.INVOKESPECIAL, owner, name, desc); + } + + + public void next(String className, int access, String name, String desc, MethodNode node, ClassVisitor cv) { + String[] exs = (String[]) node.exceptions.toArray(new String[0]); + head.createIfNeed(base, bitset, exs); + + MethodVisitor mv = cv.visitMethod(access, name, desc, null, exs); + node.accept(new MethodVisitor(Opcodes.ASM5, new AutoUnboxMethodVisitor(mv)) { + + @Override + public void visitMethodInsn(int opcode, String owner, String name, String desc, boolean itf) { + if (opcode == AopMethodAdjuster.OP_CALL) { + head.loadArgsAndInvoke(mv); + } else if (opcode == AopMethodAdjuster.OP_THIS_GET_FIELD) { + dealField(Opcodes.GETFIELD, name, mv); + } else if (opcode == AopMethodAdjuster.OP_THIS_PUT_FIELD) { + dealField(Opcodes.PUTFIELD, name, mv); + } else { + super.visitMethodInsn(opcode, owner, name, desc, itf); + } + } + + @Override + public AnnotationVisitor visitParameterAnnotation(int parameter, String desc, boolean visible) { + if (CLASS_OF.equals(desc)) { + return null; + } + return super.visitParameterAnnotation(parameter, desc, visible); + } + + }); + + headFromInsert(access, className, name, desc); + } + + private void dealField(int opcode, String name, MethodVisitor mv) { + initFields(); + + // always store in object, auto box and unbox. + final String obj = "Ljava/lang/Object;"; + + FieldEntity entity = fieldMap.get(name); + if (entity == null) { + base.visitField(Opcodes.ACC_PRIVATE, name, obj, null, null); + fieldMap.put(name, entity = new FieldEntity(Opcodes.ACC_PRIVATE, name, obj)); + } + + boolean needCreate = TypeUtil.isPrivate(entity.access); + String desc = entity.desc; + + invokerMap.computeIfAbsent(opcode + " " + name, + k -> { + Invoker invoker = Invoker.forField(new FieldInsnNode(opcode, className, name, desc), needCreate, className); + invoker.createIfNeed(base, bitset, null); + return invoker; + }) + .loadArgsAndInvoke(mv); + + } + + private void initFields() { + if (fieldMap == null) { + this.fieldMap = graph.get(className).entity.fields.stream() + .collect(Collectors.toMap(f -> f.name, f -> f)); + } + } + + public void fakePreMethod(String className, int access, String name, String desc, String signature, String[] exceptions) { + MethodVisitor mv = base.visitMethod(access, name, desc, null, exceptions); + + createMethod(access, desc, head.action()).accept(mv); + + headFromInsert(access, className, name, desc); + } + + public Invoker getHead(){ + return head; + } + + public void visitHead(MethodVisitor mv) { + head.invoke(mv); + } + + public static class Invoker implements Opcodes { + + public static Invoker forField(FieldInsnNode fn, boolean needCreate, String className) { + String staticDesc = staticDesc(className, null, Preconditions.checkNotNull(fn)); + return new Invoker(null, fn, needCreate, staticDesc, className); + } + + public static Invoker forMethod(MethodInsnNode mn, boolean needCreate, String className) { + String staticDesc = staticDesc(mn.owner, Preconditions.checkNotNull(mn), null); + return new Invoker(mn, null, needCreate, staticDesc, className); + } + + private static String staticDesc(String className, MethodInsnNode mn, FieldInsnNode fn) { + String desc = mn != null ? + mn.desc : + (fn.getOpcode() == PUTFIELD ? + '(' + fn.desc + ")V" : "()" + fn.desc); + int access = mn != null && mn.getOpcode() == INVOKESTATIC ? ACC_STATIC : 0; + return TypeUtil.descToStatic(access, desc, className); + } + + final MethodInsnNode mn; + final FieldInsnNode fn; + + final String staticDesc; + final String owner; + final boolean needCreate; + + MethodInsnNode syntheticNode; + + Invoker(MethodInsnNode mn, FieldInsnNode fn, boolean needCreate, String staticDesc, String owner) { + this.mn = mn; + this.fn = fn; + this.needCreate = needCreate; + this.staticDesc = staticDesc; + this.owner = owner; + } + + public void createIfNeed(ClassVisitor cv, Bitset bitset, String[] exceptions) { + if (syntheticNode != null) { + throw new IllegalStateException("can't create more than once"); + } + if (needCreate) { + String name = String.format(FORMAT, bitset.consume()); + + syntheticNode = new MethodInsnNode(INVOKESTATIC, owner, name, staticDesc, false); + Log.tag("transform").i("create synthetic node :" + owner + " " + name + " " + staticDesc); + + MethodVisitor mv = cv.visitMethod(ACC_STATIC | ACC_SYNTHETIC, name, staticDesc, null, exceptions); + + createMethod(ACC_STATIC, staticDesc, mn == null ? fn : mn) + .accept(mv); + } + } + + public void invoke(MethodVisitor mv) { + action().accept(mv); + } + + public void loadArgsAndInvoke(MethodVisitor mv) { + //load args + if (mn != null) { + Type[] params = Type.getArgumentTypes(staticDesc); + int index = 0; + for (Type t : params) { + mv.visitVarInsn(t.getOpcode(ILOAD), index); + index += t.getSize(); + } + invoke(mv); + } else { + if (fn.getOpcode() == PUTFIELD) { // unbox + mv.visitVarInsn(ALOAD, 0); + mv.visitInsn(SWAP); + if (PrimitiveUtil.isPrimitive(fn.desc)) { + String owner = PrimitiveUtil.box(fn.desc); + mv.visitMethodInsn(INVOKEVIRTUAL, PrimitiveUtil.virtualType(owner), + PrimitiveUtil.unboxMethod(owner), "()" + fn.desc, false); + } + invoke(mv); + } else { // box + mv.visitVarInsn(ALOAD, 0); + invoke(mv); + if (PrimitiveUtil.isPrimitive(fn.desc)) { + String owner = PrimitiveUtil.box(fn.desc); + mv.visitMethodInsn(INVOKESTATIC, owner, + "valueOf", "(" + fn.desc + ")L" + owner + ";", false); + ((AutoUnboxMethodVisitor) mv).markBoxed(); + } + } + } + } + + public AbstractInsnNode action() { + if (syntheticNode != null) { + return syntheticNode; + } else if (mn != null) { + return mn; + } else { + return fn; + } + } + } + + private static Consumer createMethod(int access, String desc, AbstractInsnNode action) { + return mv -> { + mv.visitCode(); + + //load args + Type[] params = Type.getArgumentTypes(desc); + int index = 0; + if (!TypeUtil.isStatic(access)) { + index++; + mv.visitVarInsn(Opcodes.ALOAD, 0); + } + + for (Type t : params) { + mv.visitVarInsn(t.getOpcode(Opcodes.ILOAD), index); + index += t.getSize(); + } + // action + action.accept(mv); + + // ret + Type ret = Type.getReturnType(desc); + mv.visitInsn(ret.getOpcode(Opcodes.IRETURN)); + + mv.visitMaxs(Math.max(index, ret.getSize()), index); + mv.visitEnd(); + }; + } +} diff --git a/lancet-weaver/src/main/java/me/ele/lancet/weaver/internal/asm/classvisitor/HookClassVisitor.java b/lancet-weaver/src/main/java/me/ele/lancet/weaver/internal/asm/classvisitor/HookClassVisitor.java new file mode 100644 index 0000000..209ce2a --- /dev/null +++ b/lancet-weaver/src/main/java/me/ele/lancet/weaver/internal/asm/classvisitor/HookClassVisitor.java @@ -0,0 +1,42 @@ +package me.ele.lancet.weaver.internal.asm.classvisitor; + +import org.objectweb.asm.MethodVisitor; +import org.objectweb.asm.Opcodes; + +import java.util.Set; + +import me.ele.lancet.weaver.internal.asm.LinkedClassVisitor; +import me.ele.lancet.weaver.internal.util.TypeUtil; + +/** + * Created by gengwanpeng on 17/5/15. + */ +public class HookClassVisitor extends LinkedClassVisitor { + + private final Set excludes; + private boolean matched; + + public HookClassVisitor(Set excludes) { + this.excludes = excludes; + } + + @Override + public void visit(int version, int access, String name, String signature, String superName, String[] interfaces) { + getContext().name = name; + getContext().superName = superName; + if (excludes.contains(name)) { + matched = true; + this.cv = getContext().getTail(); // make delegate point to the tail, ignore middle transform + } + super.visit(version, access, name, signature, superName, interfaces); + } + + @Override + public MethodVisitor visitMethod(int access, String name, String desc, String signature, String[] exceptions) { + if (matched){ + return super.visitMethod(TypeUtil.resetAccessScope(access,Opcodes.ACC_PUBLIC), name, desc, signature, exceptions); + }else { + return super.visitMethod(access, name, desc, signature, exceptions); + } + } +} diff --git a/lancet-weaver/src/main/java/me/ele/lancet/weaver/internal/asm/classvisitor/InsertClassVisitor.java b/lancet-weaver/src/main/java/me/ele/lancet/weaver/internal/asm/classvisitor/InsertClassVisitor.java new file mode 100644 index 0000000..ac6f095 --- /dev/null +++ b/lancet-weaver/src/main/java/me/ele/lancet/weaver/internal/asm/classvisitor/InsertClassVisitor.java @@ -0,0 +1,102 @@ +package me.ele.lancet.weaver.internal.asm.classvisitor; + +import me.ele.lancet.weaver.internal.asm.MethodChain; +import org.objectweb.asm.*; +import org.objectweb.asm.commons.GeneratorAdapter; + +import java.util.*; +import java.util.stream.Collectors; + +import me.ele.lancet.weaver.internal.asm.ClassTransform; +import me.ele.lancet.weaver.internal.asm.LinkedClassVisitor; +import me.ele.lancet.weaver.internal.entity.InsertInfo; +import me.ele.lancet.weaver.internal.log.Log; +import me.ele.lancet.weaver.internal.util.TypeUtil; + +/** + * Created by gengwanpeng on 17/3/27. + */ +public class InsertClassVisitor extends LinkedClassVisitor { + + private Map> executeInfos; + private List matched; + + + public InsertClassVisitor(Map> executeInfos) { + this.executeInfos = executeInfos; + } + + @Override + public void visit(int version, int access, String name, String signature, String superName, String[] interfaces) { + super.visit(version, access, name, signature, superName, interfaces); + matched = executeInfos.get(getContext().name); + } + + + @Override + public MethodVisitor visitMethod(int access, String name, String desc, String signature, String[] exceptions) { + if (matched != null) { + List methodsMatched = new ArrayList<>(matched.size() >> 1); + matched.removeIf(e -> { + if (e.targetMethod.equals(name) && e.targetDesc.equals(desc)) { + if (((e.sourceMethod.access ^ access) & Opcodes.ACC_STATIC) != 0) { + throw new IllegalStateException(e.sourceClass + "." + e.sourceMethod.name + " should have the same static flag with " + + getContext().name + "." + name); + } + methodsMatched.add(e); + return true; + } + return false; + }); + + if (methodsMatched.size() > 0 && (access & (Opcodes.ACC_NATIVE | Opcodes.ACC_ABSTRACT)) == 0) { + Log.tag("transform").i("visit Insert method: " + getContext().name + "." + name + " " + desc); + + String staticDesc = TypeUtil.descToStatic(access, desc, getContext().name); + ClassVisitor cv = getClassCollector().getInnerClassVisitor(ClassTransform.AID_INNER_CLASS_NAME); + String owner = getClassCollector().getCanonicalName(ClassTransform.AID_INNER_CLASS_NAME); + String newName = name + "$___twin___"; + int newAccess = (access & ~(Opcodes.ACC_PROTECTED | Opcodes.ACC_PUBLIC)) | Opcodes.ACC_PRIVATE; + + MethodChain chain = getContext().getChain(); + chain.headFromInsert(newAccess, getContext().name, newName, desc); + + methodsMatched.forEach(e -> { + Log.tag("transform").i( + " from " + e.sourceClass + "." + e.sourceMethod.name); + String methodName = e.sourceClass.replace("/", "_") + "_" + e.sourceMethod.name; + chain.next(owner, Opcodes.ACC_STATIC, methodName, staticDesc, e.threadLocalNode(), cv); + }); + chain.fakePreMethod(getContext().name, access, name, desc, signature, exceptions); + + return super.visitMethod(newAccess, newName, desc, signature, exceptions); + } + } + return super.visitMethod(access, name, desc, signature, exceptions); + } + + @Override + public void visitEnd() { + if (matched != null && matched.size() > 0) { + new ArrayList<>(matched).stream() + .collect(Collectors.groupingBy(e -> e.targetMethod)).forEach((k, v) -> { + if (v.stream().anyMatch(e -> e.createSuper)) { + InsertInfo e = v.get(0); + MethodVisitor mv = visitMethod(e.sourceMethod.access, e.targetMethod, e.targetDesc, e.sourceMethod.signature, + (String[]) e.sourceMethod.exceptions.toArray(new String[0])); + GeneratorAdapter adapter = new GeneratorAdapter(mv, e.sourceMethod.access, e.targetMethod, e.targetDesc); + adapter.visitCode(); + adapter.loadThis(); + adapter.loadArgs(); + adapter.visitMethodInsn(Opcodes.INVOKESPECIAL, getContext().superName, e.targetMethod, e.targetDesc, false); + adapter.returnValue(); + int sz = Type.getArgumentsAndReturnSizes(e.targetDesc); + adapter.visitMaxs(Math.max(sz >> 2, sz & 3), sz >> 2); + adapter.visitEnd(); + } + }); + + } + super.visitEnd(); + } +} diff --git a/lancet-weaver/src/main/java/me/ele/lancet/weaver/internal/asm/classvisitor/ProxyClassVisitor.java b/lancet-weaver/src/main/java/me/ele/lancet/weaver/internal/asm/classvisitor/ProxyClassVisitor.java new file mode 100644 index 0000000..d44a44c --- /dev/null +++ b/lancet-weaver/src/main/java/me/ele/lancet/weaver/internal/asm/classvisitor/ProxyClassVisitor.java @@ -0,0 +1,44 @@ +package me.ele.lancet.weaver.internal.asm.classvisitor; + +import me.ele.lancet.weaver.internal.asm.MethodChain; +import org.objectweb.asm.MethodVisitor; + +import java.util.HashMap; +import java.util.List; +import java.util.Map; +import java.util.stream.Collectors; + +import me.ele.lancet.weaver.internal.asm.LinkedClassVisitor; +import me.ele.lancet.weaver.internal.asm.classvisitor.methodvisitor.ProxyMethodVisitor; +import me.ele.lancet.weaver.internal.entity.ProxyInfo; + +/** + * Created by Jude on 17/4/26. + */ +public class ProxyClassVisitor extends LinkedClassVisitor { + + private List infos; + private Map> matches; + private Map maps = new HashMap<>(); + public ProxyClassVisitor(List infos) { + this.infos = infos; + } + + @Override + public void visit(int version, int access, String name, String signature, String superName, String[] interfaces) { + matches = infos.stream() + .filter(t -> t.match(name)) + .collect(Collectors.groupingBy(t -> t.targetClass + " " + t.targetMethod + " " + t.targetDesc)); + + super.visit(version, access, name, signature, superName, interfaces); + } + + @Override + public MethodVisitor visitMethod(int access, String name, String desc, String signature, String[] exceptions) { + MethodVisitor mv = super.visitMethod(access, name, desc, signature, exceptions); + if (matches.size() > 0) { + mv = new ProxyMethodVisitor(getContext().getChain(), mv, maps, matches, getContext().name, name, getClassCollector()); + } + return mv; + } +} diff --git a/lancet-weaver/src/main/java/me/ele/lancet/weaver/internal/asm/classvisitor/TryCatchInfoClassVisitor.java b/lancet-weaver/src/main/java/me/ele/lancet/weaver/internal/asm/classvisitor/TryCatchInfoClassVisitor.java new file mode 100644 index 0000000..9c51a39 --- /dev/null +++ b/lancet-weaver/src/main/java/me/ele/lancet/weaver/internal/asm/classvisitor/TryCatchInfoClassVisitor.java @@ -0,0 +1,47 @@ +package me.ele.lancet.weaver.internal.asm.classvisitor; + +import org.objectweb.asm.MethodVisitor; +import org.objectweb.asm.Opcodes; + +import java.util.List; +import java.util.stream.Collectors; + +import me.ele.lancet.weaver.internal.asm.LinkedClassVisitor; +import me.ele.lancet.weaver.internal.asm.classvisitor.methodvisitor.TryCatchMethodVisitor; +import me.ele.lancet.weaver.internal.entity.TryCatchInfo; +import me.ele.lancet.weaver.internal.log.Log; + + +/** + * Created by gengwanpeng on 17/3/27. + */ +public class TryCatchInfoClassVisitor extends LinkedClassVisitor { + + private String className; + private List infos; + private List matches = null; + + + public TryCatchInfoClassVisitor(List infos) { + this.infos = infos; + } + + @Override + public void visit(int version, int access, String name, String signature, String superName, String[] interfaces) { + className = name; + if (infos != null){ + matches = infos.stream().filter(t -> t.match(name)).collect(Collectors.toList()); + } + super.visit(version, access, name, signature, superName, interfaces); + } + + @Override + public MethodVisitor visitMethod(int access, String name, String desc, String signature, String[] exceptions) { + MethodVisitor mv = super.visitMethod(access, name, desc, signature, exceptions); + if (matches != null && matches.size() > 0) { + Log.tag("transform").i("visit TryCatch method: "+className+"."+name+" "+desc); + mv = new TryCatchMethodVisitor(Opcodes.ASM5, mv, matches); + } + return mv; + } +} diff --git a/lancet-weaver/src/main/java/me/ele/lancet/weaver/internal/asm/classvisitor/methodvisitor/AutoUnboxMethodVisitor.java b/lancet-weaver/src/main/java/me/ele/lancet/weaver/internal/asm/classvisitor/methodvisitor/AutoUnboxMethodVisitor.java new file mode 100644 index 0000000..d7f60fa --- /dev/null +++ b/lancet-weaver/src/main/java/me/ele/lancet/weaver/internal/asm/classvisitor/methodvisitor/AutoUnboxMethodVisitor.java @@ -0,0 +1,128 @@ +package me.ele.lancet.weaver.internal.asm.classvisitor.methodvisitor; + + +import me.ele.lancet.weaver.internal.util.PrimitiveUtil; +import org.objectweb.asm.*; + +/** + * Created by gengwanpeng on 17/5/31. + */ +public class AutoUnboxMethodVisitor extends MethodVisitor { + + private boolean flag = false; + private String lastOwner; + + public AutoUnboxMethodVisitor(MethodVisitor methodVisitor) { + super(Opcodes.ASM5, methodVisitor); + } + + public void markBoxed() { + flag = true; + } + + @Override + public void visitInsn(int opcode) { + clearFlag(); + super.visitInsn(opcode); + } + + private void clearFlag() { + flag = false; + } + + @Override + public void visitIntInsn(int opcode, int operand) { + clearFlag(); + super.visitIntInsn(opcode, operand); + } + + @Override + public void visitVarInsn(int opcode, int var) { + clearFlag(); + super.visitVarInsn(opcode, var); + } + + @Override + public void visitTypeInsn(int opcode, String type) { + if (flag) { + if (opcode == Opcodes.CHECKCAST && !type.equals(lastOwner) && PrimitiveUtil.boxedNumberTypes().contains(type)) { + if (lastOwner == null || !PrimitiveUtil.boxedNumberTypes().contains(lastOwner)) { + throw new IllegalStateException("can't cast bool or char to number"); + } + String method = PrimitiveUtil.unboxMethod(type); + String primitive = PrimitiveUtil.unbox(type); + super.visitMethodInsn(Opcodes.INVOKEVIRTUAL, "java/lang/Number", method, "()" + primitive, false); + super.visitMethodInsn(Opcodes.INVOKESTATIC, type, "valueOf", "(" + primitive + ")L" + type + ";", false); + } + } + clearFlag(); + super.visitTypeInsn(opcode, type); + } + + @Override + public void visitFieldInsn(int opcode, String owner, String name, String desc) { + clearFlag(); + super.visitFieldInsn(opcode, owner, name, desc); + } + + @Override + public void visitMethodInsn(int opcode, String owner, String name, String desc) { + clearFlag(); + super.visitMethodInsn(opcode, owner, name, desc); + } + + @Override + public void visitMethodInsn(int opcode, String owner, String name, String desc, boolean itf) { + this.lastOwner = owner; + clearFlag(); + super.visitMethodInsn(opcode, owner, name, desc, itf); + } + + @Override + public void visitInvokeDynamicInsn(String name, String desc, Handle bsm, Object... bsmArgs) { + clearFlag(); + super.visitInvokeDynamicInsn(name, desc, bsm, bsmArgs); + } + + @Override + public void visitJumpInsn(int opcode, Label label) { + clearFlag(); + super.visitJumpInsn(opcode, label); + } + + @Override + public void visitLdcInsn(Object cst) { + clearFlag(); + super.visitLdcInsn(cst); + } + + @Override + public void visitIincInsn(int var, int increment) { + clearFlag(); + super.visitIincInsn(var, increment); + } + + @Override + public void visitTableSwitchInsn(int min, int max, Label dflt, Label... labels) { + clearFlag(); + super.visitTableSwitchInsn(min, max, dflt, labels); + } + + @Override + public void visitLookupSwitchInsn(Label dflt, int[] keys, Label[] labels) { + clearFlag(); + super.visitLookupSwitchInsn(dflt, keys, labels); + } + + @Override + public void visitMultiANewArrayInsn(String desc, int dims) { + clearFlag(); + super.visitMultiANewArrayInsn(desc, dims); + } + + @Override + public void visitEnd() { + clearFlag(); + super.visitEnd(); + } +} diff --git a/lancet-weaver/src/main/java/me/ele/lancet/weaver/internal/asm/classvisitor/methodvisitor/ProxyMethodVisitor.java b/lancet-weaver/src/main/java/me/ele/lancet/weaver/internal/asm/classvisitor/methodvisitor/ProxyMethodVisitor.java new file mode 100644 index 0000000..d64e4b7 --- /dev/null +++ b/lancet-weaver/src/main/java/me/ele/lancet/weaver/internal/asm/classvisitor/methodvisitor/ProxyMethodVisitor.java @@ -0,0 +1,76 @@ +package me.ele.lancet.weaver.internal.asm.classvisitor.methodvisitor; + +import me.ele.lancet.weaver.internal.asm.MethodChain; +import me.ele.lancet.weaver.internal.util.TypeUtil; +import org.objectweb.asm.ClassVisitor; +import org.objectweb.asm.MethodVisitor; +import org.objectweb.asm.Opcodes; + +import java.util.List; +import java.util.Map; + +import me.ele.lancet.weaver.internal.asm.ClassCollector; +import me.ele.lancet.weaver.internal.asm.ClassTransform; +import me.ele.lancet.weaver.internal.entity.ProxyInfo; +import me.ele.lancet.weaver.internal.log.Log; + +/** + * Created by Jude on 17/4/26. + */ +public class ProxyMethodVisitor extends MethodVisitor { + + private final Map invokerMap; + private final Map> matchMap; + private final String className; + private final String name; + private final ClassCollector classCollector; + private final MethodChain chain; + + public ProxyMethodVisitor(MethodChain chain, MethodVisitor mv, Map invokerMap, Map> matchMap, String className, String name, ClassCollector classCollector) { + super(Opcodes.ASM5, mv); + this.chain = chain; + this.invokerMap = invokerMap; + this.matchMap = matchMap; + this.className = className; + this.name = name; + this.classCollector = classCollector; + } + + @Override + public void visitMethodInsn(int opcode, String owner, String name, String desc, boolean itf) { + String key = owner + " " + name + " " + desc; + List infos = matchMap.get(key); + MethodChain.Invoker invoker = invokerMap.get(key); + if (invoker != null) { + invoker.invoke(mv); + } else if (infos != null && infos.size() > 0) { + + String staticDesc = TypeUtil.descToStatic(opcode == Opcodes.INVOKESTATIC ? Opcodes.ACC_STATIC : 0, desc, owner); + // begin hook this code. + chain.headFromProxy(opcode, owner, name, desc); + + String artificialClassname = classCollector.getCanonicalName(ClassTransform.AID_INNER_CLASS_NAME); + ClassVisitor cv = classCollector.getInnerClassVisitor(ClassTransform.AID_INNER_CLASS_NAME); + + Log.tag("transform").i("start weave Call method " + " for " + owner + "." + name + desc + + " in " + className + "." + this.name); + + infos.forEach(c -> { + if (TypeUtil.isStatic(c.sourceMethod.access) != (opcode == Opcodes.INVOKESTATIC)) { + throw new IllegalStateException(c.sourceClass + "." + c.sourceMethod.name + " should have the same " + + "static flag with " + owner + "." + name); + } + Log.tag("transform").i( + " from " + c.sourceClass + "." + c.sourceMethod.name); + + String methodName = c.sourceClass.replace("/", "_") + "_" + c.sourceMethod.name; + chain.next(artificialClassname, Opcodes.ACC_STATIC, methodName, staticDesc, c.threadLocalNode(), cv); + }); + + invokerMap.put(key, chain.getHead()); + chain.getHead().invoke(mv); + } else { + super.visitMethodInsn(opcode, owner, name, desc, itf); + } + } +} diff --git a/lancet-weaver/src/main/java/me/ele/lancet/weaver/internal/asm/classvisitor/methodvisitor/TryCatchMethodVisitor.java b/lancet-weaver/src/main/java/me/ele/lancet/weaver/internal/asm/classvisitor/methodvisitor/TryCatchMethodVisitor.java new file mode 100644 index 0000000..71a1641 --- /dev/null +++ b/lancet-weaver/src/main/java/me/ele/lancet/weaver/internal/asm/classvisitor/methodvisitor/TryCatchMethodVisitor.java @@ -0,0 +1,42 @@ +package me.ele.lancet.weaver.internal.asm.classvisitor.methodvisitor; + +import org.objectweb.asm.Label; +import org.objectweb.asm.MethodVisitor; +import org.objectweb.asm.Opcodes; + +import java.util.HashSet; +import java.util.List; +import java.util.Set; + +import me.ele.lancet.weaver.internal.entity.TryCatchInfo; + + +/** + * Created by gengwanpeng on 17/3/31. + */ +public class TryCatchMethodVisitor extends MethodVisitor { + + private Set