getFile()

语法

getFile( <filepath>, [permission], [mode] )

类别

Remote

描述

新建一个远程文件对象。

参数

参数名参数类型默认值描述是否必填
filepathstring—-文件路径
permissionint0700设置打开文件的权限
modeintSDB_FILE_READWRITE | SDB_FILE_CREATE设置文件打开的方式

Note:

如果想执行远程文件类的全局方法,可以不填任何参数。具体全局方法可在 sdb shell 中执行命令 File.help() 查看。

mode 参数的可选值如下表:

可选值描述
SDB_FILE_CREATEONLY只创建文件
SDB_FILE_REPLACE覆盖原文件的内容,写入新内容
SDB_FILE_CREATE创建文件并打开文件
SDB_FILE_READONLY以只读的模式打开文件
SDB_FILE_WRITEONLY以只写的模式打开文件
SDB_FILE_READWRITE以可读可写的模式打开文件
SDB_FILE_SHAREREAD以共享读的模式打开文件
SDB_FILE_SHAREWRITE以共享写的模式打开文件

Note:

以上标志位可以使用或运算符 ‘ | ’,按位运算组合使用。

返回值

无返回值。

错误

如果出错则抛异常,并输出错误信息,可以通过getLastErrMsg()获取错误信息或通过getLastError()获取错误码。关于错误处理可以参考常见错误处理指南

常见错误可参考错误码

示例

  • 新建一个远程连接对象
  1. > var remoteObj = new Remote( "192.168.20.71", 11790 )
  • 新建一个远程文件对象。
  1. > var file = remoteObj.getFile( "/opt/sequoiadb/file", 0777, SDB_FILE_READWRITE | SDB_FILE_CREATE )
  • 读取文本文件内容。(详细可参考read
  1. > file.read()
  2. SquoiaDB