java命名空间javax.annotation.processing接口filer的类成员方法:
createsourcefile定义及介绍
本文导语:
createsourcefile
javafileobject createsourcefile(charsequence name,
element... originatingelements)
throws ioexception
创建一个新的源文件,并返回一个对象以允许写入它。文件的名称和路径(...
createsourcefile
javafileobject createsourcefile(charsequence name,
element... originatingelements)
throws ioexception
- 创建一个新的源文件,并返回一个对象以允许写入它。文件的名称和路径(相对于源文件的根目录输出位置)基于该文件中声明的类型。如果声明的类型不止一个,则应该使用主要顶层类型的名称(例如,声明为 public 的那个)。还可以创建源文件来保存有关某个包的信息,包括包注释。要为指定包创建源文件,可以用
name
作为包名称,后跟 ".package-info"
;要为未指定的包创建源文件,可以使用 "package-info"
。
注意,若要使用特定 charset 来编码文件内容,可以从返回对象的 outputstream
创建具有选定字符集的 outputstreamwriter
。如果将所返回对象中的 writer
直接用于写入操作,则其字符集由实现确定。注释处理工具可以有一个用来指出这一点的 -encoding
标志或类似选项;否则,它通常将是平台的默认编码。
为了避免后续错误,源文件的内容应该与将用于此运行的源版本兼容。
- 参数:
name
- 将在此文件中声明的主要类型的规范(完全限定)名称;对于包信息文件,则是后跟 ".package-info"
的包名称originatingelements
- 与此文件的创建有因果关联的类型或包元素,该参数可以省略或者为 null
- 返回:
- 写入新源文件的
javafileobject
- 抛出:
filerexception
- 如果创建了相同的路径名,创建了相同的类型,或者名称对于某一类型无效
ioexception
- 如果无法创建文件