Java項目中如何引入Hutool工具類并正確使用它

更新時間：2024年01月29日 09:26:57 作者：激流丶

Hutool是一個小而全的Java工具類庫,通過靜態(tài)方法封裝,降低相關(guān)API的學習成本,提高工作效率,使Java擁有函數(shù)式語言般的優(yōu)雅,這篇文章主要給大家介紹了關(guān)于Java項目中如何引入Hutool工具類并正確使用它的相關(guān)資料,需要的朋友可以參考下

1. 項目中如何引入 Hutool

1.1. import 方式引入 Hutool

如果你想像Spring-Boot一樣引入Hutool，再由子模塊決定用到哪些模塊，你可以在父模塊中加入：

<dependencyManagement>
    <dependencies>
        <dependency>
            <groupId>cn.hutool</groupId>
            <artifactId>hutool-bom</artifactId>
            <version>${hutool.version}</version>
            <type>pom</type>
            <!-- 注意這里是import -->
            <scope>import</scope>
        </dependency>
    </dependencies>
</dependencyManagement>

在子模塊中就可以引入自己需要的模塊了：

<dependencies>
    <dependency>
        <groupId>cn.hutool</groupId>
        <artifactId>hutool-http</artifactId>
    </dependency>
</dependencies>

使用 import 的方式，只會引入hutool-bom內(nèi)的dependencyManagement的配置，其它配置在這個引用方式下完全不起作用。

1.2. exclude 方式引入 Hutool

如果你引入的模塊比較多，但是某幾個模塊沒用，你可以：

<dependencies>
    <dependency>
        <groupId>cn.hutool</groupId>
        <artifactId>hutool-bom</artifactId>
        <version>${hutool.version}</version>
        <!-- 加不加這句都能跑，區(qū)別只有是否告警  -->
        <type>pom</type>
        <exclusions>
            <exclusion>
                    <groupId>cn.hutool</groupId>
                    <artifactId>hutool-system</artifactId>
            </exclusion>
        </exclusions>
    </dependency>
</dependencies>

這個配置會傳遞依賴hutool-bom內(nèi)所有dependencies的內(nèi)容，當前hutool-bom內(nèi)的dependencies全部設(shè)置了version，就意味著在maven resolve的時候hutool-bom內(nèi)就算存在dependencyManagement也不會產(chǎn)生任何作用。

2. 以 SpringBoot 項目為例如何使用它

在Spring Boot項目中使用Hutool，您可以按照以下步驟進行操作：

添加Hutool依賴：在您的項目的構(gòu)建文件（如pom.xml）中添加Hutool的依賴項。您可以在Maven中添加以下依賴：

<dependency>
    <groupId>cn.hutool</groupId>
    <artifactId>hutool-all</artifactId>
    <version>5.7.6</version>
</dependency>

在Spring Boot應用程序中使用Hutool：在您的Spring Boot應用程序中，您可以直接使用Hutool提供的工具類和方法。例如，在您的Controller類中，您可以使用Hutool的字符串工具類：

import cn.hutool.core.util.StrUtil;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;

@RestController
public class MyController {

    @GetMapping("/hello")
    public String hello() {
        String str = "Hello, Hutool!";
        String reversedStr = StrUtil.reverse(str);
        return reversedStr;
    }
}

運行應用程序：啟動您的Spring Boot應用程序，并訪問 /hello 端點，您將看到使用Hutool進行字符串翻轉(zhuǎn)后的結(jié)果。

3. Hutool 的編譯安裝

如果想對 Hutool 的源碼進行編譯安裝，可以訪問Hutool的Gitee主頁：https://gitee.com/dromara/hutool (opens new window)下載整個項目源碼（v5-master或v5-dev分支都可）然后進入Hutool項目目錄執(zhí)行：

./hutool.sh install

然后就可以使用Maven引入了。

4. Hutool 的源碼分支說明

Hutool的源碼分為兩個分支，功能如下：

分支	作用
v5-master	主分支，release版本使用的分支，與中央庫提交的jar一致，不接收任何pr或修改
v5-dev	開發(fā)分支，默認為下個版本的SNAPSHOT版本，接受修改或pr

5. 給 Hutool 提供bug反饋或建議

提交問題反饋請說明正在使用的JDK版本呢、Hutool版本和相關(guān)依賴庫版本。

Gitee issue(opens new window)
Github issue

6. 給 Hutool 貢獻代碼的步驟

在Gitee或者Github上fork項目到自己的repo
把fork過去的項目也就是你的項目clone到你的本地
修改代碼（記得一定要修改v5-dev分支）
commit后push到自己的庫（v5-dev分支）
登錄Gitee或Github在你首頁可以看到一個 pull request 按鈕，點擊它，填寫一些說明信息，然后提交即可。
等待維護者合并

7. PR遵照的原則

Hutool歡迎任何人為Hutool添磚加瓦，貢獻代碼，不過維護者是一個強迫癥患者，為了照顧病人，需要提交的pr（pull request）符合一些規(guī)范，規(guī)范如下：

