17 Star 29 Fork 6

hm-tools / hm-tools-js-css

Create your Gitee Account
Explore and code with more than 6 million developers,Free private repositories !:)
Sign up
Clone or download
Cancel
Notice: Creating folder will generate an empty file .keep, because not support in Git
Loading...
readme.md

Maven Central 996.icu

hm-tools-js-css 功能

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

使用场景

一个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>

使用说明

本工具包是适配spring boot工程开发,在以spring boot框架为基础的项目工程中的pom.xml文件引入:

<dependency>
    <groupId>top.hmtools</groupId>
    <artifactId>spring-boot-starter-js-css</artifactId>
    <version>0.3.0</version>
</dependency>

即可使用,若需要更改配置,请参照一下配置说明。

缺省的获取javascript文件URL示例:

  • http://{网址}:{端口号}/js/encoding/{字符编码名称}/aaa.js,bbb.js
  • 或者:http://{网址}:{端口号}/js/aaa.js,bbb.js
  • {字符编码名称}可选参数,不填时,缺省UTF-8,可以使用GBK,UTF-8,GB2312,UTF-16等Java支持的合法字符编码名称,否则会报错。
  • 缺省的查询所有JavaScript文件列表页面(URI可通过配置文件修改):http://{网址}:{端口号}/list/js

使用yui对JavaScript文件进行压缩、混淆

  • 缺省的获取内容URL是:http://{网址}:{端口号}/yui/js/aaa.js,bbb.js,比如:
http://localhost:8080/yui/js/javascript__munge.js,demoJs_empty.js,javascript_utf-8Demo.js?munge=false&preserveAllSemiColons=true
  • 进行yui压缩的请求参数:
charset : string类型,字符编码,缺省 utf-8
linebreak :integer类型,指定列插入换行符,-1 为不插入换行符
munge :Boolean类型,是否进行混淆
preserveAllSemiColons :Boolean类型,是否保留所有分号“;”
disableOptimizations :Boolean类型,是否禁用优化

缺省的获取css文件URL示例:

  • http://{网址}:{端口号}/css/encoding/{字符编码名称}/aaa.css,bbb.css
  • 或者:http://{网址}:{端口号}/css/aaa.css,bbb.css
  • {字符编码名称}可选参数,不填时,缺省UTF-8,可以使用GBK,UTF-8,GB2312,UTF-16等Java支持的合法字符编码名称,否则会报错。
  • 缺省的查询所有css文件列表页面(URI可通过配置文件修改):http://{网址}:{端口号}/list/css

使用yui对css文件进行压缩、混淆

  • 缺省的获取内容URL是:http://{网址}:{端口号}/yui/css/aaa.css,bbb.css,比如:
http://localhost:8080/yui/css/css_border-none.css?charset=gbk&linebreak=2
  • 进行yui压缩的请求参数:
charset : string类型,字符编码,缺省 utf-8
linebreak :integer类型,指定列插入换行符,-1 为不插入换行符

配置说明:

  • hm_tools.js_css.enabled=true 是否启用本jar包组件功能,当配置为“true”时或者不配置该值时均表示启用,为“false”时则不启用。
  • hm_tools.js_css.js_uri=/get_js 配置获取javascript文件内容的请求uri
  • hm_tools.js_css.css_uri=/get_css 配置获取CSS文件内容的请求uri
  • hm_tools.js_css.refresh_js_uri=/refresh_js 配置刷新javascript文件缓存内容的请求uri
  • hm_tools.js_css.refresh_css_uri=/refresh_css 配置刷新css文件缓存内容的请求uri
  • hm_tools.js_css.js_files_paths=static 配置获取javascript文件内容的磁盘路径集合(均相对于工程项目的classpath),以英文逗号(,)分隔
  • hm_tools.js_css.css_files_paths=static 配置获取css文件内容的磁盘路径集合(均相对于工程项目的classpath),以英文逗号(,)分隔
  • hm_tools.js_css.encoding=UTF-8 获取的文件内容的字符编码格式名称,缺省为“UTF-8”。
  • hm_tools.js_css.list_js_uri=/list_js 获取所有javascript文件列表请求uri
  • hm_tools.js_css.list_css_uri=/list_css 获取所有css文件列表请求uri
  • hm_tools.js_css.src_uri=src 通用的获取静态资源文件内容uri,仅获取单个文件,且该文件必须在配置的js_files_paths、css_files_paths路径下,用于解决css文件中含有相对路径引用其它文件的问题。
  • hm_tools.js_css.yui.js_uri= /yui/get_js 配置获取使用yui压缩后javascript文件内容的请求uri
  • hm_tools.js_css.yui.css_uri= /yui/get_css 配置获取使用yui压缩后CSS文件内容的请求uri

如何使用本组件的快照版本

  1. 在自己的私服建立一个快照代理仓库即可。https://oss.sonatype.org/content/repositories/snapshots/ 如何使用快照版本

  2. 将建好的参考纳入公共库 如何使用快照版本

Comments ( 4 )

Sign in for post a comment

About

根据URL请求参数将多个javascript文件合并成一个javascript文件返回给请求者。根据URL请求参数将多个css文件合并成一个css文件返回给请求者。 spread retract
Cancel

Releases

No release

hm-tools-js-css

Contributors

All

Activities

load more
can not load any more
Java
1
https://git.oschina.net/hm-tools/hm-tools-js-css.git
git@git.oschina.net:hm-tools/hm-tools-js-css.git
hm-tools
hm-tools-js-css
hm-tools-js-css
master

Search