Java Web项目开发从0开始的要点!

本文涉及的产品
日志服务 SLS,月写入数据量 50GB 1个月
简介:

前言

本文章详细的列出了开发一个传统JavaWeb项目需要注意的要点,从环境准备开始到三层架构搭建,需要注意的地方全部罗列出来。

第一部分:环境准备

1. Maven命令创建web骨架
mvn archetype:create -DgroupId=net.rocketa -DartifactId=mywebapp -DarchetypeArtifactId=maven-archetype-webapp

注意web servlet版本(web.xml,3.1),Junit版本指定为4.X(这样Spring好通过注解的方式来运行单元测试)
2. 注意在IDEA中需要设置好MAVEN工程的Sources/Tests/Resources/Test Resources属性。
3. 日志依赖
slf4j:规范和接口

具体的日志实现有:

log4j、logback、common-logging

因此我们一般是使用slf4j接口+一种具体的日志实现+slf4j和这个具体日志实现的依赖整合

4. 数据库依赖
有2个依赖,需要注意,一个是驱动,一个是数据库连接池(C3P0,DBCP...)。

驱动JAR包是运行期需要包含,编译期不需要的。
5. 持久层框架依赖
说白了,DAO层的框架依赖:MyBatis or Hibernate or ....

比如除MyBatis本身的依赖需要引入之外,还需要引入MyBatis和Spring的整合依赖。
6. Web层依赖

比如,JSP中使用到的一些JSTL、标签、Ajax访问JSON等,还有需要注意的是,在编译期需要引入servlet-api。

7. Spring核心依赖
spring-core、spring-beans、spring-context
8. Spring和DB之间的整合依赖
Spring是需要介入DB的管理的,比如它的声明式事务。

spring-jdbc、spring-tx
9. Spring对Web的一些整合依赖
spring-web、spring-webmvc
10. Spring对Junit的支持依赖

spring-test

NOSQL对事务的支持不是很好,它主要追求的是性能、高可用、分布式。

MySQL等关系型数据库对事务的支持是很成熟的,也是很可靠的落地方案。

第二部分:DAO层

NOSQL对事务的支持不是很好,它主要追求的是性能、高可用、分布式。

MySQL等关系型数据库对事务的支持是很成熟的,也是很可靠的落地方案。

1. 表

可以在项目中建立一个SQL文件,便于SQL的管理。

注意,表的存储引擎(事务的支持:innodb)、自动增长的特性、编码、主键和索引。

一个良好的习惯是:为所有的表都添加一个创建时间字段,用于记录,方便排查。

应该为表名、列名添加注释,方便其他工程师查阅。

应该注意SQL技巧,比如插入存在唯一约束的表中,如果出现冲突不想报错的话,可以:insert ignore into ….(可以通过返回的影响行数来进行判断)

2. Dao层实体

一些业务对象的建立,setter/getter/toString等就不说了,需要特别注意的是,除了表的字段之外,还需要什么属性?这里涉及到一个一对一、一对多,多对多的概念!

3. Dao层接口和mapper sql

MyBatis的特点:从SQL(参数+sql)映射到Entity/List(定制SQL、自由传递参数、结果集自动赋值)

使用MyBatis的方式:SQL写在XML中,或者注解提供SQL。更加推荐的是XML,因为更加灵活,XML提供的动态拼接功能也是比注解简单的多。

一个全局的mybatis配置文件+具体的SQL文件+DAO接口:让我们只需要设计接口,关注业务逻辑,解放出来。

在全局mybatis配置文件中重点注意:是否开启驼峰转换,获取数据库自增主键,列别名替换列名等。

注意DAO接口和具体的SQL文件之间的对应关系。

具体SQL写法中,比如#{},等需要引起注意。

输入参数类型parameterType,如果是多个基本类型,那么不用给出来。

即便返回的是List对象,我们的resultType依然指定的是集合中的对象类型。

在Mybatis的SQL文件中是可以通过OGNL表达式来对对象中的一些对象类型的属性进行赋值的!

表名.xxx 或者 表名.xxx as yyy 对于Mybatis而言,会忽略表名.前缀,也会忽略as。

另外,注意在Dao接口中,如果方法有多个基本类型参数,别忘了通过@Param来进行运行期参数标记!

总结:Dao层的工作逐渐演变成接口设计和SQL编写了,这种代码和SQL的分离方式,便于我们进行review,而Dao的拼接将在Service层完成。

4. 一些优化配置

比如,对带包路径的类型进行简化,通过配置扫描包。

比如,批量扫描SQL文件,通过自动扫描配置文件。

5. mybatis和spring需要整合

spring需要接管数据库

JDBC的一些连接信息,数据库连接池的一些配置信息,就是配置DataSource的过程。

spring和mybatis整合的核心

SqlSessionFactory是MyBatis的配置核心,把DataSource注入,并指明MyBatis的全局配置文件位置,typeAliasesPackage扫描,mapper文件位置扫描等。

spring通过动态代理帮助生成Dao的代理实现类(MapperScannerConfigurer)

注入SqlSessionFactory(通过sqlSessionFactoryBeanName),指明Dao接口的包路径basePackage

总之,配置的一项原则是:约定优于配置!!!

第三部分:进行Spring Junit单元测试

当我们进行了一些配置,写了一些SQL,Dao接口后,应该要进行Spring Junit单元测试,可以通过IDEA快速的生成测试用例(很好用的一个功能,因为IDEA可以帮助我们快速在test下建立与dao/service接口的同级目录下生成用例)

在用例中,我们只需要在类上打上注解:

@RunWith(SpringJUnit4ClassRunner.class)

@ContextConfiguration({"classpath:spring配置文件"})

加载Spring容器后,我们就可以在用例中注入对象,开始测试了!!!

