DolphinDB基础概念理解：模块

本文主要是介绍DolphinDB基础概念理解：模块，希望对大家解决编程问题提供一定的参考价值，需要的开发者们随着小编来一起学习吧！

模块

在DolphinDB中，模块是指只包含函数定义的代码包。具有以下特点：
1. 以.dos作为模块文件的后缀，dos是“dolphindb script”的缩写；
2. 模块文件保存在DolphinDB节点的[home]/modules目录下；
3. 模块文件第一行以声明模块语句module modulename开头；
4. 模块文件内容仅包含函数定义；
定义模块
一、创建模块目录
默认情况下，所有的模块定义在[home]/modules目录下，[home]由系统配置参数home决定。

此系统参数home可以通过getHomeDir()函数获取：
```
>>> getHomeDir() # GUI中运行
D:\Tools\DolphinDB_Win64_V0.99.0\server # 即DolphinDB的启动目录
```
需要在该目录下创建modules子目录来保存模块文件，最终模块目录为：

../server/modules

扩展知识：

home是一个系统配置参数，那一共有多少系统配置参数呢？

getClusterNodesCfg()

getClusterPerf()

可以通过这两个函数获取，不过都不支持单节点。

以上是默认情况，具体到实际情况下，modules目录是以工程项目为基准：

在一个工程项目的目录下有两个文件夹scripts和modules，模块文件就存放在modules文件夹下：

—project

—|---modules

—|---|—FileLog.dos

—|---scripts
二、创建模块文件

在modules目录下创建模块文件moduleName.dos；

模块文件的第一行必须是模块声明语句：
```
module moduleName # moduleName必须与模块文件的名称一致
```
模块文件中，仅允许封装函数定义，其他非函数定义代码将被忽略。
导入模块

DolphinDB中，使用use关键字来导入一个模块。
```
use FileLog # 导入模块
```
use关键字导入的模块是会话隔离的，进队当前会话有效。

导入模块后，可以通过两种方式来使用模块内的自定义函数：
1. 直接使用模块中的函数
```
use FileLog
appendLog("mylog.txt", "test my log")
```
2. 通过完整路径来调用模块中的函数
```
use FileLog
FileLog::appendLog("mylog.txt", "test my log")
```
不管在哪里创建的FileLog.dos文件，都需要存放到[home]/modules文件夹下才能生效，可能还需要重启server。

可以手动迁移.dos，也可以通过GUI在modules上右键synchronize module to server同步到[home]
References