Update README-English.md

This commit is contained in:
TommyLemon 2022-10-17 20:02:03 +08:00 committed by GitHub
parent a14f39acae
commit e63485571b
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23

View File

@ -162,94 +162,8 @@ Note: The UI is APIAuto, the URL+JSON is APIJSON<br/>
## <h2 id="2">2.Server-side deployment<h2/>
You can use either Eclipse for JavaEE or IntelllJ IDEA Ultimate to make installation. For both, first download the project and save it to a path.
### <h3 id="2.1">2.1 Installing with Eclipse<h3/>
#### <h4 id="2.1.1">2.1.1 prerequisites<h4/>
Java Development Kit(JDK): 1.8 or above
[MAVEN](https://maven.apache.org/download.cgi): 3.0 or above
Mysql / Oracle
[Eclipse Java EE IDE](https://www.eclipse.org/downloads/)for Web Developers.Version: Mars.1 Release (4.5.1)
#### <h4 id="2.1.2">2.1.2 Opening the project with Eclipse<h4/>
Open Eclipse> *File > Import > Maven > Existing Maven Projects > Next > Browse > Select the path of the project you saved / APIJSON-Java-Server / APIJSONBoot > check pom.xml...apijson-demo > Finish*
#### <h4 id="2.1.3">2.1.3 Preparing the library used in demo<h4/>
In the menu at the right, click libs, right click apijson-orm.jar,click add as library. Apply the same to the rest *.jar* files in libs.
#### <h4 id="2.1.4">2.1.4 Configuration<h4/>
Open apijson.demo.server.DemoSQLConfig. In line 40-61, change return values of `getDBUri`,`getDBAccount`,`getDBPassword`,`getSchema` to your own database.<br/>
```java
static {
DEFAULT_DATABASE = DATABASE_MYSQL; // TODO
DEFAULT_SCHEMA = "sys"; // TODO defaults: MySQL: sys, PostgreSQL: public, SQL Server: dbo, Oracle:
}
@Override
public String getDBVersion() {
return "5.7.22"; // "8.0.11"; // TODO
}
@JSONField(serialize = false)
@Override
public String getDBUri() {
// add userSSL=false for MySQL 8.0+ return "jdbc:mysql://localhost:3306?userSSL=false&serverTimezone=GMT%2B8&useUnicode=true&characterEncoding=UTF-8";
// for MySQL not greater than 5.7
return "jdbc:mysql://localhost:3306?serverTimezone=GMT%2B8&useUnicode=true&characterEncoding=UTF-8"; // TODO TiDB can be used as MySQL, its defaut port is 4000
}
@JSONField(serialize = false)
@Override
public String getDBAccount() {
return "root"; // TODO
}
@JSONField(serialize = false)
@Override
public String getDBPassword() {
return "apijson"; // TODO TiDB can be used as MySQL, its defaut password is an empty string ""
}
```
**Note**: Instead of this step, you can also [import your database](#2.2).
#### <h4 id="2.1.5">2.1.5 Running the application<h4/>
In Eclipse, in the menu on the top, click *Run>Run As>Java Application>choose APIJSONApplication>OK*
### <h3 id="2.2">2.2 Import MySQL table files<h3/>
This Server project needs [MySQL Server](https://dev.mysql.com/downloads/mysql/) and [MySQLWorkbench](https://www.mysql.com/products/workbench/). Please make sure that both of them are installed.<br />
My config is Windows 7 + MySQL Community Server 5.7.16 + MySQLWorkbench 6.3.7 and OSX EI Capitan + MySQL Community Server 5.7.16 + MySQLWorkbench 6.3.8. Systems and softwares are all 64 bit.
Start *MySQLWorkbench > Enter a connection > Click Server menu > Data Import > Select the path of your .sql file > Start Import > Refresh SCHEMAS*. Now you should see tables are added successfully.
### <h3 id="2.3">2.3 Installing with IntellIJ IDEA Ultimate<h3/>
#### <h4 id="2.3.1">2.3.1 Opening the project<h4/>
*Open > Select the path of the project/APIJSON-Java-Server/APIJSONBoot > OK*
#### <h4 id="2.3.2">2.3.2 Preparing the library used in demo<h4/>
In libs, right-click *apijson-orm.jar >Add as Library>OK*. Apply this to all *.jar* files in libs.
#### <h4 id="2.3.3">2.3.3 Running the application<h4/>
In the menu on the top: *Run > Run > Edit Configurations > + > Application > Configuration*<br />
In *Main class* , choose *APIJSONApplication*;<br />
In *Use classpath of module* , choose *apijson-demo*.<br />
Click *Run* in the bottom.
**Note**: After running, you should see APIJSON test logs and in the last, it would show APIJSON已启动. If it shows address already in use, that means port 8080 has been used . You need tochange the port. See [how to change ports for a Spring Boot Application.](https://stackoverflow.com/questions/21083170/how-to-configure-port-for-a-spring-boot-application)
You can skip this step and use 'apijson.cn:8080'. <br />
See https://github.com/APIJSON/APIJSON-Demo/blob/master/APIJSON-Java-Server/README-English.md
<br />