实践教程之如何快速使用 PolarDB-X

PolarDB-X 为了方便用户体验，提供了免费的实验环境，您可以在实验环境里体验 PolarDB-X 的安装部署和各种内核特性。除了免费的实验，PolarDB-X 也提供免费的视频课程，手把手教你玩转 PolarDB-X 分布式数据库。

本期实验可以让您快速体验PolarDB-X，让你像使用单机MySQL一样使用分布式数据库，直观感受PolarDB-X的MySQL兼容性。

1.前置准备

假设已经根据前一讲内容完成了PolarDB-X的搭建部署，可以成功链接上PolarDB-X数据库。

2.安装JDK

执行如下命令，使用yum安装JDK 1.8。

yum -y install java-1.8.0-openjdk*

执行如下命令，查看是否安装成功

java -version

返回结果如下，表示您已成功安装JDK 1.8。

3.体验 Spring Boot+PolarDB-X 应用开发

执行如下命令，安装Git。

yum -y install git

执行如下命令，下载Spring Boot样例工程。

git clone https://github.com/spring-guides/gs-accessing-data-mysql.git

执行如下命令，进入initial目录。

cd gs-accessing-data-mysql/initial git checkout b8408e3a1e05008811d542b706107d45160556ac

执行如下命令，查看样例工程代码。

ls

创建数据库

1 执行如下命令，登录PolarDB-X数据库。
mysql -h127.0.0.1 -P8527 -upolardbx_root -p123456

2 执行如下SQL语句，创建数据库db_example。
create database db_example;

3 执行如下SQL语句，创建用户springuser。
create user 'springuser'@'%' identified by 'ThePassword';

4 执行如下SQL语句，给用户springuser授权。
grant all on db_example.* to 'springuser'@'%';

5 输入exit退出数据库。

配置application.properties文件，将数据库连接到Spring Boot样例工程。

1 执行如下命令，打开application.properties配置文件。
vim src/main/resources/application.properties

2 按i键进入编辑模式，找到参数spring.datasource.url，并将参数值中的端口号修改为8527。
spring.datasource.url=jdbc:mysql://${MYSQL_HOST:localhost}:8527/db_example

3 修改完成后的文件内容如下所示。按下Esc键后，输入:wq后按下Enter键保存并退出。

创建Entity Model1

执行如下命令，创建一个User类。

vim src/main/java/com/example/accessingdatamysql/User.java

2 将如下代码复制粘贴到User类中。

package com.example.accessingdatamysql;  
import javax.persistence.Entity; 
import javax.persistence.GeneratedValue; 
import javax.persistence.GenerationType; 
import javax.persistence.Id;  
@Entity // This tells Hibernate to make a table out of this class 
public class User {
   @Id
   @GeneratedValue(strategy=GenerationType.AUTO)
   private Integer id;
   private String name;
   private String email;
   public Integer getId() {
     return id;
   }
   public void setId(Integer id) {
     this.id = id;
   }
   public String getName() {
     return name;
   }
   public void setName(String name) {
     this.name = name;
   }
   public String getEmail() {
     return email;   }
   public void setEmail(String email) {
     this.email = email;
   }
 }

3 修改完成后的文件内容如下所示。按下Esc键后，输入:wq后按下Enter键保存并退出。

创建Repository，保存用户记录

1 执行如下命令，创建一个UserRepository类。

vim src/main/java/com/example/accessingdatamysql/UserRepository.java

2 将如下代码复制粘贴到UserRepository类中。

package com.example.accessingdatamysql;  import org.springframework.data.repository.CrudRepository;  import com.example.accessingdatamysql.User;  // This will be AUTO IMPLEMENTED by Spring into a Bean called userRepository // CRUD refers Create, Read, Update, Delete  public interface UserRepository extends CrudRepository<User, Integer> {  }

3 修改完成后的文件内容如下所示。按下Esc键后，输入:wq后按下Enter键保存并退出。

创建一个Controller类，处理对应用程序的HTTP请求

1 执行如下命令，创建一个MainController类。

