org.reflections 一个强大的反射工具

作者:青山常在人不老   阅读 (4785)  |  收藏 (0)  |  点赞 (0)

摘要

org.reflections是一个强大的反射工具,它能够反射扫描你的类路径,索引元数据,允许你在运行时查询它,并可以保存和收集项目中许多模块的信息。


原文链接:org.reflections 一个强大的反射工具

1、它能做啥?

反射一站式服务对象

反射扫描你的类路径,索引元数据,允许你在运行时查询它,并可以保存和收集项目中许多模块的信息。

使用反射,您可以查询元数据,例如:

  1. 获取某种类型的所有子类型

  2. 获取所有类型/构造函数/方法/字段,并使用一些注释进行注释,可选地使用匹配的注释参数

  3. 获取匹配正则表达式的所有资源

  4. 获取具有特定签名的所有方法,包括参数、参数注释和返回类型

  5. 获取所有方法参数名称

  6. 获取代码中的所有字段/方法/构造函数用法

2、如何使用

需要引入org.reflections依赖

maven项目请前往:https://mvnrepository.com/artifact/org.reflections/reflections拷贝依赖,非maven项目可在连接中找到jar下载拷贝到项目中。

<!-- https://mvnrepository.com/artifact/org.reflections/reflections -->
<dependency>
    <groupId>org.reflections</groupId>
    <artifactId>reflections</artifactId>
    <version>0.10.2</version>
</dependency>

反射的基础用法

Reflections reflections = new Reflections("my.project.prefix");

Set<Class<? extends SomeType>> subTypes = reflections.getSubTypesOf(SomeType.class);

Set<Class<?>> annotated = reflections.getTypesAnnotatedWith(SomeAnnotation.class);

实例化方式

要使用反射应该使用构造函数来实例化它(传入的为包所在的路径:请注意,是相对路径,例如:com.cn.xxxx),然后根据扫描仪,方便的使用查询方法:

Reflections reflections = new Reflections("my.package.prefix");
//or
Reflections reflections = new Reflections(ClasspathHelper.forPackage("my.package.prefix"), 
     new SubTypesScanner(), new TypesAnnotationScanner(), new FilterBuilder().include(...), ...);

//or using the ConfigurationBuilder
new Reflections(new ConfigurationBuilder()
            .filterInputsBy(new FilterBuilder().include(FilterBuilder.prefix("my.project.prefix")))
            .setUrls(ClasspathHelper.forPackage("my.project.prefix"))
            .setScanners(new SubTypesScanner(), new TypeAnnotationsScanner().filterResultsBy(optionalFilter), ...));

org.reflections具有的API方法

Set<Class<? extends Module>> modules = reflections.getSubTypesOf(com.google.inject.Module.class);
Set<Class<?>> singletons =    reflections.getTypesAnnotatedWith(javax.inject.Singleton.class);

Set<String> properties =       reflections.getResources(Pattern.compile(".\*\.properties"));
Set<Constructor> injectables = reflections.getConstructorsAnnotatedWith(javax.inject.Inject.class);
Set<Method> deprecateds =      reflections.getMethodsAnnotatedWith(javax.ws.rs.Path.class);
Set<Field> ids =               reflections.getFieldsAnnotatedWith(javax.persistence.Id.class);

Set<Method> someMethods =      reflections.getMethodsMatchParams(long.class, int.class);
Set<Method> voidMethods =      reflections.getMethodsReturn(void.class);
Set<Method> pathParamMethods = reflections.getMethodsWithAnyParamAnnotated(PathParam.class);
Set<Method> floatToString =    reflections.getConverters(Float.class, String.class);
List<String> parameterNames =  reflections.getMethodsParamNames(Method.class);

Set<Member> fieldUsage =       reflections.getFieldUsage(Field.class);
Set<Member> methodUsage =      reflections.getMethodUsage(Method.class);
Set<Member> constructorUsage = reflections.getConstructorUsage(Constructor.class);

一个示例

下面示例将展示如何获取本项目中所有加载了某个注解的方法

例如,项目中有个方法如下(该方法使用了@EncodingResponse 注解):

@EncodingResponse
public UserInfo getAllUsers(String userId) {
   .......
}

我们将通过上面的org.reflections来获取项目中所有使用了@EncodingResponse 注解的方法

Reflections reflections = new Reflections(new ConfigurationBuilder()
        .setUrls(ClasspathHelper.forPackage("cn.com.xxx"))
        .setScanners(new MethodAnnotationsScanner()));

Set<Method> allMethods = reflections.getMethodsAnnotatedWith(EncodingResponse .class);
System.out.println(allMethods.size());
for (Method m : allMethods) {
    if (m.isAnnotationPresent(EncodingResponse .class)) {
        System.out.println("哈哈哈哈");
    }
}

注意:上述代码可以在任何方法中执行,而无需应用运行(你可以在任何时候,适合地方调用该方法)

有条件的可以看下官方文档:https://www.javadoc.io/doc/org.reflections/reflections/0.9.10/org/reflections/Reflections.html 

分类   Spring 配置
字数   3498

博客标签    org.reflections 方法详解  

评论