JsCss

# 指南

# 使用场景

Java web项目开发过程中，一个html页面中必然会需要引用JavaScript文件及css文件，以JavaScript文件为例，比如要分别引用 a.js,b.js。
一般情况下，会使用2个“<script>”标签引用，即：

<script src="a.js"></script>
<script src="b.js"></script>

这样会存在浏览器向服务器发送2次http请求，才能获取完所需要的JavaScript文件。 使用本工具后，则只需要一个标签就可以引入完2个JavaScript文件，即：

<script src="a.js,b.js"></script>

因而，在获取相同数据长度的情况下，通过减少了http请求次数，缩短了页面打开时间。

# 主要功能

  • 根据URL请求参数将多个javascript文件合并成一个javascript文件返回给请求者。
  • 根据URL请求参数将多个css文件合并成一个css文件返回给请求者。
  • 支持从当前运行的spring boot工程jar包中读取javascript，css文件。
  • 支持在请求URL携带字符编码名称获取相应的字符编码格式的js、css文件。
  • 支持替换css文件中url引用资源的相对路径为可访问的绝对路径。
  • 支持使用yuicompressor对js，css文件内容进行实时压缩、混淆。

# 特性

  • 本项目基于spring boot starter，可独立运行（使用命令java -jar spring-boot-starter-js-css-0.3.0.jar）。也可通过maven pom.xml引入到您的spring boot项目中。可以完全零配置使用。
  • 本项目能自动识别GBK、UTF-8字符编码，在读取磁盘JavaScript、css文件时，不需要手动统一指定何种字符编码，均可成功读取，不会乱码。在浏览器请求本项目获取JavaScript、css文件时，可以通过request param 指定任何合法的字符编码名称获取您所需要的字符编码的JavaScript、css文件内容。
  • 本项目可以从jar包中读取JavaScript、css等静态资源文件，假设您基于spring boot开发项目，引入了本工具包，当你的项目以jar包形式发布运行时，您在该jar包中的所有JavaScript、css文件均可以读取出来，同时还支持列表展示。
  • 本项目支持yuicompressor压缩、混淆JavaScript、css文件，您只需要访问本项目指定支持yuicompressor的接口，即可实现合并多个JavaScript文件并进行压缩、混淆。

# 快速开始

  1. maven引用本项目jar包到您的基于spring boot项目：
<dependency>
    <groupId>top.hmtools</groupId>
    <artifactId>spring-boot-starter-js-css</artifactId>
    <version>0.3.0</version>
</dependency>
  1. 启动您的spring boot 项目。
  2. 假设您的spring boot项目监听的端口号是“8080”，在浏览器地址栏输入：“http://localhost:8080/list/js”,如果展示下图界面，说明OK了。

# 最新版本

Maven Central

整合到您的spring boot项目 →