public class UniqueFileNameBuilder extends Object
示例用法
// Create a unique JPEG file name in the "Pictures" directory. UniqueFileNameBuilder builder = new UniqueFileNameBuilder(); builder.setDirectory(Environment.getExternalStoragePublicDirectory(Environment.DIRECTORY_PICTURES)); builder.setFileNameFormat("Picture %d"); builder.setFileExtension("jpg"); java.io.File imageFile = builder.build(); if (imageFile != null) { // Unique file name was generated. Create the file here. }
构造函数和说明 |
---|
UniqueFileNameBuilder()
创建一个新的文件名生成器对象。
|
修饰符和类型 | 方法和说明 |
---|---|
文件 |
构建()
为您提供给 setDirectory() 方法的目录生成唯一的文件名。
|
文件 |
getDirectory()
获取此生成器将在其中生成唯一文件名的目录。
|
字符串 |
getFileExtension()
获取要附加到文件名的文件扩展名。
|
字符串 |
getFileNameFormat()
获取此生成器将用于生成唯一文件名的文件名格式字符串。
|
void |
setDirectory(文件 目录)
设置在其中生成唯一文件名的目录。
|
void |
setFileExtension(字符串 扩展名)
设置要附加到文件名的文件扩展名。
|
void |
setFileNameFormat(字符串 格式)
设置要用来生成唯一文件名的文件名格式字符串。
|
public void setDirectory(File directory)
目录
- 目录的路径。预计该目录已存在,否则此对象将无法构建唯一的文件名。public File getDirectory()
如果尚未设定目录,则返回 null。
public void setFileNameFormat(String format)
格式
- 要使用的格式字符串,例如“File %d”。预计此字符串中包含“%d”,以便此构建器能为文件名生成唯一的数字。此字符串预计不会提供文件扩展名。public String getFileNameFormat()
public void setFileExtension(String extension)
扩展名
- 要附加到文件名上的扩展名。设为 null 或空字符串,以便不将扩展名附加到文件名。
public String getFileExtension()
如果不附加扩展名,则返回一个空字符串。
public File build()
请注意,此方法实际上并未在设定的目录中创建文件。此方法仅生成一个唯一的文件名,可用于创建新文件。
在调用此 build() 方法之前,预计您会调用 setDirectory()、setFileNameFormat() 和 setFileExtension() 方法。
如果目录不存在,则返回 null。