FortuneCommons正式开源啦

7次阅读

共计 1504 个字符,预计需要花费 4 分钟才能阅读完成。

Fortune Commons 是笔者在工作以来的一些技术积累,虽然是很[低端],但是对于 Java 入门或者初入 Java 开发的工作者来说,也是一个不错的学习资源,今天特地整合出来。

Github 地址:https://github.com/landy8530/…

版本说明

版本约束

  • Spring:5.x+
  • JDK:1.8+

版本计划

为适应目前国内各个行业不同的技术分布,目前计划三个大版本的计划,说明如下:

版本 功能说明
1.x 数据缓存处理和 excel/pdf 导出组件,集成 Spring MVC
2.x 数据缓存处理和 excel/pdf 导出组件,集成 Restful API
3.x 数据缓存处理和 excel/pdf 导出组件,集成 Restful API,并且计划加入 Spring Boot/Spring Cloud 等

注意:以上各个版本都可以增加其他组件。

工程说明

目前最新版本为 v1.0.x,含有以下子工程(子模块),分别说明如下(也可参考 wiki):

commons-core

主要是本项目所需的一些核心功能实现,比如 BeanCopier 工具封装,读取 yml 文件工具,Freemarker 解析实现,ApplicationContext 工具类,Spring 容器初始化后统一操作的 listener 实现以及其他一些工具类支持。

commons-datacache

本模块动态实现了各主流缓存中间件的实现,可以自由切换,依赖于 commons-nosql 模块。目前实现了以下几种:

  • 本地内存(Memory)
  • Mongodb
  • Memcached
  • Redis(即将实现)

commons-nosql

NoSql 模拟关系型数据库的 CRUD 操作,目前有 Mongodb 实现。

commons-export

实现了 excel 和 pdf 导出组件

commons-web

封装了 web 端常见的一些配置操作

commons-web-springmvc

封装了 spring mvc 的一些配置操作,依赖于 commons-web 子模块。

fortune-commons-example

本项目的演示模块,主要是用于测试用途。

如何对该开源项目进行贡献

  1. 代码大多是手敲,所以难免会有错误,你可以帮我 Bug,提交 issues 或者 PR。
  2. 很多知识点我可能没有涉及到,所以你可以对其他知识点进行补充或者加入其他的组件。
  3. 为了使项目更加的透明化,便利化,也可以参与 wiki 的编写工作。

为什么要做这个开源组件?

初始想法源于自己工作中遇到的各种坑,主要目的是为了通过这个开源平台来帮助一些在学习 Java 或者直接在自己公司中使用或者扩展自己的项目。

Git 操作说明

切换分支

fork 本工程后可以按照如下操作即可,

  • 切换到 master 分支,并且更新最新远程库中的代码

    • git checkout master
    • git pull/git fetch

创建分支

  • 创建自己的本地分支,以 master 为源创建

    • git checkout -b fortune-commons-export
  • 查看是否创建成功

    • git branch
      fortune-commons-beanutils
    * fortune-commons-export
      fortune-commons-memcached
      master

星号 (*) 表示当前所在分支。现在的状态是成功创建的新的分支并且已经切换到新分支上。

同步分支

  • 把新建的本地分支 push 到远程服务器,远程分支与本地分支同名(当然可以随意起名)

    • git push origin fortune-commons-export:fortune-commons-export

创建标签

  • git tag -a v1.0.1 -m “fortune commons v1.0.1”
  • git push origin v1.0.1

正文完
 0