为什么package-info.java有用?

问题描述 投票:48回答:5

当我在我的Java项目上运行CheckStyle时,它会为某些类说Missing package-info.java file.,但不是全部。我无法弄清楚为什么有时会出现此消息。此外,我的项目在没有package-info.java的情况下运行得非常好。

package-info.java有什么作用?我真的需要它用于我的Java项目吗?

java maven checkstyle
5个回答
71
投票

它用于为包生成javadoc。

/**
* Domain classes used to produce .....
* <p>
* These classes contain the ......
* </p>
*
* @since 1.0
* @author somebody
* @version 1.0
*/
package com.domain;

将生成com.domain包的包信息:

示例结果:https://docs.oracle.com/javase/7/docs/api/java/awt/package-summary.html


35
投票

Annotations

使用package-info.java的另一个好理由是添加默认的annotations以供FindBugs使用。例如,如果你把它放在package-info文件中:

@DefaultAnnotation(NonNull.class)
package com.my.package;

然后当findbugs在该包中的代码上运行时,除非用@CheckForNull注释它们,否则所有方法和字段都被假定为非null。这比要求开发人员为每个方法和字段添加@NonNull注释要好得多,也更加万无一失。


8
投票

不仅是一些findbugs注释,而且常见库中的许多java注释都将java.lang.annotation.ElementType.PACKAGE类型作为其自己的java.lang.annotation.Target注释的可能值之一,例如:

com.google.gwt.core.client.js.JsNamespace
com.querydsl.core.annotations.Config
com.sun.xml.bind.XmlAccessorFactory
groovy.transform.BaseScript
java.lang.Deprecated
javax.annotation.Generated
javax.xml.bind.annotation.XmlAccessorOrder
org.hibernate.annotations.TypeDef
net.sf.ehcache.pool.sizeof.annotations.IgnoreSizeOf
org.apache.hive.common.HiveVersionAnnotation
org.apache.wicket.authroles.authorization.strategies.role.annotations.AuthorizeAction
org.codehaus.commons.nullanalysis.NotNullByDefault
org.eclipse.persistence.oxm.annotations.XmlNameTransformer
org.glassfish.jersey.Beta
org.jgroups.annotations.Experimental

以及更多。

这个package-info.java文件将是文件,您可以在其中放置此类注释(以及javadoc)。


5
投票

package-info.java文件允许添加javadoc来记录整个包。例如,请参阅http://docs.oracle.com/javase/7/docs/api/java/applet/package-summary.html

如果您不关心缺少包文档,请忽略该警告或禁用JavadocPackage check


1
投票

package-info.java是一个Java文件,可以添加到任何Java源包中。它用于根据名称在“包”级别提供信息。它包含包中使用的文档和注释。

答案中已经提供了javadoc示例,下面的部分解释了它是如何工作的注释。

例如,在下面的文件中,它用于用org.jadira.usertype.dateandtime.joda.PersistentDateTime“替换”joda.time.DateTime的出现。

@TypeDefs({
    @TypeDef(name = "PersistentDateTime", typeClass = PersistentDateTime.class, defaultForType=DateTime.class)})

package xyz.abc;

import org.hibernate.annotations.TypeDef;
import org.hibernate.annotations.TypeDefs;
import org.jadira.usertype.dateandtime.joda.PersistentDateTime;
import org.joda.time.DateTime; 

有许多注释可用于在“包”级别执行不同的操作。它可以在https://docs.jboss.org/hibernate/orm/3.5/api/org/hibernate/annotations/package-summary.html找到

© www.soinside.com 2019 - 2024. All rights reserved.