iOS - Swift NSFileManage 文件管理

前言

	public class NSFileManager : NSObject
	public class NSFileHandle : NSObject, NSSecureCoding

• NSFileManager 是 Foundation 框架中用来管理和操作文件、目录等文件系统相关联内容的类。

1、路径操作

	let nfManager = NSFileManager.defaultManager()

	let folderUrl:NSURL = NSURL(string: NSHomeDirectory().stringByAppendingString("/Desktop/testFolder"))!
	let filerUrl:NSURL = NSURL(string: NSHomeDirectory().stringByAppendingString("/Desktop/testFile.txt"))!

	let srcUrl:NSURL = NSURL(string: NSHomeDirectory().stringByAppendingString("/Desktop/testFile.txt"))!
	let dstUrl:NSURL = NSURL(string: NSHomeDirectory().stringByAppendingString("/Desktop/testFolder/testFile.txt"))!

	// 创建文件夹
	/*
		public func createDirectoryAtPath(path: String,
		            withIntermediateDirectories createIntermediates: Bool,
		                            attributes: [String : AnyObject]?) throws

		path：文件夹路径
		createIntermediates：是否连同上一级路径一起创建，NO 并且上一级文件路径不存在时会创建失败。
		attributes：文件夹属性，nil 系统默认属性
	*/

	try! nfManager.createDirectoryAtPath(folderUrl.path!, withIntermediateDirectories: true, attributes: nil)

	// 创建文件
	/*
		func createFileAtPath(path: String,
		             contents data: NSData?,
		           attributes attr: [NSObject : AnyObject]?) -> Bool

		path：文件路径
		data：文件内容，nil 空
		attr：文件属性，nil 系统默认属性
		Bool：文件创建成功时返回值为 true
	*/

	let bl1:Bool = nfManager.createFileAtPath(filerUrl.path!, contents: nil, attributes: nil)

	// 拷贝文件
	/*
		如果 dstUrl 路径文件已存在，该方法会终止拷贝，并返回 false。
		如果 srcUrl 的最后一部分是符号链接，那么只有链接会被拷贝到新路径。
	*/

	try! nfManager.copyItemAtPath(srcUrl.path!, toPath: dstUrl.path!)

	// 删除文件
	/*
		删除成功或者 url 为 nil 时返回 true，如果发生错误返回 false。如果使用 delegate 终止了删除文件的操作，
		则返回 true，如果使用 delegate 终止了删除目录的操作，则返回 false。
	*/

	try! nfManager.removeItemAtPath(dstUrl.path!)

	// 移动文件
	/*
		如果 dstUrl 路径文件已存在，该方法会终止移动，并返回 false。如果 srcUrl 的最后一部分是符号链接，
		那么只有链接会被移动到新路径。链接所指向的内容仍然保持在现有的位置。
	*/

	try! nfManager.moveItemAtPath(srcUrl.path!, toPath: dstUrl.path!)

	// 查找满足指定条件的路径

		// 返回其 URL。该方法不但可以获得标准系统目录，还可以用来创建临时路径。
		let url1:NSURL = try! nfManager.URLForDirectory(.DocumentDirectory,
		                                       inDomain: .UserDomainMask,
		                              appropriateForURL: nil,
		                                         create: true)

		// 返回所有满足条件的路径列表
		let urlObjs:[NSURL] = nfManager.URLsForDirectory(.DocumentDirectory, inDomains: .UserDomainMask)
		let url2:NSURL = urlObjs[0]

	// 查询指定路径下的所有子路径

		let urls1:[String]? = nfManager.subpathsAtPath(url1.path!)
		let urls2:[String] = try! nfManager.subpathsOfDirectoryAtPath(url1.path!)

	// 浅遍历

		// 返回指定目录下的文件、子目录及符号链接的列表
		let contentsDir1:[String] = try! nfManager.contentsOfDirectoryAtPath(url1.path!)

	  	// 返回文件全路径
		/*
			public func contentsOfDirectoryAtURL(url: NSURL,
			              includingPropertiesForKeys keys: [String]?,
			                           options mask: NSDirectoryEnumerationOptions) throws -> [NSURL]

			返回指定目录下的文件、子目录及符号链接的列表，返回的是文件全路径。

			url：要进行搜索的目录路径，该路径不能为指向目标目录的符号链接，如果是可以使用 URLByResolvingSymlinksInPath 进行转换。
			keys：用来传入进行搜索的一些特定条件，包括创建时间，修改时间等。
			mask：SkipsHiddenFiles：表示不遍历隐藏文件，
                SkipsSubdirectoryDescendants：表示不递归到子目录内部，
                SkipsPackageDescendants：表示不递归到包内部。
		*/

		let contentsDir2:[NSURL] = try! nfManager.contentsOfDirectoryAtURL(url1,
		                                        includingPropertiesForKeys: nil,
		                                                           options: .SkipsHiddenFiles)

	// 深遍历

		// 返回指定目录下的所有文件及其子目录下的所有元素路径
		let enumeratorDir1:NSDirectoryEnumerator = nfManager.enumeratorAtPath(url1.path!)!

		// 返回文件全路径
		/*
			func enumeratorAtURL(url: NSURL,
			      includingPropertiesForKeys keys: [AnyObject]?,
			                         options mask: NSDirectoryEnumerationOptions,
			                 errorHandler handler: ((NSURL!, NSError!) -> Bool)?) -> NSDirectoryEnumerator?

			返回指定目录下的所有文件及其子目录下的所有元素路径，返回的是文件全路径。

			url：要进行搜索的目录路径，该路径不能为指向目标目录的符号链接，如果是可以使用 URLByResolvingSymlinksInPath 进行转换。
			keys：用来传入进行搜索的一些特定条件，包括创建时间，修改时间等。
			mask：SkipsHiddenFiles：表示不遍历隐藏文件，
			      SkipsSubdirectoryDescendants：表示不递归到子目录内部，
			      SkipsPackageDescendants：表示不递归到包内部。
		*/

		let enumeratorDir2:NSDirectoryEnumerator = nfManager.enumeratorAtURL(url1,
		                                          includingPropertiesForKeys: nil,
		                                                             options: .SkipsHiddenFiles,
		                                                        errorHandler: nil)!

		// 枚举遍历深层遍历
		let dEnu:NSDirectoryEnumerator? = nfManager.enumeratorAtPath(url1.path!)

		while let obj:AnyObject? = dEnu?.nextObject() {
			print(obj)
		}

	// 显示路径的本地化名称
	/*
		如果指定的文件或目录不存在，会返回 path 本身。
	*/
	let displayName:String = nfManager.displayNameAtPath(url1.path!)

	// 获取指定路径的各种属性

	let attributes:[String:AnyObject] = try! nfManager.attributesOfItemAtPath(url1.path!)

	// 获取指定路径文件的内容数据
	/*
		如果指定路径为目录或发生错误，返回 nil。
	*/
	let data:NSData? = nfManager.contentsAtPath(url1.path!.stringByAppendingString("/test.txt"))

	// 获取当前路径

	let currentPath:String = nfManager.currentDirectoryPath

	// 更改当前路径
	/*
		/Users/JHQ0228/Desktop/Debug
	*/
	let bl6:Bool = nfManager.changeCurrentDirectoryPath(NSHomeDirectory().stringByAppendingString("/Desktop/Debug"))

	// 获取临时工作路径
	/*
		获取系统中可以用来创建临时文件的目录路径名，一定要在完成任务之后将在其中创建的文件删除。
	*/
	let tempPath:NSString = NSTemporaryDirectory()

	// 获取用户主路径（沙盒路径）

	let homePath:NSString = NSHomeDirectory()

	// 获取指定用户的主路径
	/*
		NSUserName(); 获取当前用户的登录名。NSFullUserName(); 获取当前用户完整用户名
	*/
	let userHomePath:String? = NSHomeDirectoryForUser(NSUserName())

	// 获取用户 Documents 路径

	let documentPath:NSString = NSSearchPathForDirectoriesInDomains(.DocumentDirectory, .UserDomainMask, true)[0]

	// 获取 app 包路径

	let bundlePath = NSBundle.mainBundle().bundlePath

	// 创建一个新路径

	try! nfManager.createDirectoryAtPath(NSHomeDirectory().stringByAppendingString("/Desktop/Debug1"),
	                                                   withIntermediateDirectories: true, attributes: nil)

	// 获取最后一个路径

	let lastPath:String? = NSURL(string: NSHomeDirectory().stringByAppendingString("/Desktop"))?.lastPathComponent

	// 删除最后一个路径

	let deleteLastPath:String? = NSURL(string: NSHomeDirectory().stringByAppendingString("/Desktop"))?
	                                                            .URLByDeletingLastPathComponent?
	                                                            .path

	// 拼接一个路径

	let appendingPath:String? = NSURL(string: NSHomeDirectory().stringByAppendingString("/Desktop"))?
	                                                           .URLByAppendingPathComponent("testFolder")
	                                                           .path

	// 文件路径分割

	let pathArray:[String]? = NSURL(string: NSHomeDirectory().stringByAppendingString("/Desktop"))?.pathComponents

	// 文件路径组合

	let pathString:NSString = NSString.pathWithComponents(pathArray!)

	// 将路径中的代字符 ~ 扩展成用户主目录或指定用户的主目录

		// 特殊的代字符 ~ 是用户主目录（如：/Users/JHQ0228）的缩写，~linda 表示用户 linda 主目录的缩写。
		let path1:NSString = "~/Desktop/test.txt";

		// /Users/JHQ0228/Desktop/test.txt
		let mainPath:String = path1.stringByExpandingTildeInPath

	// 解析路径中的符号链接
	/*
		/..    上一级目录
	*/
	let path2:NSString = "~/../Debug"
	let appPath1:String = path2.stringByResolvingSymlinksInPath

	// 通过解析 ~（用户主目录）、..（父目录） 、.（当前目录）和符号链接来标准化路径
	/*
		NSHomeDirectory()/..    NSHomeDirectory() 的上一级目录
	*/
	let path3:NSString = NSString(format:"%@/../Debug", NSHomeDirectory())
	let appPath2:String = path3.stringByStandardizingPath

	// 获取文件拓展名

	let getExtension:String? = NSURL(string: "/Desktop/test.txt")?.pathExtension

	// 删除文件拓展名

	let deleteExtension:String? = NSURL(string: "/Desktop/test.txt")?.URLByDeletingPathExtension?.pathExtension

	// 拼接文件拓展名

	let appendingExtension:String? = NSURL(string: "/Desktop/test.txt")?.URLByAppendingPathExtension("doc").path

