package-info

2024-08-21 02:08
文章标签 info package

本文主要是介绍package-info,希望对大家解决编程问题提供一定的参考价值,需要的开发者们随着小编来一起学习吧!

 翻看以前的笔记,看到一个特殊的java文件:pacakge-info.java,虽然有记录,但是不全,就尝试着追踪一下该问题, 分享一下流水账式的结果。

首先,它不能随便被创建在Eclipse中, package-info文件不能随便被创建,会报“Type name is notvalid”错误,类名无效,Java变量定义规范是:字母、数字、下划线,还有那个不怎么常用的$符号(顺带说下,Java是支持中文名称的变量,习惯挑战的同学可以尝试下,分享一下这方面的经验),这个中划线可不再之列,那怎么创建这个文件呢?

很简单,用记事本创建一个,然后拷贝进去再改一下就成了,更直接的办法就是从别的项目中拷贝过来一个,这更方便。

    其次,服务的对象很特殊。一个类是一类或一组事物的描述,比如Dog这个类,就是描述旺财的,那package-info这个类是描述啥的呢?它总要有一个被描述或被陈述的对象,它是描述和记录本包信息

    最后,类不能带有publicprivate访问权限package-info.java再怎么特殊,也是一个类文件,也会被编译成package-info.class,但是在package-info.java中只能声明默认访问权限的类,也就是友好类。

其实还有几个特殊的地方,比如不可以继承,没有接口,没有类间关系(关联、组合、聚合等等)等。

这个文件的特殊性说完了,那再说说它有什么作用,它有三个作用:

1、为标注在包上Annotation提供便利;

2、声明友好类和包常量;

3、提供包的整体注释说明。

    我们来建立一个项目演示这三个作用,建立一个package-info的Java Project,在com.company包三个类:package-info.java 是我们重点关注的,PkgAnnotation.java是一个标注在包上的注解定义,Client.java模拟业务操作类。其结构如下图:


 

 

为标注在包上Annotation提供便利

     首先定义一个包类型的注解,它只能放置的一个包上:

 

Java代码   收藏代码
  1. /** 
  2.  * 定义只能标注在package上的注解 
  3. */  
  4. @Target(ElementType.PACKAGE)  
  5. @Retention(RetentionPolicy.RUNTIME)  
  6. public @interface PkgAnnotation {  
  7. }  

 

 

 

     再定义一个package-info类,这个是一个特殊的类,先看代码:

 

Java代码   收藏代码
  1. @PkgAnnotation  
  2. package com.company;  

      很简单,就这么个文件,里面啥都没有,就这两句话,没有class类,没有常变量声明。接着写一个模拟交易类,代码如下:

 

Java代码   收藏代码
  1. public class Client {     
  2.     public static void main(String[] args) {  
  3.         //可以通过I/O操作或配置项获得包名  
  4.         String pkgName = "com.company";       
  5.         Package pkg = Package.getPackage(pkgName);  
  6.         //获得包上的注解  
  7.         Annotation[] annotations = pkg.getAnnotations();  
  8.         //遍历注解数组  
  9.         for(Annotation an:annotations){  
  10.             if(an instanceof PkgAnnotation){  
  11.                 System.out.println("Hi,I'm the PkgAnnotation ,which is be placed on package!");  
  12.                 /* 
  13.                  * 注解操作 
  14.                  * MyAnnotation myAnn = (PkgAnnotation)an; 
  15.                  * 还可以操作该注解包下的所有类,比如初始化,检查等等 
  16.                  * 类似Struts的@Namespace,可以放到包名上,标明一个包的namespace路径 
  17.                  */           
  18.             }  
  19.         }  
  20.     }  
  21. }  

      运行结果如下所示:

 

 

Hi,I'm the PkgAnnotation ,which is be placed on package!

 

 

声明友好类和包常量

     这个比较简单,而且很实用,比如一个包中有很多的内部访问的类或常量,就可以统一的放到package-info类中,这样就方便,而且集中管理,减少friendly类到处游走的情况,看例子:

 

Java代码   收藏代码
  1. @PkgAnnotation  
  2. package com.company;  
  3.  //这里是包类,声明一个包使用的公共类,强调的是包访问权限  
  4. class PkgClass{  
  5.     public void test(){  
  6.     }  
  7. }  
  8. //包常量,只运行包内访问,适用于分“包”开发  
  9. class PkgConst{  
  10.     static final String PACAKGE_CONST="ABC";  
  11. }  

 

 

 

  提供包的整体注释说明

     如果是分“包”开发,也就是说一个包实现一个业务逻辑或功能点、或模块、或组件,则需要对一个包有很好的说明,说明这个包是干啥的,有啥作用,版本变迁,特别说明等等,如下:

 

