# JMVC

**Repository Path**: zhang_kaicheng/JMVC

## Basic Information

- **Project Name**: JMVC
- **Description**: JMVC, Java Model View Controller 的首字符缩写，旨在打造一款简洁的基于MVC三层架构的 Java Web 应用骨架工程。
- **Primary Language**: Java
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2020-06-21
- **Last Updated**: 2025-07-04

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# JMVC 简介
JMVC, Java Model View Controller 的首字符缩写，旨在打造一款简洁的基于MVC三层架构的 Java Web 应用骨架工程。

#### 框架功能介绍

![img.jpg](jmvc-doc/image/jmvc_gn.png)

#### 整体技术架构

 - ![img.jpg](jmvc-doc/image/jmvc_yl.png)

# Quick Start

## 初始化前置条件
- Java 1.8
- Maven 3

## 骨架构建工程
1. 安装jmvc-archetype骨架 可选择安装到
  - 本地 步骤如下：
    1. mvn install
    2. mvn org.apache.maven.plugins:maven-archetype-plugin:3.0.1:crawl
  - 私服 [参考](https://blog.csdn.net/qq_30162859/article/details/79039104)
  - idea(推荐) [参考](https://blog.csdn.net/qq_30162859/article/details/79039104)

2.用 Maven Archetype 生成应用架构骨架(本地安装)，命令为

```
mvn org.apache.maven.plugins:maven-archetype-plugin:3.0.1::generate
-DgroupId=com.zkc.demo
-DartifactId=demo
-Dversion=1.0.0-SNAPSHOT
-Dpackage=com.zkc.demo
-DarchetypeCatalog=”local”
```
其中如下命令可根据具体项目信息更改

```
-DgroupId=com.zkc.demo \
-DartifactId=demo \
-Dversion=1.0.0-SNAPSHOT \
-Dpackage=com.zkc.demo \
```

3.项目骨架

 构建成功后的骨架结构如下图：

 - ![img.jpg](jmvc-doc/image/jmvc_gj.png)


 模块之间调用关系如下图：
 - ![img.jpg](jmvc-doc/image/jmvc_jiegou.png)


- **demo-controller**

  - 只包含 API Controller 的定义
   
- **demo-service**

    - service 处理实际业务
    
- **demo-dao**
    
    - 持久层访问
    
- **demo-base**
    
    - DO(数据库实体)
    - CO(前端传入的复杂参数，用co封装-防腐层)
    - VO(服务端放回前端实体，用vo封装-防腐层)
    - util 工具类
    - common 通用类
- **start**
    
    - 应用启动入口
    - 应用配置文件
        
3.运行Demo

   - 运行 start 模块下类 Application 的 main 方法。