从今天开始，开始打造一个个人版的微信小程序，尽早上线，方便大家使用以及技术讨论。这套小程序包括前台、后台、数据库等部分，估计需要花些时间了。 小程序开发在入门阶段直接参照官方的帮助文档即可，包括基本语法、开发工具等，官方文档：微信小程序开发。 小程序开发自然而然分为前台后台，前台程序的入门参照官方文档，后台程序则需要自己搭建了。主要问题是微信小程序要求内部调用的API接口必须都是https的，并且最好是带域名，因此需要在搭建后台的时候费点功夫，整体后台基本流程如下：
选用API接口。想让产品能够吸引用户来用，首先得要求其有一些实实在在的功能，这就需要对应业务的API接口了。2Springboot统一后台。整合用到的api业务接口，同时支撑一些自定义功能3云服务器、域名、SSL证书：后台部署的媒介，同时负责将http接口转换为https接口4Nginx反向代理：将域名和IP绑定，以https的形式提供给前端程序调用5微信小程序：前端
API市场
API市场
有多少程序员在入门的时候都写过天气预报的demo?这就是一个最简单的数据API。目前在市面上有很多API接口可供大家调用，有付费的也有免费的，这里举两个例子：聚合数据、阿里云API市场。这两个市场的优缺点我并没有仔细研究。 这里以阿里云API市场中的天气预报API接口为例来做：天气预报API接口。
购买API
需要先购买该API接口之后才能调用，即使是表明免费的接口也需要进行购买操作，否则无法进行调用。这里有很多便宜且实用的接口，如天气预报、快递查询、驾照查分、身份证识别等等，具体如何组合使用还是取决于我们对产品发展的设想： 以天气预报查询为例，我们在登录阿里云账号并购买对应API接口之后，在对应的控制台中可以查看到该接口的AppCode、AppKey、AppSecret，这些都是我们对该接口的调用凭证，在调用时是需要放到header中上传的：
测试API
在API购买完成之后，我们需要测试一下这个接口的可用性，我这里使用postman来测试一下，对应的调用方式在文档中已经都明确说明过了：天气预报API接口 调用地址见文档，调用方式为get请求，请求头中写入AppCode做身份认证，添加城市名称作为请求参数，测试如下：具体身份认证方式见文档：Appcode简单认证
这里选用IntelliJIDEA，IntelliJIDEA是付费最好的java编辑器，eclipse是免费最好的java编辑器。为了方便springboot项目的新建和编写，这里推荐下载两个插件，即GsonFormat和SpringAssistant：
新建springboot项目
SpringAssistant能够方便快速的新建一个springboot项目：“file”->“new”->“project”->“SpringAssistant”，按照提示一步步创建SpringBoot项目即可。有一点需要说明的就是，这里默认通过maven来构建项目以及依赖包的管理，IDEA默认是国外的maven仓库地址，第一次构建下载相应的jar包时会相当慢，需要转换到国内镜像来下载，具体如下：maven国内镜像地址； 在新建Springboot项目时，记得选中web的依赖，后续在使用网络请求的时候会用到这个依赖： 数据库的依赖这里先不要选，等用到的时候再添加即可，不然程序启动不起来。程序新建完成之后，找到对应的Application入口，右键debug它： 也可以通过“shift+alt+F9”快捷键来实现debug，控制台输出一下内容，说明程序启动正常：
集成swagger接口文档
Swagger是一种RestAPI的简单但强大的表示方式，这里应用知乎上的一篇文章作为介绍：swagger简介。接下来，我们要在新建的springboot项目中将swagger集成进来。 在项目的poxml文件中添加swagger相关依赖：
io.springfox
springfox-swagger2
2.6.1
io.springfox
springfox-swagger-ui
2.6.1
@Configuration
@EnableSwagger2
public class Swagger2 {
private String BASE_PACKAGE = Swagger2.class.getPackage().getName();
@Bean
public Docket createRestApi() {
return new Docket(DocumentationType.SWAGGER_2).apiInfo(apiInfo()).select()
.apis(RequestHandlerSelectors.basePackage(BASE_PACKAGE)).paths(PathSelectors.any()).build();
}
private ApiInfo apiInfo() {
return new ApiInfoBuilder().title('WechatApplet')
.description('微信小程序后台支持')
.termsOfServiceUrl('http://www.neuqosft.com')
.version('0.0.1')
.build();
}
}“ctrl+F5”重启项目，启动成功之后在浏览器中输入：http://localhost:8080/swagger-uhtml，显示swagger页面，配置完成。
调用阿里云api市场中的天气预报接口
springboot的项目建完之后，需要在其中调用我们之前购买的API接口。
新建api、weather两个包，同时在weather新建dto、service两个包：
api：放置SpringMVC中的controller，直接接受前台的请求，并返回数据结果weather：放置有关天气相关的service层、dto层、entity层代码service：负责相关业务调用和逻辑处理dto：构造bean，负责将API返回的json串解析成对应的类
新建dto
在dto包下新建WeatherInfoDto的javaclass，dto生成可以使用插件gsonformat。在postman中复制接口返回的所有字符串数据：在WeatherInfoDto的类内部，点击右键->“Generate”->“GsonFormat”，然后将接口中返回的json字符串完整的复制到弹出的输入框中：点击“OK”->“OK”，对应的javabean会根据接口返回的字符串来自动生成：
Service层主要是负责业务逻辑的处理，同时将处理结果返回给Controller层。这里在Service层中完成接口的网络请求，这里的网络请求选用RestTemplate。在使用RestTemplate之前，需要先在pom文件中添加“spring-boot-starter-web”依赖，这个我们在新建项目的过程中已经完成。在service包下新建名为“WeatherService”的javaclass文件，具体如下：
@Service
public class WeatherService {
public WeatherInfoDto queryBasicInfo(String strCityName){
RestTemplate restTemplate = new RestTemplate();
HttpHeaders requestHeaders = new HttpHeaders();
Map parmaters = new HashMap();
requestHeaders.set('Authorization','APPCODE ae35098dabb84cd883c047c80672cb2b');
parmaters.put('city',strCityName);
HttpEntity requestEntity = new HttpEntity(requestHeaders);
ResponseEntity response = restTemplate.exchange('http://chkj02.market.alicloudapi.com/qgtq?city={city}',HttpMethod.GET, requestEntity, WeatherInfoDto.class, parmaters);
return response.getBody();
}
}
有如下几个问题需要强调：
RestTemplate官方文档：1RestTemplate2需要在header中加入参数“Authorization”，其中的值包含申请到的Appcode；请求参数包含”city”，具体指由controller层传入3RestTemplate中get请求的URL为“http://chkj0market.alicloudapcom/qgtq?city={city}”，注意需要将参数拼接到后边，否则无法正常进行传参4service层，需要加“@Service”注解
Service中完成之后，可以开始编写Controller层中的代码了。Controller层主要职责是接受前台的网络请求，调用对应的service层代码，并将service层的处理结果返回给调用者。在api中新建名为“WeatherController”的javaclass文件，代码如下：
@Api(description = '天气信息查询')
@RestController
@RequestMapping('/weather')
public class WeatherController {
@Autowired
private WeatherService weatherService;
@ApiOperation(value = '天气基本信息查询')
@ApiImplicitParam(name = 'strCityName', value = '城市名称', required = true, paramType = 'query')
@GetMapping('/jbxx')
public WeatherInfoDto queryBasicInfo(@RequestParam String strCityName) {
return weatherService.queryBasicInfo(strCityName);
}
}
这些都是基本的Springboot、swagger注解，这里就不在一一解释。
运行
至此，Springboot中API调用代码已经完成，ctrl+F5重启一下程序，输入swagger地址：http://localhost:8080/swagger-uhtml：点击“tryitout”按钮，正常返回信息，程序运行正常： OK，这篇博客先到此为止，在下一篇博客中我们重点解释如何将这个简单的springboot程序部署到腾讯云上，并且通过“域名+https”的形式代理出来，供前台接口进行调用，谢谢。
文章为作者独立观点，不代表股票交易接口观点
股民评论