Dreamfactory使用说明
本文Dreamfactory的安装环境是Ubuntu16.04。
从官网(https://www.dreamfactory.com/)上下载DreamFactory,安装后会自动安装MariaDB,并在此实例中生成两个数据库,bitnami_dreamfactory和binami_df两个数据库。binami_dreamfactory存储系统的配置数据。而业务数据库可以通过建立配置DreamFactory连接查询。当然也可以使用自带的Maria数据库来保存业务数据。
主面板功能
Apps: 平台的应用(客户端)。一个应用要接入平台需要先创建ApiKey,默认已创建的应用有admin平台管理,api_docsApi演示,file_manager文件管理。我们也可以创建自己的ApiKey接入我们应用。
Admins: DreamFactory管理平台管理员帐户。用于登录管理后台。
Users: DreamFactory管理平台用户帐户。用于登录管理后台。可以设置角色,其权限由角色来决定。
Roles: 用户角色管理。角色对应Service的使用权限和使用方式。
Service: 服务管理。平台台提供的所有服务都在这里有定义。默认创建的服务有system管理系统资源服务,api_docs演示Api文档服务,user用户管理服务。默认可选的服务有file访问本地文件服务,db访问本地SQLite数据库服务,email本地邮件服务。一般,一个Service的体现是一个数据库。比如,有一个订单记录的查询服务,其对应的可以是一个订单数据库。
Schema: 查询和刷新已连接数据库的表结构和修改定义。
Files: 文件上传下载管理。
Scripts: 可以通过PHP,Nodejs等脚本来处理查询出的数据,再生成接口。
API Docs: API演示文档。可以在这里查看Api的用法。
Config: 查看系统信息、清除缓存等。
Packages: 备份DreamFactory配置信息。
创建自己的服务
1.导入数据至数据库,可以是本机的数据库,也可以是远程的。也可以重用DreamFactory的配置数据库。
2.在DreamFactory控制台,配置CORS
CORS(Cross-Origin Resource Sharing),是一个系统级别的Web服务。主要配置hosts(主机)和HTTP变量,开发阶段可以使用*来代替,使用所有机器都可以访问。
3.进入Roles设置,创建一个角色
点开Access选项卡,配置角色的服务访问规则。约束该角色用户可以访问哪些服务和组件。Component可以选刚创建的CORS。
4.打开App管理,创建一个App
现在可以看到API Key,使用这个API Key不需要登录就可以访问到Role的所有权限。如果需要登录才能访问接口,应当在Role的里不添加任何Access(上一步添加GET方法Access)
5.创建一个服务,连接数据库
Service Type选择 Database->MySQL
配置config,可以配置为本机或者其他机器上的数据库。这里我配置本机上的别一个数据库服务,端口号为3306
现在我们可以在API Doc里看到刚创建的App,并且可以测试一下。