毕业设计实战：基于Spring Boot的租房网站全栈开发

收藏 2025-11-21

一、项目背景：数字化时代的租房服务革新

在城市化加速推进与流动人口持续增长的背景下，传统租房模式暴露出信息不透明、沟通效率低下、流程缺乏规范等显著问题。行业统计表明，我国每年租房需求超过2.4亿人次，其中78%的租客曾遭遇虚假房源、中介加价或签约复杂等情况，高达90%的用户期望通过数字化平台实现“信息透明、操作便捷、服务标准”的全新租房体验。

随着“互联网+房产”概念的深入发展，基于Spring Boot技术构建的租房网站应运而生，成为连接租客、房东与管理方的核心数字桥梁。该平台采用轻量级B/S架构，集成房源展示、在线预约看房、电子签约、租赁评价等全流程功能，打造“管理员统筹—用户操作—信息共享”的三方协同机制，为市场提供安全、高效的技术支持，有效弥补传统租房服务在数字化方面的短板。

二、技术架构：全栈技术选型与系统支撑体系

本项目以“稳定可靠、安全可控、易于使用”为核心设计原则，选用成熟稳定的Java Web技术栈，保障系统的高性能运行及未来可扩展性。

技术模块	具体工具/技术	核心作用
后端框架	Spring Boot 2.x	快速搭建后端服务，简化配置流程，提供完整的MVC开发支持
数据库	MySQL 8.0	存储用户资料、房源数据、预约记录、合同文件及评价内容
前端技术	JSP + Bootstrap + JavaScript	构建响应式界面，适配多种屏幕尺寸，提升用户交互体验
架构模式	B/S结构	支持跨平台访问，无需安装客户端，浏览器即可使用
开发工具	Eclipse + Navicat	Eclipse用于代码编写与调试，Navicat实现数据库可视化管理
服务器	Tomcat 9.0	部署Web应用，处理用户请求与业务逻辑交互
文件存储	本地文件系统	存放房源图片、合同文档、用户头像等静态资源

三、项目实施流程：六步完成租房平台开发

3.1 第一步：需求分析——明确系统核心价值定位

针对传统租房服务中存在的“房源造假、流程繁琐、沟通低效”三大痛点，本系统聚焦于“信息透明、操作便捷、流程规范”的目标，将需求划分为功能性与非功能性两大类。

3.1.1 功能性需求

双角色权限管理体系：

管理员功能模块：首页、个人中心、用户管理、房屋类型管理、房屋信息发布与维护、预约看房审核、在线签约管理、租赁评价监管、交流论坛管理、系统设置（轮播图配置、资讯发布、客服信息设定）；
用户（租客）功能模块：首页浏览、个人中心、预约看房申请、在线签约查看、租赁评价提交、收藏夹管理、房源检索与收藏操作。

核心租赁服务功能：

房源管理：支持房屋分类、房源信息的发布、编辑与删除，实时更新房源状态（如“可租”或“已租”）；
租赁流程支持：实现在线预约看房、自动生成租赁合同并完成电子签约，记录租金与押金支付情况；
互动服务模块：租客可对房源进行评分与评论，参与交流论坛分享租房经验，并接收平台推送的相关房屋资讯。

辅助功能支持：

支持按房屋类型、月租金区间、小区位置等多维度筛选房源；
用户可收藏感兴趣房源，便于后续查阅；
系统自动发送通知提醒，包括预约审核结果、签约进度更新、他人回复评价等。

3.1.2 非功能性需求

系统安全性：用户密码加密存储，严格划分角色权限，保护房源与合同数据隐私；
数据准确性：确保房源信息、合同条款等内容真实准确，具备可追溯性；
响应及时性：页面加载时间控制在2秒以内，预约审核与签约反馈延迟不超过3秒；
系统稳定性：支持500人以上同时在线操作，无卡顿或崩溃现象，数据存储可靠性达到99.9%。

3.2 第二步：系统设计——构建分层架构体系

系统采用经典的三层架构设计，实现表现层、业务逻辑层与数据访问层之间的解耦，增强代码的可维护性和后期扩展能力。