2、路径判断

	let nfManager = NSFileManager.defaultManager()
	let url1:NSURL = try! nfManager.URLForDirectory(.DocumentDirectory,
	                                       inDomain: .UserDomainMask,
	                              appropriateForURL: nil,
	                                         create: true)

	// 判断路径是否存在
	/*
		如果当前路径以～开头，需使用 NSString 的 stringByExpandingTildeInPath 方法进行处理，否则会返回 false
	*/

	let bl1:Bool = nfManager.fileExistsAtPath(url1.path!) 

	// 判断指定路径是否有可读权限

	let bl2:Bool = nfManager.isReadableFileAtPath(url1.path!)

	// 判断指定路径是否有可写权限

	let bl3:Bool = nfManager.isWritableFileAtPath(url1.path!)

	// 判断指定路径是否有可执行权限

	let bl4:Bool = nfManager.isExecutableFileAtPath(url1.path!)

	// 判断指定路径是否有可删除权限

	let bl5:Bool = nfManager.isDeletableFileAtPath(url1.path!)

	// 判断两个指定路径的内容是否相同

	let bl6:Bool = nfManager.contentsEqualAtPath(url1.path!,
	                                     andPath: url1.path!.stringByAppendingString("/test.txt"))

3、文件操作

	let fileUrl:NSURL = NSFileManager.defaultManager().URLsForDirectory(.DocumentDirectory,
	                                                          inDomains: .UserDomainMask)[0]
	                                                          as! NSURL

	// 文件打开

		// 读写
		var nfHandle = NSFileHandle(forUpdatingAtPath: fileUrl.path!.stringByAppendingString("/test.txt"))!

		// 只读
		var nfHandle1 = NSFileHandle(forReadingAtPath: fileUrl.path!.stringByAppendingString("/test.txt"))!

		// 只写
		var nfHandle2 = NSFileHandle(forWritingAtPath: fileUrl.path!.stringByAppendingString("/test.txt"))!

	// 文件句柄偏移量

		// 获取文件句柄指针的偏移量
		let offSetNum1:UInt64 = nfHandle.offsetInFile

		// 将偏移量移到文件末尾，返回移动后的指针偏移量
		let offSetNum2:UInt64 = nfHandle.seekToEndOfFile()

		// 将偏移量指向特定的位置
		nfHandle.seekToFileOffset(0)

	// 文件读取

		// 获取当前文件句柄的可用数据，获取后指针移到文件末尾
		let availableData:NSData = nfHandle.availableData

		// 获取从当前指针位置到文件结束的所有数据，获取后指针移到文件末尾
		let data1:NSData = nfHandle.readDataToEndOfFile()

		// 获取从当前指针位置开始读取的 length 长度的数据内容，获取后指针移到文件读取到的位置
		let data2:NSData = nfHandle.readDataOfLength(10)

	// 文件写入

		// 从当前指针位置写入数据到文件
		nfHandle.writeData("你好".dataUsingEncoding(NSUTF8StringEncoding, allowLossyConversion: true)!)

	// 文件关闭

		// 关闭文件
		nfHandle.closeFile()

	// 文件比较

		let nfManager = NSFileManager.defaultManager()

		// 文件路径
		let filePath1:String = NSHomeDirectory().stringByAppendingString("/Desktop/file1.txt")
		let filePath2:String = NSHomeDirectory().stringByAppendingString("/Desktop/file2.txt")

		nfManager.createFileAtPath(filePath1,
		                  contents: "北京欢迎您".dataUsingEncoding(NSUTF8StringEncoding, allowLossyConversion: true),
		                attributes: nil)

		nfManager.createFileAtPath(filePath2,
		                  contents: "北京欢迎".dataUsingEncoding(NSUTF8StringEncoding, allowLossyConversion: true),
		                attributes: nil)

		// 比较两个文件的内容是否相等
		let bl:Bool = nfManager.contentsEqualAtPath(filePath1, andPath: filePath2)