发表于: 2016-09-28 22:09:32
2 2161
今天完成的事情:优化代码,将登陆和其他功能串起来了,自己试了试swagger的注释及其属性。
明天计划的事情:为了国庆少加班,明天把需要的假数据做好。
遇到的问题:
1.
怎么判断Long这种包装类型是否为空,
没有找到办法,决定先通过String来接受参数,然后再转成Long类型
2.
javax.servlet.jsp.JspException cannot be resolved to a type
jsp页面报错,只要在build path中加入对应的server runtime就可以了(这个错误是不是以前犯过!。。。。。。)
3.
在web.xml中配置<welcome-file-list>控制页面跳转的问题
welcome-file-list元素只是服务器在收到一个目录名而不是文件名的url时,使用哪个文件
但是我依然没有实现,访问localhost:8080/项目名/依然报404错误,我估计是因为路径问题吧,网上都说这个标签指向了web
应用根目录,但是我在tomcat下的发布路径根目录下确实有我指向的文件啊。。。
4.
在web.xml中配置<diaplay-name>是什么意思
一般在配置Servlet时候,
<description>描述信息</description>
<display-name>显示名称</display-name>
<servlet-name>Servlet的名称</servlet-name>
<servlet-class>Servlet所引用的类名</servlet-class>
display-name 提供GUI工具可能会用来标记这个特定的web应用的一个名称,
而GUI工具也被称为图形用户界面,指的是采用图形方式显示的计算机操作用户界面。
5.
http://www.cnblogs.com/bukudekong/archive/2011/12/26/2302081.html
这篇帖子介绍了web.xml配置
http://blog.csdn.net/guihaijinfen/article/details/8363839
这篇也不错
总结:
关于自己尝试出来的swagger注释的一些属性,github上的文档有点没太懂,
https://github.com/swagger-api/swagger-core/wiki/Annotations#apimodel
这是Github上的注释api
这个图就将就着看吧
@Api(value="客户控制器" ,description = "所有与客户相关的操作",consumes="application/json")
上图1的内容是通过springMvc的@requestMapping获得的
@ApiOperation(value = "销售-客户管理-列表", response = AppCustomer.class, notes = "根据员工关联的分销商id查询指定分销商和员工下的客户列表")
上图2的内容是通过@ApiOperation的value获得的,
上图3的内容是是通过@ApiOperation的notes获得的,
上图10的内容是通过@ApiOperation的repsonse获得的,
@ApiResponses(value = { @ApiResponse(code = 400, message = "请传递参数",response=ResultDto.class ) })
上图9的内容通过@ApiResponses和他的子注释@ApiResponse获得的,
其中@ApiResponse的code决定你修饰的是HTTP状态码,message决定了reason的内容,response决定了response Model中显示什么类的基本信息,
@ApiParam(value = "请求参数类", required = true,access="123",allowableValues="435",
allowMultiple=false ,defaultValue="51",name="name")
上图7的内容是通过@ApiParam的value获得的,而allowableValues字面意思是允许的值,如果写了这个属性,那么上图5就会变成一个下来菜单,
菜单内容就是该属性的值,如上面的435,如果不写allowableValues但是写了defaultValue,那么上图6会显示defaultValue写的内容,
上图4由springMvc的注释确定,上图8由方法参数确定
其他的还没有找到,
评论