久久国产精品亚洲综合,色噜噜亚洲精品中文字幕,国产成人人综合亚洲欧美丁香花

JDK5.0 Annotation 入门介绍

Wed, 04 Aug 2010 02:22:00 GMT

背景知识�Q?/font>

从JDK5开始提供名为Annotation�Q�注释）的功能，它被定义为JSR-175规范。注释是�?#8220;@注释�?#8221;在代码中存在的，�q�可以添加一些参数��|��例如�Q�@SuppressWarnings(value="unchecked")。注释可以附加在package, class, method, field�{�上面，相当于给它们��d��了额外的辅助信息�Q�我们可以通过反射机制�~�程实现对这些元数据的访问。如果没有外部解析工��L��对其加以解析和处理的情况�Q�本�w�不会对Java的源代码或class文�g�{��生�Q何媄响，也不会对它们的执行��生�Q何媄响�?/div>

元数据的作用�Q�大致可分�ؓ三种�Q�编写文档，通过代码里标识的元数据生成文档；代码分析�Q�通过代码里标识的元数据对代码�q�行分析�Q�编译检查，通过代码里标识的元数据让�~�译器能实现基本的编译检查�?/div>

JDK5内置的基本注�?/font>

JDK5内置了一些常用的注释�Q�可以在�~�译时帮我们捕获部分�~�译错误�Q�及提示信息�Q�下面介�l�下�q�些注释的用法：

1、@Override定义在java.lang.Override中，此注释只适用于修辞方法，表示一个方法声明打��重写超�c�M��的另一个方法声明。如果方法利用此注释�c�d��q�行注解但没有重写超�c�L��法，则编译器会生成一条错误消息。例如我们�ؓ某类重写toString()�Ҏ��却写成了tostring()�Q��ƈ且我们�ؓ该方法添加了@Override注释�Q�代码如下：

