package-info.java对于经常使用外部包的程序员来说应该是熟悉陌生人。
因为不是专门开发包的程序员很少需要关注它,而又常在其他包中看到他,眼很熟。它到底有哪些特性和作用及如何使用呢?程序员讲究动口不如动手,何不创建一个试试。打开Eclipse,new class,哦!创建失败,‘-’ 作为特殊字符不允许在类名称里出现,什么情况。原来它本来就是个特例当然得用特别方法创建,记事本上,好了成功了。
原文地址:
http://strong-life-126-com.iteye.com/blog/806246
特点:
首先,它不能随便被创建。在
Eclipse
中,
package-info
文件不能随便被创建,会报
“Type name is notvalid”
错误,类名无效,Java变量定义规范是:字母、数字、下划线,还有那个不怎么常用的$符号(顺带说下,
Java
是支持中文名称的变量,习惯挑战的同学可以尝试下,分享一下这方面的经验)。
其次,服务的对象很特殊。一个类是一类或一组事物的描述,比如
Dog
这个类,就是描述旺财的,那
package-info
这个类是描述啥的呢?它总要有一个被描述或被陈述的对象,它是描述和记录本包信息。
最后,类不能带有
public、private
访问权限。
package-info.java
再怎么特殊,也是一个类文件,也会被编译成
package-info.class
,但是在
package-info.java
中只能声明默认访问权限的类,也就是友好类。
其实还有几个特殊的地方,比如不可以继承,没有接口,没有类间关系(关联、组合、聚合等等)等。
这个文件的特殊性说完了,那再说说它有什么作用,它有三个作用:
为标注在包上
Annotation
提供便利;
声明友好类和包常量;
提供包的整体注释说明。
为标注在包上
Annotation
提供便利
Java
代码
@PkgAnnotation
package com.company;
Java
代码:
Hi,I'm the PkgAnnotation!
Java
代码:
@PkgAnnotation
package com.company;
class PkgClass{
}
//包常量,只运行包内访问,适用于分“包”开发
class PkgConst{
}
提供包的整体注释说明
Java
代码: