Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/rickyes/polix
This repo is deprecated, please move to https://github.com/polixjs/polix
https://github.com/rickyes/polix
babel docker docker-compose dockerfile eslint gulp koa2 nodejs ts webframework
Last synced: 24 days ago
JSON representation
This repo is deprecated, please move to https://github.com/polixjs/polix
- Host: GitHub
- URL: https://github.com/rickyes/polix
- Owner: rickyes
- License: mit
- Created: 2018-03-05T12:18:18.000Z (over 6 years ago)
- Default Branch: master
- Last Pushed: 2018-07-13T13:25:30.000Z (over 6 years ago)
- Last Synced: 2024-09-27T19:05:47.657Z (about 1 month ago)
- Topics: babel, docker, docker-compose, dockerfile, eslint, gulp, koa2, nodejs, ts, webframework
- Language: JavaScript
- Homepage:
- Size: 114 KB
- Stars: 1
- Watchers: 1
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Polix
Node.js Web Framework
[](https://travis-ci.org/zhoumingque/polix)
[](https://www.npmjs.com/package/polix)
[](https://www.npmjs.com/package/polix)
`polix`是基于`koa v2.5.0`的`IOC`框架,和平常的`Node.js Web Framework`相比，它无需另外绑定路由集合，开发简单，依照`java`的著名依赖注入框架`spring`来制作，让开发者专注于逻辑。`polix`采用多服务多进程架构来保证服务的稳定和快速响应能力，每个`controller`都是一个独立的服务，各服务之间采用`RPC`来通信，这一点借鉴了`pomelo`的架构，不同的是，`polix`采用的是`google`的`gRPC`实现服务通信。`polix`的中间件和`koa v2.x`的中间件保持兼容。`polix`提供`Dockerfile`+`docker-compose.yml`方案进行部署，默认使用的`ORM`是`sequelize`(后续会提供`polix-orm`)。开发者可以选择ES6/7/8 或者 TypeScript来进行开发。
> 以上部分功能尚在开发阶段，敬请关注！
## Install
[](https://nodei.co/npm/polix/)
```bash
$ npm i polix --save
```
## Getting Started
```bash
$ npm i polix-cli -g
$ pol init example && cd example
$ make build && make dev
```
## Service
> 在`service`文件夹下添加`user.js`
```javascript
const { Service } = require('polix');
class UserService extends Service {
constructor(){
super();
this._name = {};
}
async addUser(userId,name){
this._name[userId] = name;
return this;
}
async getUser(userId){
return this._name[userId];
}
}
module.exports = UserService;
```
## Controller
> 在`controller`文件夹下添加`user.js`
```javascript
const { Controller, GET, POST, DEL, PUT } = require('polix');
class UserController extends Controller {
// POST /user/addUser
@POST
async addUser(param, ctx){
await this.service.user.addUser(param.userId,param.name);
ctx.body = {
result: 'ok'
};
}
// GET /user/getUser
@GET
async getUser(param, ctx){
let user = await this.service.user.getUser(param.userId);
ctx.body = {
user
};
}
// GET /user/info
@GET('info')
async getInfo(param, ctx){
ctx.body = {
v: 'v1.0'
}
}
// PUT /user/updateUser
@PUT
async updateUser(param, ctx){
ctx.body = {
status: true
}
}
// DEL /user/delUser
@DEL
async delUser(param, ctx){
ctx.body = {
status: true
};
}
// GET /user/status/:userId
@GET('status/:userId')
async getStatus(param, ctx){
ctx.body = {
status: true,
userId: param.userId
};
}
}
module.exports = UserController;
```
## middware
`polix`的中间件与koa 2.x 的中间件保持兼容
框架默认加载`koa-body`中间件，如需另外添加中间件则新建`middware`文件夹（与`controller`文件夹平级）
添加跨域中间件 ，新建`cors.js`:
```javascript
# cors.js
const cors = require('koa2-cors');
module.exports = function(){
return cors({
origin: function(ctx) {
return '*';
},
exposeHeaders: ['WWW-Authenticate', 'Server-Authorization'],
maxAge: 5,
credentials: true,
allowMethods: ['GET', 'POST', 'DELETE'],
allowHeaders: ['Content-Type', 'Authorization', 'Accept']
});
}
```
该文件夹下必须存在`index.js`文件作为总输出中间件文件,加载时根据导出对象的顺序进行绑定中间件
```javascript
# index.js
const cors = require('./cors');
module.exports = {
cors // 必须是函数 ,绑定方式为：app.use(cors())
}
```
## Start
```bash
$ make build && make dev
```
## Author
Polix © [Ricky 泽阳](https://github.com/zhoumingque), Released under the MIT License.