第四部分:Service层

Service层需要关注几个要点:

业务对象的封装、web和service之间进行数据传递的DTO、异常的处理(业务异常)

注意Spring事务回退的默认机制是:运行时异常。

因此,我们在service层默认定义的业务异常一般extends RuntimeException。

一般而言,通过:

try{

}catch(业务异常1 e1){

}catch(业务异常2 e2){

}catch(Exception e){

throw new 业务异常(...);

}

要知道,service层可能会发生业务异常,也可能发生一些其他异常,为了Spring都可以感知到,这里会把Exception异常转化成运行时异常

第五部分:Controller层

1. Restful

一种优雅的URI表述方式;资源的状态;状态的转移

Restful示例:

GET     /product/list   查询操作

GET    /product/{productId}/detail

GET     /product/time/now

POST    /product/{productId}/execution 添加、修改操作【非幂等性】

POST    /product/{productId}/{userId}/order

DELETE  /product/{productId}/delete  删除操作

PUT       修改操作【幂等性】

URL设计:

/模块/资源/{标示}/集合1/...
2.Controller中请求方法的细节处理

考虑几个方面:请求参数绑定、请求方式限制、转发与重定向、数据模型赋值、JSON数据返回、Cookie访问

@RequestMapping(value="/{productId:\d+}/detail",method=RequestMethod.GET,produces={"application/json;charset=UTF-8"})
@ResponseBody
public String detail(
@PathVariable("productId") Long  productId,@CookieValue(value="userId",required=false) Long userId,Model model){
return "rediect:/xxx/yyy"
return "forward:/xxx/yyy"
return "view"
}
3.整合配置Spring MVC

在web.xml中配置DispatcherServlet拦截请求,并指出Spring相关的配置文件。

开启Spring MVC的注解模式:

静态资源请求采用默认的servlet配置

配置JSP、ViewResolver的prefix「如/WEB-INF/jsp」suffix「如.jsp」

扫描web相关的Controller:

OK,先整理到这里。


原文发布时间为:2018-11-25

本文来自云栖社区合作伙伴“互联网架构师”,了解相关信息可以关注“互联网架构师”。


相关实践学习
日志服务之使用Nginx模式采集日志
本文介绍如何通过日志服务控制台创建Nginx模式的Logtail配置快速采集Nginx日志并进行多维度分析。
相关文章
|
2月前
|
关系型数据库 MySQL Java
【MySQL+java+jpa】MySQL数据返回项目的感悟
【MySQL+java+jpa】MySQL数据返回项目的感悟
45 1
|
2天前
|
NoSQL Java 关系型数据库
Liunx部署java项目Tomcat、Redis、Mysql教程
本文详细介绍了如何在 Linux 服务器上安装和配置 Tomcat、MySQL 和 Redis,并部署 Java 项目。通过这些步骤,您可以搭建一个高效稳定的 Java 应用运行环境。希望本文能为您在实际操作中提供有价值的参考。
50 26
|
11天前
|
Java 开发者 微服务
Spring Boot 入门:简化 Java Web 开发的强大工具
Spring Boot 是一个开源的 Java 基础框架,用于创建独立、生产级别的基于Spring框架的应用程序。它旨在简化Spring应用的初始搭建以及开发过程。
27 6
Spring Boot 入门:简化 Java Web 开发的强大工具
|
14天前
|
XML Java 测试技术
从零开始学 Maven:简化 Java 项目的构建与管理
Maven 是一个由 Apache 软件基金会开发的项目管理和构建自动化工具。它主要用在 Java 项目中,但也可以用于其他类型的项目。
30 1
从零开始学 Maven:简化 Java 项目的构建与管理
|
13天前
|
Java
Java项目中高精度数值计算:为何BigDecimal优于Double
在Java项目开发中,涉及金额计算、面积计算等高精度数值操作时,应选择 `BigDecimal` 而非 `Double`。`BigDecimal` 提供任意精度的小数运算、多种舍入模式和良好的可读性,确保计算结果的准确性和可靠性。例如,在金额计算中,`BigDecimal` 可以精确到小数点后两位,而 `Double` 可能因精度问题导致结果不准确。
|
24天前
|
Java Android开发
Eclipse 创建 Java 项目
Eclipse 创建 Java 项目
39 4
|
29天前
|
Java Maven Spring
Java Web 应用中,资源文件的位置和加载方式
在Java Web应用中,资源文件如配置文件、静态文件等通常放置在特定目录下,如WEB-INF或classes。通过类加载器或Servlet上下文路径可实现资源的加载与访问。正确管理资源位置与加载方式对应用的稳定性和可维护性至关重要。
46 6
|
29天前
|
SQL Java 数据库连接
从理论到实践:Hibernate与JPA在Java项目中的实际应用
本文介绍了Java持久层框架Hibernate和JPA的基本概念及其在具体项目中的应用。通过一个在线书店系统的实例,展示了如何使用@Entity注解定义实体类、通过Spring Data JPA定义仓库接口、在服务层调用方法进行数据库操作,以及使用JPQL编写自定义查询和管理事务。这些技术不仅简化了数据库操作,还显著提升了开发效率。
39 3
|
1月前
|
存储 安全 搜索推荐
理解Session和Cookie:Java Web开发中的用户状态管理
理解Session和Cookie:Java Web开发中的用户状态管理
58 4
|
1月前
|
前端开发 Java 数据库
如何实现一个项目,小白做项目-java
本教程涵盖了从数据库到AJAX的多个知识点,并详细介绍了项目实现过程,包括静态页面分析、数据库创建、项目结构搭建、JSP转换及各层代码编写。最后,通过通用分页和优化Servlet来提升代码质量。
45 1