PandaJS 使用说明(1.8)：配置文件

[size=large][align=center][b]PandaJS 使用说明(1.8)：配置文件[/b][/align][/size]

　　配置文件的目的是把经常变化的部分提取出来，以便修改。相比 XML，直接用 js 进行配置会更为直截了当一些。
　　在现在的 HelloPanda 工程中有三类配置文件：
　　首先是 lib 和 server 的配置，在程序启动时生效，不支持热部署。
　　其次是特定应用的配置，修改后生效，支持热部署。
　　最后是用于测试的配置，与 lib 的配置相似，但设置的参数不同。

　　当然，现在 PandaJS 的功能还比较基础，因此需要配置的地方还不多。
　　接下来，我们就逐一看看这些配置文件吧。

[size=medium][align=center][b]lib 和 server 的配置文件[/b][/align][/size]
　　lib 中需要配置的有 panda.db 使用的数据库名称 和 panda.render 使用的页面文件目录（路径前缀）。
　　server 需要配置端口、网站根目录、web 资源文件目录等。

　　以下是 lib 和 server 的配置文件：
　　[b]scripts/config.js[/b]
[code]config = {
// 指定数据库名称
db : { name : 'app' },

// 指定页面文件目录（路径前缀）
render : { prefix : 'webapp/' },

// server 的配置
server : {

// 使用的端口号
port : 80,

// 网站根目录，即网站 URL 中接在域名之后的部分
contextPath: "/",

// web 资源文件目录，客户端可见的 html、css、js 等都放在这个目录下
resourceBase: "webapp",

// 上传文件的最大限制
maxUploadSize : 10 * 1024 * 1024,

// log4j 日志系统的配置文件的位置
logConfigPath: "log4j.properties",

// 服务器端执行的脚本的位置，这些脚本支持热部署
scriptsDirs : ["scripts/lib", "webapp/js/both", "scripts/app"],

// servlet 的位置 (apiServlet 和 pageServlet)
servletsDirs: ["scripts/servlets"],

// apiServlet 的访问路径映射
apiServletPath: "/api",

// pageServlet 的访问路径映射
pageServletPath: "/",

// defaultServlet（静态文件）的访问路径映射
defaultServletPath : "*.js,*.css,*.ico,*.txt,*.png,*.jpg,*.gif,*.htm,*.html,*.swf"
}
}[/code]

[size=medium][align=center][b]特定应用的配置文件[/b][/align][/size]
　　应用本身也需要配置文件，并且这些文件通常放在 app 目录或其子目录下，以支持热部署。
　　这里以 admin 的用户名和密码为例：

　　[b]scripts/app/config.js[/b]
[code]app.config = {
admin : { name: "admin", password: "admin123" }
};[/code]
　　在 api.auth 的实现中就可以使用 app.config.admin 了：

[b]scripts/app/api/auth.js[/b]
[code]api.auth = {
login : function(params, req) {
var admin = app.config.admin;

if (params.name !== admin.name
|| params.password !== admin.password) {
return false;
}

req.session.setAttribute("user.role", "admin");
return true;
}
}[/code]
[size=medium][align=center][b]用于测试的配置文件[/b][/align][/size]
　　测试时使用的数据库和页面文件的位置可能与生产不同，因此需要另外的配置文件。
　　首先，是测试 lib 的配置文件：
[b]scripts/test/lib/config.js[/b]
[code]config = {
db: { name: 'test' },
render: { prefix: 'scripts/test/lib/render/' }
};[/code]

　　此外，下一篇文章中我们将对 scripts/app 目录下的文件编写测试，现在我们可以先编写相应的配置文件：

　　[b]scripts/test/app/config.js[/b]
[code]config = {
db: { name: 'test' },
render: { prefix: 'webapp/' }
};[/code]