# 初始化SqlMap配置文件及SqlTemplate模板 xorm提供了SqlMap配置和SqlTemplate功能,如创建引擎,且需要使用SqlMap配置和SqlTemplate功能,参考如下方式创建引擎并初始化SqlMap配置文件及SqlTemplate模板 ~~~ var err error engine, err = xorm.NewPostgreSQL("postgres://postgres:root@localhost:5432/testdb?sslmode=disable") if err != nil { t.Fatal(err) } /*-------------------------------------------------------------------------------------------------- 1、使用RegisterSqlMap()注册SqlMap配置 2、RegisterSqlTemplate()方法注册SSqlTemplate模板配置 3、SqlMap配置文件总根目录和SqlTemplate模板配置文件总根目录可为同一目录 --------------------------------------------------------------------------------------------------*/ //注册SqlMap配置,可选功能,如应用中无需使用SqlMap,可无需初始化 //此处使用xml格式的配置,配置文件根目录为"./sql/oracle",配置文件后缀为".xml" err = x.RegisterSqlMap(xorm.Xml("./sql/oracle", ".xml")) if err != nil { t.Fatal(err) } //注册动态SQL模板配置,可选功能,如应用中无需使用SqlTemplate,可无需初始化 //此处注册动态SQL模板配置,使用Pongo2模板引擎,配置文件根目录为"./sql/oracle",配置文件后缀为".stpl" err = x.RegisterSqlTemplate(xorm.Pongo2("./sql/oracle", ".stpl")) if err != nil { t.Fatal(err) } //开启SqlMap配置文件和SqlTemplate配置文件更新监控功能,将配置文件更新内容实时更新到内存,如无需要可以不调用该方法 err = engine.StartFSWatcher() if err != nil { t.Fatal(err) } ~~~ * <b>db.RegisterSqlMap()过程</b> * 使用RegisterSqlMap()方法指定SqlMap配置文件文件格式,配置文件总根目录,配置文件后缀名,RegisterSqlMap()方法按指定目录遍历所配置的目录及其子目录下的所有xml配置文件(<a href="https://github.com/xormplus/xorm/blob/master/test/sql/oracle/studygolang.xml">配置文件样例</a>)或json配置文件(<a href="https://github.com/xormplus/xorm/blob/master/test/sql/oracle/test.json">配置文件样例</a>) * 解析所有配置SqlMap的xml配置文件或json配置文件 * xml配置文件中sql标签的id属性值作为SqlMap的key,如有重名id,则后加载的覆盖之前加载的配置sql条目 * json配置文件中key值作为SqlMap的key,如有重名key,则后加载的覆盖之前加载的配置sql条目 * json配置文件中key和xml配置文件中sql标签的id属性值有相互重名的,则后加载的覆盖之前加载的配置sql条目 * 配置文件中sql配置会读入内存并缓存 * 由于SqlTemplate模板能完成更多复杂组装和特殊场景需求等强大功能,故SqlMap的xml或json只提供这种极简配置方式,非ibatis的OGNL的表达式实现方式 * <b>db.RegisterSqlTemplate()过程</b> * 使用RegisterSqlTemplate()方法指定SqlTemplate模板的模板引擎(支持[pongo2](https://github.com/flosch/pongo2)、[jet](https://github.com/CloudyKit/jet)、[html/template](https://github.com/golang/go/tree/master/src/html/template)3种模板引擎,但只能选用一种,不能同时混用),配置文件总根目录,配置文件后缀名,RegisterSqlTemplate()方法按指定目录遍历所配置的目录及其子目录及其子目录下的所有stpl模板文件(<a href="https://github.com/xormplus/xorm/blob/master/test/sql/oracle/select.example.stpl">模板文件样例</a>) * 使用指定模板引擎解析stpl模板文件 * stpl模板文件名作为SqlTemplate存储的key(不包含目录路径),如有不同路径下出现同名文件,则后加载的覆盖之前加载的配置模板内容 * stpl模板内容会读入内存并缓存