3.2.1 系统整体架构

表现层（Web层）：

用户界面：基于JSP动态生成页面内容，根据用户身份（管理员或普通用户）展示不同功能模块（例如仅管理员可见“用户管理”入口）；
交互控制：处理表单提交（如预约申请、评价发布）、页面跳转以及权限验证逻辑。

业务逻辑层（Service层）：

核心服务：涵盖用户服务（注册登录、信息维护）、房源服务（查询筛选、状态变更）、租赁服务（预约审核、合同生成、评价管理）；
业务规则执行：包含预约时间冲突检测、合同条款合法性校验、评价内容过滤（防止违规言论）等功能。

数据访问层（DAO层）：

数据持久化：利用MyBatis框架完成数据库的增删改查操作，降低SQL编写复杂度；
事务管理：保证多表联动操作的数据一致性，例如签约成功后同步将房源状态更新为“已租”。

3.2.2 核心数据库设计

系统设计多个关键业务数据表，全面覆盖租房场景下的各类数据存储需求，确保各表之间具有良好的关联性与完整性。

表名	核心字段	作用说明
yonghu（用户表）	id、yonghuming、mima、xingming、xingbie、shouji、shenfenzheng、touxiang	存储租客的基本个人信息及账户认证信息
fangwuxinxi（房屋信息表）	id、fangwumingcheng、fangwuleixing、tupian、mianji、yuezujiage、yajin、xiaoqu、xiangxidizhi、fangwuzhuangtai	保存房源详细描述，包括名称、类型、面积、价格、位置及当前出租状态

zulinpingjia（租赁评价表）

id、hetongbianhao、fangwumingcheng、yonghuming、pingfen、pingjiarneirong、pingjiariqi、sfsh

用于记录租户对所租住房屋的评分与评价内容，反映房源服务质量。

zaixianqianyue（在线签约表）

id、hetongbianhao、fangwumingcheng、yonghuming、yuezujiage、zulinyueshu、zulinjine、hetongneirong、shengxiaoriqi、youxiaoqizhi

该表用于保存用户在线签署的租赁合同相关数据，包括租金金额、租赁周期及合同生效时间等关键信息。

yuyuekanfang（预约看房表）

id、yuyuebianhao、fangwumingcheng、yonghuming、yuyueriqi、shouji、sfsh（审核状态）、shhf（审核回复）

存储用户提交的看房预约申请，并记录后台审核进度与反馈结果。

3.3 第三步：后端核心功能实现——基于Spring Boot架构

系统后端采用Spring Boot框架进行开发，围绕“房源管理”“租赁流程”“互动服务”三大主要业务场景，构建稳定高效的核心功能模块。

3.3.1 房源管理功能实现

@RestController
@RequestMapping("/api/house")
public class HouseController {

    @Autowired
    private HouseService houseService;

    /**
     * 查询房源列表，支持按类型、小区、价格区间等条件筛选
     */
    @GetMapping("/list")
    public ResponseEntity<?> getHouseList(
        @RequestParam(required = false) String fangwuleixing,
        @RequestParam(required = false) String xiaoqu,
        @RequestParam(required = false) Integer minPrice,
        @RequestParam(required = false) Integer maxPrice,
        @RequestParam(defaultValue = "1") int page,
        @RequestParam(defaultValue = "10") int size) {
        
        try {
            HouseQuery query = new HouseQuery();
            query.setFangwuleixing(fangwuleixing);
            query.setXiaoqu(xiaoqu);
            query.setMinPrice(minPrice);
            query.setMaxPrice(maxPrice);
            query.setPage(page);
            query.setSize(size);

            PageResult<HouseInfo> result = houseService.getHouseList(query);
            return ResponseEntity.ok(result);
        } catch (Exception e) {
            return ResponseEntity.internalServerError().body("获取房源列表失败：" + e.getMessage());
        }
    }

    /**
     * 管理员新增房源信息接口
     */
    @PostMapping("/add")
    public ResponseEntity<?> addHouse(@RequestBody HouseAddDTO addDTO) {
        try {
            // 校验必填字段是否为空
            if (StringUtils.isEmpty(addDTO.getFangwumingcheng()) || 
                StringUtils.isEmpty(addDTO.getFangwuleixing()) ||
                addDTO.getYuezujiage() == null || 
                StringUtils.isEmpty(addDTO.getXiangxidizhi())) {
                return ResponseEntity.badRequest().body("房源名称、类型、月租价格、详细地址不能为空");
            }

            HouseInfo house = new HouseInfo();
            house.setFangwumingcheng(addDTO.getFangwumingcheng());
            house.setFangwuleixing(addDTO.getFangwuleixing());
            house.setTupian(addDTO.getTupian());
            house.setZulinfangshi(addDTO.getZulinfangshi());

@Service
@Transactional
public class RentalService {
@Autowired
private ReservationMapper reservationMapper;
@Autowired
private ContractMapper contractMapper;
@Autowired
private HouseService houseService;
@Autowired
private UserService userService;

/**
 * 用户提交预约看房申请
 */
public Reservation submitReservation(ReservationDTO reservationDTO) {
    // 校验用户是否存在
    User user = userService.getUserByUsername(reservationDTO.getYonghuming());
    if (user == null) {
        throw new RuntimeException("用户不存在");
    }

    // 检查房源信息及当前状态
    HouseInfo house = houseService.getHouseByName(reservationDTO.getFangwumingcheng());
    if (house == null) {
        throw new RuntimeException("房源不存在");
    }
    if ("已租".equals(house.getFangwuzhuangtai())) {
        throw new RuntimeException("该房源已出租，无法进行预约");
    }

    // 生成唯一预约编号：格式为年月日加6位随机数

    String reservationNumber = LocalDateTime.now().format(DateTimeFormatter.ofPattern("yyyyMMdd")) +
            String.format("%06d", new Random().nextInt(900000) + 100000);

    Reservation reservation = new Reservation();
    reservation.setReservationNumber(reservationNumber);
    reservation.setYonghuming(reservationDTO.getYonghuming());
    reservation.setFangwumingcheng(reservationDTO.getFangwumingcheng());
    reservation.setYuyueshijian(reservationDTO.getYuyueshijian());
    reservation.setLianxifangshi(reservationDTO.getLianxifangshi());
    reservation.setStatus("待处理");
    reservation.setAddtime(new Date());

    reservationMapper.insert(reservation);
    return reservation;
}

/**
 * 管理员更新房源状态（可租或已租）
 */
@PutMapping("/status/{id}")
public ResponseEntity<?> updateHouseStatus(@PathVariable Integer id, @RequestParam String status) {
    try {
        if (!"可租".equals(status) && !"已租".equals(status)) {
            return ResponseEntity.badRequest().body("房源状态仅支持'可租'或'已租'");
        }
        boolean result = houseService.updateHouseStatus(id, status);
        if (result) {
            return ResponseEntity.ok("房源状态更新成功");
        } else {
            return ResponseEntity.badRequest().body("房源不存在或更新失败");
        }
    } catch (Exception e) {
        return ResponseEntity.internalServerError().body("更新房源状态失败：" + e.getMessage());
    }
}

/**
 * 添加新房源信息
 */
@PostMapping("/add")
public ResponseEntity<String> addHouse(@RequestBody HouseAddDTO addDTO) {
    try {
        House house = new House();

        house.setMianji(addDTO.getMianji());
        house.setChaoxianglouceng(addDTO.getChaoxianglouceng());
        house.setXiaoqu(addDTO.getXiaoqu());
        house.setXiangxidizhi(addDTO.getXiangxidizhi());
        house.setYuezujiage(addDTO.getYuezujiage().toString());
        house.setYajin(addDTO.getYajin().toString());
        house.setFangwuxiangqing(addDTO.getFangwuxiangqing());
        house.setFaburiqi(new SimpleDateFormat("yyyy-MM-dd").format(new Date()));
        house.setAddtime(new Date());
        house.setFangwuzhuangtai("可租"); // 默认新录入的房源为可租状态

        houseService.addHouse(house);
        return ResponseEntity.ok("房源添加成功");
    } catch (Exception e) {
        return ResponseEntity.internalServerError().body("添加房源失败：" + e.getMessage());
    }
}
}

3.3.2 实现预约看房与在线签约功能

// 在线签约相关逻辑可在此处扩展，例如生成电子合同、保存签约记录等

String reservationNo = new SimpleDateFormat("yyyyMMdd").format(new Date()) + 
    RandomUtils.nextInt(100000, 999999);
Reservation reservation = new Reservation();
reservation.setYuyuebianhao(reservationNo);
reservation.setFangwumingcheng(reservationDTO.getFangwumingcheng());
reservation.setFangwuleixing(house.getFangwuleixing());
reservation.setTupian(house.getTupian());
reservation.setMianji(house.getMianji());
reservation.setFangwuzhuangtai(house.getFangwuzhuangtai());
reservation.setXiaoqu(house.getXiaoqu());
reservation.setYuezujiage(house.getYuezujiage());
reservation.setZulinyueshu(reservationDTO.getZulinyueshu().toString());
reservation.setZulinjine(String.valueOf(Integer.parseInt(house.getYuezujiage()) * 
    reservationDTO.getZulinyueshu()));
reservation.setYajin(house.getYajin());
reservation.setYuyueriqi(reservationDTO.getYuyueriqi());
reservation.setYonghuming(reservationDTO.getYonghuming());
reservation.setShouji(user.getShouji());
reservation.setShenfenzheng(user.getShenfenzheng());
reservation.setSfsh("待审核");
reservation.setShhf("");
reservation.setAddtime(new Date());
reservationMapper.insertReservation(reservation);
return reservation;

/**
 * 管理员对预约申请进行审核操作
 */
public boolean auditReservation(Integer id, String status, String reply) {
    Reservation reservation = reservationMapper.selectReservationById(id);
    if (reservation == null) {
        throw new RuntimeException("预约记录不存在");
    }
    if (!"待审核".equals(reservation.getSfsh())) {
        throw new RuntimeException("该预约已处理，不可重复审核");
    }
    reservation.setSfsh(status);
    reservation.setShhf(reply);
    reservationMapper.updateReservation(reservation);

    // 审核通过后可选择性触发合同生成流程
    if ("通过".equals(status)) {
        createContract(reservation);
    }
    return true;
}

/**
 * 构建线上签约用的合同信息
 */
private Contract createContract(Reservation reservation) {
    // 合同编号规则：HT + 当前日期 + 8位随机数
    String contractNo = "HT" + new SimpleDateFormat("yyyyMMdd").format(new Date()) + 
        RandomUtils.nextInt(10000000, 99999999);

    // 根据租赁金额与押金计算总合同金额
    int rent = Integer.parseInt(reservation.getZulinjine());

// 计算合同总金额（租金 + 押金）
int deposit = Integer.parseInt(reservation.getYajin());
int rent = Integer.parseInt(reservation.getZulinjine());
int total = rent + deposit;

// 创建合同对象并填充基础信息
Contract contract = new Contract();
contract.setHetongbianhao(contractNo);
contract.setFangwumingcheng(reservation.getFangwumingcheng());
contract.setFangwuleixing(reservation.getFangwuleixing());
contract.setXiaoqu(reservation.getXiaoqu());
contract.setYuezujiage(reservation.getYuezujiage());
contract.setZulinyueshu(reservation.getZulinyueshu());
contract.setZulinjine(reservation.getZulinjine());
contract.setYajin(reservation.getYajin());
contract.setHetongjine(String.valueOf(total));
contract.setShengxiaoriqi(reservation.getYuyueriqi());

// 设置合同有效期：根据预约日期和租赁月数计算截止时间
Calendar calendar = Calendar.getInstance();
calendar.setTime(DateUtils.parseDate(reservation.getYuyueriqi(), "yyyy-MM-dd"));
calendar.add(Calendar.MONTH, Integer.parseInt(reservation.getZulinyueshu()));
contract.setYouxiaoqizhi(new SimpleDateFormat("yyyy-MM-dd").format(calendar.getTime()));

// 设置默认合同内容条款
contract.setHetongneirong("甲方（出租方）承诺房源信息真实，乙方（承租方）需按时支付租金...");

// 填写用户基本信息
contract.setYonghuming(reservation.getYonghuming());
contract.setShouji(reservation.getShouji());

// 初始化审核状态与回复字段
contract.setSfsh("待审核");
contract.setShhf("");
contract.setAddtime(new Date());

// 插入数据库并返回结果
contractMapper.insertContract(contract);
return contract;
}



/**
 * 评价功能接口控制器
 * 提供用户对已完成租赁合同的评价操作支持
 */
@RestController
@RequestMapping("/api/evaluation")
public class EvaluationController {

    @Autowired
    private EvaluationService evaluationService;

    @Autowired
    private ContractService contractService;

    /**
     * 用户提交租赁评价接口
     */
    @PostMapping("/add")
    public ResponseEntity<?> addEvaluation(@RequestBody EvaluationAddDTO addDTO) {
        try {
            // 校验合同是否存在
            Contract contract = contractService.getContractByNo(addDTO.getHetongbianhao());
            if (contract == null) {
                return ResponseEntity.badRequest().body("合同不存在");
            }

            // 确保当前用户为该合同的承租人
            if (!addDTO.getYonghuming().equals(contract.getYonghuming())) {
                return ResponseEntity.badRequest().body("仅合同承租方可发布评价");
            }

            // 防止重复提交评价：同一合同只允许一次评价
            boolean exists = evaluationService.checkEvaluationExists(addDTO.getHetongbianhao());
            if (exists) {

/**
 * 添加房屋评价（租客）
 */
@PostMapping("/add")
public ResponseEntity<?> addEvaluation(@RequestBody AddEvaluationDTO addDTO) {
    try {
        // 校验合同是否已评价
        if (evaluationService.hasEvaluation(addDTO.getContractId())) {
            return ResponseEntity.badRequest().body("该合同已发布评价，不可重复提交");
        }
        evaluationService.addEvaluation(addDTO);
        return ResponseEntity.ok("评价发布成功，待审核后展示");
    } catch (Exception e) {
        return ResponseEntity.internalServerError().body("发布评价失败：" + e.getMessage());
    }
}

/**
 * 根据房源名称获取所有评价
 */
@GetMapping("/house/{houseName}")
public ResponseEntity<?> getEvaluationsByHouse(@PathVariable String houseName) {
    try {
        List<EvaluationVO> evaluations = evaluationService.getEvaluationsByHouse(houseName);
        return ResponseEntity.ok(evaluations);
    } catch (Exception e) {
        return ResponseEntity.internalServerError().body("获取评价失败：" + e.getMessage());
    }
}

/**
 * 管理员对评价进行审核：通过或驳回
 */
@PutMapping("/audit/{id}")
public ResponseEntity<?> auditEvaluation(@PathVariable Integer id, @RequestParam String status) {
    try {
        if (!"通过".equals(status) && !"驳回".equals(status)) {
            return ResponseEntity.badRequest().body("审核状态仅支持'通过'或'驳回'");
        }
        evaluationService.auditEvaluation(id, status);
        return ResponseEntity.ok("评价审核成功");
    } catch (Exception e) {
        return ResponseEntity.internalServerError().body("审核评价失败：" + e.getMessage());
    }
}

3.5 第五步：系统测试——保障系统稳定与可靠性

采用“功能测试 + 性能测试 + 安全测试”三位一体的测试方案，全面验证租房平台在真实环境下的稳定性、响应能力与安全性。

3.5.1 功能测试

围绕核心业务流程设计测试用例，确保各模块逻辑正确、交互正常：

测试场景	测试用例	预期结果	实际结果	是否通过
用户登录	账号：test01，密码：123456	登录成功，跳转至用户首页	登录成功，跳转至用户首页	是
用户登录	账号：test01，密码：123	提示“密码错误”	提示“密码错误”	是
房源预约	选择“房源A”，填写预约日期：2024-06-10	预约申请提交成功，状态为“待审核”	预约申请提交成功，状态为“待审核”	是