天气预报第三方数据网关服务
配置不同的第三方天气数据，统一的数据格式输出，确保天气数据的有效性，并同时进行数据本地化缓存与持久化存储。数据从远程获取通过本地缓存的功能，减少远程的api调用量。通过配置文件配置多个不同的api数据源，字段可以自动合并，输出最大的结果集。新加入数据源只要添加相应的配置文件就可以，无需重新启动服务。
系统采用微服务模式开发。
服务部署后，提供三个接口：
-
1、天气实况数据：/weather/now
-
2、天气预报数据（未来几天的）：/weather/forecast
-
3、近海天气数据 /weather/seas
-
微服务架构，支持多种服务注册中心（mDNS、consul、eureka），默认为mdns
-
API数据源数据元可以通过文件配置
-
数据可本地化存储，方便历史数据调用
基于go-micro、GoFrame开发的天气预报桥接服务
微服务框架：go-micro V2【 中文文档 】 、 micro V2【 文档 】
数据库：SQLite 【 中文文档 】 GO驱动使用 github.com/mattn/go-sqlite3 【 接口文档 】
目录结构说明：
.
├── api-srv weather对外暴露api接口服务，内部与RPC服务通讯。
├── bin 统一编译后生成的执行文件，可以拷走直接使用。包括了必要的运行文件
├── config 开发环境配置文件目录
├── db 开发环境数据库目录
├── resources 相关资源
├── tools 自行编译的Micro API网关服务
└── weather-srv weather RPC服务
├── handler
├── proto
├── service
└── units
1、运行 Micro API网关服务
micro api 即可启动api一个网关,默认的端口是8080
$ micro api --handler=proxy
自定义端口号：
./micro --server_advertise=127.0.0.1:8088 api --handler=proxy
$ micro --registry=consul --registry_address=127.0.0.1:8500 api
注意：micro2 默认支持的服务注册中心是mdns。micro1默认支持的是consul。
2、运行micro web : Weather API
$ go run ./api-srv/main.go
3、运行 Weather Service
进入到weather-srv目录
$ go run ./weather-srv/main.go
Curl API 测试Now 天气实况
$ curl http://127.0.0.1:8080/weather/now
{
"message": "Hi, this is the Now API"
}
测试forecast 天气预报未来三天的天气情况
$ curl http://127.0.0.1:8080/weather/forecast
{
"msg": "测试forecast"
}
1，编译
需要跟据目标运行环境，编译。已编写了一个简单的脚本，进行交叉。
Linux系统： $ ./build.sh linux
Windows系统： $ ./build.sh windows
Mac系统： $ ./build.sh mac
通过build.sh脚本编译后，工程下会生成一个bin目录。就是编译好的运行文件及相关的配置文件、数据库文件。直接复制到目标位置即可。
2，运行
1）运行micro API $ micro api
2）运行Web Api $ ./api-srv
3）运行micro srv $ ./weather-srv
在浏览器中直接访问接口：http://127.0.0.1:8080/weather/now
由于使用的sqlite3数据驱动需要gcc编译。所以不能直接用默认的交叉编译，需要手动进行。
开发环境是MacOS系统，需要安装不同的编译器。在MacOS下安装不同的编译器的方式：
- Windows平台(mingw-w64)
安装编译器：brew install mingw-w64
编译指令：CGO_ENABLED=1 GOOS=windows GOARCH=amd64 CC=x86_64-w64-mingw32-gcc go build -v
- Linux平台（x86_64-linux-musl-gcc）
安装编译器：brew install FiloSottile/musl-cross/musl-cross
编译指令：CGO_ENABLED=1 GOOS=linux GOARCH=amd64 CC=x86_64-linux-musl-gcc CGO_LDFLAGS="-static" go build -a -v
注：
-a:重新编译
-static表示静态连接，没有这个选项，linux上运行报：-bash: ./xxx: /lib/ld-musl-x86_64.so.1: bad ELF interpreter: No such file or directory
支持多种服务发现系统（mDNS、consul、eureka）。默认支的mDNS。
1、mDns 方式
无需添加注册服务中心相关的启动参数，默认支持。可以通过Micro 的web服务查看服务的注册情况。
$ micro web
2020-06-05 08:59:05 level=info service=web HTTP API Listening on [::]:8082
2、consul 方式
如果要使用consul，请按下面方式执行。
运行consul服务
$ consul agent -dev
micro网关、srv、api三个服务启动加参数
--registry=consul
3、eureka 方式
micro网关、srv、api三个服务启动加参数
--registry=eureka
一、sojson.com 说明：https://www.sojson.com/blog/305.html
二、天气API https://www.tianqiapi.com
三、国家气象信息中心 http://data.cma.cn/market/index.html
天气质数说明相关的
http://aqicn.org/city/beijing/cn/
可参考的天气预报接口说明： https://open.caiyunapp.com/%E5%BD%A9%E4%BA%91%E5%A4%A9%E6%B0%94_API_%E4%B8%80%E8%A7%88%E8%A1%A8
近海天气情况配置文件说明
支持城市及港口，见 resources目录下的《潮汐预报支持城市及港口.20191226》
配置文件的修改将即时生效，无所重启服务。
config/source 目录下的json文件为天气预报api数据源配置文件。 左侧为固定项，右侧为配置api源中对应的字段
其中：
now 为天气实况信息
forecast 为天气预报信息，未来1--5天
filter 为进行数据过滤的设置。如：源数据中的温度值为：高温 35度，如果想只保留数字，就需要设置为 \\D
filter的值为正则表达。系统会自动过滤掉通过正则表达式选取的内容。
常用正则：
\\D只保留数字
\s.*
以空格开始的所有字符
[u4e00-\u9fa5]
选择所有汉字
[^\u4e00-\u9fa5]^[-,.?:;'\"!']
选择所有非汉字，但是不包括-,.?:;'"!'这些标点符号
^((?!abc).)*admin((?!abc).)*$
包含admin且不包含abc。
参数特别说明 配置文件中param是参数配置项，其中会有一些特别的关键词，系统将做特别处理。跟据需要慢慢增加。 1、autoDate 自动填写当天的日期，值为显示的格式，跟据需要写。如值为：2006-01-02 15:04:05.000 输出今天的日期，这也是按这个格式显示。 示例见source/cmacn.json文件中的配置。
