Dreamfactory使用简要说明

Dreamfactory使用说明

本文DF的安装环境是Ubuntu16.04。

从官网上下载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,并且可以测试一下。