相信不少人在学习Java注解这部分知识的时候,都会有一个疑问,注解对于我们实际的开发究竟有什么用!
关于注解的基本原理和自定义注解的使用网上有很多例子,所以我想分享注解的一个实际应用场景,即注解究竟可以帮助我们做什么。
在日常的软件开发过程中,为了实现复杂的业务逻辑,我们经常会维护许多结构复杂的表并且在Java应用程序中建立与表一一对应的实体类来使用库中的数据。假设有这样一张表 “exampleTable”,如下是其表结构:......代表更多字段
ecom_item_key bigint
ecom_item_id string
......
ecom_site_id string
在相应的Java代码中,我们应该有对应于这张表的一个实体类public class exampleTable,类信息为
@Data自动生成getter,setter方法,减少代码量
@Data
public class d_ecom_item implements Serializable {
private String ecom_item_key;
private String ecom_item_id;
......
private String ecom_site_id;
public static d_ecom_item get(Row row){
d_ecom_item item =new d_ecom_item();
item.setEcom_item_key(row.getAs("ecom_item_key").toString());
item.setEcom_item_id(row.getAs("ecom_item_id"));
......
item.setEcom_site_id(row.getAs("ecom_site_id"));
return item;
}
public static d_ecom_item get(Row row)是一个获取表中信息装载实体类的方法。但是,该方法现在的设计有俩个明显的缺点,1,在软件开发过程中,对数据库的字段增加,减少是经常发生的事情,这时为了适应表结构的修改,我们需要经常修改类字段和该方法 2.有时新的需求会要求我们对字段做一个特殊处理,即添加一个方法。为了应对上面的困难,现在我们重构代码,修改后的代码如下
public static DEcomItem get(Row row){
DEcomItem entity=new DEcomItem();
try{
Class clazz = entity.getClass();
Field[]fields =clazz.getDeclaredFields();
for(Field field :fields){
String fieldStr =field.getName();
Method method =clazz.getMethod("set" +fieldStr.substring(0,1).toUpperCase() +fieldStr.substring(1),field.getType());
if(row.getAs(fieldStr)!=null){
String value = row.getAs(fieldStr).toString();
ImageAnnotation annotation =field.getAnnotation(ImageAnnotation.class);
if(annotation!=null){
String annotationValue =annotation.value();
String []array =annotationValue.split("#");
if(array.length>1){
String className =array[0];
String functionName =array[1];
Method utilMethod =Class.forName(className).getMethod(functionName,String.class);
method.invoke(entity,utilMethod.invoke(null,value));
}
}else{
method.invoke(entity,value);
}
}
}
}catch (Exception e){
e.printStackTrace();
}
return entity;
}
重构代码主要做了俩点修改:
(1)使用反射获取实体类字段和方法,将数据库中获取到的数据装载到实体对象。这样的话,哪怕将来字段继续增加,或减少,我们都不需要修改该方法。只需要修改类字段就可以。解决困难1/
(2)添加了处理字段含有注解的逻辑,这样的话,当我们需要为某个字段添加特殊处理的方法时,我们只需要在该字段上添加一个自定义注解,注解的值就是“com.taobao.entityutil.util#handlestr”,#前面是类名,后面是添加的方法。
通过上面的修改,代码的重用性大大提升,代码量也减少了。