[转载]Java学习总结（Java源文件、JavaDoc文档）
一、Java源文件
1、一个Java应用包含一个或多个Java源文件，每个Java源文件只能包含下列内容(空格和注释除外)
l 零个或一个包声明语句
l 零个或多个包引入语句
l 零个或多个类声明语句
l 零个或多个接口声明
2、每个Java源文件可包含多个类或接口的定义，但是至多只有一个类或者接口是public的，而且Java源文件必须以其中public类型的名字命名。
3、包声明语句用于把Java类放到特定的包中。在一个Java源文件中，最多只能有一个package语句，但package语句不是必需的。如果没有提供package语句，就表明Java类位于默认包中，默认包没有名字。
声明形式：
package 包名;
4、package语句必须位于Java源文件的第一行(忽略注释行)。并且在同一个Java源文件中定义的多个Java类或接口都位于同一个包中。
5、关于包引入的几个注意事项：
l import语句不会导致类的初始化
l 如果一个类同时引用了两个来自于不同包的同名类，在程序中必须通过类的完整类名来区分这两个类。
l 每个包都是独立的，顶层包不会包含子包中的类。
l package和import语句的顺序是固定的，在Java源文件中，package语句必须位于第一行(忽略注释行)，其次是import语句，接着才是类或接口的声明。
6、作为程序入口的main方法，必须是 public static void main(String[] args){…}
7、static修饰的方法默认都是final类型的(不能被子类覆盖)。所以在main方法前加上final也是可以的。
二、JavaDoc文档
Java比C++多了一种注释，即：/**text*/——从“/**”到“*/”之间的所有字符会被编译器忽略。
当这类注释出现在任何声明(如类的声明、接口声明、类的成员变量的声明、类的成员方法的声明或者类的构造方法声明)之前时，会作为JavaDoc文档的内容。而在其他地方使用这种声明，不会出现在JavaDoc文档中。
以下为搜集到的JavaDoc标记的使用方法：
Javadoc注释编写细则
-------------------------------------------------------------------------------------------------------------------------------------------------------
一.Java 文档
// 注释一行
/* ...... */ 注释若干行
/** ...... */ 注释若干行，并写入 javadoc 文档
通常这种注释的多行写法如下：
/**
* .........
* .........
*/
javadoc -d 文档存放目录 -author -version 源文件名.java
这条命令编译一个名为 “源文件名.java”的 java 源
相关文档：
java接口实例
2009-03-10 09:00:18.0 来源:中国JAVA技术网
关键词： java 接口 码
近日在编程中用到接口知识,由于课本中对接口描述较少,所以想从网上查找资料,但网上的资料大多也只是冗长的描述,所以� ......
作者:cleverpig(作者的Blog:http://blog.matrix.org.cn/page/cleverpig
)
原文:http://www.matrix.org.cn/resource/article/44/44055_Java+Annotation+Reflect.html
关键字:java,annotation,reflect
阅读提示：文中提到的程序成员或者程序元素是一个概念，指组成程序代码的单元：如类、方法、成员变量。
一、Annotatio ......
/**
* 对图片裁剪，并把裁剪完蛋新图片保存 。
*
* @param srcpath: 被裁减的图片完整路径
* @param tarpath: 已裁减的新图片保存完整的路径
* @param x: 裁减矩形区域左上顶点水平位移
* @param y: 裁减矩形区域左上顶点垂直位移
* @param width: 裁减矩形区域的宽度
* @param height: 裁减矩形 ......
detachedCriteria.add(Restrictions.or(
Restrictions.like("chengBanDanWeiIds", rForm.getChengBanDanWeiIds()+(char)13, MatchMode.START),
Restrictions.or(
&n ......
