README

Web Server, including HTTP and HTTPS.

Configuration
- feidao.json
  - java
  - max_file_size
  - port
  - timeout
  - wx.appid
  - wx.appsecret
  - wx.getopenid
  - wx.getuserinfo
  - wx.token
  - secure.redirect
  - secure.ignore
  - favicon
  - spaceid
  - type
  - routers
  - routers.url
  - routers.method
  - routers.service
  - routers.data
- 说明
favicon.ico
log4js.json

Configuration

feidao.json

{
    "java": "http://192.168.40.196/router4js",
    "port": 8889,
    "timeout": 50000,
    "wx": {
        "getopenid": true,
        "getuserinfo": false,
        "token": "dfeidao",
        "appid": "wx7d84eff0fb9683e4",
        "appsecret": "63d1f587ee735140cbe653822c3f5823"
    },
    "max_file_size": 53687091200,
    "secure": {
        "redirect": "",
        "ignore": [
            "/home.html",
            "http://thirdpart.com"
        ]
    },
    "favicon": "./favicon.ico",
    "spaceid": "webtest",
    "type": "web",
    "routers": [
        {
            "url": "/xxx",
            "method": "get",
            "service": "dataservice.nodejs",
            "data": {
                "modelid": "web/captcha"
            }
        }
    ]
}

java

运维提供的java服务地址,如 http://192.168.40.196/router4js

max_file_size

支持的最大文件大小,计算方法为 x*1024*1024,比如要设置限制最大上传200兆的文件,那么这个值就应该配置为200*1024*1024=209715200,比如要设置限制最大上传500兆的文件,那么这个值就应该配置为500*1024*1024=524288000

port

web容器的端口号,通常我们使用8889或8890

timeout

请求服务的超时时间(非客户端请求的时间),单位为毫秒,通常设置为5秒5000

wx.appid

微信公众号,微信小程序,均须配置该参数和wx.appsecret,用来调用微信开发平台接口使用.

wx.appsecret

微信公众号,微信小程序,均须配置该参数和wx.appid,用来调用微信开发平台接口使用.

wx.getopenid

公众号项目getopenid和getuserinfo必须配置其一值为true,通常建议设置getopenid为true.二者的区别为:

getopenid

用户打开页面无感知,体验好.
getuserinfo

当该公众号页面无须关注但仍须获取用户信息时请设置 getuserinfo.

这二种方式均会在每个服务请求的消息体添加wxuserinfo参数.参数值有不同:

getopenid

{
    wxuserinfo: {
        openid: string; // 用户的唯一标识
    }
}

getuserinfo

{
    openid: string;		// 用户的唯一标识
    nickname: string;	// 用户昵称
    sex: '1' | '2';		// 用户的性别，值为1时是男性，值为2时是女性，值为0时是未知
    province: string;		// 用户个人资料填写的省份
    city: string;			// 普通用户个人资料填写的城市
    country: string;		// 国家，如中国为CN
    headimgurl: string;	// 用户头像，最后一个数值代表正方形头像大小（有0、46、64、96、132数值可选，0代表640*640正方形头像），用户没有头像时该项为空。若用户更换头像，原有头像URL将失效。
    privilege: string[];	// 用户特权信息，json 数组，如微信沃卡用户为（chinaunicom）
    unionid: string;		// 只有在用户将公众号绑定到微信开放平台帐号后，才会出现该字段。
}

wx.getuserinfo

参见wx.getopenid说明.

wx.token

登录公众号平台,在开发->基本配置->服务器配置->Token中配置

secure.redirect

该项目如果为安全级别较高项目需配置.配置参数参数之后,所有到服务器所有(ignore配置的页面除外)资源(包括服务调用,css,js等)的请求均会验证sessionid,如果未登录或登录失效,所有请求将会被拒绝,返回403错误.

secure.ignore

对于某些请求(比如登录页面,开放给第三方的服务地址)不能验证sessionid,请在这里配置.

favicon

请固定使用"./favicon.ico"作为该配置值.

spaceid

当前项目的spaceid

type

项目的类型,同一个产品下的不同端点的项目请务必配置为不同的值.通常使用的有web,h5,mobile.

routers

当前项目提供的web服务

routers.url

服务的url,支持通配符,请务必使用/开头.以下为保留url,项目上禁止使用.

/sendmessage
/wx-validate
/*.html
/*.docx
/*.pdf
/*.xlsx
/getip
/invoke-atom

routers.method

目前支持三种参数配置post,get,all(一般情况下请不要使用)

routers.service

messagetype,如js服务为dataservice.nodejs,也可以是其它服务端(如java服务)提供的其它服务.

routers.data

附加参数,这里设置的参数将会添加到消息体中.比如js服务需要添加固定参数"modelid": "xxx"(xxx为js服务路径),但不限于此,开发者可以添加更多的参数,以减少客户端调用参数及网络传输.

@dfeidao/server

Usage no npm install needed!