storm-server使用指南

作者：stormma

博客：http://blog.stormma.me/

一、storm-server介绍

storm-server, 以jetty为servlet容器的一个java web框架, 主要用于为前端提供api服务, 具有快速开发的优势。storm-server之后会提供一些操作mysql, redis的工具, storm-server旨在快速开发一些小型的web应用, 以及用于日常学习。storm-server github地址:

 https://github.com/stormmaybin/storm-server.git

 欢迎各位star和参与开发，storm-server期待你的参与与建议。

二、小试牛刀

1.引入storm-server依赖(最新版本1.0，后期会跟进升级和维护)

2.添加storm.properties配置文件

storm-server默认去classpath下读取storm.properties配置文件, 当然, 你也可以指定配置文件的路径和名字, 如果你选择这么做了，那么你要在运行启动类时候传入配置文件的完整路径, 例如: 假如我的配置文件名字叫application.properties, 放在resources/config/,那么你需要在运行启动类(下面会说到)的时候传入参数’resources/config/application.properties’。

3.添加logback.xml

storm-server使用logback日志系统，storm-server已经提供了base.xml, 你只需要新建logback.xml，添加base.xml即可，当然你也可以加入自己的配置。

4.启动storm-server

5.新建service

@Service注解声明此类是一个service, 这与spring mvc/boot保持一致

6.新建controller

storm-server建议响应数据统一化，controller method返回值都是Response 类型，Response是storm-server提供的一个响应数据封装类。

controller的用法和spring boot/mvc差别不大，storm-server提供了参数自动绑定，内部提供了String2Boolean, 默认的String2Date，还有String2Number三种转换器, 当然，如果这三种转换器不够满足你项目的需求，你也可以自定义一个converter, 实现Converter接口即可，具体的步骤为:

同样，storm-server提供了json参数自动绑定到对象上，@JsonParam注解可以帮你完成这个冗余的操作。

7.启动storm-server

8.使用maven打成可执行jar

• 添加打包插件

你要做的就是修改 MainClass 为你的启动类, 也就是调用 StormApplication.run(args) 的那个类。

打包结束之后会出现一个xxx.jar，然后执行java -jar xxx.jar即可运行。

三、结束语

storm-server从开始开发到1.0版本的发布历经了1个月，这一个月其中的两周因为一些事情一行代码都没写，所以今天匆匆茫茫发布了1.0版本之后，甚是心虚，我深知storm-server现在还远远不够完善，但是作为学习资料足够了。我相信，storm-server后期的升级与维护，离不开你的支持、参与和建议。

一命二运三风水，四修阴德五读书！

刘桂林

微信号 : Android_LiuGuiLin

新浪微博：@刘某人程序员