文档：Welcome to sandman2’s documentation! — sandman2 0.0.1 documentation
【安装】
pip install sandman2
安装成功后，就可以得到一个 sandman2ctl 命令行工具，用它来启动一个 RESTful API 服务器
sandman2ctl sqlite+pysqlite:///data.db
启动之后，默认端口是 5000，访问地址是 http://localhost:5000/admin 就能看到服务器控制台了
【数据库连接】
sandman2 是基于 SQLAlchemy 的，所以使用连接 Url 来连接数据库
格式为
dialect+driver://username:password@host:port/database
-
dialect 为数据库类型，如 mysql、SQLite 等
-
driver 为数据库驱动模块名，例如 pymysql、psycopg2、mysqldb 等，如果忽略，表示使用默认驱动
例如：MySQL
sandman2ctl mysql+pymysql://bob:bobpasswd@localhost:3306/testdb
注意点：如果环境中没有安装 pymysql 模块，必须先安装，才能正常启动，其他数据库的连接方式可参考 SQLAlchemy 的 引擎配置 章节, 在这里查看 https://docs.sqlalchemy.org/en/13/core/engines.html
控制台
需要快速预览数据，对数据进行简单调整的话，控制台很有用
左侧菜单除了 Home 外，其他的都是库表名称
点击相应库表名称，会在右侧显示表内数据，并且可以做增删改操作
API
以 RESTful 的角度来看，库表相当于资源(resource)，一组资源相当于集合(collection)
查询
通过 Http GET 方法，以 JSON 格式将数据返回，例如返回 学生表 student 的所有记录：
$ curl http://localhost:5000/student/
{"resources":[{"age":18,"class":"1","id":1,"name":"\u5f20\u4e09","profile":"\u64c5\u957f\u5b66\u4e60"},...
注意：资源要以 / 结尾
通过参数 page 来分页，例如返回 学生表 student 的第一页数据
$ curl http://localhost:5000/student/?page=1
{"resources":[{"age":18,"class":"1"...
通过参数 limit 显示返回行数
如果要获取具体记录，可以用主键值作为节段，例如获取 id 为 3 的学生记录
$ curl http://localhost:5000/student/3
{"age":18,"class":"2","id":3,"name":"\u738b\u4e94","profile":"\u7231\u7f16\u7a0b"}
以字段名做参数，相当于查询条件，例如，查询 name 为 Tom 的学生记录：
$ curl http://localhost:5000/student/?name=Tom
{"resources":[{"age":19,"class":"1","id":7,"name":"Tom","profile":"Handsome"}]}
查询条件可以被组合，例如，查询班级为 1 年龄为 18 的学生:
$ curl http://localhost:5000/student/?class=1&age=19
{"resources":[{"age":19,"class":"1","id":2,"name":"\u674e\u56db","profile":"\u559c\u6b22\u7bee\u7403"},{"age":19,"class":"1","id":7,"name":"Tom","profile":"Handsome"}]}
修改
POST 方法用于新增，新增内容，由请求的数据部分提供，例如增加一个学生信息：
$ curl -X POST -d '{"name": "Lily", "age": 17, "class":1, "profile":"Likely"}' -H "Content-Type: application/json" http://127.0.0.1:5000/student/
{"age":17,"class":"1","id":8,"name":"Lily","profile":"Likely"}
注意：库表主键是自增长的，可以忽略主键字段，否则必须提供
PATCH 方法用于更新，更新内容，由请求的数据部分提供，例如将 id 为 1 的学生班级更改为 3
注意: 更新时主键信息通过 url 的主键值节段提供，而不在数据部分中
$ curl -X PATCH -d '{"class":3}' -H "Content-Type: application/json" http://127.0.0.1:5000/student/1 {"age":18,"class":"3","id":1,"name":"\u5f20\u4e09","profile":"\u64c5\u957f\u5b66\u4e60"}
DELETE方法由于删除，例如删除 id 为 8 的学生记录:$ curl -X DELETE -H "Content-Type: application/json" http://127.0.0.1:5000/student/8
其他接口
获取表的字段定义信息，通过
meta节段获取，例如获取学生表 student的字段定义：$ curl http://127.0.0.1:5000/student/meta {"age":"INTEGER(11)","class":"VARCHAR(255)","id":"INTEGER(11) (required)","name":"VARCHAR(255)","profile":"VARCHAR(500)"}
导出数据，通过查询字段
export获取，数据格式为 csv，例如导出学生数据，存放到 student.csv 文件中：
$ curl -o student.csv http://127.0.0.1:5000/student/?export % Total % Received % Xferd Average Speed Time Time Time Current Dload Upload Total Spent Left Speed 100 202 100 202 0 0 2525 0 --:--:-- --:--:-- --:--:-- 2525