Java代码   收藏代码
  1. /** 
  2.  * <b>package-info不是平常类,其作用有三个:</b><br> 
  3.  * 1、为标注在包上Annotation提供便利;<br> 
  4.  * 2、声明包的私有类和常量;<br> 
  5.  * 3、提供包的整体注释说明。<br>  
  6. */  
  7. package com.company;  

 

 

 

     通过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文件惹的祸,在各个包下创建一个即可。

该文章为转载,原文地址:http://strong-life-126-com.iteye.com/blog/806246

这篇关于package-info的文章就介绍到这儿,希望我们推荐的文章对编程师们有所帮助!



http://www.chinasem.cn/article/1091818

相关文章

ORACLE语法-包(package)、存储过程(procedure)、游标(cursor)以及java对Result结果集的处理

陈科肇 示例: 包规范 CREATE OR REPLACE PACKAGE PACK_WMS_YX IS-- Author : CKZ-- Created : 2015/8/28 9:52:29-- Purpose : 同步数据-- Public type declarations,游标 退休订单TYPE retCursor IS REF CURSOR;-- RETURN vi_co_co

UserWarning: mkl-service package failed to import

安装完成anaconda,并设置了两个环境变量  之后再控制台运行python环境,输入import numpy as np,提示错误 D:\InstallFolder\Anaconda3\lib\site-packages\numpy\__init__.py:143: UserWarning: mkl-service package failed to import, therefore

maven 指令之package 和install的区别

https://blog.csdn.net/zy103118/article/details/79901357   maven 指令之package 和install的区别 2018年04月11日 19:08:46 brave_zhao 阅读数:2018更多 个人分类: maven maven package 和 install 区别 原创 2016年08月18日 14:55:26

Flutter-加三方库卡在flutter package get 的解决办法

Windows PUB_HOSTED_URL ===== https://pub.flutter-io.cnFLUTTER_STORAGE_BASE_URL ===== https://storage.flutter-io.cn 增加两个环境变量,然后执行一下 flutter doctor命令。问题完美解决。

【大数据Java基础-JAVA 面向对象11】关键字(二):package/import

1.1 使用说明: * 1.为了更好的实现项目中类的管理,提供包的概念 * 2.使用package声明类或接口所属的包,声明在源文件的首行 * 3.包,属于标识符,遵循标识符的命名规则、规范(xxxyyyzzz)、“见名知意” * 4.每"."一次,就代表一层文件目录。 1.2 举例: 举例一: 某航运软件系统包括:一组域对象、GUI和reports子系统 举例二:MVC设计模式

Complex Networks Package for MatLab

http://www.levmuchnik.net/Content/Networks/ComplexNetworksPackage.html 翻译: 复杂网络的MATLAB工具包提供了一个高效、可扩展的框架,用于在MATLAB上的网络研究。 可以帮助描述经验网络的成千上万的节点,生成人工网络,运行鲁棒性实验,测试网络在不同的攻击下的可靠性,模拟任意复杂的传染病的传

j2ee项目 web-info目录问题

1、资源文件只能放在WebContent下面,如 CSS,JS,image等.放在WEB-INF下引用不了.   2、页面放在WEB-INF目录下面,这样可以限制访问,提高安全性.如JSP,html   3、只能用转向方式来访问WEB-INF目录下的JSP,不用采用重定向的方式请求该目录里面的任何资源.如图:index.jsp>>  main.jsp   4、WEB-INF

JAVA - package与import解析(一)

一、为什么要引入package和import? 这个问题和c++中引入命名空间是一样的,也是为了解决重名问题。java通过包机制来解决重名问题,也就相当于给重名的代码加一系列前缀,从而达到唯一标识的作用。 二、如何解决重名问题?这个就有点像外国人的名字:如果我叫Jeason,我爸叫Kevin,我爷爷叫Bob,我爷爷的爸爸叫Peter。那么如果没有人和我同名(Jeason),那么Je

Update Azure OpenAI npm Package to 2023-12-01-preview Version

题意:将 Azure OpenAI npm 包更新到 2023-12-01-preview 版本 问题背景: I am currently using the azure-openai npm package in my project with version 2023-03-15-preview. As per the latest updates, version 2023-12