关于JAVA注解的一个例子

大部分头次接触注解的人，应该都是从框架开始的吧，之前感觉注解很神秘，也没有了解过如何基于注解的开发，最近忙里偷闲，学习了一下注解的原理及应用。简单地说，注解就是在类、字段、方法上打一个标记，在之后的代码中，可以通过反射获取到被打上标记的类、字段、方法，方便做一些逻辑处理，而这些处理内容是你自己编写的，所以注解提供的仅仅是一个标记而已，下面贴上一个注解的应用，场景是通过jdbc获取数据库中的行数据Map<String,String>,将该Map转换为相应的POJO

首先是注解的声明，

import java.lang.annotation.ElementType;
import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;
import java.lang.annotation.Target;

@Retention(RetentionPolicy.RUNTIME)
@Target(ElementType.FIELD)
public @interface Column {

	String name();
}

这里name为该注解的属性，使用时按照格式：@Column(name="xxx")

public class UserDO {
	
	@Column(name = "name")
	private String userName;
	
	@Column(name = "title")
	private String userTitle;
	
	private int loginTimes;
	
	private String empId;

	public String getUserName() {
		return userName;
	}

	public void setUserName(String userName) {
		this.userName = userName;
	}

	public String getUserTitle() {
		return userTitle;
	}

	public void setUserTitle(String userTitle) {
		this.userTitle = userTitle;
	}

	public int getLoginTimes() {
		return loginTimes;
	}

	public void setLoginTimes(int loginTimes) {
		this.loginTimes = loginTimes;
	}

	public String getEmpId() {
		return empId;
	}

	public void setEmpId(String empId) {
		this.empId = empId;
	}
}

之后是POJO，只有2个属性被打上了注解。

import java.lang.reflect.Field;
import java.lang.reflect.Modifier;
import java.util.ArrayList;
import java.util.HashSet;
import java.util.List;
import java.util.Map;
import java.util.Set;

import org.apache.commons.lang.StringUtils;

public class ConvertionService {

	private static List<Field> findFields(Class <?>clazz) {
		List<Field> fieldList = new ArrayList<Field>();
		Set<String>fieldNames = new HashSet<String>();
        Class <?>clazzTemp = clazz;
        while(clazzTemp != Object.class) {
        	Field []fields = clazzTemp.getDeclaredFields();
        	for(Field field : fields) {
        		if(!fieldNames.contains(field.getName())) {//同名属性子类覆盖
        			fieldList.add(field);
        			fieldNames.add(field.getName());
        		}
        	}
            clazzTemp = clazzTemp.getSuperclass();
        }
        return fieldList;
	}
	
	@SuppressWarnings("unchecked")
	public static <T> T convertMapToBean(Map<String , String>row , Class<T>clazz) 
				throws InstantiationException, IllegalAccessException {
		Object object = clazz.newInstance();
		List<Field>list = findFields(clazz);
		for(Field field : list) {
			if (!Modifier.isStatic(field.getModifiers()) && !Modifier.isFinal(field.getModifiers())) {//过滤static和final修饰的变量
				if(!field.isAccessible()) field.setAccessible(true);//如果是private变量，放开访问的权限
				Column columnAnnotation = field.getAnnotation(Column.class);
				if(columnAnnotation != null) {
					String value = row.get(columnAnnotation.name());//通过annotation注解的名称来获取对应的值
					Class <?>fieldType = field.getType();
					if(fieldType == String.class) {
						field.set(object, value);
					}else if(fieldType == Integer.class) {
						field.set(object, getInteger(value));
					}else if(fieldType == int.class) {
						field.setInt(object, getInt(value));
					}else if(fieldType == Long.class) {
						field.set(object, getLongWrapper(value));
					}else if(fieldType == long.class) {
						field.setLong(object , getLong(value));
					}/*
						继续的数据类型大家可以自己补充
					*/
				}else {
					/*没有annotation的代码交给大家自己去完成了*/
				}
			}
		}
		return (T)object;
	}
	
	public static Integer getInteger(String value) {
        if (StringUtils.isEmpty(value)) return null;
        return Integer.valueOf(value);
    }

    public static int getInt(String value) {
        if (StringUtils.isEmpty(value)) return 0;
        return Integer.valueOf(value);
    }

    public static Long getLongWrapper(String value) {
        if (StringUtils.isEmpty(value)) return null;
        return Long.valueOf(value);
    }

    public static long getLong(String value) {
        if (StringUtils.isEmpty(value)) return 0;
        return Long.valueOf(value);
    }
}

通过注解及反射，将Map<String,String>转化为相应的POJO的方法

import java.util.ArrayList;
import java.util.Arrays;
import java.util.HashMap;
import java.util.List;

public class TestMain {

	public static void main(String []args)
			throws InstantiationException, IllegalAccessException {
		@SuppressWarnings({ "unchecked", "serial" })
		List<HashMap<String , String>>list = Arrays.asList(
				new HashMap<String , String>() {
					{
						put("name" , "xieyuooo");
						put("title" , "小胖");
					}
				},
				new HashMap<String , String>() {
					{
						put("name" , "ffff");
						put("title" , "标题2");
					}
				}
		);
		List<UserDO>users = new ArrayList<UserDO>(list.size());
		for(HashMap<String , String> row : list) {
			users.add(ConvertionService.convertMapToBean(row, UserDO.class));
		}
		System.out.println();
		//这里大家可以将users的列表进行输出
	}
}

测试类的入口方法