package test;
import java.awt.Dimension;
import java.awt.Rectangle;
import java.awt.Robot;
import java.awt.Toolkit;
import java.awt.image.BufferedImage;
import java.io.File;
import javax.imageio.ImageIO;
public class GuiCamera {
private String fileName; // 文件的前缀
private String defaultName = "GuiCamera";
static int serialNum = 0;
private String imageFormat; // 图像文件的格式
private String defaultImageFormat = "png";
Dimension d = Toolkit.getDefaultToolkit().getScreenSize();
public GuiCamera() {
fileName = defaultName;
imageFormat = defaultImageFormat;
}
public GuiCamera(String s, String format) {
fileName = s;
imageFormat = format;
}
public void snapShot() {
try {
// 拷贝屏幕到一个BufferedImage对象screenshot
BufferedImage screenshot = (new Robot())
.createScreenCapture(new Rectangle(0, 0,
(int) d.getWidth(), (int) d.getHeight()));
serialNum++;
// 根据文件前缀变量和文件格式变量,自动生成文件名
String name = fileName + String.valueOf(serialNum) + "."
+ imageFormat;
File f = new File(name);
System.out.print("Save File " + name);
// 将screenshot对象写入图像文件
ImageIO.write(screenshot, imageFormat, f);
System.out.print("..Finished!\n");
} catch (Exception ex) {
System.out.println(ex);
}
}
public static void main(String[] args) {
GuiCamera cam = new GuiCamera("d:\\Hello", "png");//
cam.snapShot();
}
}
一、什么是java注解
注解,顾名思义,注解,就是对某一事物进行添加注释说明,会存放一些信息,这些信息可能对以后某个时段来说是很有用处的。
Java注解又叫java标注,java提供了一套机制,使得我们可以对方法、类、参数、包、域以及变量等添加标准(即附上某些信息)。且在以后某个时段通过反射将标注的信息提取出来以供使用。
二、自定义Java标注
1 为什么要自定义注解
Java从1.5版本以后默认内置三个标注:
Ø @Override:只能用在方法之上的,用来告诉别人这一个方法是改写父类的。
Ø @Deprecated:建议别人不要使用旧的API的时候用的,编译的时候会用产生警告信息,可以设定在程序里的所有的元素上.
Ø @SuppressWarnings:这一个类型可以来暂时把一些警告信息消息关闭.
但是,仅仅这三个标注是不能满足我们开发时一些需求的。所以java允许我们自定义注解来使用。
2 如何自定义注解
自定义步骤大致分为两步:
1, 通过@interface关键字(注意,不是interface,是@interace)声明注解名称,以及注解的成员属性或者叫做注解的参数。
2, 使用java内置的四个元注解对这个自定义标注的功能和范围进行一些限制
问题来了,什么是元注解?
3 什么是元注解
元注解,就是定义注解的注解,也就是说这些元注解是的作用就是专门用来约束其它注解的注解。请区别上面那三个注解,他们也是通过元注解定义而来的。
元注解有哪些呢,主要有四个@Target,@Retention,@Documented,@Inherited?
1. * 元注解有:@Target,@Retention,@Documented,@Inherited
2. *
3. * @Target 表示该注解用于什么地方,可能的 ElemenetType 参数包括:
4. * ElemenetType.CONSTRUCTOR 构造器声明
5. * ElemenetType.FIELD 域声明(包括 enum 实例)
6. * ElemenetType.LOCAL_VARIABLE 局部变量声明
7. * ElemenetType.METHOD 方法声明
8. * ElemenetType.PACKAGE 包声明
9. * ElemenetType.PARAMETER 参数声明
10. * ElemenetType.TYPE 类,接口(包括注解类型)或enum声明
11. *
12. * @Retention 表示在什么级别保存该注解信息。可选的 RetentionPolicy 参数包括:
13. * RetentionPolicy.SOURCE 注解将被编译器丢弃
14. * RetentionPolicy.CLASS 注解在class文件中可用,但会被VM丢弃
15. * RetentionPolicy.RUNTIME VM将在运行期也保留注释,因此可以通过反射机制读取注解的信息。
16. *
17. * @Documented 将此注解包含在 javadoc 中
18. *
19. * @Inherited 允许子类继承父类中的注解
4 自定义及使用注解示例
自定义一个类级别的标注Description
package lighter.javaeye.com;
import java.lang.annotation.Documented;
import java.lang.annotation.ElementType;
import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;
import java.lang.annotation.Target;
@Target(ElementType.TYPE)//这个标注应用于类
@Retention(RetentionPolicy.RUNTIME)//标注会一直保留到运行时
@Documented//将此注解包含在javadoc中
public @interface Description {
String value();
}
再定义个方法级别的注解Name
package lighter.javaeye.com;
import java.lang.annotation.Documented;
import java.lang.annotation.ElementType;
import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;
import java.lang.annotation.Target;
//注意这里的@Target与@Description里的不同,参数成员也不同
@Target(ElementType.METHOD)
@Retention(RetentionPolicy.RUNTIME)
@Documented
public @interface Name {
String originate();
String community();
}
然后使用以上两个注解
package lighter.javaeye.com;
@Description(value="javaeye,做最棒的软件开发交流社区")
public class JavaEyer {
@Name(originate="创始人:robbin",community="javaEye")
public String getName()
{
return null;
}
@Name(originate="创始人:江南白衣",community="springside")
public String getName2()
{
return "借用两位的id一用,写这一个例子,请见谅!";
}
}
说明:其中标注“@Description(value="javaeye,做最棒的软件开发交流社区")”,可以写成“@Description("javaeye,做最棒的软件开发交流社区") ”,结果也是一样的。因为Description标注定义的时候其参数(或者说属性)为value。而value比较特殊,它在被指定参数的时候可以不用显示的写出来。当然如果定义的时候参数名不是value而是其它的比如des,那么使用注解的时候,必须显示写出参数名,然后再赋值:@Description(Des=”xxx”)
提取出注解的信息
package lighter.javaeye.com;
import java.lang.reflect.Method;
import java.util.HashSet;
import java.util.Set;
public class TestAnnotation {
/**
* author lighter
* 说明:具体关天Annotation的API的用法请参见javaDoc文档
*/
public static void main(String[] args) throws Exception {
String CLASS_NAME = "lighter.javaeye.com.JavaEyer";
Class test = Class.forName(CLASS_NAME);
Method[] method = test.getMethods();
boolean flag = test.isAnnotationPresent(Description.class);
if(flag)
{
Description des = (Description)test.getAnnotation(Description.class);
System.out.println("描述:"+des.value());
System.out.println("-----------------");
}
//把JavaEyer这一类有利用到@Name的全部方法保存到Set中去
Set<Method> set = new HashSet<Method>();
for(int i=0;i<method.length;i++)
{
boolean otherFlag = method[i].isAnnotationPresent(Name.class);
if(otherFlag) set.add(method[i]);
}
for(Method m: set)
{
Name name = m.getAnnotation(Name.class);
System.out.println(name.originate());
System.out.println("创建的社区:"+name.community());
}
}
}
注意事项:
所有的Annotation会自动继承java.lang.annotation这一个接口,所以不能再去继承别的类或是接口.
最重要的一点,Annotation类型里面的参数该怎么设定:
第一,只能用public或默认(default)这两个访问权修饰.例如,String value();这里把方法设为defaul默认类型.
第二,参数成员只能用基本类型byte,short,char,int,long,float,double,boolean八种基本数据类型和String,Enum,Class,annotations等数据类型,以及这一些类型的数组.例如,String value();这里的参数成员就为String.
1 package com.ljq.test; 2 3 import java.lang.annotation.ElementType; 4 import java.lang.annotation.Retention; 5 import java.lang.annotation.RetentionPolicy; 6 import java.lang.annotation.Target; 7 8 /** 9 * 定义一个注解 10 * 11 * 12 * @author jiqinlin 13 * 14 */ 15 // Java中提供了四种元注解,专门负责注解其他的注解,分别如下 16 17 // @Retention元注解,表示需要在什么级别保存该注释信息(生命周期)。可选的RetentionPoicy参数包括: 18 // RetentionPolicy.SOURCE: 停留在java源文件,编译器被丢掉 19 // RetentionPolicy.CLASS:停留在class文件中,但会被VM丢弃(默认) 20 // RetentionPolicy.RUNTIME:内存中的字节码,VM将在运行时也保留注解,因此可以通过反射机制读取注解的信息 21 22 // @Target元注解,默认值为任何元素,表示该注解用于什么地方。可用的ElementType参数包括 23 // ElementType.CONSTRUCTOR: 构造器声明 24 // ElementType.FIELD: 成员变量、对象、属性(包括enum实例) 25 // ElementType.LOCAL_VARIABLE: 局部变量声明 26 // ElementType.METHOD: 方法声明 27 // ElementType.PACKAGE: 包声明 28 // ElementType.PARAMETER: 参数声明 29 // ElementType.TYPE: 类、接口(包括注解类型)或enum声明 30 31 // @Documented将注解包含在JavaDoc中 32 33 // @Inheried允许子类继承父类中的注解 34 35 36 @Retention(RetentionPolicy.RUNTIME) 37 @Target({ElementType.METHOD, ElementType.TYPE}) 38 public @ interface MyAnnotation { 39 // 为注解添加属性 40 String color(); 41 String value() default " 我是林计钦 " ; // 为属性提供默认值 42 int [] array() default { 1 , 2 , 3 }; 43 Gender gender() default Gender.MAN; // 添加一个枚举 44 MetaAnnotation metaAnnotation() default @MetaAnnotation(birthday = " 我的出身日期为1988-2-18 " ); 45 // 添加枚举属性 46 47 }
1 package com.ljq.test; 2 3 /** 4 * 注解测试类 5 * 6 * 7 * @author jiqinlin 8 * 9 */ 10 // 调用注解并赋值 11 @MyAnnotation(metaAnnotation = @MetaAnnotation(birthday = " 我的出身日期为1988-2-18 " ),color = " red " , array = { 23 , 26 }) 12 public class AnnotationTest { 13 14 public static void main(String[] args) { 15 // 检查类AnnotationTest是否含有@MyAnnotation注解 16 if (AnnotationTest. class .isAnnotationPresent(MyAnnotation. class )){ 17 // 若存在就获取注解 18 MyAnnotation annotation = (MyAnnotation)AnnotationTest. class .getAnnotation(MyAnnotation. class ); 19 System.out.println(annotation); 20 // 获取注解属性 21 System.out.println(annotation.color()); 22 System.out.println(annotation.value()); 23 // 数组 24 int [] arrs = annotation.array(); 25 for ( int arr:arrs){ 26 System.out.println(arr); 27 } 28 // 枚举 29 Gender gender = annotation.gender(); 30 System.out.println( " 性别为: " + gender); 31 // 获取注解属性 32 MetaAnnotation meta = annotation.metaAnnotation(); 33 System.out.println(meta.birthday()); 34 } 35 } 36 }
1 package com.ljq.test; 2 /** 3 * 枚举,模拟注解中添加枚举属性 4 * 5 * @author jiqinlin 6 * 7 */ 8 public enum Gender { 9 MAN{ 10 public String getName(){ return " 男 " ;} 11 }, 12 WOMEN{ 13 public String getName(){ return " 女 " ;} 14 }; // 记得有“;” 15 public abstract String getName(); 16 }
1 package com.ljq.test; 2 3 /** 4 * 定义一个注解,模拟注解中添加注解属性 5 * 6 * @author jiqinlin 7 * 8 */ 9 public @ interface MetaAnnotation { 10 String birthday(); 11 }