APIJSON后端上手 - Java

APIJSONDemo 为 APIJSON + SpringBoot 的最简单的初级使用 Demo；
APIJSONBoot 为 APIJSON + SpringBoot 的接近生产环境成品的 Demo；
APIJSONFinal 为 APIJSON + JFinal 的接近生产环境成品的 Demo。

Oracle, SQLServer 的 JDBC 驱动用了 GPL 类协议，所以示例项目的 pom.xml 都没有加它们的 Maven 依赖，需要自己加。

以下简要地说明了上手步骤，也可以看这个详细的 图文入门教程

用现成的开箱即用 jar包 极速部署 见

https://github.com/TommyLemon/StaticResources/tree/master/APIJSONServer

1.下载后解压APIJSON-Demo工程

打开APIJSON-Demo的GitHub主页 > Clone or download > Download ZIP > 解压到一个路径并记住这个路径。

2.导入表文件到数据库

后端需要MySQL Server和MySQLWorkbench，没有安装的都先下载安装一个。
我的配置是Windows 7 + MySQL Community Server 5.7.16 + MySQLWorkbench 6.3.7 和 OSX EI Capitan + MySQL Community Server 5.7.16 + MySQLWorkbench 6.3.8 + Postgre 2.1.5，其中系统和软件都是64位的。

使用 Navicat

启动Navicat > 双击 localhost > 双击 postgres > 右键 postgres >
如果没有 sys 模式则先右键新建一个 > 运行 SQL 文件 > 根据你使用的数据库类型来选择刚才解压路径下的 APIJSON-Demo-Master 里的 MySQL/PostgreSQL/Oracle 等
> 开始 > 右键 postgres 里的 sys > 刷新， sys/表 会出现添加的表。

使用 MySQLWorkbench（仅限MySQL）

启动MySQLWorkbench > 进入一个Connection > 如果没有 sys Schema则先右键新建一个 > 点击Server菜单 > Data Import > 选择刚才解压路径下的APIJSON-Demo-Master/MySQL > Start Import > 刷新SCHEMAS， 左下方 sys/tables 会出现添加的表。

配置你自己的表请参考： 3步创建APIJSON后端新表及配置

3.用 Eclipse for JavaEE 或 IntellIJ IDEA Ultimate 运行后端工程

如果以上编辑器一个都没安装，运行前先下载安装一个。
我的配置是 Windows 7 + JDK 1.7.0_71 + Eclipse 4.6.1 + IntellIJ 2016.3 和 OSX EI Capitan + JDK 1.8.0_91 + Eclipse 4.6.1 + IntellIJ 2016.2.5

Eclipse for JavaEE

1)打开项目

顶部菜单 File > Import > Maven > Existing Maven Projects > Next > Browse
> 选择刚才解压路径下的APIJSON-Demo-Master/APIJSON-Java-Server/APIJSONBoot
> 勾选 /pom.xml ... apijson-demo > Finish

2)配置依赖库

其中 apijson-orm, apijson-framework 默认使用 Maven 远程依赖仓库，等待自动下载完成，
具体见 https://github.com/APIJSON/apijson-orm 和 https://github.com/APIJSON/apijson-framework
如果依赖下载不了，注释掉报错的 apijson-orm, apijson-framework 依赖代码，
然后右键 libs (APIJSONBoot 内，其它项目需要拷贝过去)里面的 apijson-orm.jar > Build Path > Add to Build Path
同样按照以上步骤来依赖 libs 目录内的其它所有 jar 包。

3)配置数据库(如果完成下方步骤 4，导入 APIJSON 的表，则可跳过)

打开 DemoSQLConfig 类，编辑 getDBUri，getDBAccount，getDBPassword，getSchema 的返回值为你自己数据库的配置。

4)运行项目

右键 DemoApplication > Run As > Java Application

IntellIJ IDEA Ultimate

1)打开项目

Open > 选择刚才解压路径下的 APIJSON-Demo-Master/APIJSON-Java-Server 里面的 APIJSONDemo(简单Demo) 或 APIJSONBoot(实际项目) > OK

2)配置依赖库

其中 apijson-orm, apijson-framework 默认使用 Maven 远程依赖仓库，等待自动下载完成，
具体见 https://github.com/APIJSON/apijson-orm 和 https://github.com/APIJSON/apijson-framework
如果依赖下载不了，注释掉报错的 apijson-orm, apijson-framework 依赖代码，
然后右键 libs (APIJSONBoot 内，其它项目需要拷贝过去)里面的 apijson-orm.jar > Add as Library > OK
同样按照以上步骤来依赖 libs 目录内的其它所有 jar 包。

3)配置数据库(如果完成下方步骤 4，导入 APIJSON 的表，则可跳过)

打开 DemoSQLConfig 类，编辑 getDBUri，getDBAccount，getDBPassword，getSchema 的返回值为你自己数据库的配置。

4)运行项目

右键 DemoApplication > Run DemoApplication.main

运行后会出现 APIJSON 的测试日志，最后显示 "APIJSON 已启动" ，说明已启动完成。

如果是 Address already in use，说明 8080 端口被占用，
可以关闭占用这个端口的程序(可能就是已运行的 APIJSON 工程)
或者 改下 APIJSON 工程的端口号，参考 SpringBoot 改端口。
其它问题请谷歌或百度。

4.测试连接

在浏览器输入 http://localhost:8080/get/{}
如果出现

{
  "code": 200,
  "msg": "success"
}

则说明已连接上。

如果是404 Not Found，请把防火墙关闭，以便外网能够访问你的电脑或服务器。
其它问题请谷歌或百度。

5.测试接口

直接使用 APIJSON在线工具 或 下载主页提供的 客户端App。