vim src/main/java/com/example/accessingdatamysql/MainController.java

2 将如下代码复制粘贴到MainController类中。

package com.example.accessingdatamysql;
import org.springframework.beans.factory.annotation.Autowired; 
import org.springframework.stereotype.Controller; 
import org.springframework.web.bind.annotation.GetMapping; 
import org.springframework.web.bind.annotation.PostMapping; 
import org.springframework.web.bind.annotation.RequestMapping; 
import org.springframework.web.bind.annotation.RequestParam; 
import org.springframework.web.bind.annotation.ResponseBody;  
@Controller // This means that this class is a Controller 
@RequestMapping(path="/demo") // This means URL's start with /demo (after Application path) 
public class MainController {
   @Autowired 
   // This means to get the bean called userRepository
   // Which is auto-generated by Spring, we will use it to handle the data
   private UserRepository userRepository;
   @PostMapping(path="/add")
   // Map ONLY POST Requests
   public @ResponseBody String addNewUser (@RequestParam String name
       , @RequestParam String email) {
   // @ResponseBody means the returned String is the response, not a view name     
   // @RequestParam means it is a parameter from the GET or POST request      
     User n = new User();
     n.setName(name);
     n.setEmail(email);
     userRepository.save(n);
     return "Saved";
   }

   @GetMapping(path="/all")
   public @ResponseBody Iterable<User> getAllUsers() {
     // This returns a JSON or XML with the users
     return userRepository.findAll();
   }
 }

3 修改完成后的文件内容如下所示。按下Esc键后，输入:wq后按下Enter键保存并退出。

创建一个Application

说明：Spring Boot样例工程中已为您创建好AccessingDataMysqlApplication类，您可跳过此步骤。

1 执行如下命令，创建一个AccessingDataMysqlApplication类。

vim src/main/java/com/example/accessingdatamysql/AccessingDataMysqlApplication.java2 按i键进入编辑模式，将如下代码复制粘贴到User类中。package com.example.accessingdatamysql;  
import org.springframework.boot.SpringApplication; 
import org.springframework.boot.autoconfigure.SpringBootApplication;  
@SpringBootApplication
 public class AccessingDataMysqlApplication {
    public static void main(String[] args) {
     SpringApplication.run(AccessingDataMysqlApplication.class, args);
   }
  }

3 修改完成后的文件内容如下所示。按下Esc键后，输入:wq后按下Enter键保存并退出。

运行Spring Boot样例

工程执行如下命令，运行Spring Boot样例工程。

./gradlew bootRun

请您耐心等待大约两分钟，返回结果如下，表示您成功运行。

测试

在实验页面，单击右上角的

图标，创建新的终端窗口。

在新的终端窗口中，执行如下命令，增加一条记录。

curl localhost:8080/demo/add -d name=First -d email=username@example.com

返回结果如下，表示您成功增加一条记录。

执行如下命令，查询记录。

curl 'localhost:8080/demo/all'

返回结果如下，您可以查询到刚刚增加的记录信息。

执行如下命令，登录PolarDB-X数据库。

mysql -h127.0.0.1 -P8527 -upolardbx_root -p123456

执行如下SQL语句，使用数据库。

use db_example;

执行如下SQL语句，查询user表。

select * from user;

返回如下结果，您可以在user表查询到刚刚增加的记录。

输入exit退出数据库。

4.体验WordPress+PolarDB-X部署博客站点

本步骤将指导您如何使用Wordpress的Docker镜像和PolarDB-X搭建一个博客站点。Wordpress提供了Docker镜像，方便其快速安装，详情请参见WordPress的Docker Hub主页。

安装WordPress

执行如下命令，安装WordPress。

docker run --name some-wordpress -p 9090:80 -d wordpress

创建WordPress的数据库。

1 执行如下命令，登录PolarDB-X数据库。
mysql -h127.0.0.1 -P8527 -upolardbx_root -p123456

2 执行如下SQL语句，创建数据库wordpress。
create database wordpress MODE='AUTO';

3 输入exit退出数据库。