注釋完備，尤其每個新增的方法應按照Java文檔規(guī)范標明方法說明、參數(shù)說明、返回值說明等信息，必要時請?zhí)砑訂卧獪y試，如果愿意，也可以加上你的大名。
Hutool的縮進按照Eclipse（不要跟我說IDEA多好用，維護者非常懶，學不會，IDEA真香，改了Eclipse快捷鍵后舒服多了）默認（tab）縮進，所以請遵守（不要和我爭執(zhí)空格與tab的問題，這是一個病人的習慣）。
新加的方法不要使用第三方庫的方法，Hutool遵循無依賴原則（除非在extra模塊中加方法工具）。
請pull request到v5-dev分支。Hutool在5.x版本后使用了新的分支：v5-master是主分支，表示已經(jīng)發(fā)布中央庫的版本，這個分支不允許pr，也不允許修改。
我們?nèi)绻P(guān)閉了你的issue或pr，請不要詫異，這是我們保持問題處理整潔的一種方式，你依舊可以繼續(xù)討論，當有討論結(jié)果時我們會重新打開。

補充：基于Hutool的excel開發(fā)

引入依賴

excel 包完全依賴于hutool 工具包，不需要額外的引入，hutool all中已經(jīng)包含了hutool 的全部工具包

        <!--   hutool工具類 -->
        <dependency>
            <groupId>cn.hutool</groupId>
            <artifactId>hutool-all</artifactId>
            <version>5.7.22</version>
        </dependency>

開發(fā)

首先確定我們要對那些表進行數(shù)據(jù)的導入導出，這里的建議是對數(shù)據(jù)更改不頻繁的表進行數(shù)據(jù)的導入導出，而且對于數(shù)據(jù)的唯一性要求不高，否則在進行數(shù)據(jù)導入的過程中，需要進行復雜的邏輯處理。這里我使用的是組織的用戶信息表，該表的數(shù)據(jù)只有組織自己進行維護，就可以使用標準導入。

/**
 * 組織用戶信息表
 * @TableName cf_group_user
 */
@TableName(value ="cf_group_user")
@Data
public class GroupUser implements Serializable {
    /**
     * id
     */
    @TableId(type = IdType.AUTO)
    private Integer id;

    /**
     * 組織id
     */
    private Integer groupId;

    /**
     * 姓名
     */
    @NotBlank(message = "姓名不可為空")
    private String nickname;

    /**
     * 性別(0:默認，1:男，2:女)
     */
    @NotBlank(message = "性別不可為空")
    private Integer sex;

    /**
     * 出生日期
     */
    @NotBlank(message = "出生日期不可為空")
    private Date bornTime;

    /**
     * 形象照片
     */
    @NotBlank(message = "形象照片不可為空")
    private String photo;

    /**
     * 家庭地址
     */
    @NotBlank(message = "家庭地址不可為空")
    private String homeAddress;

    /**
     * 聯(lián)系電話
     */
    @NotBlank(message = "聯(lián)系電話不可為空")
    private Integer mobile;

    /**
     * 實名信息
     */
    private String authId;

    /**
     * 職務信息
     */
    @NotNull(message = "職務不可為空")
    private String post;
}

create table cf_group_user
(
    id           int unsigned auto_increment comment 'id'
        primary key,
    group_id     int unsigned               not null comment '組織id',
    nickname     char(30)                   not null comment '姓名',
    sex          tinyint unsigned           not null comment '性別(1:男，2:女)',
    born_time    datetime                   not null comment '出生日期',
    photo        varchar(255)               not null comment '形象照片',
    home_address varchar(255)               not null comment '家庭地址',
    mobile       int                        not null comment '聯(lián)系電話',
    post         varchar(255)               not null comment '職務信息'
)
    comment '組織用戶信息表' collate = utf8_unicode_ci;

create index auth_id
    on cf_group_user (auth_id);

create index group_id
    on cf_group_user (group_id);

create index mobile
    on cf_group_user (mobile);

在確定表后，我們需要選取那些字段是我們需要使用的，在excel 表中進行展示，需要用戶填入，根據(jù)字段構(gòu)建反射。

實現(xiàn)

在工程中先確定使用的字段構(gòu)建模板，根據(jù)字段構(gòu)建excel 的模板。這里的示例如下：

//controller層
//返回模板
    @RequestMapping("/getExcelTemplate")
    public void getExcelTemplate(HttpServletResponse response) {
        groupUserService.getExcelTemplate(response);
    }

//sevice層
void getExcelTemplate(HttpServletResponse response);

