12568人阅读
Java Web（58）
& & & &&使用注解来配置Action可以实现零配置，零配置将从基于纯XML的配置转化为基于注解的配置。使用注解，可以在大多数情况下避免使用struts.xml文件来进行配置。
& & & &struts2框架提供了四个与Action相关的注解类型，分别为ParentPackage、Namespace、Result和Action。
& & & &ParentPackage:ParentPackage注解用于指定Action所在的包要继承的父包。该注解只有一个value参数。用于指定要继承的父包。示例：
使用ParentPackage注解，其value值为mypackage,表示所在的Action需要继承mypackage包，
@ParentPackage(value=&mypackage&)
public class UserAction extends ActionSupport{
如果注解中只有一个value参数值，或者其他参数值都使用默认值时，则可以对value参数设置进行简写，比如上述的代码：
@ParentPackage(&mypackage&)
public class UserAction extends ActionSupport{
}把struts2-convention-pligin-2.x.x.jar包导入到web应用中，才能在Action类中使用注解。
& & & &Namespace：Namespace注解用于指定Action所在的包的命名空间。该注解只有一个value参数，用于指定ACtion所属于的命名空间。
当使用Namespace注解时，在为命名空间取名需要使用斜杠（/）开头。
使用Namespace注解，指定其Action所在的包的命名空间为/user：
@Namespace(&/user&)
public class UserAction extends ActionSupport{
}& & & &Result：Result注解用于定义一个Result映射，该注解包含四个参数，
1）name:可选参数，用于指定Result的逻辑名，默认值为success
2）location：必选参数，用于指定Result对应资源的URL
3）type：可选参数，用于指定Result的类型，默认值为NullResult.class
4）params:可选参数，用于为Result指定要传递的参数，格式为：{key1,value1,key2,value2,...}
如果type参数的值为NullResult.class,那么struts2框架在解析Result配置时，会使用默认的结果类型（即ServletDispatcherResult）来替换NullResult。
@Result(name=&login&,location=&/login.jsp&,params={},type=&dispatcher&)
public class UserAction extends ActionSupport{
}& & & & &Action：Action注解对应于struts.xml文件中的action元素。该注解可用于Action类上，也可用于方法上。这个注解包含一下的几个属性：
&1）value：可选参数，表示Action的名字
2）results：可选参数，表示Action的多个Result映射。该属性用于定义一组Result映射
3）interceptorRefs:可选参数，表示Action的多个拦截器。该属性用于定义一组拦截器
4）params：可选参数，表示传递给Action的参数，格式为{key1,value1,key2,value2,...}
5)exceptionMappings：可选参数，指定Action的异常处理类，他是一个Exception-Mapping的数组属性
value=&user&,
interceptorRefs = {
@InterceptorRefs(value=&fileUpload&,params={&maximumSize&,&1024000&,&allowedTypes&,image/123}),
@InterceptorRefs(value = &basicStack&)
results = {
@Result(name=&success&,location=&success.jsp&),
@Result(name=&login&,location=&login.jsp&)
exceptionMappings = {
@ExceptionMapping(exception=&java.lang.Exception&,result=&error&)
public class UserAction extends ActionSupport{
&&相关文章推荐
* 以上用户言论只代表其个人观点，不代表CSDN网站的观点或立场
访问：330113次
积分：7192
积分：7192
排名：第3216名
原创：391篇
转载：20篇
评论：62条
文章：32篇
阅读：121149
文章：27篇
阅读：21773
文章：37篇
阅读：16417
文章：28篇
阅读：23840
(1)(1)(1)(5)(2)(4)(12)(7)(6)(20)(12)(12)(15)(6)(9)(8)(58)(9)(5)(5)(16)(20)(9)(13)(14)(10)(3)(6)(18)(34)(27)(5)(16)(22)
(window.slotbydup = window.slotbydup || []).push({
id: '4740881',
container: s,
size: '200,200',
display: 'inlay-fix'给包加javadoc注释
&& 翻看以前的笔记，看到一个特殊的java文件：pacakge-info.java，虽然有记录，但是不全，就尝试着追踪一下该问题，
分享一下流水账式的结果。
首先，它不能随便被创建。在Eclipse中，&package-info文件不能随便被创建，会报“Type
name is notvalid”错误，类名无效，Java变量定义规范是：字母、数字、下划线，还有那个不怎么常用的$符号（顺带说下，Java是支持中文名称的变量，习惯挑战的同学可以尝试下，分享一下这方面的经验），这个中划线可不再之列，那怎么创建这个文件呢？
很简单，用记事本创建一个，然后拷贝进去再改一下就成了，更直接的办法就是从别的项目中拷贝过来一个，这更方便。
&&&&其次，服务的对象很特殊。一个类是一类或一组事物的描述，比如Dog这个类，就是描述旺财的，那package-info这个类是描述啥的呢？它总要有一个被描述或被陈述的对象，它是描述和记录本包信息。
&&&&最后，类不能带有public、private访问权限。package-info.java再怎么特殊，也是一个类文件，也会被编译成package-info.class，但是在package-info.java中只能声明默认访问权限的类，也就是友好类。
其实还有几个特殊的地方，比如不可以继承，没有接口，没有类间关系（关联、组合、聚合等等）等。
这个文件的特殊性说完了，那再说说它有什么作用，它有三个作用：
1、为标注在包上Annotation提供便利；
2、声明友好类和包常量；
3、提供包的整体注释说明。
&我们来建立一个项目演示这三个作用，建立一个package-info的Java
Project，在pany包三个类:package-info.java是我们重点关注的，PkgAnnotation.java是一个标注在包上的注解定义，Client.java模拟业务操作类。其结构如下图：
为标注在包上Annotation提供便利
首先定义一个包类型的注解，它只能放置的一个包上：
Java代码&&
@Target(ElementType.PACKAGE)&&
@Retention(RetentionPolicy.RUNTIME)&&
public&@interface&PkgAnnotation&{&&
&&再定义一个package-info类，这个是一个特殊的类，先看代码：
Java代码&&
@PkgAnnotation&&
package&<&&
&&很简单，就这么个文件，里面啥都没有，就这两句话，没有class类，没有常变量声明。接着写一个模拟交易类，代码如下：
Java代码&&
public&class&Client&{&&&&&
&&&&public&static&void&main(String[]&args)&{&&
&&&&&&&&//可以通过I/O操作或配置项获得包名&&
&&&&&&&&String&pkgName&=&"pany";&&&&&&&
&&&&&&&&Package&pkg&=&Package.getPackage(pkgName);&&
&&&&&&&&//获得包上的注解&&
&&&&&&&&Annotation[]&annotations&=&pkg.getAnnotations();&&
&&&&&&&&//遍历注解数组&&
&&&&&&&&for(Annotation&an:annotations){&&
&&&&&&&&&&&&if(an&instanceof&PkgAnnotation){&&
&&&&&&&&&&&&&&&&System.out.println("Hi,I'm&the&PkgAnnotation&,which&is&be&placed&on&package!");&&
&&&&&&&&&&&&&&&&&&&&&&&&&&&
&&&&&&&&&&&&}&&
&&&&&&&&}&&
&&运行结果如下所示：
Hi,I'm the
PkgAnnotation ,which is be placed on package!
声明友好类和包常量
&&这个比较简单，而且很实用，比如一个包中有很多的内部访问的类或常量，就可以统一的放到package-info类中，这样就方便，而且集中管理，减少friendly类到处游走的情况，看例子：
Java代码&&
@PkgAnnotation&&
package&<&&
&//这里是包类，声明一个包使用的公共类，强调的是包访问权限&&
class&PkgClass{&&
&&&&public&void&test(){&&
//包常量，只运行包内访问，适用于分“包”开发&&
class&PkgConst{&&
&&&&static&final&String&PACAKGE_CONST="ABC";&&
&&提供包的整体注释说明
&&如果是分“包”开发，也就是说一个包实现一个业务逻辑或功能点、或模块、或组件，则需要对一个包有很好的说明，说明这个包是干啥的，有啥作用，版本变迁，特别说明等等，如下：
Java代码&&
package&<&&
&&通过javadoc生成的API文档如下：
&&这与包下放置package.htm没啥区别，只是package-info可以更好的在代码中维护文档的完整性，并且可以实现代码与文档同步更新，package.htm也可以做到，不争论，建议是Java
1.5以上版本都使用package-info.java来注释。
&&与package-info相关的问题
&&在项目开发中，可以放置在包上的常用注解有：Struts的@namespace、Hibernate的@FilterDef和@TypeDef等等。在包下，随便一个类中的包名前加这些注解，Eclipse会提示“Package
annotations must be in file package-info.java”,在该包下建立package-info.java文件，把注解移到这里即可。
&使用Checkstyle插件做代码检查时，会报一个警告“Missing
package-info.java file.”也是这个package-info文件惹的祸，在各个包下创建一个即可。
为包添加上注释可以使我们清楚的知道这个包的作用，能够更加清晰的知道包中的核心问题所在，所以添加包注释很重要。
Eclipse 中在添加java文件时，是不允许添加Name
为package-info的java文件的。但我们可以通过向导创建一个普通的File文件，然后将其文件名命名为package-info.java.
==================================
/thread-.html
===============================
设置Eclipse代码模板
eclipse菜单:
window-&preferences，展开java-&editor-&templates,新建一个javadoc类型的模板：
name设置为：package
context选择：javadoc
pattern输入：
xxx实现&a href="#" target="_blank"&a name&/a&. * &p& * &h1&detail1:&/h1& * &img src="doc-files/test.png"/& * * @author &a href="mailto:skzr."&skzr.org&/a& * @since JDK1.6 * @version 1.0.0
开发中使用
在你想要创建包注释的包下建立文件:package-info.java文件：
package org.skzr.
在第二行输入:"packa"按atl+/调出前面设置的模板，然后输入自己感兴趣的即可，最终效果如下：
/** * slf4j本地化日志扩展实现&a href="/p/slf4j-local" target="_blank"&
已投稿到：
以上网友发言只代表其个人观点，不代表新浪网的观点或立场。Groovy（Java笨狗）系列---注释，语法，包导入机制 - Leo.Tao - ITeye博客
博客分类：
学习一门新的编程语言，就像学习一门新的外语。你必须面对新的词汇量，语法，方言。而Groovy能和Java无缝的结合在一起，Java能调用Groovy,Groovy能调用Java,而且语法上是类似而友好的，这为你学习Groovy无疑平滑的。那么现在我们就开始Groovy的学习吧。Commenting Groovy code单行注释和多行注释就和Java一样，唯一不同的是Groovy多了一个首行注释。#!/usr/bin/groovy（首行注释，必须出现在第一行）
// some line comment（单行注释）
（多行注释）
some multiline
*/ 一些指导方针来书写注释.■
#! 注释只允许出现在第一行 ，允许Unix shells 定位 Groovy bootstrap script
通过它来运行代码■ // 单行注释■/* … */ 多行注释.■ /** … */ Javadoc，Groovydoc注释。一些Groovy代码--但不完全是--看上去完全像Java代码。这经常导致一些错误的结论---Groovy语法是Java语法的扩展子集。尽管类似，但他们谁也不是谁的子集。例如，Groovy不支持Java中的for(inc)相对于稍微的不同，其实Java的绝大部分语法是Groovy语法的一部分：■ 普通的包导入机制■ Statements (i包括 package and import 语句)■ Class and method 定义 (除了嵌套Class)■ 控制结构 (除了for(inc) )■ 操作符, 表达式, and 赋值■ 异常处理■ 字符声明 ■ 对象实例化, 应用， 解除对象, 方法调用Groovy增加的语法部分，这些添加的部分是Groovy代码更简洁易懂■ 通过新的表达式和操作符更加容易的访问对象■ 允许更多的方法声明对象■ 提供新的控制结构使用高级流控制■ 引入新的数据类型与表达式和操作符一起工作■Groovy中的一切都是对象通过简洁让语法更美好Groovy允许你省略掉一些Java中必须的语法。省略这些使语法更简洁，不冗长，更具有表达力，例如：Java:
java.net.URLEncoder.encode("a b"); Groovy:
URLEncoder.encode 'a b' 上面的代码不单是简洁了，而且更直接的方式的表达了我们的意思，省略了包导入机制，圆括号，分号。代码最小化了。然而，这可能对我们习惯使用Java语法的人来说，直觉上有点不舒服（也有可能产生语法上的误解，比如优先机制），而Groovy看出了我们的心思，上面这些都是可选的，意思就是，你可以使用或者不使用。Groovy自动导入下面的类包：groovy.lang.*groovy.util.*java.lang.*java.util.*java.net.*java.io.*java.math.BigIntegerjava.math.BigDecimal这样你可以使用这些包，而不用再去导入了。
Javabengou
浏览: 130049 次
来自: 郴州
很好的，如果可以，希望分享一下详细过程，谢谢
汗 这错别字多的...终于面试了下载抵制
什么时候有中文文档呀
现在从办公室调到建行新开的营业厅所以比较忙没时间做，如果谁想接 ...
现在出了吗?