sg-uap常用注解介绍

Posted loveshare

tags:

篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了sg-uap常用注解介绍相关的知识,希望对你有一定的参考价值。

注解基本介绍

 Annotation(注解)是JDK5.0及以后版本引入的。它可以用于创建文档,跟踪代码中的依赖性,甚至执行基本编译时检查。注解是以‘@注解名’在代码中存在的,根据注解参数的个数,我们可以将注解分为:标记注解、单值注解、完整注解三类。它们都不会直接影响到程序的语义,只是作为注解(标识)存在,我们可以通过反射机制编程实现对这些元数据的访问。另外,你可以在编译时选择代码里的注解是否只存在于源代码级,或者它也能在class文件中出现

 

注解定义

注解定义很简单:

@Target(ElementType.PARAMETER)

public @interface Test

使用时以@Test方式标记在方法体,类或参数上。Target(ElementType.PARA

METER)可以定义注解的标记类型。

 

常用 SPRING注解

1.@Controller

       @Controller注解将一个类标明为用来接收HTTP请求控制器

2.@RequesMapping

       @RequestMapping注解将特定的URL和具体的控制器类或控制类类中的方法绑定

3.@PathVariable

       添加@PathVariable注解,可以直接在方法中使用请求URI中的值。

4.@Repository

         用于将数据访问层(DAO层) 的类标识为Spring Bean。具体只需将该注解标注          

        在 DAO类上即可。同时,为了让Spring能够扫描类路径中的类并识别出       

         @Repository注解,需要在XML配置文件中启用Bean的自动扫描功能,这可    

         以通过<context:component-scan/><context:component-scanbase-

         package=”bookstore.dao”/>   如此,我们就不再需要在XML中显式使用

        <bean/> 进行 Bean 的配置。Spring在容器初始化时将自动扫描base-package         

        指定的包及其子包下的所有class文件,所有标注了@Repository的类都将被册       

         为 SpringBean。

控制层使用的注解介绍

1. @ColumnRequestParam

      作用:参数注解。

      com.sgcc.uap.rest.annotation.ColumnRequestParam

      请求体是columns:["id","name"]的形式,指明方法的参数是从请求体中获取的字符串数组。

用于在获取元数据信息时,从请求体获取显示的列,并将列名封装为字符串数组。

      例如:请求参数为params=“columns”:[“id”,“name”,“sex”],返回数据为:String[]“id”,“name”,“sex”    

使用示例:@RequestMapping("/meta")

    public @ColumnResponseBodyList<ViewAttributeData>getMetaData(

        @ColumnRequestParam("params")String[] columns)

             …………

       

2. @ColumnResponseBody

      作用:方法体注解,对返回值进行拦截。

      拦截List类型的返回值,将返回值解析为JSON格式字符串,如:

      “columns”:[“name”:”id”,”caption”:”编号”,”length”:32,,,…]

      com.sgcc.uap.rest.annotation.ColumnResponseBody

      响应体是columns:[,,……]的形式,指明将方法返回值转化为JSON格式列信息,

      将返回的对象转换为json串。

      返回对象为ViewAttributeData,

      返回数据格式为:  

     "columns":["name":"id","caption":"ID",nullable:false,dataType:"string",...]

3. @IdRequestBody:

      作用:参数注解。

      拦截请求体为params:primaryKey: ”EMP_ID” ,  ids:[”001”, “002”,……] 格式的数据,将此数据转换为字符串数组。如                    

                 [“0001”,”0002”]。

      com.sgcc.uap.rest.annotation.IdRequestBody

      指明方法的参数是从请求体中获取的字符串数组 ,并将主键信息封装为IDRequestObject对象。通过getPrimarykey()和getIds()取出主键名称和主键值

      例如:用于删除操作从请求体中获取主键

     public @VoidResponseBody

  Object delete(@IdRequestBodyIDRequestObjectid)

                。。。。。。

     

4. @ItemRequestParam:

        作用:参数注解。

        com.sgcc.uap.rest.annotation.ItemRequestParam 

        拦截请求数据“itemType”:”school”,将数据的itemType解析,返回字符串。例如返回:school。

        该注解用于在树场景中取出节点的itemType。使用示例:

       public @TreeResponseBody

  List<TreeNode>getNodes(@PathVariableString id,

  @ItemRequestParam("params")StringitemType)

                。。。。。。

        