public class OverrideDemo {

@Override

public String tostring() {

return super.toString();

}

在编译时�Q�会提示以下错误信息�Q?/div>

OverrideTest.java:4: �Ҏ��未覆盖其父类的方�?/span>

@Override

^1 错误

2、@Deprecated定义在java.lang.Deprecated中，此注释可用于修辞�Ҏ��、属性、类�Q�表�C�Z��鼓励�E�序员��用这��L��元素�Q�通常是因为它很危险或存在更好的选择。在使用不被赞成的程序元素或在不被赞成的代码中执行重写时�Q�编译器会发��告。��用@Deprecated的示例代码如下：

public class DeprecatedDemo {

public static void main(String[] args) {

DeprecatedClass.DeprecatedMethod();

}

class DeprecatedClass {

@Deprecated

public static void DeprecatedMethod() {

// TODO

}

在编译时�Q�会得到以下提示信息�Q?/div>

注意�Q?/span>DeprecatedDemo.java 使用或覆盖了已过时的 API�?/span>

注意�Q�要了解详细信息�Q�请使用 -Xlint:deprecation 重新�~�译�?/span>

如果在编译时��d��-Xlint:deprecation参数�Q�我们能更清楚的看到该警告的详细信息�Q�如下：

DeprecatedDemo.java:6: 警告�Q?/span>[deprecation] SomeClass 中的 DeprecatedMethod() 已过�?/span>

SomeClass.DeprecatedMethod();

^1 警告

要注意@Deprecated与@deprecated的区别，@deprecated是�ؓ了生成文档的需要，例如�Q?/div>

class DeprecatedClass {

/**

* @deprecated 此方法已�q�时�Q�不��使用

@Deprecated

public static void DeprecatedMethod() {

// TODO

}

3、@SuppressWarnings定义在java.lang.SuppressWarnings中，用来抑制�~�译时的警告信息。与前两个注释有所不同�Q�你需要添加一个参数才能正��用，�q�些参数值都是已�l�定义好了的�Q�我们选择性的使用��好了，参数如下�Q?/div>

参数	说明
deprecation	使用了过时的�c�L��Ҏ��时的警告
unchecked	执行了未��查的转换时的警告�Q�例如当使用集合时没有用泛型 (Generics) 来指定集合保存的�c�d��
fallthrough	�?Switch �E�序块直接通往下一�U�情况而没�?Break 时的警告
path	在类路径、源文�g路径�{�中有不存在的�\径时的警�?/div>
serial	当在可序列化的类上缺��?serialVersionUID 定义时的警告
finally	��M�� finally 子句不能正常完成时的警告
all	关于以上所有情�늚�警告

通过上面的表��|��你应该了解到每个参数的用意了�Q�下面我��׃��一个常用的参数unchecked��Z��Q��ؓ你展�C�如何��用@SuppressWarnings注释�Q�示例代码如下：

import java.util.List;

import java.util.ArrayList;

public class SuppressWarningsDemo {

public static List cache = new ArrayList();

//@SuppressWarnings(value = "unchecked")

public void add(String data) {

cache.add(data);

}

当我们不使用@SuppressWarnings注释�Ӟ��~�译器就会有如下提示�Q?/div>

注意�Q?/span>SuppressWarningsDemo.java 使用了未�l�检查或不安全的操作�?/span>

注意�Q�要了解详细信息�Q�请使用 -Xlint:unchecked 重新�~�译�?/span>

下面我们��L��@SuppressWarnings(value="unchecked")�q�一行的注释�W?#8220;//”�Q�它会屏蔽编译时的警告信息，�q�也��是它所要达到的目的�?/div>

另外�Q�由于@SuppressWarnings注释只有一个参敎ͼ��q�且参数名�ؓvalue�Q�所以我们可以将上面一句注释简写�ؓ@SuppressWarnings("unchecked")�Q?br /> 同时参数value可以取多个值如�Q�@SuppressWarnings(value={"unchecked", "deprecation"})
或@SuppressWarnings({"unchecked", "deprecation"})�?/div>

自定义Annotation注释

1、注释annotation与接口的异同�Q?/div>

因�ؓannotation�c�d��是一个非凡的接口�Q�所以它与接口之间存在着某些差异�Q?/div>

A. Annotation�c�d��使用关键字@interface而不是interface�Q�这个关键字声明隐含了一个信息，它是�l�承了java.lang.annotation.Annotation接口�Q��ƈ非声明了一个interface�?/div>

B. Annotation�c�d��的方法定义是独特的、受限制的，�Ҏ��必须声明为无参数、无异常抛出的。这些方法定义了annotation的成员：�Ҏ��名成��Z��成员名，而方法返回值成��Z��成员的类型。而方法返回值类型必��Mؓprimitive�c�d��、Class�c�d��、枚丄��型、annotation�c�d��或者由前面�c�d��之一作�ؓ元素的一�l�数�l�。方法的后面可以使用default和一个默认数值来声明成员的默认��|��null不能作�ؓ成员默认��|��q�与我们在非annotation�c�d��中定义方法有很大不同�?/div>

C. Annotation�c�d��又与接口有着�q�似之处�Q�它们可以定义常量、静态成员类型（比如枚�D�c�d��定义�Q�。Annotation�c�d��也可以如接口一般被实现或者��ѝ�?/div>

2、自定义注释的实例：

下面�Q�我们将看到如何定义annotation�c�d��的例子。它展示了annotation�c�d��声明以及@interface与interface之间的不同：

import java.lang.annotation.*;

/**
* 使用annotation来描�q�那些被标注的成员是不稳定的�Q�需要更�?/span>
*/
public @interface Unstable {

}

下面的另一个例子只定义了一个成员。�ƈ通过��这个成员命名�ؓvalue�Q��我们可以方便的��用这�U�annotation的快捷声明方式：

/**
* 使用Author�q�个annotation定义在程序中指出代码的作�?/span>
*/
public @interface Author {
/** �q�回作者名 */
String value();
}

以下的例子更加复杂。Reviews annotation�c�d��只有一个成员，但是�q�个成员的类型是复杂的：由Review annotation�l�成的数�l�。Review annotation�c�d��?个成员：枚�D�c�d��成员grade、表�C�Review名称的字�W�串�c�d��成员Reviewer、具有默认值的字符串类型成�?Comment�?/div>

/**
* Reviews annotation�c�d��只有一个成员，
* 但是�q�个成员的类型是复杂的：�?/span>Review annotation�l�成的数�l?/span>
*/
@Retention(RetentionPolicy.RUNTIME)
public @interface Reviews {
Review[] value();
}

/**
* Review annotation�c�d��?/span>3个成员：
* 枚�D�c�d��成员grade�?/span>
* 表示Review名称的字�W�串�c�d��成员Reviewer�?/span>
* ��h��默认值的字符串类型成�?/span>Comment�?/span>
*/
public @interface Review {
    // 内嵌的枚丄��?/span>
     public static enum Grade { EXCELLENT, SATISFACTORY, UNSATISFACTORY };
     // 下面的方法定义了annotation的成�?/span>
    Grade grade();
     String reviewer();
    String comment() default "";
}

最后，我们来定义一个annotation�Ҏ��用于�|�列出类�q�行中所有的unchecked异常。这�?annotation�c�d��一个数�l�作��Z��唯一的成员。数�l�中的每个元素都是异常类。�ؓ了加强对未检查的异常�Q�此�c�d��帔R��是在�q�行时抛出）�q�行报告�Q�我们可以在代码中对异常的类型进行限�Ӟ��

public @interface UncheckedExceptions {
Class[] value();
}

Meta-Annotation�c�d���Q?/span>

Annotation �c�d��可以被它们自己所标注。Java5.0定义�?个标准的meta-annotation�c�d��Q�分别是�Q�Target、Retention、Documented、Inherited�Q�它们被用来提供对其它annotation�c�d��作说明�?�q�些�c�d��和它们所支持的类在java.lang.annotation包中可以扑ֈ��?/div>

@Target的用法：指示注释�c�d��所适用的程序元素的�U�类。如果注释类型声明中不存�?/span> Target 元注释，则声明的�c�d��可以用在��M��E�序元素上。如果存在这��L��元注释，则编译器强制实施指定的��用限制�?/span>例如�Q�以下这个注释只能用来声明方�?/span>�Q?/span>

@Target(ElementType.METHOD)

