Forest简介：
Forest是一个高层的、极简的轻量级HTTP调用API框架。相比于直接使用Httpclient您不再用写一大堆重复的代码了，而是像调用本地方法一样去发送HTTP请求。
环境配置：
因为本项目想要将调用得到的数据存进数据库，所以我在创建springBoot项目的时候勾选了以下的模块，具体的mybatis配置请看这篇博客
除了上面的环境，还需要添加本篇博客的主题forest，由于后面设计操作excel,所以还需要poi的相关jar，在pom中添加下面的依赖：
<dependency>
<groupId>com.dtflys.forest</groupId>
<artifactId>spring-boot-starter-forest</artifactId>
<version>1.4.0</version>
</dependency>
<!-- Excel中表格POI插件 -->
<dependency>
<groupId>org.apache.poi</groupId>
<artifactId>poi</artifactId>
<version>3.8</version>
</dependency>
<!-- poi插件 XSSFWorkbook和SXSSHWorkbook -->
<dependency>
<groupId>org.apache.poi</groupId>
<artifactId>poi-ooxml</artifactId>
<version>3.8</version>
</dependency>
plugins添加下面的插件：
<!--添加配置跳过测试-->
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-surefire-plugin</artifactId>
<version>2.22.1</version>
<configuration>
<skipTests>true</skipTests>
</configuration>
</plugin>
<!--添加配置跳过测试-->
application.yml的配置：
spring:
application:
name: demo
datasource:
username: root
password: root
url: jdbc:mysql://127.0.0.1:3306/bigdata?serverTimezone=Asia/Shanghai
driver-class-name: com.mysql.cj.jdbc.Driver
server:
port: 8888
servlet:
context-path: /demo # 添加项目名为 demo
# ========================== ↓↓↓↓↓↓ forest配置 ↓↓↓↓↓↓ ==========================
forest:
bean-id: config0 # 在spring上下文中bean的id, 默认值为forestConfiguration
backend: okhttp3 # 后端HTTP API： okhttp3 【支持`okhttp3`/`httpclient`】
max-connections: 1000 # 连接池最大连接数，默认值为500
max-route-connections: 500 # 每个路由的最大连接数，默认值为500
timeout: 8000 # 请求超时时间，单位为毫秒, 默认值为3000
connect-timeout: 8000 # 连接超时时间，单位为毫秒, 默认值为2000
retry-count: 6 # 请求失败后重试次数，默认为0次不重试
ssl-protocol: SSLv3 # 单向验证的HTTPS的默认SSL协议，默认为SSLv3
logEnabled: true # 打开或关闭日志，默认为true
至此，环境就已经配置完毕！
简单的入门demo
- 书写一个返回json字符串的controller层，向外界暴露接口。
package org.lzl.forest.api;
import org.springframework.beans.factory.annotation.Value;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.bind.annotation.RestController;
@RestController
public class IndexController {
@Value(value = "${spring.application.name}")
private String applicationName; //demo
@GetMapping("/index")
public String index() {
return "您好，欢迎访问【" + applicationName + "】";
}
@GetMapping("/hello")
public String hello(@RequestParam(required = false) String msg) throws InterruptedException {
// 模拟业务耗时处理流程
// Thread.sleep(2 * 1000L);
return "hello: " + msg;
}
}
- 书写一个接口MyClient，在@Get的括号中书写请求controller层的接口。
package org.lzl.forest.rpc.client;
import com.dtflys.forest.annotation.DataVariable;
import com.dtflys.forest.annotation.Get;
import java.util.Map;
public interface MyClient {
/**
* 本地测试接口
*/
@Get(url = "http://127.0.0.1:8888/demo/index")
String index();
@Get(url = "http://127.0.0.1:8888/demo/hello?msg=${msg}")
String hello(@DataVariable("msg") String msg);
}
- 在springboot的启动类上加上@ForestScan注解，扫描上面写的接口的包
- 测试 注意在运行前要提前运行springboot的启动类。
@RunWith(SpringRunner.class)
@SpringBootTest
class ForestApplicationTests {
@Autowired
private MyClient myClient;
@Test
public void testForest() throws Exception {
// 调用接口
String index = myClient.index();
System.out.println(index);
String hello = myClient.hello("测试...");
System.out.println(hello);
}
}
运行结果：
正式进入本篇博客的主题
彩云api其实也就是像上面我们自己写的controller，那样像外界暴露一个端口，返回一个json字符串。想要使用彩云就需要先去注册：注册地址
测试接口
注册好了之后，根据里面的api文档，在MyClient接口中加入下面的方法：
先测试这个接口能否调用成功：
@Test
public void testWeather() throws Exception{
Map weather = myClient.getWeather("121.475070,31.223570");
System.out.println(weather.toString());
}
运行很成功：
根据返回的json字符串的详细信息，设计bean的属性，和数据库的字段：
public class Weather {
private String cityName;//城市名字
private String temperature;//温度
private String cloudrate;//云量
private String skycon;//
private String visibility;//能见度
private String dswrf;//
private String pressure;//压力
private String apparent_temperature;//表观温度
private String humidity;//湿度
//省略getter,setter 和 构造器
}
并提前写好mapper层;
package org.lzl.forest.mapper;
import org.apache.ibatis.annotations.Insert;
import org.apache.ibatis.annotations.Mapper;
import org.lzl.forest.pojo.Weather;
@Mapper
public interface MyMapper {
@Insert("insert into weather values(#{cityName},#{temperature},#{cloudrate},#{skycon},#{visibility},#{dswrf},#{pressure},#{apparent_temperature},#{humidity})")
void insert(Weather weather);
}
由于彩云是根据经纬度来返回天气情况的，所以我们需要先下载城市和经纬度的对照表，下载地址，由于解压之后是个excel文件。
下面我们的工作就是读取excel的数据，将数据封装成hjava的map。map的key为城市名，map的value为（经度,维度）的字符串。
对excel的操作就需要用到poi的jar（前面已经引入了！）先写个PIO的帮助类：
package org.lzl.forest.util;
import java.text.DateFormat;
import java.text.DecimalFormat;
import java.text.SimpleDateFormat;
import java.util.Date;
import org.apache.poi.hssf.usermodel.HSSFCell;
import org.apache.poi.hssf.usermodel.HSSFDateUtil;
import org.apache.poi.ss.usermodel.Cell;
import org.apache.poi.ss.usermodel.FormulaEvaluator;
public class POIUtil {
/**
* 获取cell中的值并返回String类型
*
* @param cell
* @return String类型的cell值
*/
public static String getCellValue(Cell cell) {
String cellValue = "";
if (null != cell) {
// 以下是判断数据的类型
switch (cell.getCellType()) {
case HSSFCell.CELL_TYPE_NUMERIC: // 数字
if (0 == cell.getCellType()) {// 判断单元格的类型是否则NUMERIC类型
if (HSSFDateUtil.isCellDateFormatted(cell)) {// 判断是否为日期类型
Date date = cell.getDateCellValue();
// DateFormat formater = new SimpleDateFormat("yyyy/MM/dd HH:mm");
DateFormat formater = new SimpleDateFormat("yyyy/MM/dd");
cellValue = formater.format(date);
} else {
// 有些数字过大，直接输出使用的是科学计数法： 2.67458622E8 要进行处理
DecimalFormat df = new DecimalFormat("####.####");
cellValue = df.format(cell.getNumericCellValue());
// cellValue = cell.getNumericCellValue() + "";
}
}
break;
case HSSFCell.CELL_TYPE_STRING: // 字符串
cellValue = cell.getStringCellValue();
break;
case HSSFCell.CELL_TYPE_BOOLEAN: // Boolean
cellValue = cell.getBooleanCellValue() + "";
break;
case HSSFCell.CELL_TYPE_FORMULA: // 公式
try {
// 如果公式结果为字符串
cellValue = String.valueOf(cell.getStringCellValue());
} catch (IllegalStateException e) {
if (HSSFDateUtil.isCellDateFormatted(cell)) {// 判断是否为日期类型
Date date = cell.getDateCellValue();
// DateFormat formater = new SimpleDateFormat("yyyy/MM/dd HH:mm");
DateFormat formater = new SimpleDateFormat("yyyy/MM/dd");
cellValue = formater.format(date);
} else {
FormulaEvaluator evaluator = cell.getSheet().getWorkbook().getCreationHelper()
.createFormulaEvaluator();
evaluator.evaluateFormulaCell(cell);
// 有些数字过大，直接输出使用的是科学计数法： 2.67458622E8 要进行处理
DecimalFormat df = new DecimalFormat("####.####");
cellValue = df.format(cell.getNumericCellValue());
// cellValue = cell.getNumericCellValue() + "";
}
}
// //直接获取公式
// cellValue = cell.getCellFormula() + "";
break;
case HSSFCell.CELL_TYPE_BLANK: // 空值
cellValue = "";
break;
case HSSFCell.CELL_TYPE_ERROR: // 故障
cellValue = "非法字符";
break;
default:
cellValue = "未知类型";
break;
}
}
return cellValue;
}
}
然后在springboot提供的测试类中正式写代码，封装到map（见方法readExcelToMap），然后遍历map，挨个请求每个map键值对的value地址，将数据存进数据库（见方法insertWeatherIntoDb）
@RunWith(SpringRunner.class)
@SpringBootTest
class ForestApplicationTests {
static HashMap<String, String> hashMap = new HashMap();
public static void readExcelToMap(){
String filePath = "src/main/resources/static/adcode-release-2020-06-10.xlsx";
InputStream fis = null;
try {
fis = new FileInputStream(filePath);
Workbook workbook = null;
if (filePath.endsWith(".xlsx")) {
workbook = new XSSFWorkbook(fis);
} else if (filePath.endsWith(".xls") || filePath.endsWith(".et")) {
workbook = new HSSFWorkbook(fis);
}
fis.close();
/* 读EXCEL文字内容 */
// 获取第一个sheet表，也可使用sheet表名获取
Sheet sheet = workbook.getSheetAt(0);
// 获取行
Iterator<Row> rows = sheet.rowIterator();
Row row;
Cell cell;
int k = 0;
while (rows.hasNext()) {
k++;
row = rows.next();
// 获取单元格
Iterator<Cell> cells = row.cellIterator();
int n = 0 ;
String key = "";
String value = "";
while (cells.hasNext()) {
n++;
cell = cells.next();
String cellValue = POIUtil.getCellValue(cell);
// System.out.print(cellValue + " ");
if(n==2){
// System.out.print(cellValue+ " ");
key = key+cellValue;
}else if(n==3){
// System.out.print(cellValue+",");
value = value+cellValue+",";
}else if(n==4){
// System.out.print(cellValue);
value = value+cellValue;
n=0;
}
}
// System.out.println(key+"-----"+value);
if(k>2) hashMap.put(key.trim(),value.trim());
// System.out.println();
}
System.out.println(hashMap.toString());
} catch (FileNotFoundException e) {
e.printStackTrace();
} catch (IOException e) {
e.printStackTrace();
} finally {
if (null != fis) {
try {
fis.close();
} catch (IOException e) {
e.printStackTrace();
}
}
}
@Test
public void insertWeatherIntoDb(){
// HashMap<String, String> map = new HashMap();
// map.put("北京市","116.407526,39.90403");
// map.put("天津市","117.200983,39.084158");
readExcelToMap();
for (Map.Entry<String,String> m : hashMap.entrySet()){
// System.out.println("Key = " + m.getKey() + ", Value = " + m.getValue());
Map api = myClient.getWeather(m.getValue());
Map result = (Map) api.get("result");
Map realtime = (Map) result.get("realtime");
System.out.println(realtime.toString());
String temperature = "" + realtime.get("temperature");//将double转为String
String cloudrate = "" + realtime.get("cloudrate");
String skycon = "" + realtime.get("skycon");
String visibility = "" + realtime.get("visibility");
String dswrf = "" + realtime.get("dswrf");
String pressure = "" + realtime.get("pressure");
String apparent_temperature = "" + realtime.get("apparent_temperature");
String humidity = "" + realtime.get("humidity");
Weather weather = new Weather(m.getKey(),temperature,cloudrate,skycon,visibility,dswrf,pressure,apparent_temperature,humidity);
myMapper.insert(weather);
System.out.println("成功！！！！！！！！！");
}
}
}
运行效果：