一个后端框架,支持AI编写,不写编程代码就能启动服务器进行增删改查,还能为前端生成请求包,写一个登录功能只需5行代码。支持Node.js,支持Python,支持Rust。使用编程代码的话,它的ORM API可能是世界上最好用,最类型安全的。
使用方法
它的使用方法非常简单,一般我们在编写后端开发的时候,肯定离不开数据建模,编写各个类和表,我们就编写这个,就能得到默认的增删改查和分组聚合。
connector { provider: .sqlite, url: "sqlite::memory:" } server { bind: ("0.0.0.0", 5050) } model User { @id @autoIncrement @readonly id: Int @unique @onSet($if($presents, $isEmail)) email: String name: String? @relation(fields: .id, references: .authorId) posts: Post[] } model Post { @id @autoIncrement @readonly id: Int title: String content: String? @default(false) published: Bool @foreignKey authorId: Int @relation(fields: .authorId, references: .id) author: User }
这就是最精简的博客网站的后台,用户和文章相关联。我们可以对用户和文章进行非常丰富的创建、编辑和查询等操作。
如果要创建一个用户的同时创建其相关联的文章,使用这个请求,发送到/User/create。
{ "create": { "email": "[email protected]", "name": "Ada", "posts": { "create": [ { "title": "Introducing Teo", "content": "This post introduces Teo." }, { "title": "The next generation framework", "content": "Use the next generation technology." } ] } }, "include": { "posts": true } }
这样的返回值会包括用户,也包括文章。
{ "data": { "id": 1, "email": "[email protected]", "name": "Ada", "posts": [ { "id": 1, "title": "Introducing Teo", "content": "This post introduces Teo.", "published": false, "authorId": 1 }, { "id": 2, "title": "The next generation framework", "content": "Use the next generation technology.", "published": false, "authorId": 1 } ] } }
5行代码编写登录
一个集成的登录只需要5行代码。请看演示:
@identity.tokenIssuer($identity.jwt(expired: 3600 * 24 * 365)) @identity.jwtSecret(ENV["JWT_SECRET"]!) model User { @id @autoIncrement @readonly id: Int @unique @onSet($if($presents, $isEmail)) @identity.id email: String @writeonly @onSet($presents.bcrypt.salt) @identity.checker($get(.value).presents.bcrypt.verify($self.get(.password).presents)) password: String include handler identity.signIn include handler identity.identity } middlewares [identity.identityFromJwt(secret: ENV["JWT_SECRET"]!)]
这里的代码多于5行,是因为用户表的字段也在这段代码里。把这个请求发送到/User/signIn:
{
"credentials": {
"email": "[email protected]",
"password": "Aa123456"
}
}
我们得到了用户信息和他的token。
{
"data": {
"id": 1,
"email": "[email protected]"
},
"meta": {
"token": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpZCI6eyJpZCI6MX0sIm1vZGVsIjpbIlVzZXIiXSwiZXhwIjoxNzQyMTI0NDk2fQ.x2DSIpdnUeJtsUOGQsHlGksr29aF-CWog6X5LILxsOc"
}
}
完整框架功能一个不少
文件上传,文件返回,静态目录映射,返回HTML页面,或是返回其他内容,一应俱全。Teo的插件是先进的先进后出插件,即第一个插件进入,第二个插件进入,执行路由定义,第二个插件退出,第一个插件退出。
要编写自定义路由,请看这里,这三段代码分别用Node.js,Python和Rust编写,选择你想选择的语言开发后台即可:
import { App, Response, RequestCtx } from '@teocloud/teo' import { EchoPathArguments } from './entities' const app = new App() app.mainNamespace().defineHandler("hello", () => { return Response.html(` <html> <head> <title>Hello, Teo handlers</title> </head> <body> <h1>Hello, Teo handlers!</h1> </body> </html> `) }) app.mainNamespace().defineHandler("empty", () => { return Response.empty() }) app.mainNamespace().defineHandler("echo", (ctx: RequestCtx) => { const pathArguments: EchoPathArguments = ctx.pathArguments() return Response.string(pathArguments.data, "text/plain") }) app.run()
from asyncio import run from teo import App, Response, RequestCtx from entities import EchoPathArguments async def main(): app = App() def hello_handler(_ctx): return Response.html(""" <html> <head> <title>Hello, Teo handlers</title> </head> <body> <h1>Hello, Teo handlers!</h1> </body> </html> """) app.main_namespace().define_handler("hello", hello_handler) def empty_handler(_ctx): return Response.empty() app.main_namespace().define_handler("empty", empty_handler) def echo_handler(ctx: RequestCtx): path_arguments: EchoPathArguments = ctx.path_arguments() return Response.string(path_arguments["data"], "text/plain") app.main_namespace().define_handler("echo", echo_handler) await app.run() run(main())
mod entities; use tokio::main; use teo::prelude::{App, Response, Result, path}; use crate::entities::EchoPathArguments; #[main] async fn main() -> Result<()> { let app = App::new()?; app.main_namespace_mut().define_handler("hello", || async { let response = Response::html(r#" <html> <head> <title>Hello, Teo handlers</title> </head> <body> <h1>Hello, Teo handlers!</h1> </body> </html> "#)?; Ok::<Response, Error>(response) }); app.main_namespace_mut().define_handler("empty", || async { Ok::<Response, Error>(Response::empty()) }); app.main_namespace_mut().define_handler("echo", |path_args: EchoPathArguments| async move { Ok::<Response, Error>(Response::string(path_args.data(), "text/plain")) }); app.run().await }
在这个例子中,我们定义了三个路由,返回HTML,返回空,和返回文本。
开始使用
Teo的安装过程非常简单,Node.js用npm、pnpm、yarn都可以安装,Python的用pip安装,Rust的用cargo安装,都是语言标配的包管理工具。
npm install @teocloud/teo # node.js pip install teo # python cargo install teo # rust
添加我们的微信群管微信caofz007,关注公众号,在Gitee上面给我们的辛苦劳动一点鼓励,点一颗星,即可加入我们微信群。群里你可以任意问答,我们有专人回复,我们的作者会聆听你的需求,为你改变框架的未来,开发你正需要的功能。
项目地址
官网:https://teocloud.io
Gitee: https://gitee.com/teocloud/teo
学习资料
我们的作者花了数月的时间编写文档,我们的官网有详细的文档和教程,现在的浏览器翻译工具非常厉害,只要安装一个翻译插件,网站秒变中文,阅读轻松畅快。
还没有评论,来说两句吧...