    public @interface MyAnnotation {

...

java.lang.annotation.ElementType是一个枚丄��型，它具有以下定义：

ElementType�?/span>	说明
ElementType.ANNOTATION_TYPE	应用于注释类型声�?/div>
ElementType.CONSTRUCTOR	构造方法声�?/div>
ElementType.FIELD	应用于字�D�声明（包括枚�D帔R��Q?/div>
ElementType.LOCAL_VARIABLE	应用于局部变量声�?/div>
ElementType.METHOD	应用于方法声�?/div>
ElementType.PACKAGE	应用于包声明
ElementType.PARAMETER	应用于参数声�?/div>
ElementType.TYPE	应用于类、接口（包括注释�c�d��Q�或枚�D声明

@Retention的用�?/span>�Q?/span>指示注释�c�d��的注释要保留多久。如果注释类型声明中不存�?/span> Retention 注释�Q�则保留�{�略默认�?/span> RetentionPolicy.CLASS�Q�例如：

@ Retention(RetentionPolicy.CLASS)

    public @interface MyAnnotation {

...

java.lang.annotation.RetentionPolicy是一个枚丄��型，它具有以下定义：

RetentionPolicy�?/span>	说明
RetentionPolicy.CLASS	�~�译器将把注释记录在�c�L��件中�Q�但在运行时 VM 不需要保留注�?/div>
RetentionPolicy.RUNTIME	�~�译器将把注释记录在�c�L��件中�Q�在�q�行�?VM ��保留注释，因此可以反射性地��d��
RetentionPolicy.SOURCE	�~�译器要丢弃的注�?/div>

@Documented的用法：指示某一�c�d��的注释将通过 javadoc 和类似的默认工具�q�行文档化。应使用此类型来注释�q�些�c�d��的声明：其注释会影响由其客户端注释的元素的��用。如果类型声明是�?/span> Documented 来注释的�Q�则其注释将成�ؓ注释元素的公�?/span> API 的一部分�?/span>Documented是一个没有成员的注释�?/span>

@Inherited的用法：指示注释�c�d��自动被子�cȝ��ѝ�?/span> Inherited�?/span>是一个没有成员的注释�?/span>

注意�Q�如果��?/span>@Inherited注释�c�M��外的��M��事物都是无效的。还要注意，此元注释仅对从超�cȝ��承注释有效；对已实现接口的注释无效�?/span>

�W�七�?/a> 2010-08-04 10:22 发表评论

Fri, 05 Jan 2007 01:22:00 GMT

怎么�?/span> javascript 做数据的格式�?/span>

作者：�?/span> K

我们在项目中都有用过金额数字及日期等数据格式化输出显�C�，比如前面加上“��E”，数值取��数点后两位�Q�短日期旉��{�。一般的高��语言及开发工具都有提供相应的转换函数�?/span> format 之类�Q�可是我在最�q�做 web �|�上银行相关的系�l�时�Q�却遇到�q�个很麻烦的问题�Q�就�?/span> javascript 不提供这�U?/span> format 函数�Q�查了些资料�Q�知�?/span> vbscript 是有格式化函数的�Q�可�?/span> vbscript 是微软专用的�Q�无奈只好用正则表达式，可正则表辑ּ�也不能够很通用地解军_��U�类型�{换问题，真的是很郁闷�Q�无意中扑ֈ�看到一�?/span> AJAX 开发工��L��演示�Q�工具下载地址�?a >点击链接�Q�，看到它的数据有显�C�“��E”和数值小数点后两位格式化�Q�马上下载了看了下，发现它居然是�?/span> javascript+XSL 实现了通用的格式化函数�Q�下�?/span> AJAX WebShop 后，我找到它�?/span> system.js �q�个文�g�Q�打开扑ֈ�以下函数�Q?/span>

function FormatFloat(value,mask)

{

return BasicFormat(value,mask,'FormatNumber')

}

function FormatDate(varDate, bstrFormat, varDestLocale)

{

return BasicFormat(varDate,bstrFormat,'FormatDate',varDestLocale);

}

function FormatTime(varTime, bstrFormat, varDestLocale)

{

return BasicFormat(varTime,bstrFormat,'FormatTime',varDestLocale);

}

function BasicFormat(value,mask,action,param)

{

var xmlDoc;

var xslDoc;

var v=''+value+''+mask+'';

xmlDoc=parseXML(v);

var x;

if(isIE)

x=''

else

x='';

x+='';

if(isIE) {

x+=''+action+'('+value+',"'+mask+'"';

if(param)x+=','+param;

x+=')';

}

else

x+='';

xslDoc=parseXML(x);

var s;

if(isIE)

s= xmlDoc.transformNode(xslDoc)

else{

//for mozilla/netscape

var processor = new XSLTProcessor();

processor.importStylesheet(xslDoc);

var result = processor.transformToFragment(xmlDoc, xmlDoc);

var xmls = new XMLSerializer();

s = xmls.serializeToString(result);

}

return s;

}

看来他们�?/span> xsl 用得可真是出��入化了�Q�居然这样就可以实现很通用的格式化转换了，当然不客气了�Q�直接加到我的函数库中哈�?/span>

�q�个代码偶没有看得很懂，不过��实很管用，请对 XSL �_�N��的朋友分析下也好让我们学习下�?/span>

�W�七�?/a> 2007-01-05 09:22 发表评论