JeePlus 基础使用指南(浅析JeePlus)

JeePlus 是基于 SpringMVC 和 MyBatis 的快速开发平台,可以大大提高项目开发效率。本文将从几个方面介绍 JeePlus 的基本使用方法。

一、快速搭建项目

使用 JeePlus 可以快速创建一个基于 SpringMVC 和 MyBatis 的项目,只需要少量的配置即可完成。

首先需要创建一个 Maven 项目,然后在 pom.xml 文件中添加以下依赖:

<dependency>
    <groupId>com.jeeplus.modules</groupId>
    <artifactId>jeeplus-core</artifactId>
    <version>${jeeplus.version}</version>
</dependency>

然后,在 Spring 配置文件中加入以下配置:

<import resource="classpath*:spring-context.xml"/>
<import resource="classpath*:spring-mvc.xml"/>
<import resource="classpath*:mybatis-config.xml"/>

接下来,在 web.xml 文件中配置 DispatcherServlet:

<servlet>
    <servlet-name>springMVC</servlet-name>
    <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
    <init-param>
        <param-name>contextConfigLocation</param-name>
        <param-value>classpath:springMVC-config.xml</param-value>
    </init-param>
</servlet>

完成以上配置之后,就可以在项目中愉快地使用 JeePlus 了。

二、基本 CRUD 操作

JeePlus 的基础功能是提供了一套通用的数据库操作接口,可以通过简单的配置,完成基本的 CRUD 操作。

首先需要在实体类上使用 JeePlus 的注解进行配置:

@Table(name = "sys_user")
public class User extends BaseEntity {

    private static final long serialVersionUID = 1L;

    @ExcelField(title = "姓名")
    private String name; // 姓名
    
    @ExcelField(title = "电话")
    private String mobile; // 电话
    
    // ... getter 和 setter 方法省略
}

然后就可以在 Service 层中使用 JeePlus 的通用接口进行数据库操作了:

@Service
@Transactional(readOnly = true)
public class UserService extends CrudService<UserMapper, User> {

    // 添加用户
    @Transactional(readOnly = false)
    public void saveUser(User user) {
        super.save(user);
    }

    // 修改用户信息
    @Transactional(readOnly = false)
    public void updateUser(User user) {
        super.update(user);
    }

    // 删除用户
    @Transactional(readOnly = false)
    public void deleteUser(String id) {
        super.delete(new User(id));
    }

    // 获取用户列表
    public List<User> findUserList() {
        return super.findList(new User());
    }

    // 获取单个用户信息
    public User getUser(String id) {
        return super.get(id);
    }
}

使用以上方法可以快速完成基本的 CRUD 操作。

三、自定义逻辑操作

在某些情况下,需要进行一些自定义的逻辑操作,这时就需要自己编写 Service 层的实现方法。

以查询用户列表为例,自定义实现方法如下:

@Service
@Transactional(readOnly = true)
public class UserService extends CrudService<UserMapper, User> {

    // 获取用户列表
    public List<User> findUserList() {
        return dao.findUserList();
    }

    // 自定义查询方法
    public List<User> findUserByName(String name) {
        User user = new User();
        user.setName(name);
        return dao.findUserList(user);
    }
}

在上面 UserService 类中,我们自定义了一个查询用户列表的方法 findUserList(),并使用了 Spring 提供的事务注解 @Transactional。

使用以上方法可以快速自定义逻辑操作。

四、代码生成器

JeePlus 还提供了一个强大的代码生成器,可以大大提高开发效率。

在使用代码生成器之前,需要在项目中添加以下依赖:

<dependency>
    <groupId>com.jeeplus.modules</groupId>
    <artifactId>jeeplus-gen</artifactId>
    <version>${jeeplus.version}</version>
</dependency>

然后在项目的 resources 目录下创建一个名为 jeeplus-gen.properties 的配置文件,配置如下:

# 数据库配置
jdbc.driver=com.mysql.jdbc.Driver
jdbc.url=jdbc:mysql://localhost:3306/jeeplus?characterEncoding=utf8&autoReconnect=true&failOverReadOnly=false&useSSL=false
jdbc.username=root
jdbc.password=root

# 代码生成器配置
gen.jdbc.type=mysql
gen.java.src.dir=src/main/java
gen.java.template.dir=src/main/resources/templates
gen.html.src.dir=src/main/webapp/WEB-INF/views
gen.html.template.dir=src/main/resources/templates
gen.table.name=sys_user
gen.package.base=com.jeeplus.modules
gen.module.name=sys

配置文件中的最后五个参数表示要生成代码的相关配置。其中 gen.table.name 表示要生成代码的数据库表名,gen.package.base 表示包名,gen.module.name 表示模块名。

完成以上配置之后,执行以下命令:

mvn jeeplus-gen:gen -Dfile.encoding=UTF8

执行结束之后,就可以在相应目录下看到生成的代码文件了。

总结

本文介绍了 JeePlus 的基础使用方法,包括快速搭建项目、基本 CRUD 操作、自定义逻辑操作和代码生成器等几个方面。JeePlus 的简单可依赖于 MyBatis 和 SpringMVC,易于学习和使用,可以提高项目的开发效率。

Published by

风君子

独自遨游何稽首 揭天掀地慰生平