5. @ItemsRequestBody:

        作用:参数注解。

        com.sgcc.uap.rest.annotation.ItemsRequestBody

        拦截请求体的数据格式:

       “items”:[“id”:”01”,”name”:”n1”,,,…]和“parentID”:”0003329281”,“items”:[“id”:”01”,”name”:”n1”,,,…]

        将数据转化为List<Map>格式,list中map封装一个item数据

        使用示例:用于保存场景,将请求体中的记录封装为到list中。

       public @ItemResponseBody

  List<SchoolVO>saveSchool(@ItemsRequestBodyList<Map>list)

  。。。。

       

6. @ItemsResponseBody:

       作用:方法体注解。

       拦截返回数据。将返回的list集合转化为json字符串。

                “items”:[“id”:”01”,”name”:”n1”,,,…] ,itemCount:100

       com.sgcc.uap.rest.annotation.ItemResponseBody

       拦截返回数据。将返回的list集合转化为json字符串。指明返回值将以 

       items:[]的形式返回。使用示例:

      public @ItemResponseBody

  QueryResultObjectquery(@QueryRequestParam("params")     

       RequestConditionparams)

        。。。。。

      

7. @QueryRequestParam:

        作用:参数注解。

        com.sgcc.uap.rest.annotation.QueryRequestParam

        GET请求中从url中通过指定KEY值将参数取出,用于查询条件。    

        QueryRequestParam("params"),将url中的"params":"filter":"name  =‘eqe‘&sex=‘female‘","orderStr":"age","columns":"id,name,age,sex"转换为RequestCondition对象。使用实例:

        public @ItemResponseBody

  QueryResultObjectquery(@QueryRequestParam("params")RequestCondition     

        params)

                。。。。。

         

8. @QueryRequestParam:

        作用:参数注解。

        com.sgcc.uap.rest.annotation.QueryRequestParam

        GET请求中从url中通过指定KEY值将参数取出,用于查询条件。    

        QueryRequestParam("params"),将url中的"params":"filter":"name  =‘eqe‘&sex=‘female‘","orderStr":"age","columns":"id,name,age,sex"转换为RequestCondition对象。使用实例:

        public @ItemResponseBody

  QueryResultObjectquery(@QueryRequestParam("params")RequestCondition     

        params)

                。。。。。

         

9. @RawResponseBody:

      作用:方法体注解。

      拦截返回值,对于字符串类型的返回值可以原样输出。

      对于List或对象类型的返回值转换为响应的json字符串输出。方便用户封装自定义的格式。

      com.sgcc.uap.rest.annotation.RawResponseBody

      指明方法的返回值应当以原生返回值的形式,绑定到响应体中 ,使用该注解的方法应当返回object。

      使用示例:将方法中返回的字符串原样输出,用于自己拼装返回的格式,不用平台的json转换。

     public @RawResponseBodyObject test()

  return"welcome!";

     

      示例中的方法将字符串”welcome!”原样返回。

11. @VoidResponseBody:

       作用:将空返回值包装为通用的返回格式。

       com.sgcc.uap.rest.annotation.VoidResponseBody

       用于没有特定返回值得方法注解,将对象转换为统一的json串。如:

      

   "successful":true,    ————方法是否调用成功

    "resultHint":"",     ————异常信息

    "resultValue": “”   ————数据信息是空的

      

       例如:删除操作

      public @VoidResponseBody

       Object delete(@IdRequestBodyIDRequestObjectid)

                       。。。。

      

Hibernate实体映射注解支持

平台已经引入了hibernate的注解功能,具体用法与hibernate注解映射相同,

详细用法可参考Hibernate注解映射相关文档。

@Entity

@Table(name= "O_ORG")

publicclass ORG implementsjava.io.Serializable

    @Id

    @GenericGenerator(name="ORG_ID",strategy="uuid")

    @GeneratedValue(generator="ORG_ID")

    @Column(name="ORG_ID")

    public String getId()

        return this.id;

   

   

    public void setId(Stringid)

        this.id = id;

   

以上是关于sg-uap常用注解介绍的主要内容,如果未能解决你的问题,请参考以下文章

Spring注解的实现原理和Spring常用注解介绍

SpringBoot 中常用注解@PathVaribale/@RequestParam/@GetMapping介绍

Spring中常用注解的介绍

[刘阳Java]_Spring常用注解介绍_第6讲

博学谷学习记录超强总结,用心分享 | SpringCache常用注解介绍+集成redis

SpringBoot注解介绍