actix-web-async-graphql-rbatis
Clean boilerplate for graphql services using actix-web, rhai, async-graphql, surf, rbatis, graphql-client, handlebars-rust, jsonwebtoken, and mysql / postgresql.
See also: tide-async-graphql-mongodb
Features
- Graphql Services
- User register
- Salt and hash a password with PBKDF2 - 使用 PBKDF2 对密码进行加密(salt)和散列(hash)运算
- Sign in
- JSON web token authentication - JWT 鉴权整合
- Change password
- Profile Update
- User: query & mutation
- Project: query & mutation
- Web Application
- Client request, bring & parse GraphQL data
- Render data to template engine
- Define custom helper with Rhai scripting language
Stacks
- Rust - 中文资料集萃
- actix-web - 中文文档
- rhai - Embedded Scripting for Rust
- async-graphql - 中文文档
- rbatis
- Surf
- graphql_client
- handlebars-rust
- jsonwebtoken
- cookie-rs
How to run?
git clone https://github.com/zzy/actix-web-async-graphql.git
cd actix-web-async-graphql
cargo build
Frontend - actix-web server
cd frontend-handlebars
Rename file .env.example
to .env
, or put the environment variables into a .env
file:
ADDRESS=127.0.0.1
PORT=3000
GRAPHQL_PORT=8080
GRAPHQL_PATH=graphql
GRAPHIQL_PATH=graphiql
Build & Run:
cargo run
Then connect to http://127.0.0.1:3000 with browser.
Backend - Graphql Server
cd backend
Rename file .env.example
to .env
, or put the environment variables into a .env
file:
ADDRESS=127.0.0.1
PORT=8080
GRAPHQL_PATH=graphql
GRAPHIQL_PATH=graphiql
MYSQL_URI=mysql://root:mysql@localhost:3306/budshome
POSTGRES_URI=postgres://root:mysql@localhost:5432/budshome
SITE_KEY=0F4EHz+1/hqVvZjuB8EcooQs1K6QKBvLUxqTHt4tpxE=
CLAIM_EXP=10000000000
Build & Run:
cargo run
GraphiQL: connect to http://127.0.0.1:8080/graphiql with browser.
Queries
- getUserByEmail(...): User!
- getUserByUsername(...): User!
- userSignIn(...): SignInfo!
- allUsers(...): [User!]!
- allProjects: [Project!]!
- allProjectsByUser(...): [Project!]!
MUTATIONS
- userRegister(...): User!
- userChangePassword(...): User!
- userUpdateProfile(...): User!
- addProject(...): Project!
Sample Usage
Sample mutation for user register:
mutation {
userRegister(
newUser: {
email: "example@budshome.com",
username: "我是谁",
password: "wo#$shi^$shui"
}
) {
id
email
username
}
}
Sample query for user sign in:
{
userSignIn(
userAccount: {
email: "example@budshome.com"
username: ""
password: "wo#$shi^$shui"
}
) {
email
username
token
}
}
When submit method userSignIn
, a token would be generated, use this token for query all users and every user's projects:
{
allUsers(
token: "fyJ0eXAiOiJKV1Q..."
) {
id
email
username
projects {
id
userId
subject
website
}
}
}
Sample query and mutation for projects was similar to users.
Contributing
You are welcome in contributing to this project.