http server base on lua + libuv
参考：
实现目标：通过对coroutine包装实现同步代码编写异步程序，lua代码实现[形式同步]，c代码实现[实质异步]。
开发模式：需求驱动
##第一阶段工作：http1.1 预计三个月完成
###模块 ####system
system.cpuinfo()
- @overview returns an array of all cpus informations.
- @return {table[array(object)]}
ret = {
{
model = '{string} Intel(R) Core(TM) i7 CPU860 @2.80GHz',
speed = '{integer} [MHz]',
times = {
user = '{integer}',
nice = '{integer}',
sys = '{integer}',
idle = '{integer}',
irq = '{integer}'
}
},
{
model = '{string}',
speed = '{integer}',
times = {
user = '{integer}',
nice = '{integer}',
sys = '{integer}',
idle = '{integer}',
irq = '{integer}'
}
}
}system.meminfo()
- @overview returns the total and free system memory in bytes.
- @return {table}
ret = {
total = '{integer} [bytes]',
free = '{integer} [bytes]'
}system.loadavg()
- @overview returns an array containing the 1, 5, 15 minute load averages.
- @return {table[array(number)]}
system.hrtime()
- @overview returns the current high-resolution real time in nanoseconds.
- @return {integer} [nanoseconds]
system.uptime()
- @overview returns the system running time in seconds
- @return {number} [seconds]
####process
process.fork(options)
- @overview create a process and return the pid.
- @param options {table}
local options = {
file = '{string} the file to run in the process',
args = '{table[array(string)]} string arguments',
uid = '{integer} the user identity of the process',
gid = '{integer} the group identity of the process',
forever = '{boolean} if true, the process will restart when it dies',
cpu = '{integer} set the affinity of CPU and process',
detached = '{boolean} if true, the child process will be made the leader of a new process group. This makes it possible for the child to continue running after the parent exits'
}- @return pid {integer}
process.exec(command)
- @overview create a new process and executive the command
- @param command {string}
- @return pid {integer}
process.cwd()
- @overview return the current working directory of the process
- @return cwd {string}
process.exit([signal])
- @overview end the process with the specified signal
- @param signal {integer|default:SIGTERM}
process.abort()
- @overview abort the process and generate a core file(if core file is open)
process.kill(pid[, signal])
- @overview send a signal to a process
- @param pid {integer}
- @param signal {integer|default:SIGTERM}
process.uptime()
- @overview return the process running time in seconds
- @return {integer} [seconds]
####dns dns.resolve4(hostname)
- @overvie resolve hostname(e.g. 'baidu.com') into an array of IPv4 address
- @param hostname {string}
- @return {table[array(string)]} ips array
dns.resolve6(hostname)
- @overvie resolve hostname(e.g. 'baidu.com') into an array of IPv6 address
- @param hostname {string}
- @return {table[array(string)]} ips array
####tcp tcp.createServer(port, onconnect[, options])
- @overview create a new tcp server
- @param port {integer|required}
- @param onconnect {function|required}
local function onconnect(socket, server)
end- @param options {table}
local options = {
family = '{integer|default: 4}',
host = '{string|default: 0.0.0.0(::)}',
timeout = '{integer|default: 0}',
tcp_nodelay = '{boolean|default: true}',
tcp_keepalive = '{boolean|default: true}',
tcp_keepidle = '{integer|default: 0}',
tcp_backlog = 'integer|default: 511}',
tcp_reuseport = '{boolean|default: false}',
read_buffer_size = '{integer|default: 16}',
maxconnections = '{integer|default: 65535}'
}tcp.connect(port[, host, options])
- @overview connect to a host:port and return a new socket
- @param port {integer|required}
- @param host {string}
- @param options {table}
local options = {
family = '{integer|default: 4}',
timeout = '{integer|default: 0}',
tcp_nodelay = '{boolean|default: true}',
tcp_keepalive = '{boolean|default: true}',
tcp_keepidle = '{integer|default: 0}',
read_buffer_size = '{integer|default: 16}'
}- @return {2} socket {table[object]} error {table}
error = {
code = '[integer] error code',
name = '[string] error name',
message = '[string] error message'
}tcp.isIP(address)
- @overview test if address is an IPv4 or IPv6 address
- @param address {string}
- @return {integer} IPv4: 4, IPv6: 6, not an address: 0
server:address()
- @overview return the local address of the server
- @return address {table}
address = {
family = '{integer}',
port = '{integer}',
address = '{string}'
}server:connections()
- @overview return the current connections of the server
- @return {integer}
server:close()
- @overview close the server
socket:read(n)
- @overview read n bytes data from read buffer
- @param n {integer} bytes
- @return {2} data {string} error {table}
socket:readline()
- @overview read a line data from read buffer
- @return {2} data {string} error {table}
socket:write(data)
- @overview send data to the socket
- @param data {string|table[array(string)]}
- @return {table}
socket:localAddress()
- @overview return the local address of the socket
- @return address {table}
socket:remoteAddress()
- @overview return the remote address of the socket
- @return address {table}
socket:setTimeout(timeout)
- @overview set timeout milliseconds of inactivity(no read and write) on the socket, when the socket timeout, socket:read(n), socket:readline(), socket:writ(data) will return an error
- @param timeout {integer} [milliseconds]
socket:setNodelay([enable])
- @overview enable/disable the nagle algorithm
- @param enable {boolean|default: true}
- @return error {table}
socket:setKeepalive([enable][, idle])
- @overview enable/disable keep-alive functionality
- @param enable {boolean|default: true}
- @parm idle {integer|default : 0}
- @return error {table}
socket:end()
- @overview half close the socket, the socket write channel is shutdown
- @return error {table}
####http 进行中
####websocket
以下模块采用迭代开发模式，逐步完善
####log
####https
####redis
####mysql
####mongodb
####sequoiadb
##第二阶段工作：测试 预计两个月完成
####单元测试
####性能测试
##第三阶段工作：实例 结合实际情况开展项目，通过项目开发过程中出现的问题，形成需求，驱动links开发
####社区
####聊天
####游戏
##第四阶段工作：http2.0
####spdy3.0 看http2.0发展情况，如果http2.0推广的迅速就跳过这个阶段
####http2.0