我以前的博客(Java Scala获取注解的类信息)介绍过通过Reflections工具通过使用特定注解的类的信息,其实本工具也可以获取接口,抽象类,类等的所有子类信息。使用方法如下:
Reflections reflections = new Reflections("my.project"); Set> subTypes = reflections.getSubTypesOf(SomeType.class);
下面实例来说明如何使用的:
定义接口:
package test.reflection; /** * 类功能描述://TODO * * @author WangXueXing create at 19-5-4 下午10:16 * @version 1.0.0 */ public interface Base { void doSomeThing(); }
定义子类1:
package test.reflection; /** * 类功能描述://TODO * * @author WangXueXing create at 19-5-4 下午10:18 * @version 1.0.0 */ public class SubClass1 implements Base{ @Override public void doSomeThing() { System.out.println("SubClass1"); } }
定义子类2:
package test.reflection; /** * 类功能描述://TODO * * @author WangXueXing create at 19-5-4 下午10:18 * @version 1.0.0 */ public class SubClass2 implements Base{ @Override public void doSomeThing() { System.out.println("SubClass2"); } }
测试获取所有Base的子类信息:
package test.reflection; import org.reflections.Reflections; import java.util.Set; /** * 类功能描述://TODO * * @author WangXueXing create at 19-5-4 下午10:19 * @version 1.0.0 */ public class Test { public static void main(String[] args){ Reflections reflections = new Reflections("test.reflection"); Setextends Base>> subTypes = reflections.getSubTypesOf(Base.class); subTypes.forEach(x -> System.out.println(x)); } }
结果输出如下:
class test.reflection.SubClass1
class test.reflection.SubClass2
如上如何获取所有子类信息。
其实Reflections还有其他很有用的功能,如下了解下:
一. Reflections的其他用法
使用默认的scanners,浏览url包含my.package的路径,包括以my.package开头的
Reflections reflections = new Reflections("my.package");
使用ConfigurationBuilder
new Reflections(new ConfigurationBuilder()
.setUrls(ClasspathHelper.forPackage("my.project.prefix"))
.setScanners(new SubTypesScanner(),
new TypeAnnotationsScanner().filterResultsBy(optionalFilter), ...), .filterInputsBy(new FilterBuilder().includePackage("my.project.prefix")) ...);
然后方便的使用查询方法,这要根据具体scanners配置
SubTypesScanner
Set> modules =
reflections.getSubTypesOf(com.google.inject.Module.class);
TypeAnnotationsScanner
Set> singletons =
reflections.getTypesAnnotatedWith(javax.inject.Singleton.class);
ResourcesScanner
Set properties =
reflections.getResources(Pattern.compile(".*\\.properties"));
MethodAnnotationsScanner
Set resources =
reflections.getMethodsAnnotatedWith(javax.ws.rs.Path.class);
Set injectables =
reflections.getConstructorsAnnotatedWith(javax.inject.Inject.class);
FieldAnnotationsScanner
Set ids =
reflections.getFieldsAnnotatedWith(javax.persistence.Id.class);
MethodParameterScanner
Set someMethods =
reflections.getMethodsMatchParams(long.class, int.class);
Set voidMethods =
reflections.getMethodsReturn(void.class);
Set pathParamMethods =
reflections.getMethodsWithAnyParamAnnotated(PathParam.class);
MethodParameterNamesScanner
List parameterNames =
reflections.getMethodParamNames(Method.class)
MemberUsageScanner
Set usages =
reflections.getMethodUsages(Method.class)
如果没有配置scanner,默认使用SubTypesScanner
和TypeAnnotationsScanner
也可以配置Classloader,用来解析某些实时类
保证能够解析到url
git上的例子:https://github.com/ronmamo/reflections/tree/master/src/test/java/org/reflections
三. ReflectionUtils
ReflectionsUtils包含了一些方便的方法,形式类似*getAllXXX(type, withYYY)
比如
import static org.reflections.ReflectionUtils.*;
Set getters = getAllMethods(someClass,
withModifier(Modifier.PUBLIC), withPrefix("get"), withParametersCount(0));
//or Set listMethodsFromCollectionToBoolean = getAllMethods(List.class, withParametersAssignableTo(Collection.class), withReturnType(boolean.class)); Set fields = getAllFields(SomeClass.class, withAnnotation(annotation), withTypeAssignableTo(type));
四. ClasspathHelper
获取包、class、classloader的方法
使用maven可以很方便的集成到项目中,可以把浏览的元数据存储到xml/json文件中,下一次不必浏览,直接使用
在maven中,使用Reflections Maven plugin
插件
其他用法
- 并行查找url
- 序列化查找为xml/json
- 直接利用存储的元数据,快速load,不必再次scan
- 存储模型实体为.java文件,可以通过静态方式引用
types/fields/methods/annotation
- 初始化srping的包浏览
五. 注解的例子
获取包中,带TaskOption注解的类,然后获取注解的task()
Map, Class>> optionMap = new HashMap<>();
for (Class> clazz : reflections.getTypesAnnotatedWith(TaskOption.class)) {
TaskOption taskOption = clazz.getAnnotation(TaskOption.class);
if (taskOption == null) continue; // this shouldn't happen optionMap.put(taskOption.task(), clazz); }