支持通过参数定义返回类型

#### 遇到的问题
如果请求接口的方法的返回类型，是由未知的泛型参数所构成的话，无法通过Java的反射获取调用时实际泛型类型，所以无法正常将数据按照预想的类型进行反序列化

```java
    /**
     * 带有方法泛型 <T> 的接口，其返回类型为未知类型，无法正常返回结果
     * 在调用时会报错: 无法将数据转换为用户预期的
     * 
     * @return 无法正常反序列化的对象
     * @param <T> 未知泛型参数
     */
    @Get("/")
    <T> T getUnkownTypeResult();

```

#### 解决方案

新增`@Return`参数注解，来标识某个参数为返回类型

```java

/**
     * 通过 Class 类型参数来标识返回类型
     * 
     * @param clazz 返回类型
     * @return clazz 参数所标识的返回类型的实例
     * @param <T> 未知泛型参数，通过传入 clazz 参数来明确泛型的实际类型
     */
    @Get("/")
    <T> T getGenericClass(@Return Class<T> clazz);

/**
     * 通过 Type 类型参数来标识返回类型
     * 
     * @param type 返回类型
     * @return type 参数所标识的返回类型的实例
     * @param <T> 未知泛型参数，通过传入 type 参数来明确泛型的实际类型
     */
    @Get("/")
    <T> T getGenericType(@Return Type type);

/**
     * 通过 TypeReference 类型参数来标识返回类型
     * 
     * @param typeReference 返回类型
     * @return typeReference 参数所标识的返回类型的实例
     * @param <T> 未知泛型参数，通过传入 typeReference 参数来明确泛型的实际类型
     */
    @Get("/")
    <T> T getGenericTypeReference(@Return TypeReference<T> typeReference);
```

#### 需要注意
1. `@Return`注解所标注参数类型的必须是 Class 类或 Type 接口（及其实现类），或是 `com.dtflys.forest.utils.TypeReference`类（该类也是 Type 接口的实现类）
2. `@Return`注解在一个方法的参数中，至多只能有一个，如有超过一个的`@Return`注解，返回类型会被覆盖，可能发生不可预期的错误
3. `@Return`注解所标注的类型是指定方法的实际返回类型，而并不是指定方法泛型参数的类型

以下代码是错误示例:

```java
    /**
     * 这里的 dataClass 并不是 <T>
     * 如果 dataClass 传入 String.class，那么最终返回的类型就是 String, 而不是 MyRes<String>
     */
    @Get("/")
    <T> MyRes<T> getUnkownTypeResult(@Return Class<T> dataClass);

```

dromara/forest

内容风险标识

评论 (1)

dromara/forest .gitee-modal { width: 500px !important; }

内容风险标识