时间:2018年5月26日
目的:
搭建一个简单的ssm框架,提升自己对ssm框架的理解。
基本步骤:
1、创建web工程
2、导入ssm相关jar包
3、利用mybatis的generator逆向工程,生成dao接口、xml文件、实体类
4、配置xml相关文件
5、编写service层
6、测试service以及dao层
7、编写controller
8、测试控制层
说明: 控制层接口采用Restful风格、测试采用junit注解、框架会尽自己能力,尽量做到规范一些。
开发工具说明:
Eclipse Oxygen
jdk 1.8
tomcat:8.0
1、创建web工程
以下是项目最终的目录结构
创建动态web工程,创建两个source folder 一个放主代码, 一个放各类资源文件
2、导入ssm相关jar包
不复杂,故不赘述。
jar包可以考虑采用UserLibrary的方式导入,这样项目转移(jar包整体带走),也不会报错,浪费时间配置所有的jar包
说明: 日志采用log4j、 数据库连接的sql server
扩展:jar包可以访问https://mvnrepository.com/ maven仓库地址,关键词搜索,查询自己所需要的jar包。
3、利用mybatis的generator逆向工程,生成dao接口、xml文件、实体类
说明:
1、用户当然可以自行编写
dao接口、xml文件、实体类,但是会花费相当多的时间和精力。 而利用逆向工程,则可以节省很多时间。
2、 逆向工程一般是自己新建一个简单的工程,自动生成持久层相关文件,然后,再按需将所需要的文件导入正式的项目里, 而非在当前项目里直接生成。
可以参考我之前写的博客,里面提供了两种方式:MyBatis逆向工程,自动生成dao、实体类、mapper文件
4、配置xml相关文件
配置属性文件,分离数据库连接的信息,便于维护---- jdbc.propert
jdbc.driverClassName=com.microsoft.sqlserver.jdbc.SQLServerDriver
jdbc.url=jdbc:sqlserver://localhost;databaseName=loraBase
jdbc.username=sa
jdbc.password=123
initialSize=0
maxActive=20
maxIdle=20
minIdle=1
maxWait=60000
配置数据库连接、事务处理、整合Mybatis等: spring-mybatis.xml
配置spring mvc相关信息,视图解析器、开启注解扫描等 ---- spring-mvc.xml
配置web.xml文件
IOTDemo
index.jsp
spring-mvc
org.springframework.web.servlet.DispatcherServlet
contextConfigLocation
classpath:spring/spring-mvc.xml
spring-mvc
/
contextConfigLocation
classpath:spring/spring-mybatis.xml,
org.springframework.web.context.ContextLoaderListener
encodingFilter
org.springframework.web.filter.CharacterEncodingFilter
encoding
utf-8
encodingFilter
/*
扩展:
1、mvc核心配置信息主要是控制层的文件包扫描、视图解析器、和
2、当url采用restful风格时,可能会导致springMVC会拦截静态资源,这时就需要配置一下,让静态资源可以访问
3、 当文件为了提高安全性
放在WEB-INF下面时,就需要注意路径的正确性
配置日志文件输出,可以输出再控制台、文本文件,配置丰富。 甚至可以配置信息存入数据库。----log4j.properties
log4j.rootLogger = info,stdout
log4j.appender.stdout = org.apache.log4j.ConsoleAppender
log4j.appender.stdout.Target = System.out
log4j.appender.stdout.layout = org.apache.log4j.PatternLayout
log4j.appender.stdout.layout.ConversionPattern = [%-5p] %d{yyyy-MM-dd HH:mm:ss,SSS} method:%l%n%m%n
5、
编写service层
1、要在类名上标记注解@Service
2、一般可以考虑在Service层导入日志功能,输出各类信息。
3、依赖注入:@Resource或者@Autowired两种方式,别人推荐都是@Autowired
扩展: 一般可以考虑dao层,方法名直接就是增删改查selectXXX、addXXX、deleteXXX、updateXXX等。
service层可以考虑,从用户的角度去对方法命名。比如:登陆--login(),比如注册--register(),比如:执行秒杀:executeSecKill().....:
6、测试service以及dao层
1、一般编写完Service层和Dao层以后,就可以进行测试,推荐使用Junt注解单元测试
2、
需要导入spring-test的jar包,便于依赖注入(已经被托管,所以dao和service是无法new的)
3、建议使用快捷方式,按类自动生成所有方法的测试文件。优雅而且方便
4、其他获取springde 实例对象的方式可以参考如下:
简单的在类文件里用ApplicationContext获得Spring中定义的Bean实例(对象):
ApplicationContext ac = new ClassPathXmlApplicationContext("applicationContext.xml");
TestDao testDAO = (TestDao )ac.getBean("TestDao ");
如果是两个以上配置文件:
ApplicationContext ac = new ClassPathXmlApplicationContext(new String[]{"applicationContext.xml","spring-mybatis.xml"});
或者用通配符:
ApplicationContext ac = new ClassPathXmlApplicationContext("classpath:/*.xml");
测试流程:
1、选择需要测试的类:dao或者service的实现类
2、右键,找到 Junit Test Case
。。。
new:
java文件夹下面的Junit文件夹里
package默认在当前dao或者service里,推荐建立新的test包
注意选完包名要记得点击Next,不要点击Finish
勾选选择所有的方法!
结果:(带上了asert断言相关语句代码)
接下来就是配置Spring-Test相关注解,引入dao和service进行测试!
1、@RunWith(SpringJUnit4ClassRunner.class);
2、@ContestConfiguration(locations = { "classpath:spring/spring-mybatis.xml" }); 获取相关配置文件,不需要导入mvc相关的配置文件,支持多配置文件的导入
3、直接利用@Autowired注入dao或者Service
4、可以考虑引入logger,来进行数据的打印,,而非System.out.println()
7、编写controller
说明1:
1、控制层与外部的数据传输,模板采用了DTO(data transfer object),即,用户需要什么数据,我就在这个模板里给你封装什么数据,与实体类由一定的区别
;
2、控制层的包命名采用com.xxx.web.xxx的方式,便于后期的维护,比如与app相关的我叫:com.xxx.web.app,一般的接口:com.xxx.web.api
3、
静态资源放在了WEB-INF下面,所以需要spring-mvc.xml
的配置文件里配置允许静态资源的访问。
4、和页面放在了WEB-INF下面,所以,每个页面的访问,都需要请求服务端的controller
说明2:
1、controller采用restful风格,所以一般请求都是名词,动作交给http的GET、POST、PUT、等来表述。行为采用动词表述
2、请求路径:最好在类名上也编写,实现模块化
3、Model 、ModelAndView、 HttpServletRequest、基本数据类型、实体对象、Map都可以作为参数传入方法
4、@RequestMapping()里面,路径都用value=“”,访问方式都进行说明,采用post还是get,
5、@RequestMapping()里面,可以给一个方法,配置多个路径访问它
6、返回json数据,可以加上produces = { "application/json;charset=utf-8" },进行标记,表明这是json数据
7、提高代码健壮性,注意try-catch的灵活应用
8、注意方法注释的编写,尤其是service层和controller层! 因为项目是一个团队在开发,注释详写,对人对己都有好处
9、@PathVariable RestFul风格参数直接在url里,/iot/details/{userId} ,需要用(@PathVariable(“userId”) int userId)进行参数的获取
dto封装前端所需要的数据,在service层进行获取,controller进行返回
1、dto 配置json数据返回通用格式,即数据获取是否成功,错误信息, data数据(泛型T的使用,使得该方法更灵活)
2、重载构造函数,以便在其他方法里,便捷优雅的实现数据的封装