//impl
@Override
    public void getExcelTemplate(HttpServletResponse response) {
        try {
            // 1 讀取對象
            final ExcelReader reader = ExcelUtil.getReader(ResourceUtil.getStream("templates/group.xlsx"));
            List<List<Object>> lists = reader.read();
            ExcelWriter writer = ExcelUtil.getWriter(true);
            writer.write(lists);
            response.setHeader("Content-disposition", "attachment;filename=" + URLEncoder.encode("group.xlsx", "UTF-8"));
            response.setContentType("application/vnd.openxmlformats-officedocument.spreadsheetml.sheet");
            // 2 寫出對象
            ServletOutputStream outputStream = response.getOutputStream();
            // 通過IO寫出我們的表格對象
            writer.flush(outputStream, true);
            writer.close();
            IoUtil.close(outputStream);
        } catch (IOException e) {
            log.error("EducationServiceImpl [export] 輸出到響應流失敗", e);
            throw new APIException("導出Excel異常");
        }
    }

這里我使用的是三層構(gòu)建，在controller 層中暴露接口，進行調(diào)用，所有的具體實現(xiàn)進行抽象。

//導入信息
    @RequestMapping("/importStudent")
    public R importStudent(@RequestParam MultipartFile file) {
        try {
            boolean userInfo = groupUserService.getUserInfo(file);
            if(userInfo) return R.success();
        } catch (IOException e) {
            log.error("EducationController [getEducation] 獲取輸入流失敗", e);
            throw new APIException("獲取輸入流失敗");
        }
        return R.error();
    }

//導出信息
    @RequestMapping("/export")
    public void export(@RequestBody PageVo pageVo, HttpServletResponse response) {
        groupUserService.export(pageVo, response);
    }

void export(PageVo pageVo, HttpServletResponse response);

boolean getUserInfo(MultipartFile file) throws IOException;

@Override
    public void export(PageVo pageVo, HttpServletResponse response) {
        // 從數(shù)據(jù)庫查出數(shù)據(jù)對象封裝成map
        final List<Map<String, Object>> educationList = this.page(new Page<>(pageVo.getPage(), pageVo.getLimit()), Wrappers.lambdaQuery()).getRecords()
                .stream()
                // 封裝成 Map 并且放入 List
                .map(item -> {
                    final Map<String, Object> map = new LinkedHashMap<>();
                    // 錯誤，這里需要根據(jù)表中字段名稱進行命名
                    map.put("nickname", item.getNickname());
                    map.put("sex", item.getSex());
                    map.put("mobile", item.getMobile());
                    map.put("bornTime", item.getBornTime());
                    map.put("homeAddress", item.getHomeAddress());
                    map.put("post", item.getPost());
                    return map;
                })
                .collect(Collectors.toList());
        // 準備將數(shù)據(jù)集合封裝成Excel對象
        ExcelWriter writer = ExcelUtil.getWriter(true);
        // 通過工具類創(chuàng)建writer并且進行別名
        writer.addHeaderAlias("nickname", "姓名");
        writer.addHeaderAlias("sex", "性別( 0 表示男 ， 1 表示 女)");
        writer.addHeaderAlias("mobile", "電話");
        writer.addHeaderAlias("bornTime", "出生日期");
        writer.addHeaderAlias("homeAddress", "家庭地址");
        writer.addHeaderAlias("post", "職位");
        // 準備將對象寫入我們的 List
        writer.write(educationList, true);
        try {
            // 獲取我們的輸出流
            final OutputStream output = response.getOutputStream();
            response.setHeader("Content-disposition", "attachment;filename=" + URLEncoder.encode("group.xlsx", "UTF-8"));
            response.setContentType("application/vnd.openxmlformats-officedocument.spreadsheetml.sheet");
            writer.flush(output, true);
            writer.close();
            // 這里可以自行關(guān)閉資源或者寫一個關(guān)閉資源的工具類
            IoUtil.close(output);
        } catch (IOException e) {
            log.error("EducationServiceImpl [export] 輸出到響應流失敗", e);
            throw new APIException("導出Excel異常");
        }
    }

    @Override
    public boolean getUserInfo(MultipartFile file) throws IOException {
        ExcelReader reader = ExcelUtil.getReader(file.getInputStream());
        HashMap<String, String> head = new HashMap<>(6);
        head.put("姓名","nickname");
        head.put("性別( 0 表示男 ， 1 表示 女)","sex");
        head.put("電話","mobile");
        head.put("出生日期", "bornTime");
        head.put("家庭地址","homeAddress");
        head.put("職位","post");
        reader.setHeaderAlias(head);
        List<GroupUser> read = reader.read(0, 1, GroupUser.class);
        Group group = groupService.getOne(new QueryWrapper<Group>().eq("uid", UserConstant.USER_ID));
        for (GroupUser user : read) {
            user.setGroupId(group.getId());
            //TODO 默認圖片
            user.setPhoto("https://cube.elemecdn.com/0/88/03b0d39583f48206768a7534e55bcpng.png");
            user.setStatus(1);
            user.setCreateTime(new DateTime());
            if(!this.save(user))return false;
        }
        return true;
    }

使用hutool 進行excel 處理的時候，需要自己定義字段與excel 表頭見的映射關(guān)系，這一點是比較麻煩的。但相比于其他excel的使用方式，這是一種非常簡單的實現(xiàn)。