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()
创建一个新的文件名构建器对象。
|
修饰符和类型 | 方法和说明 |
---|---|
文件 |
build()
为您提供给 setDirectory() 方法的目录生成唯一的文件名。
|
文件 |
getDirectory()
获取此构建器将生成唯一文件名的目录。
|
字符串 |
getFileExtension()
获取要附加到文件名的文件扩展名。
|
字符串 |
getFileNameFormat()
获取此构建器将用于生成唯一文件名的文件名格式字符串。
|
无效 |
setDirectory(文件 目录)
设置目录以生成唯一的文件名。
|
无效 |
setFileExtension(字符串 扩展名)
设置要附加到文件名的文件扩展名。
|
无效 |
setFileNameFormat(字符串 格式)
设置文件名格式字符串以用于生成唯一文件名。
|
public void setDirectory(File directory)
directory
- 目录路径。期望此目录存在,否则此对象将无法构建唯一的文件名。public File getDirectory()
如果尚未设置目录,则返回 null。
public void setFileNameFormat(String format)
format
- 要使用的格式字符串,例如“文件 %d”。期望该字符串包含“%d”,以便此构建器为文件名生成唯一号码。该字符串不要提供文件扩展名。public String getFileNameFormat()
public void setFileExtension(String extension)
extension
- 要追加到文件名的扩展名。设置为 null 或空字符串以不追加扩展名到文件名。
public String getFileExtension()
如果不想追加扩展名,则返回空字符串。
public File build()
请注意,此方法不会在设置的目录中实际创建文件。此方法仅生成您可以用来创建新文件的唯一文件名。
您应在调用此 build() 方法之前调用 setDirectory()、setFileNameFormat() 和 setFileExtension() 方法。
如果目录不存在,则返回 null。