创建单表维护功能

请参考Demo中的示例功能:汽车管理。

需要参考的文件列表:

  • /WebContent/WEB-INF/config/spring/spring-mvc.xml
  • /WebContent/WEB-INF/views/demo/demo/car/*.jsp
  • /src/com/dlshouwen/demo/demo/controller/CarController.java
  • /src/com/dlshouwen/demo/demo/dao/CarDao.java
  • /src/com/dlshouwen/demo/demo/model/Car.java

创建图表统计功能

请参考Demo中的示例功能:汽车统计。

  • /WebContent/WEB-INF/config/spring/spring-mvc.xml
  • /WebContent/WEB-INF/views/demo/demo/carCount/*.jsp
  • /src/com/dlshouwen/demo/demo/controller/CarCountController.java
  • /src/com/dlshouwen/demo/demo/dao/CarCountDao.java
  • /src/com/dlshouwen/demo/demo/model/Car.java

表格开发文档

Core Classic产品使用的表格控件为SigmaGrid控件,研发人员对该控件进行了一部分扩展参数,本节仅对修改的参数部分进行说明,其他SigmaGrid自带参数及方法请参考其官方文档。

属性

针对SigmaGrid追加了type、codeTableKey、fastQuery属性。

type

使用位置:列定义对象

参数用途:标明该列使用的数据类型,数值型数据指定为string即可。该属性用于快速查询及高级查询时的数据录入样式,若设置为string类型,则为文本框,若为date则为日期选择框,若为time则为时间选择框。

可选值:string、date、time

  • string:字符或数值类型
  • date:日期类型,格式为yyyy-HH-dd
  • time:时间类型,格式为yyyy-HH-dd hh:mm:ss

codeTableKey

使用位置:列定义对象

参数用途:标识该列的显示信息取自码表,并给出取自的码表类别代码。若列设置了此属性,则在快速查询及高级查询中将以下拉选择框的方式提供操作用户选择,增强用户体验。

可选值:所有码表管理功能中的码表类别代码

注意:请确保配置的码表类别代码在码表中存在。

fastQuery

使用位置:列定义对象

参数用途:表示该列启用快速查询,快速查询方式可选用下述可选值,若不配置该项,则快速查询中不显示该列。

可选值:eq、ne、lk、rl、ll、gt、ge、lt、le、range

  • eq:等于
  • ne:不等于
  • lk:匹配
  • rl:右匹配
  • ll:左匹配
  • gt:大于,仅对数值、日期、时间型有效
  • ge:大于等于,仅对数值、日期、时间型有效
  • lt:小于,仅对数值、日期、时间型有效
  • le:小于等于,仅对数值、日期、时间型有效
  • range:范围,仅对数值、日期、时间型有效

格式化方法

SigmaGrid提供renderer参数,该参数可以定义在绘制列内容时系统调用的方法,参数定义的方法的返回值为绘制内容。

对于常用的数据格式化方案,大连首闻核心系统Classic版本提供如下常用方法。

gridformatMoney

使用位置:列定义对象中的renderer属性

方法用途:格式化内容为金额,追加千分位符号,固定保留两位小数

gridformatDate

使用位置:列定义对象中的renderer属性

方法用途:格式化内容为日期,格式为yyyy-HH-dd

gridformatTime

使用位置:列定义对象中的renderer属性

方法用途:格式化内容为日期,格式为yyyy-HH-dd hh:mm:ss

gridformatFileSize

使用位置:列定义对象中的renderer属性

方法用途:格式化内容为文件大小,按大小自动生成KB、MB、GB字符,保留千分位

gridformatHtmlEncode

使用位置:列定义对象中的renderer属性

方法用途:将内容进行Html特殊字符转义

扩展方法

大连首闻核心系统Classic版本追加了一部分常用的扩展方法。

sigmaGridCheckedAll

使用位置:任意

方法用途:全选当前页中的表格内数据

参数:

  • sigmaGridObject:SigmaGrid对象

返回值:无

sigmaGridUnCheckedAll

使用位置:任意

方法用途:取消全选当前页中的表格内数据

参数:

  • sigmaGridObject:SigmaGrid对象

返回值:无

doFastQuery

使用位置:任意

方法用途:打开快速查询窗口

参数:

  • sigmaGridObject:SigmaGrid对象
  • isSelf:是否为当前页面打开,非必要参数,默认为false
  • callback:查询执行或关闭页面后调用的回调方法
  • _colsOption:自定义列对象,若不传入此参数,则使用SigmaGrid对象自带的列定义信息

返回值:无

doAdvanceQuery

使用位置:任意

方法用途:打开高级查询窗口

参数:

  • sigmaGridObject:SigmaGrid对象
  • functionCode:高级查询识别号,用于区别各列表,请保证不同功能的不同列表该识别号不同,否则会造成高级查询方案串到其他功能的问题
  • isSelf:是否为当前页面打开,非必要参数,默认为false
  • callback:查询执行或关闭页面后调用的回调方法
  • _colsOption:自定义列对象,若不传入此参数,则使用SigmaGrid对象自带的列定义信息

返回值:无

extraDefaultOption

使用位置:任意

方法用途:为表格定义设置默认参数

参数:

  • option:原表格定义参数对象

返回值:无

设置的默认属性如下

  • id : 'myGrid'
  • loadURL : null
  • width : "100%"
  • height : "100%"
  • container : 'sigmaGridContainer'
  • replaceContainer : false
  • skin : "default"
  • toolbarPosition:'bottom'
  • showGridMenu : true
  • allowCustomSkin : false
  • allowFreeze : true
  • allowHide : true
  • allowAccountBook : false
  • resizable : false
  • showIndexColumn : false
  • stripeRows : true
  • toolbarContent : 'nav | goto | pagesize | reload | xls print | state'
  • exportFileName : null
  • pageSize : 20
  • pageSizeList : [20, 50, 100]
  • dataset : null
  • columns : null

Java工具类

大连首闻核心系统Classic版本提供大量的内部工具类,涉及加密算法、辅助开发、参数、日期扩展等内容。

注意:文档中标识的版本没有特定含义,版本号以最后修订日期为准。

AjaxUtils.java

包路径:com.dlshouwen.core.base.utils

类名称:AjaxUtils

类全名:com.dlshouwen.core.base.utils.AjaxUtils

类说明:AJAX操作响应的工具类

作者:大连首闻科技有限公司

版本:2013-7-12 9:24:32

ajaxPut

方法名称:ajaxPut

方法全名:public static void ajaxPut (javax.servlet.http.HttpServletResponse, java.lang.String) throws java.lang.Exception

方法描述:Ajax回写内容

方法说明:用于回写response信息,由于Spring MVC可以直接通过return响应,该方法几乎不会用到

参数信息:

  • javax.servlet.http.HttpServletResponse response:响应对象。
  • java.lang.String value:需要写入的内容。

返回值:无返回值 [void]

异常信息:Exception 抛出全部异常

ajaxPut

方法名称:ajaxPut

方法全名:public static void ajaxPut (javax.servlet.http.HttpServletResponse, java.util.Map) throws java.lang.Exception

方法描述:Ajax回写Map对象,回写过程中将会把Map对象转为JSON

方法说明:用于回写response信息,回写过程中将会把Map对象转为JSON,由于Spring MVC可以直接通过return响应,该方法几乎不会用到

参数信息:

  • javax.servlet.http.HttpServletResponse response:响应对象。
  • java.util.Map params:需要写入的Map对象。

返回值:无返回值 [void]

异常信息:Exception 抛出全部异常

ajaxPut

方法名称:ajaxPut

方法全名:public static void ajaxPut (javax.servlet.http.HttpServletResponse, java.util.List) throws java.lang.Exception

方法描述:AJAX回写List对象,回写过程中将会把List对象转为JSON

方法说明:用于回写response信息,回写过程中将会把List对象转为JSON,由于Spring MVC可以直接通过return响应,该方法几乎不会用到

参数信息:

  • javax.servlet.http.HttpServletResponse response:响应对象。
  • java.util.List list:需要写入的List对象。

返回值:无返回值 [void]

异常信息:Exception 抛出全部异常

ajaxPut

方法名称:ajaxPut

方法全名:public static void ajaxPut (javax.servlet.http.HttpServletResponse, java.lang.Object) throws java.lang.Exception

方法描述:Ajax回写Object对象,回写过程中将会把Object对象转为JSON

方法说明:用于回写response信息,回写过程中将会把Object对象转为JSON,由于Spring MVC可以直接通过return相应,该方法几乎不会用到

参数信息:

  • javax.servlet.http.HttpServletResponse response:响应对象。
  • java.lang.Object object:需要写入的对象。

返回值:无返回值 [void]

异常信息:Exception 抛出全部异常

AssistDevelopUtils.java

包路径:com.dlshouwen.core.base.utils

类名称:AssistDevelopUtils

类全名:com.dlshouwen.core.base.utils.AssistDevelopUtils

类说明:辅助开发工具类

作者:大连首闻科技有限公司

版本:2016-5-25 08:57:32

getDataSource

方法名称:getDataSource

方法全名:public static DataSource getDataSource (java.lang.String, java.lang.String, java.lang.String, java.lang.String) throws java.lang.Exception

方法描述:获取数据源

方法说明:根据驱动类地址、链接地址、用户名及密码获取数据源信息,使用C3P0数据连接池

参数信息:

  • java.lang.String driverClass:驱动类地址。
  • java.lang.String jdbcUrl:链接地址。
  • java.lang.String username:用户名。
  • java.lang.String password:密码。

返回值:数据源对象 [javax.sql.DataSource]

异常信息:Exception 抛出全部异常

getSQL

方法名称:getSQL

方法全名:public static void getSQL (javax.sql.DataSource, java.lang.String, java.lang.String, java.lang.String) throws java.lang.Exception

方法描述:获取对应SQL

方法说明:根据数据源及表名获取常用SQL,输入SQL包含:insert、update、select,可控制输出类型

参数信息:

  • javax.sql.DataSource dataSource:连接数据源。
  • java.lang.String tableName:表名。
  • java.lang.String aliasName:表别名。
  • java.lang.String type:输入类型,0-${*}格式输出、1-?输出。

返回值:无返回值 [void]

异常信息:Exception 抛出全部异常

createModel

方法名称:createModel

方法全名:public static void createModel (javax.sql.DataSource, java.lang.String, java.lang.String, java.lang.String, java.lang.String, java.lang.String) throws java.lang.Exception

方法描述:通过表名新增实体对象

方法说明:通过表名查询数据库表信息,根据表基础信息生成实体对象,生成的对象包含验证信息,验证信息依据数据库中是否必填及长度信息生成,验证名称依据字段备注说明信息生成。由于主键、创建人(creator)、创建时间(create_time)、编辑人(editor)、编辑时间(edit_time)、是否删除(is_delete)字段通过系统生成,故不作必填限制。

参数信息:

  • javax.sql.DataSource dataSource:连接数据源。
  • java.lang.String srcPath:src根节点路径。
  • java.lang.String packageName:包名。
  • java.lang.String className:类名。
  • java.lang.String tableName:表名。
  • java.lang.String name:对象名。

返回值:无返回值 [void]

异常信息:Exception 抛出全部异常

createJavaFile

方法名称:createJavaFile

方法全名:public static void createJavaFile (java.lang.String, java.lang.String, java.lang.String, java.lang.String) throws java.lang.Exception

方法描述:新增Java文件

方法说明:用于生成新的Java未见,需要制定位置及包名、类名、业务名信息,生成的Java文件包含Controller及Dao套件文件,文件内容包含一些基础引用的对象及代码

参数信息:

  • java.lang.String srcPath:src根绝对路径。
  • java.lang.String packageName:包名称。
  • java.lang.String className:类名称。
  • java.lang.String name:业务名称。

返回值:无返回值 [void]

异常信息:Exception 抛出全部异常

constructSigmaGridDate

方法名称:constructSigmaGridDate

方法全名:public static void constructSigmaGridDate (javax.sql.DataSource, java.lang.String) throws java.lang.Exception

方法描述:生成sigmaGrid对应属性

方法说明:根据表名生成前台使用的SigmaGrid表格属性

参数信息:

  • javax.sql.DataSource dataSource:连接数据源。
  • java.lang.String tableName:表名。

返回值:无返回值 [void]

异常信息:Exception 抛出全部异常

constructInputData

方法名称:constructInputData

方法全名:public static void constructInputData (javax.sql.DataSource, java.lang.String) throws java.lang.Exception

方法描述:生成表单对应属性

方法说明:根据表名生成表单信息,顺序依据字段顺序生成,表单元素的验证信息使用字段的必填、长度、格式等限制

参数信息:

  • javax.sql.DataSource dataSource:连接数据源。
  • java.lang.String tableName:表名称。

返回值:无返回值 [void]

异常信息:Exception 抛出全部异常

constructFiledDescription

方法名称:constructFiledDescription

方法全名:public static void constructFiledDescription (javax.sql.DataSource, java.lang.String, java.lang.String) throws java.lang.Exception

方法描述:生成字段描述信息

方法说明:根据表名称生成所有字段描述信息,用于文档编写

参数信息:

  • javax.sql.DataSource dataSource:连接数据源。
  • java.lang.String tableName:表名称。
  • java.lang.String tableComment:表注释信息。

返回值:无返回值 [void]

异常信息:Exception 抛出全部异常

constructTaskAttrDescription

方法名称:constructTaskAttrDescription

方法全名:public static void constructTaskAttrDescription (javax.sql.DataSource, java.lang.Class, java.lang.String, java.lang.String) throws java.lang.Exception

方法描述:生成任务可用参数

方法说明:反射某对象信息,并根据某表信息匹配该对象属性,匹配上则生成说明信息。该方法主要用于编写任务的可用参数说明,通常不会用到。

参数信息:

  • javax.sql.DataSource dataSource:连接数据源。
  • java.lang.Class z:类。
  • java.lang.String tableName:表名称。
  • java.lang.String tableComment:表注释信息。

返回值:无返回值 [void]

异常信息:Exception 抛出全部异常

constructJavaAPI

方法名称:constructJavaAPI

方法全名:public static void constructJavaAPI (java.lang.String, java.lang.Class) throws java.lang.Exception

方法描述:生成Java接口文档

方法说明:用于生成大连首闻核心系统Classic版本Java文件接口文档

参数信息:

  • java.lang.String path:类文件所在路径。
  • java.lang.Class z:文件类对象。

返回值:无返回值 [void]

异常信息:Exception 抛出全部异常

constructJavaScriptAPI

方法名称:constructJavaScriptAPI

方法全名:public static void constructJavaScriptAPI (java.lang.String) throws java.lang.Exception

方法描述:生成JavaScript接口文档

方法说明:用于生成大连首闻核心系统Classic版本JavaScript文件接口文档

参数信息:

  • java.lang.String path:文件路径。

返回值:无返回值 [void]

异常信息:Exception 抛出全部异常

constructCssAPI

方法名称:constructCssAPI

方法全名:public static void constructCssAPI (java.lang.String) throws java.lang.Exception

方法描述:生成Css接口文档

方法说明:用于生成大连首闻核心系统Classic版本Css文件接口文档

参数信息:

  • java.lang.String path:文件路径。

返回值:无返回值 [void]

异常信息:Exception 抛出全部异常

imageClipping

方法名称:imageClipping

方法全名:public static void imageClipping (java.lang.String, java.lang.String, java.lang.String, double, double) throws java.lang.Exception

方法描述:图片裁剪

方法说明:用于图片裁剪,可控制裁剪类型

参数信息:

  • java.lang.String sourceFolder:源文件路径。
  • java.lang.String targetFolder:目标文件路径。
  • java.lang.String type:裁剪类型。
  • double width:裁剪宽度。
  • double height:裁剪高度。

返回值:无返回值 [void]

异常信息:Exception 抛出全部异常

constructTestDatas

方法名称:constructTestDatas

方法全名:public static void constructTestDatas (javax.sql.DataSource) throws java.lang.Exception

方法描述:生成测试数据

方法说明:用于生成大连首闻核心系统Classic版本测试数据

参数信息:

  • javax.sql.DataSource dataSource:连接数据源。

返回值:无返回值 [void]

异常信息:Exception 抛出全部异常

clearTestDatas

方法名称:clearTestDatas

方法全名:public static void clearTestDatas (javax.sql.DataSource) throws java.lang.Exception

方法描述:清除测试数据

方法说明:用于清除大连首闻核心系统Classic版本测试数据

参数信息:

  • javax.sql.DataSource dataSource:连接数据源。

返回值:无返回值 [void]

异常信息:Exception 抛出全部异常

constructSkin

方法名称:constructSkin

方法全名:public static void constructSkin(DataSource dataSource) throws java.lang.Exception

方法描述:更新皮肤辅色

方法说明:循环所有皮肤,将皮肤的辅色根据基色及配置偏移生成辅色并更新到数据库中

参数信息:

  • javax.sql.DataSource dataSource:连接数据源。

返回值:无返回值 [void]

异常信息:Exception 抛出全部异常

AttributeUtils.java

包路径:com.dlshouwen.core.base.utils

类名称:AttributeUtils

类全名:com.dlshouwen.core.base.utils.AttributeUtils

类说明:系统参数工具类

作者:大连首闻科技有限公司

版本:2013-7-12 9:24:32

getAttributeContent

方法名称:getAttributeContent

方法全名:public static String getAttributeContent (javax.servlet.ServletContext, java.lang.String)

方法描述:获取参数内容

方法说明:用于获取参数值,需要提供参数编号

参数信息:

  • javax.servlet.ServletContext context:Servlet上下文。
  • java.lang.String attrCode:参数编号。

返回值:参数内容 [java.lang.String]

异常信息:无异常抛出

CodeTableUtils.java

包路径:com.dlshouwen.core.base.utils

类名称:CodeTableUtils

类全名:com.dlshouwen.core.base.utils.CodeTableUtils

类说明:码表工具类

作者:大连首闻科技有限公司

版本:2013-7-23 20:18:14

createCodeTableJS

方法名称:createCodeTableJS

方法全名:public static void createCodeTableJS (javax.servlet.ServletContext, javax.servlet.jsp.JspWriter, java.lang.String) throws java.lang.Exception

方法描述:JSP页面中输出码表映射的JS代码

方法说明:用于JSP页面中需要引用码表的情况,通过Java代码调用该方法即可输入JS代码,代码将处理两项操作:追加JS中的code_table_info对象值,key为码表类别编号,value为该码表类别的码表信息JSON数据,JSON数据格式为Object,key-码表编号、value-码表值;定义方法“sigmaGridCodeTable_码表类别编号”,根据传入的value参数获取码表具体值,通常用于列表回显。

参数信息:

  • javax.servlet.ServletContext context:Servlet上下文。
  • javax.servlet.jsp.JspWriter out:JSP输出对象。
  • java.lang.String type:码表类别编号。

返回值:无返回值 [void]

异常信息:Exception 抛出全部异常

getValue

方法名称:getValue

方法全名:public static String getValue (javax.servlet.ServletContext, java.lang.String, java.lang.String)

方法描述:获取码表值

方法说明:用于获取码表值,需要提供码表类别编号及码表编号信息

参数信息:

  • javax.servlet.ServletContext context:Servlet上下文。
  • java.lang.String type:码表类别编号。
  • java.lang.String key:码表编号。

返回值:码表值 [java.lang.String]

异常信息:无异常抛出

DateUtils.java

包路径:com.dlshouwen.core.base.utils

类名称:DateUtils

类全名:com.dlshouwen.core.base.utils.DateUtils

类说明:日期工具类

作者:大连首闻科技有限公司

版本:2013-7-13 15:18:09

getNowDate

方法名称:getNowDate

方法全名:public static String getNowDate ()

方法描述:获取当前日期

方法说明:用于获取当前日期,格式为yyyy-MM-dd

参数信息:无

返回值:当前日期 [java.lang.String]

异常信息:无异常抛出

getNowTime

方法名称:getNowTime

方法全名:public static String getNowTime ()

方法描述:获取当前时间

方法说明:用于获取当前时间,格式为:yyyy-MM-dd HH:mm:ss

参数信息:无

返回值:当前时间 [java.lang.String]

异常信息:无异常抛出

getNowTimeHaveMS

方法名称:getNowTimeHaveMS

方法全名:public static String getNowTimeHaveMS ()

方法描述:获取当前时间,包含毫秒

方法说明:用于获取当前时间,包含毫秒,格式为:yyyy-MM-dd HH:mm:ss SSS

参数信息:无

返回值:当前时间 [java.lang.String]

异常信息:无异常抛出

getNowDateFormat

方法名称:getNowDateFormat

方法全名:public static String getNowDateFormat (java.lang.String)

方法描述:按指定格式获取当前时间

方法说明:用于获取指定格式的当前时间,格式通过format参数传递

参数信息:

  • java.lang.String format:日期格式。

返回值:格式化后的当前时间 [java.lang.String]

异常信息:无异常抛出

getDateFormat

方法名称:getDateFormat

方法全名:public static String getDateFormat (java.lang.String, java.lang.String) throws java.text.ParseException

方法描述:按指定格式获取指定时间

方法说明:用于按指定格式获取指定时间

参数信息:

  • java.lang.String date:需要格式化的时间字符串。
  • java.lang.String format:日期格式。

返回值:格式化后的时间 [java.lang.String]

异常信息:Exception 抛出格式化异常

parseDateTime

方法名称:parseDateTime

方法全名:public static Calendar parseDateTime (java.lang.String)

方法描述:将日期字符串转换为Calendar类型日期

方法说明:用于将日期字符串转换为Calendar类型日期

参数信息:

  • java.lang.String baseDate:yyyyMMdd格式日期。

返回值:Calendar类型日期对象 [java.util.Calendar]

异常信息:无异常抛出

formatDateTime

方法名称:formatDateTime

方法全名:public static String formatDateTime (java.lang.String, java.lang.String)

方法描述:格式化时间

方法说明:用于格式化时间

参数信息:

  • java.lang.String date:需要被格式化的时间。
  • java.lang.String format:时间格式。

返回值:格式化后的时间 [java.lang.String]

异常信息:无异常抛出

getDay

方法名称:getDay

方法全名:public static int getDay (java.lang.String)

方法描述:根据字符串时间格式获取日

方法说明:用于获取字符串时间中的日,用Calendar方式

参数信息:

  • java.lang.String date:时间。

返回值:日 [int]

异常信息:无异常抛出

getMonth

方法名称:getMonth

方法全名:public static int getMonth (java.lang.String)

方法描述:根据字符串时间格式获取月

方法说明:用于获取字符串时间中的月,用Calendar方式

参数信息:

  • java.lang.String date:时间。

返回值:月 [int]

异常信息:无异常抛出

getYear

方法名称:getYear

方法全名:public static int getYear (java.lang.String)

方法描述:根据字符串时间格式获取年

方法说明:用于获取字符串时间中的年,用Calendar方式

参数信息:

  • java.lang.String date:时间。

返回值:年 [int]

异常信息:无异常抛出

getWeekDay

方法名称:getWeekDay

方法全名:public static int getWeekDay (java.lang.String)

方法描述:根据字符串时间格式获取星期

方法说明:用于获取字符串时间中的星期,用Calendar方式,返回数字,1表示星期日,2表示星期一,以此类推

参数信息:

  • java.lang.String date:时间。

返回值:星期 [int]

异常信息:无异常抛出

getWeekDayName

方法名称:getWeekDayName

方法全名:public static String getWeekDayName (java.lang.String)

方法描述:根据字符串时间格式获取星期

方法说明:用于获取字符串时间中的星期,用Calendar方式,返回中文,星期日-星期六

参数信息:

  • java.lang.String date:时间。

返回值:星期 [java.lang.String]

异常信息:无异常抛出

dateAdd

方法名称:dateAdd

方法全名:public static String dateAdd (java.lang.String, int, int)

方法描述:日期加法运算

方法说明:用于进行加法运算

参数信息:

  • java.lang.String iCount:增加数量,可为负值。
  • int iType:增加的类型:0-年、1-月、2-日、3-时、4-分、5-秒。

返回值:运算后的日期,若包含时分秒则格式为yyyy-MM-dd HH:mm:ss,若不包含时分秒,则格式为yyyy-MM-dd [java.lang.String]

异常信息:无异常抛出

dateDiff

方法名称:dateDiff

方法全名:public static int dateDiff (java.lang.String, java.lang.String, int)

方法描述:日期减法运算

方法说明:用于进行日期减法运算,使用开始时间减去结束时间

参数信息:

  • java.lang.String beginDate:开始时间。
  • java.lang.String endDate:结束时间。
  • int iType:返回值类型:0-毫秒、1-秒、2-分钟、3-小时、4-天。

返回值:日期减法运算后的结果 [int]

异常信息:无异常抛出

isLeapYear

方法名称:isLeapYear

方法全名:public static boolean isLeapYear (int)

方法描述:判断某年是否为闰年

方法说明:用于判断某年是否为闰年

参数信息:

  • int year:年份。

返回值:是否为闰年 [boolean]

异常信息:无异常抛出

getWeekNumOfYear

方法名称:getWeekNumOfYear

方法全名:public static int getWeekNumOfYear ()

方法描述:获取当前时间为该年度的第几周

方法说明:用于获取当前时间为该年度的第几周

参数信息:无

返回值:当前时间为该年度的第几周 [int]

异常信息:无异常抛出

getWeekNumOfYearDay

方法名称:getWeekNumOfYearDay

方法全名:public static int getWeekNumOfYearDay (java.lang.String) throws java.text.ParseException

方法描述:获取指定日期为该年度的第几周

方法说明:用于获取指定日期为该年度的第几周,日期格式为yyyy-MM-dd

参数信息:

  • java.lang.String date:日期,格式为yyyy-MM-dd。

返回值:该年度的第几周 [int]

异常信息:Exception 抛出格式化异常

getYearWeekFirstDay

方法名称:getYearWeekFirstDay

方法全名:public static String getYearWeekFirstDay (int, int) throws java.text.ParseException

方法描述:计算某年某周的开始日期

方法说明:用于计算某年某周的开始日期

参数信息:

  • int year:年份。
  • int week:第几周。

返回值:开始日期,格式为yyyy-MM-dd [java.lang.String]

异常信息:Exception 抛出格式化异常

getYearWeekEndDay

方法名称:getYearWeekEndDay

方法全名:public static String getYearWeekEndDay (int, int) throws java.text.ParseException

方法描述:计算某年某周的结束日期

方法说明:用于计算某年某周的结束日期

参数信息:

  • int year:年份。
  • int week:第几周。

返回值:结束日期,格式为yyyy-MM-dd [java.lang.String]

异常信息:Exception 抛出格式化异常

getYearMonthFirstDay

方法名称:getYearMonthFirstDay

方法全名:public static String getYearMonthFirstDay (int, int) throws java.text.ParseException

方法描述:计算某年某月的开始日期

方法说明:用于计算某年某月的开始日期

参数信息:

  • int year:年份。
  • int month:第几月。

返回值:开始日期,格式为yyyy-MM-dd [java.lang.String]

异常信息:Exception 抛出格式化异常

getYearMonthEndDay

方法名称:getYearMonthEndDay

方法全名:public static String getYearMonthEndDay (int, int) throws java.text.ParseException

方法描述:计算某年某月的结束日期

方法说明:用于计算某年某月的结束日期

参数信息:

  • int year:年份。
  • int month:第几月。

返回值:结束日期,格式为yyyy-MM-dd [java.lang.String]

异常信息:Exception 抛出格式化异常

getYearMonthEndDayReturnDay

方法名称:getYearMonthEndDayReturnDay

方法全名:public static String getYearMonthEndDayReturnDay (int, int) throws java.text.ParseException

方法描述:计算某年某月的结束日期,只返回日

方法说明:用于计算某年某月的结束日期,只返回日

参数信息:

  • int year:年份。
  • int month:第几月。

返回值:结束日期日 [java.lang.String]

异常信息:Exception 抛出格式化异常

getNMonthBeforeOneDay

方法名称:getNMonthBeforeOneDay

方法全名:public static String getNMonthBeforeOneDay (java.lang.String, int)

方法描述:获取某个日期前n个月的相对应的一天

方法说明:用于获取某个日期前n个月的相对应的一天,格式为yyyy-MM-dd

参数信息:

  • java.lang.String date:日期。
  • int n:前几个月。

返回值:前n个月的相对应的一天 [java.lang.String]

异常信息:无异常抛出

getNMonthAfterOneDay

方法名称:getNMonthAfterOneDay

方法全名:public static String getNMonthAfterOneDay (java.lang.String, int)

方法描述:获取某个日期后n个月的相对应的一天

方法说明:用于获取某个日期后n个月的相对应的一天,格式为yyyy-MM-dd

参数信息:

  • java.lang.String date:日期。
  • int n:后几个月。

返回值:后n个月的相对应的一天 [java.lang.String]

异常信息:无异常抛出

getNDayBeforeOneDate

方法名称:getNDayBeforeOneDate

方法全名:public static String getNDayBeforeOneDate (java.lang.String, int)

方法描述:获取某个日期前n天日期

方法说明:用于获取某个日期前n天日期,格式为yyyy-MM-dd

参数信息:

  • java.lang.String date:日期。
  • int n:前几天。

返回值:前n天日期 [java.lang.String]

异常信息:无异常抛出

getNDayAfterOneDate

方法名称:getNDayAfterOneDate

方法全名:public static String getNDayAfterOneDate (java.lang.String, int)

方法描述:获取某个日期后n天日期

方法说明:用于获取某个日期后n天日期,格式为yyyy-MM-dd

参数信息:

  • java.lang.String date:日期。
  • int n:后几天。

返回值:后n天日期 [java.lang.String]

异常信息:无异常抛出

switchStringToCalendar

方法名称:switchStringToCalendar

方法全名:public static Calendar switchStringToCalendar (java.lang.String)

方法描述:日期字符串转化成Calendar类型日期

方法说明:用于将日期字符串转化成Calendar类型日期

参数信息:

  • java.lang.String date:待转换日期字符串。

返回值:转换为Calendar类型的日期对象 [java.util.Calendar]

异常信息:无异常抛出

switchStringToCalendar

方法名称:switchStringToCalendar

方法全名:public Calendar switchStringToCalendar (java.util.Date)

方法描述:日期对象转化成Calendar类型日期

方法说明:用于将日期对象转化成Calendar类型日期

参数信息:

  • java.util.Date date:待转换日期对象。

返回值:转换为Calendar类型的日期对象 [java.util.Calendar]

异常信息:无异常抛出

switchStringToDate

方法名称:switchStringToDate

方法全名:public static Date switchStringToDate (java.lang.String)

方法描述:日期字符串转化成日期对象

方法说明:用于将日期字符串转化成日期对象,支持格式为yyyy-MM-dd

参数信息:

  • java.lang.String sDate:待转换的日期字符串,格式为yyyy-MM-dd。

返回值:转换后的日期对象 [java.util.Date]

异常信息:无异常抛出

compDate

方法名称:compDate

方法全名:public static boolean compDate (java.lang.String, java.lang.String) throws java.text.ParseException

方法描述:比较两日期大小

方法说明:用于比较两个日期的大小,格式为yyyy-MM-dd,若date1大于或等于date2,则返回true

参数信息:

  • java.lang.String date1:需要比较的日期。
  • java.lang.String date2:需要比较的日期。

返回值:比较结果 [boolean]

异常信息:Exception 抛出格式化异常

getMonthList

方法名称:getMonthList

方法全名:public static List getMonthList (java.lang.String, java.lang.String) throws java.text.ParseException

方法描述:获取月份间的日期列表

方法说明:用于获取月份间的日期列表,存在于List<String>类型中,月份格式yyyyMM,返回日期格式为yyyy-MM-dd

参数信息:

  • java.lang.String begin:开始月份,格式为yyyyMM。
  • java.lang.String end:结束月份,格式为yyyyMM。

返回值:月份间的日期列表,List<String>格式,日期格式为yyyy-MM-dd [java.util.List]

异常信息:Exception 抛出格式化异常

getDayList

方法名称:getDayList

方法全名:public static List getDayList (java.util.Date, java.util.Date) throws java.text.ParseException

方法描述:获取日期间的日期列表

方法说明:用于获取日期间的日期列表,存在于List<String>类型中,返回日期格式为yyyy-MM-dd

参数信息:

  • java.util.Date begin:开始日期,Date类型对象。
  • java.util.Date end:结束日期,Date类型对象。

返回值:日期间的日期列表,List<String>格式,日期格式为yyyy-MM-dd [java.util.List]

异常信息:Exception 抛出格式化异常

getDayList

方法名称:getDayList

方法全名:public static List getDayList (java.lang.String, java.lang.String) throws java.text.ParseException

方法描述:获取日期字符串间的日期列表

方法说明:用于获取日期字符串间的日期列表,存在于List<String>类型中,返回日期格式为yyyy-MM-dd

参数信息:

  • java.lang.String begin:开始日期,日期字符串对象,格式为yyyyMMdd。
  • java.lang.String end:结束日期,日期字符串对象,格式为yyyyMMdd。

返回值:日期间的日期列表,List<String>格式,日期格式为yyyy-MM-dd [java.util.List]

异常信息:Exception 抛出格式化异常

DemoUtils.java

包路径:com.dlshouwen.core.base.utils

类名称:DemoUtils

类全名:com.dlshouwen.core.base.utils.DemoUtils

类说明:编写示例程序经常使用的工具类

作者:大连首闻科技有限公司

版本:2013-7-12 9:24:32

getRandomNum

方法名称:getRandomNum

方法全名:public static int getRandomNum (int, int)

方法描述:获取随机数

方法说明:用于获取start到end之间的随机数,start、end亦可能被随机到

参数信息:

  • int start:开始数值。
  • int end:结束数值。

返回值:介于开始结束之间的随机数,包含开始及结束数值 [int]

异常信息:无异常抛出

getEmail

方法名称:getEmail

方法全名:public static String getEmail (int, int)

方法描述:随机生成Email

方法说明:用于随机生成Email信息,长度介于lMin及lMax之间,包含lMin及lMax,Email后缀亦计入长度

参数信息:

  • int lMin:Email最小长度。
  • int lMax:Email最大长度。

返回值:Email地址 [java.lang.String]

异常信息:无异常抛出

getTelephone

方法名称:getTelephone

方法全名:public static String getTelephone ()

方法描述:随机生成手机号码

方法说明:用于随机生成手机号码

参数信息:无

返回值:手机号码 [java.lang.String]

异常信息:无异常抛出

getChineseName

方法名称:getChineseName

方法全名:public static String getChineseName ()

方法描述:随机生成中文名

方法说明:用于随机生成中文名,生成过程中将随机性别,随机到的性别存储在name_sex属性中

参数信息:无

返回值:中文名 [java.lang.String]

异常信息:无异常抛出

getFirstSpell

方法名称:getFirstSpell

方法全名:public static String getFirstSpell (java.lang.String)

方法描述:中文转拼音首字母

方法说明:用于将字符串中的中文转化为拼音首字母,其他字符不变

参数信息:

  • java.lang.String chinese:需要转换为拼音的汉字字符串。

返回值:转换拼音首字母后的字符串 [java.lang.String]

异常信息:无异常抛出

getFullSpell

方法名称:getFullSpell

方法全名:public static String getFullSpell (java.lang.String)

方法描述:中文转拼音

方法说明:用于将字符串中的中文转化为拼音,其他字符不变

参数信息:

  • java.lang.String chinese:需要转换为拼音的汉字字符串。

返回值:转换拼音后的字符串 [java.lang.String]

异常信息:无异常抛出

GUID.java

包路径:com.dlshouwen.core.base.utils

类名称:GUID

类全名:com.dlshouwen.core.base.utils.GUID

类说明:GUID工具类

作者:大连首闻科技有限公司

版本:2013-7-13 15:18:19

getRandomGUID

方法名称:getRandomGUID

方法全名:private void getRandomGUID (boolean)

方法描述:生成GUID值

方法说明:生成GUID值,并使用MD5加密

参数信息:

  • boolean secure:是否使用加密随机数。

返回值:无返回值 [void]

异常信息:无异常抛出

toString

方法名称:toString

方法全名:public String toString ()

方法描述:返回GUID

方法说明:用于返回GUID字符串

参数信息:无

返回值:GUID字符串 [java.lang.String]

异常信息:无异常抛出

IdCardGenerator.java

包路径:com.dlshouwen.core.base.utils

类名称:IdCardGenerator

类全名:com.dlshouwen.core.base.utils.IdCardGenerator

类说明:身份证生成器

作者:大连首闻科技有限公司

版本:2015-12-1 15:37:22

generate

方法名称:generate

方法全名:public String generate ()

方法描述:生成身份证号

方法说明:用于生成身份证号,18位格式

参数信息:无

返回值:身份证号(18位) [java.lang.String]

异常信息:无异常抛出

randomAreaCode

方法名称:randomAreaCode

方法全名:public int randomAreaCode ()

方法描述:获取随机区域码

方法说明:用于获取随机区域码

参数信息:无

返回值:区域码 [int]

异常信息:无异常抛出

randomBirthday

方法名称:randomBirthday

方法全名:public String randomBirthday ()

方法描述:随机出生日期

方法说明:用于获取随机出生日期,格式为yyyyMMdd

参数信息:无

返回值:出生日期 [java.lang.String]

异常信息:无异常抛出

calcTrailingNumber

方法名称:calcTrailingNumber

方法全名:public char calcTrailingNumber (char[])

方法描述:获取身份证校验码

方法说明:获取18位身份证的校验码,根据〖中华人民共和国国家标准 GB11643-1999〗中有关公民身份号码的规定,公民身份号码是特征组合码,由十七位数字本体码和一位数字校验码组成。排列顺序从左至右依次为:六位数字地址码,八位数字出生日期码,三位数字顺序码和一位数字校验码。第十八位数字(校验码)的计算方法为:1.将前面的身份证号码17位数分别乘以不同的系数。从第一位到第十七位的系数分别为:7 9 10 5 8 4 2 1 6 3 7 9 10 5 8 4 2。2.将这17位数字和系数相乘的结果相加。3.用加出来和除以11,看余数是多少?4.余数只可能有0 1 2 3 4 5 6 7 8 9 10这11个数字。其分别对应的最后一位身份证的号码为1 0 X 9 8 7 6 5 4 3 2。5.通过上面得知如果余数是2,就会在身份证的第18位数字上出现罗马数字的Ⅹ。如果余数是10,身份证的最后一位号码就是2。

参数信息:

  • char[] chars:字符数组。

返回值:校验码 [char]

异常信息:无异常抛出

randomCode

方法名称:randomCode

方法全名:public String randomCode ()

方法描述:随机产生3位数

方法说明:随机生成三位数值,不够三位补0

参数信息:无

返回值:随机生成的三位数值 [java.lang.String]

异常信息:无异常抛出

IdCardUtils.java

包路径:com.dlshouwen.core.base.utils

类名称:IdCardUtils

类全名:com.dlshouwen.core.base.utils.IdCardUtils

类说明:中国公民身份证工具类

作者:大连首闻科技有限公司

版本:2015-12-1 14:54:08

conver15CardTo18

方法名称:conver15CardTo18

方法全名:public static String conver15CardTo18 (java.lang.String)

方法描述:将15位身份证号转换为18位

方法说明:用于将15为身份证号转换为18位

参数信息:

  • java.lang.String idCard:15位身份证号。

返回值:18位身份证号 [java.lang.String]

异常信息:无异常抛出

validateCard

方法名称:validateCard

方法全名:public static boolean validateCard (java.lang.String)

方法描述:验证身份证是否合法

方法说明:用于验证身份证是否合法,可验证15位及18位身份证合法性

参数信息:

  • java.lang.String idCard:身份证号。

返回值:身份证是否合法 [boolean]

异常信息:无异常抛出

validateIdCard18

方法名称:validateIdCard18

方法全名:public static boolean validateIdCard18 (java.lang.String)

方法描述:验证18位身份证号是否合法

方法说明:用于验证18为身份证号是否合法

参数信息:

  • java.lang.String idCard:身份证号。

返回值:18位身份证号是否合法 [boolean]

异常信息:无异常抛出

validateIdCard15

方法名称:validateIdCard15

方法全名:public static boolean validateIdCard15 (java.lang.String)

方法描述:验证15位身份证号是否合法

方法说明:用于验证15位身份证号是否合法

参数信息:

  • java.lang.String idCard:身份证号。

返回值:15位身份证号是否合法 [boolean]

异常信息:无异常抛出

validateIdCard10

方法名称:validateIdCard10

方法全名:public static String[] validateIdCard10 (java.lang.String)

方法描述:验证10位身份证号是否合法

方法说明:用于验证10位身份证号是否合法

参数信息:

  • java.lang.String idCard:身份证号。

返回值:身份证信息数组,信息详细内容如下:[0]-台湾、澳门、香港;[1]-性别(男M,女F,未知N);[2]-是否合法(合法true,不合法false),若不是身份证件号码则返回null [java.lang.String[]]

异常信息:无异常抛出

validateTWCard

方法名称:validateTWCard

方法全名:public static boolean validateTWCard (java.lang.String)

方法描述:验证台湾身份证号是否合法

方法说明:用于验证台湾身份证号是否合法

参数信息:

  • java.lang.String idCard:身份证号。

返回值:台湾身份证号是否合法 [boolean]

异常信息:无异常抛出

converCharToInt

方法名称:converCharToInt

方法全名:public static int[] converCharToInt (char[])

方法描述:将字符数组转换成数字数组

方法说明:用于将字符数组转换成数字数组

参数信息:

  • char[] charArray:字符数组。

返回值:数字数组 [int[]]

异常信息:无异常抛出

getPowerSum

方法名称:getPowerSum

方法全名:public static int getPowerSum (int[])

方法描述:将身份证的每位和对应位的加权因子相乘之后,再得到和值

方法说明:将身份证的每位和对应位的加权因子相乘之后,再得到和值

参数信息:

  • int[] iArr:数值数组。

返回值:身份证编码 [int]

异常信息:无异常抛出

getCheckCode18

方法名称:getCheckCode18

方法全名:public static String getCheckCode18 (int)

方法描述:获取校验位

方法说明:将power和值与11取模获得余数进行校验码判断

参数信息:

  • int iSum:身份证编码。

返回值:校验位 [java.lang.String]

异常信息:无异常抛出

getAgeByIdCard

方法名称:getAgeByIdCard

方法全名:public static int getAgeByIdCard (java.lang.String)

方法描述:根据身份证号获取年龄

方法说明:根据身份证号获取年龄

参数信息:

  • java.lang.String idCard:身份证号。

返回值:年龄 [int]

异常信息:无异常抛出

getBirthByIdCard

方法名称:getBirthByIdCard

方法全名:public static String getBirthByIdCard (java.lang.String)

方法描述:根据身份证号获取生日

方法说明:根据身份证号获取生日

参数信息:

  • java.lang.String idCard:身份证号。

返回值:生日(yyyyMMdd) [java.lang.String]

异常信息:无异常抛出

getYearByIdCard

方法名称:getYearByIdCard

方法全名:public static Short getYearByIdCard (java.lang.String)

方法描述:根据身份证号获取生日年

方法说明:根据身份证号获取生日年

参数信息:

  • java.lang.String idCard:身份证号。

返回值:生日(yyyy) [java.lang.Short]

异常信息:无异常抛出

getMonthByIdCard

方法名称:getMonthByIdCard

方法全名:public static Short getMonthByIdCard (java.lang.String)

方法描述:根据身份证号获取生日月

方法说明:根据身份证号获取生日月

参数信息:

  • java.lang.String idCard:身份证号。

返回值:生日(MM) [java.lang.Short]

异常信息:无异常抛出

getDateByIdCard

方法名称:getDateByIdCard

方法全名:public static Short getDateByIdCard (java.lang.String)

方法描述:根据身份证号获取生日天

方法说明:根据身份证号获取生日天

参数信息:

  • java.lang.String idCard:身份证号。

返回值:生日(dd) [java.lang.Short]

异常信息:无异常抛出

getGenderByIdCard

方法名称:getGenderByIdCard

方法全名:public static String getGenderByIdCard (java.lang.String)

方法描述:根据身份证号获取性别

方法说明:根据身份证号获取性别

参数信息:

  • java.lang.String idCard:身份证号。

返回值:性别,返回值内容:M-男,F-女,N-未知 [java.lang.String]

异常信息:无异常抛出

getProvinceByIdCard

方法名称:getProvinceByIdCard

方法全名:public static String getProvinceByIdCard (java.lang.String)

方法描述:根据身份证号获取户籍省份

方法说明:根据身份证号获取户籍省份

参数信息:

  • java.lang.String idCard:身份证号。

返回值:省级编码。 [java.lang.String]

异常信息:无异常抛出

isNum

方法名称:isNum

方法全名:public static boolean isNum (java.lang.String)

方法描述:数字验证

方法说明:验证字符串是否全部由数字组成

参数信息:

  • java.lang.String val:需要验证的字符串。

返回值:是否全部由数字组成 [boolean]

异常信息:无异常抛出

validDate

方法名称:validDate

方法全名:public static boolean validDate (int, int, int)

方法描述:验证小于当前日期

方法说明:验证传入时间是否小于当前日期

参数信息:

  • int iYear:待验证日期(年)。
  • int iMonth:待验证日期(月。
  • int iDate:待验证日期(日)。

返回值:传入时间是否小于当前日期 [boolean]

异常信息:无异常抛出

LimitUtils.java

包路径:com.dlshouwen.core.base.utils

类名称:LimitUtils

类全名:com.dlshouwen.core.base.utils.LimitUtils

类说明:AJAX操作响应头的工具类

作者:大连首闻科技有限公司

版本:2013-7-12 9:24:32

checkLimit

方法名称:checkLimit

方法全名:public static boolean checkLimit (java.lang.String, java.util.Map) throws java.lang.Exception

方法描述:判断地址是否有权限

方法说明:判断地址是否包含权限,主要应用于button标签及SessionFilter中的地址权限判断,可匹配通配符

参数信息:

  • java.lang.String url:URL地址。
  • java.util.Map limitInfo:Application中存储的权限信息。

返回值:是否有权限 [boolean]

异常信息:Exception 抛出全部异常

LogUtils.java

包路径:com.dlshouwen.core.base.utils

类名称:LogUtils

类全名:com.dlshouwen.core.base.utils.LogUtils

类说明:日志工具类

作者:大连首闻科技有限公司

版本:2014-11-10 10:26:59

insertLoginLog

方法名称:insertLoginLog

方法全名:public static void insertLoginLog (com.dlshouwen.core.base.dao.BaseDao, com.dlshouwen.core.log.model.LoginLog) throws java.lang.Exception

方法描述:记录登录日志

方法说明:用于记录登录日志,登录日志由于包含某些登录控制是需要实时记录的。

参数信息:

  • com.dlshouwen.core.base.dao.BaseDao dao:数据操作对象基类。
  • com.dlshouwen.core.log.model.LoginLog loginLog:登录日志对象。

返回值:无返回值 [void]

异常信息:Exception 抛出全部异常

updateLoginLog

方法名称:updateLoginLog

方法全名:public static void updateLoginLog (com.dlshouwen.core.base.dao.BaseDao, com.dlshouwen.core.log.model.LoginLog) throws java.lang.Exception

方法描述:更新登录日志

方法说明:用于更新登录日志,该操作在用户退出、Session失效、服务器启动处理未退出用户记录时执行

参数信息:

  • com.dlshouwen.core.base.dao.BaseDao dao:数据操作对象基类。
  • com.dlshouwen.core.log.model.LoginLog loginLog:登录日志对象。

返回值:无返回值 [void]

异常信息:Exception 抛出全部异常

insertSqlLog

方法名称:insertSqlLog

方法全名:public static synchronized void insertSqlLog (com.dlshouwen.core.base.dao.BaseDao, com.dlshouwen.core.log.model.SqlLog) throws java.lang.Exception

方法描述:记录SQL日志

方法说明:用于记录SQL日志,SQL日志缓存到Application域中,当缓存数量达到系统设置的最大值时批量向数据库中插入,提高执行效率

参数信息:

  • com.dlshouwen.core.base.dao.BaseDao dao:数据操作对象基类。
  • com.dlshouwen.core.log.model.SqlLog sqlLog:SQL日志对象。

返回值:无返回值 [void]

异常信息:Exception 抛出全部异常

updateOperationLog

方法名称:updateOperationLog

方法全名:public static void updateOperationLog (javax.servlet.http.HttpServletRequest, java.lang.String, java.lang.String) throws java.lang.Exception

方法描述:更新操作日志

方法说明:用于更新操作日志,操作日志原类在SessionFilter中进行实例化,并传入到request请求对象中,在业务方法中可通过此方法进行追加操作的详细描述信息

参数信息:

  • javax.servlet.http.HttpServletRequest operationLog:操作日志对象。
  • java.lang.String operationType:操作类别,可通过OperationType类调用静态属性,其中:UNKNOW-0-未知、VISIT-1-访问、SEARCH-2-查询、INSERT-3-新增、UPDATE-4-更新、DELETE-5-删除、LOGIN-6-登录、LOGOUT-7-登出。
  • java.lang.String operationDetail:操作详细信息。

返回值:无返回值 [void]

异常信息:Exception 抛出全部异常

insertOperationLog

方法名称:insertOperationLog

方法全名:public static synchronized void insertOperationLog (com.dlshouwen.core.base.dao.BaseDao, com.dlshouwen.core.log.model.OperationLog) throws java.lang.Exception

方法描述:记录操作日志

方法说明:用于记录操作日志,操作日志缓存到Application域中,当缓存数量达到系统设置的最大值时批量向数据库中插入,提高执行效率

参数信息:

  • com.dlshouwen.core.base.dao.BaseDao dao:数据操作对象基类。
  • com.dlshouwen.core.log.model.OperationLog operationLog:操作日志对象。

返回值:无返回值 [void]

异常信息:Exception 抛出全部异常

QuartzUtils.java

包路径:com.dlshouwen.core.base.utils

类名称:QuartzUtils

类全名:com.dlshouwen.core.base.utils.QuartzUtils

类说明:任务调度工具类

作者:大连首闻科技有限公司

版本:2013-11-29 14:18:27

getScheduler

方法名称:getScheduler

方法全名:public static Scheduler getScheduler () throws java.lang.Exception

方法描述:获取任务调度对象

方法说明:如果程序中使用了QuartZ定时任务组件,可通过该方法获取任务对象,需要在spring配置文件中定义一个类型通常为org.springframework.scheduling.quartz.SchedulerFactoryBean的bean对象且bean名称必须为schedulerFactory

参数信息:无

返回值:调度对象 [org.quartz.Scheduler]

异常信息:Exception 抛出全部异常

updateTriggerInterval

方法名称:updateTriggerInterval

方法全名:public static void updateTriggerInterval (java.lang.String, java.lang.String) throws java.lang.Exception

方法描述:更新调度频率

方法说明:用于更新某触发器的调度频率,频率格式请参考QuartZ官方文档

参数信息:

  • java.lang.String triggerName:触发器名称。
  • java.lang.String cronExpression:调度频率,频率格式请参考QuartZ官方文档。

返回值:无返回值 [void]

异常信息:Exception 抛出全部异常

deleteJob

方法名称:deleteJob

方法全名:public static void deleteJob (java.lang.String) throws java.lang.Exception

方法描述:删除作业

方法说明:用于删除某调度作业

参数信息:

  • java.lang.String jobName:作业名称。

返回值:无返回值 [void]

异常信息:Exception 抛出全部异常

SecurityUtils.java

包路径:com.dlshouwen.core.base.utils

类名称:SecurityUtils

类全名:com.dlshouwen.core.base.utils.SecurityUtils

类说明:安全工具类

作者:大连首闻科技有限公司

版本:2013-7-13 15:18:31

encryptBASE64

方法名称:encryptBASE64

方法全名:public static String encryptBASE64 (byte[]) throws java.lang.Exception

方法描述:Base64加密

方法说明:用于Base64加密,Base64内容传送编码被设计用来把任意序列的8位字节描述为一种不易被人直接识别的形式。常见于邮件、http加密,截取http信息,你就会发现登录操作的用户名、密码字段通过BASE64加密的。

参数信息:

  • byte[] data:需要加密的字节数组。

返回值:加密后的字符串 [java.lang.String]

异常信息:Exception 抛出全部异常

decryptBASE64

方法名称:decryptBASE64

方法全名:public static byte[] decryptBASE64 (java.lang.String) throws java.lang.Exception

方法描述:Base64解密

方法说明:用于Base64解密,Base64内容传送编码被设计用来把任意序列的8位字节描述为一种不易被人直接识别的形式。常见于邮件、http加密,截取http信息,你就会发现登录操作的用户名、密码字段通过BASE64加密的。

参数信息:

  • java.lang.String data:需要解密的字符串。

返回值:解密后的字节数组 [byte[]]

异常信息:Exception 抛出全部异常

encryptMD5

方法名称:encryptMD5

方法全名:public static byte[] encryptMD5 (byte[]) throws java.lang.Exception

方法描述:MD5加密

方法说明:用于MD5加密。MD5——message-digest algorithm 5 (信息-摘要算法)缩写,广泛用于加密和解密技术,常用于文档校验。

参数信息:

  • byte[] data:需要加密的字节数组。

返回值:加密后的字节数组 [byte[]]

异常信息:Exception 抛出全部异常

encryptSHA

方法名称:encryptSHA

方法全名:public static byte[] encryptSHA (byte[]) throws java.lang.Exception

方法描述:SHA加密

方法说明:用于SHA加密。SHA(Secure HashAlgorithm,安全散列算法),数字签名等密码学应用中重要的工具,被广泛地应用于电子商务等信息安全领域。虽然SHA与MD5通过碰撞法都已经被破解,但SHA仍是公认较MD5更为安全的加密算法。

参数信息:

  • byte[] data:需要加密的字节数组。

返回值:加密后的字节数组 [byte[]]

异常信息:Exception 抛出全部异常

initMacKey

方法名称:initMacKey

方法全名:public static String initMacKey () throws java.lang.Exception

方法描述:初始化HMAC密钥

方法说明:用于初始化HMAC密钥。HMAC(Hash Message AuthenticationCode,散列消息鉴别码,基于密钥的Hash算法的认证协议。消息鉴别码实现鉴别的原理是,用公开函数和密钥产生一个固定长度的值作为认证标识,用这个标识鉴别消息的完整性。使用一个密钥生成一个固定大小的小数据块,并将其加入到消息中然后传输。接收方利用与发送方共享的密钥进行鉴别认证等。

参数信息:无

返回值:HMAC密钥 [java.lang.String]

异常信息:Exception 抛出全部异常

encryptHMAC

方法名称:encryptHMAC

方法全名:public static byte[] encryptHMAC (byte[], java.lang.String) throws java.lang.Exception

方法描述:HMAC加密

方法说明:用于HMAC加密。HMAC(Hash Message Authentication Code,散列消息鉴别码,基于密钥的Hash算法的认证协议。消息鉴别码实现鉴别的原理是,用公开函数和密钥产生一个固定长度的值作为认证标识,用这个标识鉴别消息的完整性。使用一个密钥生成一个固定大小的小数据块,并将其加入到消息中然后传输。接收方利用与发送方共享的密钥进行鉴别认证等。

参数信息:

  • byte[] data:需要加密的字节数组。
  • java.lang.String key:HMAC密钥。

返回值:加密后的字节数组 [byte[]]

异常信息:Exception 抛出全部异常

initKey

方法名称:initKey

方法全名:public static String initKey (java.lang.String) throws java.lang.Exception

方法描述:生成密钥

方法说明:用于生成DES密钥。DES——Data Encryption Standard,数据加密算法。是IBM公司于1975年研究成功并公开发表的。DES算法的入口参数有三个:Key、Data、Mode。其中Key为8个字节共64位,是DES算法的工作密钥,Data也为8个字节64位,是要被加密或被解密的数据。

参数信息:

  • java.lang.String seed:密钥生成的基础信息。

返回值:DES密钥 [java.lang.String]

异常信息:Exception 抛出全部异常

toKey

方法名称:toKey

方法全名:public static Key toKey (byte[]) throws java.lang.Exception

方法描述:转换DES密钥

方法说明:用于转换DES密钥。DES——Data Encryption Standard,数据加密算法。是IBM公司于1975年研究成功并公开发表的。DES算法的入口参数有三个:Key、Data、Mode。其中Key为8个字节共64位,是DES算法的工作密钥,Data也为8个字节64位,是要被加密或被解密的数据。

参数信息:

  • byte[] key:DES密钥。

返回值:DES转换后密钥 [java.security.Key]

异常信息:Exception 抛出全部异常

encrypt

方法名称:encrypt

方法全名:public static byte[] encrypt (byte[], java.lang.String) throws java.lang.Exception

方法描述:DES加密

方法说明:用于DES加密。DES——Data Encryption Standard,数据加密算法。是IBM公司于1975年研究成功并公开发表的。DES算法的入口参数有三个:Key、Data、Mode。其中Key为8个字节共64位,是DES算法的工作密钥,Data也为8个字节64位,是要被加密或被解密的数据。

参数信息:

  • byte[] data:需要解密的字节数组。
  • java.lang.String key:DES密钥。

返回值:加密后的字节数组 [byte[]]

异常信息:Exception 抛出全部异常

decrypt

方法名称:decrypt

方法全名:public static byte[] decrypt (byte[], java.lang.String) throws java.lang.Exception

方法描述:DES解密

方法说明:用于DES解密。DES——Data Encryption Standard,数据加密算法。是IBM公司于1975年研究成功并公开发表的。DES算法的入口参数有三个:Key、Data、Mode。其中Key为8个字节共64位,是DES算法的工作密钥,Data也为8个字节64位,是要被加密或被解密的数据。

参数信息:

  • byte[] data:需要解密的字节数组。
  • java.lang.String key:DES密钥。

返回值:解密后的字节数组 [byte[]]

异常信息:Exception 抛出全部异常

initRandomBytes

方法名称:initRandomBytes

方法全名:public static byte[] initRandomBytes () throws java.lang.Exception

方法描述:随机字节初始化

方法说明:用于生成随机数。PBE——Password-based encryption(基于密码加密)。其特点在于口令由用户自己掌管,不借助任何物理媒体;采用随机数杂凑多重加密等方法保证数据的安全性。

参数信息:无

返回值:随机字节 [byte[]]

异常信息:Exception 抛出全部异常

toKey

方法名称:toKey

方法全名:private static Key toKey (java.lang.String) throws java.lang.Exception

方法描述:转换PEB密钥

方法说明:用于转换PEB密钥。PBE——Password-based encryption(基于密码加密)。其特点在于口令由用户自己掌管,不借助任何物理媒体;采用随机数杂凑多重加密等方法保证数据的安全性。

参数信息:

  • java.lang.String key:需要转换的PEB密钥。

返回值:PEB转换后密钥 [java.security.Key]

异常信息:Exception 抛出全部异常

encrypt

方法名称:encrypt

方法全名:public static byte[] encrypt (byte[], java.lang.String, byte[]) throws java.lang.Exception

方法描述:PEB加密

方法说明:用于PEB加密。PBE——Password-based encryption(基于密码加密)。其特点在于口令由用户自己掌管,不借助任何物理媒体;采用随机数杂凑多重加密等方法保证数据的安全性。

参数信息:

  • byte[] data:需要加密的字节数组。
  • java.lang.String key:PEB密钥。
  • byte[] randomBytes:随机字节数组。

返回值:加密后的字节数组 [byte[]]

异常信息:Exception 抛出全部异常

decrypt

方法名称:decrypt

方法全名:public static byte[] decrypt (byte[], java.lang.String, byte[]) throws java.lang.Exception

方法描述:PEB解密

方法说明:用于PEB解密。PBE——Password-based encryption(基于密码加密)。其特点在于口令由用户自己掌管,不借助任何物理媒体;采用随机数杂凑多重加密等方法保证数据的安全性。

参数信息:

  • byte[] data:需要解密的字节数组。
  • java.lang.String key:PEB密钥。
  • byte[] randomBytes:随机字节数组。

返回值:解密后的字节数组 [byte[]]

异常信息:Exception 抛出全部异常

getFormattedText

方法名称:getFormattedText

方法全名:private static String getFormattedText (byte[]) throws java.lang.Exception

方法描述:格式化字节数组为字符串

方法说明:用于格式化字节数组为字符串

参数信息:

  • byte[] bytes:需要格式化的字节数组。

返回值:格式化后的字符串 [java.lang.String]

异常信息:Exception 抛出全部异常

getMD5

方法名称:getMD5

方法全名:public static String getMD5 (java.lang.String) throws java.lang.Exception

方法描述:MD5加密

方法说明:用于将字符串进行MD5加密,返回加密后字符串

参数信息:

  • java.lang.String data:需要MD5加密的字符串。

返回值:经MD5加密后的字符串 [java.lang.String]

异常信息:Exception 抛出全部异常

getSHA

方法名称:getSHA

方法全名:public static String getSHA (java.lang.String) throws java.lang.Exception

方法描述:SHA加密

方法说明:用于将字符串进行SHA加密,返回加密后字符串

参数信息:

  • java.lang.String data:需要SHA加密的字符串。

返回值:经SHA加密后的字符串 [java.lang.String]

异常信息:Exception 抛出全部异常

SpringUtils.java

包路径:com.dlshouwen.core.base.utils

类名称:SpringUtils

类全名:com.dlshouwen.core.base.utils.SpringUtils

类说明:Spring工具类

作者:大连首闻科技有限公司

版本:2015-12-1 10:11:44

getBean

方法名称:getBean

方法全名:public static Object getBean (java.lang.String) throws java.lang.Exception

方法描述:取得对应的bean实例

方法说明:通过beanName参数获取对应的bean实例对象,若传递的实例名称在定义的配置中未找到则返回空

参数信息:

  • java.lang.String beanName:bean名称。

返回值:对应的bean实例 [java.lang.Object]

异常信息:Exception 抛出全部异常

SqlUtils.java

包路径:com.dlshouwen.core.base.utils

类名称:SqlUtils

类全名:com.dlshouwen.core.base.utils.SqlUtils

类说明:SQL工具类

作者:大连首闻科技有限公司

版本:2015-12-1 09:30:17

getArgsKey

方法名称:getArgsKey

方法全名:public static String getArgsKey (java.lang.String, java.lang.String) throws java.lang.Exception

方法描述:获取Preparestatement方式SQL的Key值

方法说明:用于获取Preparestatement方式SQL的key值,传入值后将会依据内容个数生成对应的?占位符

参数信息:

  • java.lang.String values:值列表,将依据该值列表决定生成对应的?占位符数量。
  • java.lang.String splitChar:分隔符,值列表的分割符号,通常为英文逗号,。

返回值:Preparestatement方式SQL的Key值 [java.lang.String]

异常信息:Exception 抛出全部异常

getArgsValue

方法名称:getArgsValue

方法全名:public static List getArgsValue (java.lang.String, java.lang.String) throws java.lang.Exception

方法描述:获取Preparestatement方式SQL的值列表

方法说明:用于获取Preparestatement方式SQL的值列表,传入值后将会依据内容生成List<Object>列表

参数信息:

  • java.lang.String values:值列表,将依据该值列表决定生成List<Object>类型的值列表内容及顺序。
  • java.lang.String splitChar:分隔符,值列表的分割符号,通常为英文逗号,。

返回值:Preparestatement方式SQL的值列表 [java.util.List]

异常信息:Exception 抛出全部异常

getObjectSql

方法名称:getObjectSql

方法全名:public static String getObjectSql (java.lang.String) throws java.lang.Exception

方法描述:获取对象操作的SQL

方法说明:用于获取对象操作的SQL,对象的参数格式采用${参数名}的方式进行匹配,该方法可以替换改格式参数为?占位符

参数信息:

  • java.lang.String sql:原对象操作SQL。

返回值:经过替换占位符处理的SQL [java.lang.String]

异常信息:Exception 抛出全部异常

getObjectArgs

方法名称:getObjectArgs

方法全名:public static transient List getObjectArgs (java.lang.String, java.lang.Object, java.lang.Object[]) throws java.lang.Exception

方法描述:获取对象操作参数列表

方法说明:用于获取对象操作的参数列表,对象的参数格式采用${参数名}的方式进行匹配,该方法根据传入的SQL内容匹配SQL中所有符合条件的参数格式,获取参数名后通过对象反射一一查找object对象内匹配的属性,若匹配上,则该位置将填入对象参数值,若不能匹配,则从此节点顺序开始查找对应的追加参数,若查找到,则追加到参数列表中,若长度溢出,则抛出异常。

参数信息:

  • java.lang.String sql:原对象操作SQL。
  • java.lang.Object object:通过反射查找对应属性的对象。
  • java.lang.Object[] args:若对象未能匹配到属性则通过该对象数据顺次追加参数值。

返回值:对象操作的参数列表 [java.util.List]

异常信息:Exception 抛出全部异常

TagUtils.java

包路径:com.dlshouwen.core.base.utils

类名称:TagUtils

类全名:com.dlshouwen.core.base.utils.TagUtils

类说明:标签工具类

作者:大连首闻科技有限公司

版本:2015-12-2 14:02:52

getInstance

方法名称:getInstance

方法全名:public static TagUtils getInstance ()

方法描述:获取标签工具类实例对象

方法说明:

参数信息:无

返回值:标签工具类实例对象 [com.dlshouwen.core.base.utils.TagUtils]

异常信息:无异常抛出

write

方法名称:write

方法全名:public void write (javax.servlet.jsp.PageContext, java.lang.String)

方法描述:写入内容

方法说明:将content信息写入到页面内容

参数信息:

  • javax.servlet.jsp.PageContext pageContext:page上下文。
  • java.lang.String content:需要写入的内容。

返回值:无返回值 [void]

异常信息:无异常抛出

ValidateUtils.java

包路径:com.dlshouwen.core.base.utils

类名称:ValidateUtils

类全名:com.dlshouwen.core.base.utils.ValidateUtils

类说明:验证工具类

作者:大连首闻科技有限公司

版本:2015-12-2 14:00:20

validate

方法名称:validate

方法全名:public static Set validate (java.lang.Object) throws java.lang.Exception

方法描述:验证对象

方法说明:该方法可以进行对象做服务器验证,采用Hibernate Validate验证方案

参数信息:

  • java.lang.Object t:需要验证的泛型对象。

返回值:验证结果 [java.util.Set]

异常信息:Exception 抛出全部异常

TaskUtils.java

包路径:com.dlshouwen.core.base.extra.task.utils

类名称:TaskUtils

类全名:com.dlshouwen.core.base.extra.task.utils.TaskUtils

类说明:任务工具类

作者:大连首闻科技有限公司

版本:2013-7-17 14:13:23

getTaskSqlByTemplate

方法名称:getTaskSqlByTemplate

方法全名:public static String getTaskSqlByTemplate (java.lang.String, com.dlshouwen.core.base.model.SessionUser) throws java.lang.Exception

方法描述:处理模板SQL

方法说明:通过反射处理模板SQL,将SQL中的参数转换为SessionUser对象实例中具体的值

参数信息:

  • java.lang.String templateSql:模板SQL。
  • com.dlshouwen.core.base.model.SessionUser sessionUser:登录用户对象。

返回值:经过处理后的SQL [java.lang.String]

异常信息:Exception 抛出全部异常

UniqueUtils.java

包路径:com.dlshouwen.core.base.extra.unique.utils

类名称:UniqueUtils

类全名:com.dlshouwen.core.base.extra.unique.utils.UniqueUtils

类说明:唯一验证工具类

作者:大连首闻科技有限公司

版本:2013-8-8 10:27:03

unique

方法名称:unique

方法全名:public static transient boolean unique (com.dlshouwen.core.base.dao.BaseDao, com.dlshouwen.core.base.model.AjaxResponse, java.lang.String, java.lang.String, java.lang.Object[]) throws java.lang.Exception

方法描述:验证唯一

方法说明:用于进行表单唯一验证

参数信息:

  • com.dlshouwen.core.base.dao.BaseDao dao:数据库操作基类。
  • com.dlshouwen.core.base.model.AjaxResponse ajaxResponse:Ajax响应回执。
  • java.lang.String warningMessage:验证出错时的错误信息。
  • java.lang.String sqlCode:SQL的对应键值。
  • java.lang.Object[] args:参数列表,可变参数。

返回值:验证唯一是否成功 [boolean]

异常信息:Exception 抛出全部异常

数据库链接对象

所有的功能中的Dao链接对象均集成BaseDao,该类中对JDBCTemplate进行了二次封装,并提供了SigmaGrid的数据传输封装,集成数据操作日志的自动追加,支持对象更新。

包路径:com.dlshouwen.core.base.dao

类名称:BaseDao

类全名:com.dlshouwen.core.base.dao.BaseDao

类说明:数据操作对象的基类

作者:大连首闻科技有限公司

版本:2013-7-22 15:20:43

batchExcute

方法名称:batchExcute

方法全名:public void batchExcute (java.lang.String, int, int[], java.util.List) throws java.lang.Exception

方法描述:批量执行操作

方法说明:执行批量操作,定义SQL,设置缓冲池大小,定义占位符类别及参数列表即可批量执行,该SQL占位符使用英文半角问号:?

参数信息:

  • java.lang.String prepareSql:预编译的SQL,支持?占位符。
  • int batchSize:缓冲池大小,即每达到多少条批量执行一次。
  • int[] dataType:占位符类别。
  • java.util.List argsList:参数列表,Object数组泛型。

返回值:无返回值 [void]

异常信息:Exception 抛出全部异常

batchUpdate

方法名称:batchUpdate

方法全名:public int[] batchUpdate (java.lang.String[]) throws org.springframework.dao.DataAccessException

方法描述:批量更新操作

方法说明:批量更新SQL语句

参数信息:

  • java.lang.String[] sql:批量更新的SQL语句。

返回值:影响的记录条数数组 [int[]]

异常信息:DataAccessException 抛出数据处理异常

batchUpdate

方法名称:batchUpdate

方法全名:public int[] batchUpdate (java.lang.String, java.util.List) throws org.springframework.dao.DataAccessException

方法描述:批量更新操作(包含参数)

方法说明:包含参数的批量更新,定义参数列表即可批量更新,该SQL占位符使用英文半角问号:?

参数信息:

  • java.lang.String sql:批量更新的SQL语句。
  • java.util.List batchArgs:参数列表,Object数组泛型。

返回值:影响的记录条数数组 [int[]]

异常信息:DataAccessException 抛出数据处理异常

batchUpdateNoLog

方法名称:batchUpdateNoLog

方法全名:public int[] batchUpdateNoLog (java.lang.String, java.util.List) throws org.springframework.dao.DataAccessException

方法描述:批量更新操作(包含参数)不记日志

方法说明:包含参数的批量更新,定义参数列表即可批量更新,该SQL占位符使用英文半角问号:?,此操作不记录数据操作日志

参数信息:

  • java.lang.String sql:批量更新的SQL语句。
  • java.util.List batchArgs:参数列表,Object数组泛型。

返回值:影响的记录条数数组 [int[]]

异常信息:DataAccessException 抛出数据处理异常

execute

方法名称:execute

方法全名:public void execute (java.lang.String) throws org.springframework.dao.DataAccessException

方法描述:执行操作

方法说明:执行SQL语句

参数信息:

  • java.lang.String sql:需要执行的SQL语句。

返回值:无返回值 [void]

异常信息:DataAccessException 抛出数据处理异常

update

方法名称:update

方法全名:public int update (java.lang.String) throws org.springframework.dao.DataAccessException

方法描述:更新操作

方法说明:更新SQL语句

参数信息:

  • java.lang.String sql:需要更新的SQL语句。

返回值:影响的记录条数 [int]

异常信息:DataAccessException 抛出数据处理异常

update

方法名称:update

方法全名:public transient int update (java.lang.String, java.lang.Object[]) throws org.springframework.dao.DataAccessException

方法描述:更新操作(包含参数列表)

方法说明:更新SQL语句,定义参数列表即可更新,该SQL占位符使用英文半角问号:?

参数信息:

  • java.lang.String sql:需要更新的SQL语句。
  • java.lang.Object[] args:参数列表,可变参数。

返回值:影响的记录条数 [int]

异常信息:DataAccessException 抛出数据处理异常

updateNoLog

方法名称:updateNoLog

方法全名:public transient int updateNoLog (java.lang.String, java.lang.Object[]) throws org.springframework.dao.DataAccessException

方法描述:更新操作(包含参数列表)(不记录日志)

方法说明:更新SQL语句,定义参数列表即可更新,该SQL占位符使用英文半角问号:?,此操作不记录数据操作日志

参数信息:

  • java.lang.String sql:需要更新的SQL语句。
  • java.lang.Object[] args:参数列表,可变参数。

返回值:影响的记录条数 [int]

异常信息:DataAccessException 抛出数据处理异常

queryForInt

方法名称:queryForInt

方法全名:public int queryForInt (java.lang.String) throws org.springframework.dao.DataAccessException

方法描述:查询int类型数据

方法说明:查询int类型数据

参数信息:

  • java.lang.String sql:查询的SQL。

返回值:查询结果 [int]

异常信息:DataAccessException 抛出数据处理异常

queryForInt

方法名称:queryForInt

方法全名:public transient int queryForInt (java.lang.String, java.lang.Object[]) throws org.springframework.dao.DataAccessException

方法描述:查询int类型数据(包含参数列表)

方法说明:查询int类型数据,定义参数列表即可查询,该SQL占位符使用英文半角问号:?

参数信息:

  • java.lang.String sql:查询的SQL。
  • java.lang.Object[] args:参数列表,可变参数。

返回值:查询结果 [int]

异常信息:DataAccessException 抛出数据处理异常

queryForLong

方法名称:queryForLong

方法全名:public long queryForLong (java.lang.String) throws org.springframework.dao.DataAccessException

方法描述:查询long类型数据

方法说明:查询long类型数据

参数信息:

  • java.lang.String sql:查询的SQL。

返回值:查询结果 [long]

异常信息:DataAccessException 抛出数据处理异常

queryForLong

方法名称:queryForLong

方法全名:public transient long queryForLong (java.lang.String, java.lang.Object[]) throws org.springframework.dao.DataAccessException

方法描述:查询Long类型数据(包含参数列表)

方法说明:查询long类型数据,定义参数列表即可查询,该SQL占位符使用英文半角问号:?

参数信息:

  • java.lang.String sql:查询的SQL。
  • java.lang.Object[] args:参数列表,可变参数。

返回值:查询结果 [long]

异常信息:DataAccessException 抛出数据处理异常

queryForMap

方法名称:queryForMap

方法全名:public Map queryForMap (java.lang.String) throws org.springframework.dao.DataAccessException

方法描述:查询Map类型数据

方法说明:查询Map类型数据,仅限查询单行数据,若查询多行数据则会保存,未查出数据返回null

参数信息:

  • java.lang.String sql:查询的SQL。

返回值:查询结果 [java.util.Map]

异常信息:DataAccessException 抛出数据处理异常

queryForMap

方法名称:queryForMap

方法全名:public transient Map queryForMap (java.lang.String, java.lang.Object[]) throws org.springframework.dao.DataAccessException

方法描述:查询Map类型数据(包含参数列表)

方法说明:查询Map类型数据,仅限查询单行数据,若查询多行数据则会抛出异常,未查出数据返回null,定义参数列表即可查询,该SQL占位符使用英文半角问号:?

参数信息:

  • java.lang.String sql:查询的SQL。
  • java.lang.Object[] args:参数列表,可变参数。

返回值:查询结果 [java.util.Map]

异常信息:DataAccessException 抛出数据处理异常

queryForObject

方法名称:queryForObject

方法全名:public Object queryForObject (java.lang.String, java.lang.Class) throws org.springframework.dao.DataAccessException

方法描述:查询Object类型数据,行映射泛型对象

方法说明:查询Object类型数据,仅限查询单行数据,若查询多行数据则会抛出异常,未查出数据返回null,该查询仅支持自定义对象,不支持Integer、String等基础类型

参数信息:

  • java.lang.String sql:查询的SQL。
  • java.lang.Class rowMapper:对象映射,仅限自定义对象。

返回值:查询结果 [java.lang.Object]

异常信息:DataAccessException 抛出数据处理异常

queryForObject

方法名称:queryForObject

方法全名:public transient Object queryForObject (java.lang.String, java.lang.Class, java.lang.Object[]) throws org.springframework.dao.DataAccessException

方法描述:查询Object类型数据,行映射泛型对象(包含参数列表)

方法说明:查询Object类型数据,仅限查询单行数据,若查询多行数据则会抛出异常,未查出数据返回null,该查询仅支持自定义对象,不支持Integer、String等基础类型,定义参数列表即可查询,该SQL占位符使用英文半角问号:?

参数信息:

  • java.lang.String sql:查询的SQL。
  • java.lang.Class rowMapper:对象映射,仅限自定义对象。
  • java.lang.Object[] args:参数列表,可变参数。

返回值:查询结果 [java.lang.Object]

异常信息:DataAccessException 抛出数据处理异常

queryForObject

方法名称:queryForObject

方法全名:public Object queryForObject (java.lang.String, com.dlshouwen.core.base.extra.spring.mapper.ClassRowMapper) throws org.springframework.dao.DataAccessException

方法描述:查询Object类型数据,行映射泛型对象

方法说明:查询Object类型数据,仅限查询单行数据,若查询多行数据则会抛出异常,未查出数据返回null,该查询仅支持自定义对象,不支持Integer、String等基础类型

参数信息:

  • java.lang.String sql:查询的SQL。
  • com.dlshouwen.core.base.extra.spring.mapper.ClassRowMapper rowMapper:对象映射,仅限自定义对象。

返回值:查询结果 [java.lang.Object]

异常信息:DataAccessException 抛出数据处理异常

queryForObject

方法名称:queryForObject

方法全名:public transient Object queryForObject (java.lang.String, com.dlshouwen.core.base.extra.spring.mapper.ClassRowMapper, java.lang.Object[]) throws org.springframework.dao.DataAccessException

方法描述:查询Object类型数据,行映射泛型对象(包含参数列表)

方法说明:查询Object类型数据,仅限查询单行数据,若查询多行数据则会抛出异常,未查出数据返回null,该查询仅支持自定义对象,不支持Integer、String等基础类型,定义参数列表即可查询,该SQL占位符使用英文半角问号:?

参数信息:

  • java.lang.String sql:查询的SQL。
  • com.dlshouwen.core.base.extra.spring.mapper.ClassRowMapper rowMapper:对象映射,仅限自定义对象。
  • java.lang.Object[] args:参数列表,可变参数。

返回值:查询结果 [java.lang.Object]

异常信息:DataAccessException 抛出数据处理异常

queryForList

方法名称:queryForList

方法全名:public List queryForList (java.lang.String) throws org.springframework.dao.DataAccessException

方法描述:查询List类型数据

方法说明:查询List类型数据,未查出数据返回null

参数信息:

  • java.lang.String sql:查询的SQL。

返回值:查询结果 [java.util.List]

异常信息:DataAccessException 抛出数据处理异常

queryForList

方法名称:queryForList

方法全名:public transient List queryForList (java.lang.String, java.lang.Object[]) throws org.springframework.dao.DataAccessException

方法描述:查询List类型数据(包含参数列表)

方法说明:查询List类型数据,未查出数据返回null,定义参数列表即可查询,该SQL占位符使用英文半角问号:?

参数信息:

  • java.lang.String sql:查询的SQL。
  • java.lang.Object[] args:参数列表,可变参数。

返回值:查询结果 [java.util.List]

异常信息:DataAccessException 抛出数据处理异常

queryForList

方法名称:queryForList

方法全名:public List queryForList (java.lang.String, com.dlshouwen.core.base.extra.spring.mapper.ClassRowMapper) throws org.springframework.dao.DataAccessException

方法描述:查询List类型数据,行映射泛型对象

方法说明:查询List类型数据,未查出数据返回null,支持对象映射,仅支持自定义对象,不支持Integer、String等基础类型

参数信息:

  • java.lang.String sql:查询的SQL。
  • com.dlshouwen.core.base.extra.spring.mapper.ClassRowMapper rowMapper:对象映射,仅支持自定义对象。

返回值:查询结果 [java.util.List]

异常信息:DataAccessException 抛出数据处理异常

queryForList

方法名称:queryForList

方法全名:public transient List queryForList (java.lang.String, com.dlshouwen.core.base.extra.spring.mapper.ClassRowMapper, java.lang.Object[]) throws org.springframework.dao.DataAccessException

方法描述:查询List类型数据,行映射泛型对象(包含参数列表)

方法说明:查询List类型数据,未查出数据返回null,支持对象映射,仅支持自定义对象,不支持Integer、String等基础类型,定义参数列表即可查询,该SQL占位符使用英文半角问号:?

参数信息:

  • java.lang.String sql:查询的SQL。
  • com.dlshouwen.core.base.extra.spring.mapper.ClassRowMapper rowMapper:对象映射,仅支持自定义对象。
  • java.lang.Object[] args:参数列表,可变参数。

返回值:查询结果 [java.util.List]

异常信息:DataAccessException 抛出数据处理异常

queryForListNoLog

方法名称:queryForListNoLog

方法全名:public transient List queryForListNoLog (java.lang.String, com.dlshouwen.core.base.extra.spring.mapper.ClassRowMapper, java.lang.Object[]) throws org.springframework.dao.DataAccessException

方法描述:查询List类型数据,行映射泛型对象(包含参数列表)-无日志

方法说明:查询List类型数据,未查出数据返回null,支持对象映射,仅支持自定义对象,不支持Integer、String等基础类型,定义参数列表即可查询,该SQL占位符使用英文半角问号:?,此操作不记录数据操作日志

参数信息:

  • java.lang.String sql:查询的SQL。
  • com.dlshouwen.core.base.extra.spring.mapper.ClassRowMapper rowMapper:对象映射,仅支持自定义对象。
  • java.lang.Object[] args:参数列表,可变参数。

返回值:查询结果 [java.util.List]

异常信息:DataAccessException 抛出数据处理异常

updateBlob

方法名称:updateBlob

方法全名:public int updateBlob (java.lang.String, byte[]) throws org.springframework.dao.DataAccessException

方法描述:更新Blob数据

方法说明:更新Blob对象数据,如果有插入的对象中包含Blob数据,则需要先执行insert方法插入基础数据,然后通过该方法对数据中的Blob数据进行更新

参数信息:

  • java.lang.String sql:更新的SQL。
  • byte[] content:Blob字节数组。

返回值:影响的记录条数 [int]

异常信息:DataAccessException 抛出数据处理异常

getBlobByte

方法名称:getBlobByte

方法全名:public transient byte[] getBlobByte (java.lang.String, java.lang.Object[]) throws org.springframework.dao.DataAccessException

方法描述:获取Blob数据

方法说明:获取Blob数据,返回Blob字节数组

参数信息:

  • java.lang.String sql:获取的SQL。
  • java.lang.Object[] args:参数列表,可变参数。

返回值:Blob字节数组 [byte[]]

异常信息:DataAccessException 抛出数据处理异常

getSigmaGridParameters

方法名称:getSigmaGridParameters

方法全名:public Map getSigmaGridParameters (javax.servlet.http.HttpServletRequest, javax.servlet.http.HttpServletResponse) throws java.lang.Exception

方法描述:获取从SigmaGrid传递过来的参数

方法说明:获取SigmaGrid响应传递的所有参数信息,并映射为Map对象返回

参数信息:

  • javax.servlet.http.HttpServletRequest request:请求对象。
  • javax.servlet.http.HttpServletResponse response:响应对象。

返回值:参数对象 [java.util.Map]

异常信息:Exception 抛出全部异常

queryForSigmaGrid

方法名称:queryForSigmaGrid

方法全名:public transient void queryForSigmaGrid (javax.servlet.http.HttpServletRequest, javax.servlet.http.HttpServletResponse, java.lang.String, java.lang.Object[]) throws java.lang.Exception

方法描述:SigmaGrid的分页方法

方法说明:SigmaGrid的分页方法,传入需要查询的SQL语句及参数即可完成查询,查询过程将自动获取SigmaGrid传递的参数完成快速查询及高级查询的SQL拼接完成数据库分页,该操作包含导出,通常不需要开发人员单独处理,表格已经将导出参数封装到组件中,查询后获得的结果将直接通过response写回到响应中

参数信息:

  • javax.servlet.http.HttpServletRequest request:请求对象。
  • javax.servlet.http.HttpServletResponse response:响应对象。
  • java.lang.String sql:需要查询的SQL。
  • java.lang.Object[] args:参数列表,可变参数。

返回值:无返回值 [void]

异常信息:Exception 抛出全部异常

updateObject

方法名称:updateObject

方法全名:public transient int updateObject (java.lang.String, java.lang.Object, java.lang.Object[]) throws java.lang.Exception

方法描述:更新方法,可以直接更新一个对象(包含参数列表)

方法说明:更新对象,可更新自定义对象,传入需要更新的SQL语句及参数即可完成查询,参数格式为${*},其中$符号及{}符号为固定,括号内字符标识需要引用对象的哪个属性,方法体中会通过反射自动匹配传入对象的对应属性,若匹配不到,则按顺序使用参数列表中的参数,需要保证最终生成的参数要同SQL中定义的参数个数一致,否则将抛出异常

参数信息:

  • java.lang.String sql:需要执行操作的SQL。
  • java.lang.Object object:被执行的对象。
  • java.lang.Object[] args:参数列表,可变参数。

返回值:影响的记录条数 [int]

异常信息:Exception 抛出全部异常

updateObjectNoLog

方法名称:updateObjectNoLog

方法全名:public transient int updateObjectNoLog (java.lang.String, java.lang.Object, java.lang.Object[]) throws java.lang.Exception

方法描述:更新方法,可以直接更新一个对象(包含参数列表)-不记录日志

方法说明:更新对象,可更新自定义对象,传入需要更新的SQL语句及参数即可完成查询,参数格式为${*},其中$符号及{}符号为固定,括号内字符标识需要引用对象的哪个属性,方法体中会通过反射自动匹配传入对象的对应属性,若匹配不到,则按顺序使用参数列表中的参数,需要保证最终生成的参数要同SQL中定义的参数个数一致,否则将抛出异常,此操作不记录数据操作日志

参数信息:

  • java.lang.String sql:需要执行操作的SQL。
  • java.lang.Object object:被执行的对象。
  • java.lang.Object[] args:参数列表,可变参数。

返回值:影响的记录条数 [int]

异常信息:Exception 抛出全部异常

getLastInsertId

方法名称:getLastInsertId

方法全名:public int getLastInsertId () throws java.lang.Exception

方法描述:获取上一次插入的序列

方法说明:MySQL数据库特有方法,对于自动增加的列获取上一次插入的编号,出于数据库通用角度考虑,建议不使用此方法,使用GUID方式完成编号的定义,缺点是会增加数据库容载量

参数信息:无

返回值:序列号 [int]

异常信息:Exception 抛出全部异常

getConditionLogicContent

方法名称:getConditionLogicContent

方法全名:public String getConditionLogicContent (java.lang.String) throws java.lang.Exception

方法描述:获取逻辑内容

方法说明:该方法用于获取高级查询中条件逻辑的SQL内容,其中0-and,1-or

参数信息:

  • java.lang.String logic:逻辑码值,0-and,1-or。

返回值:逻辑内容 [java.lang.String]

异常信息:Exception 抛出全部异常

getSingleAdvanceQueryConditionSql

方法名称:getSingleAdvanceQueryConditionSql

方法全名:public void getSingleAdvanceQueryConditionSql (java.lang.StringBuffer, java.lang.String, java.lang.String, java.lang.String, java.lang.String, java.lang.String, java.lang.String, java.util.List) throws java.lang.Exception

方法描述:拼接单条的高级查询条件SQL

方法说明:该方法用于拼接高级查询中的查询条件SQL,拼接后的参数将放置在参数列表中

参数信息:

  • java.lang.StringBuffer conditionSql:条件SQL。
  • java.lang.String leftParentheses:左括号。
  • java.lang.String conditionField:字段信息。
  • java.lang.String conditionType:条件。
  • java.lang.String conditionValue:值。
  • java.lang.String rightParentheses:右括号。
  • java.lang.String logic:逻辑符号。
  • java.util.List args:参数列表。

返回值:无返回值 [void]

异常信息:Exception 抛出全部异常

getSortLogicContent

方法名称:getSortLogicContent

方法全名:public String getSortLogicContent (java.lang.String) throws java.lang.Exception

方法描述:获取排序逻辑内容

方法说明:该方法用于获取高级查询中排序逻辑的SQL内容,其中0-asc,1-desc

参数信息:

  • java.lang.String sortLogic:逻辑码值,其中0-asc,1-desc。

返回值:逻辑内容 [java.lang.String]

异常信息:Exception 抛出全部异常

getSingleAdvanceQuerySortSql

方法名称:getSingleAdvanceQuerySortSql

方法全名:public void getSingleAdvanceQuerySortSql (java.lang.StringBuffer, java.lang.String, java.lang.String) throws java.lang.Exception

方法描述:拼接单条的高级查询排序SQL

方法说明:该方法用于拼接高级查询中的排序SQL,拼接后的参数将放置在排序SQL中

参数信息:

  • java.lang.StringBuffer sortSql:排序SQL。
  • java.lang.String sortField:字段信息。
  • java.lang.String sortLogic:排序逻辑。

返回值:无返回值 [void]

异常信息:Exception 抛出全部异常

getFastQuerySql

方法名称:getFastQuerySql

方法全名:public String getFastQuerySql (java.util.Map, java.util.List) throws java.lang.Exception

方法描述:获取快速查询的条件SQL

方法说明:该方法可获取快速查询条件的SQL片段

参数信息:

  • java.util.Map params:SigmaGrid传递参数。
  • java.util.List args:参数列表。

返回值:条件SQL [java.lang.String]

异常信息:Exception 抛出全部异常

getAdvanceQueryConditionSql

方法名称:getAdvanceQueryConditionSql

方法全名:public String getAdvanceQueryConditionSql (java.util.Map, java.util.List) throws java.lang.Exception

方法描述:获取高级查询的条件SQL

方法说明:该方法可获取高级查询的条件SQL片段

参数信息:

  • java.util.Map params:SigmaGrid传递参数。
  • java.util.List args:参数列表。

返回值:条件SQL [java.lang.String]

异常信息:Exception 抛出全部异常

getAdvanceQuerySortSql

方法名称:getAdvanceQuerySortSql

方法全名:public String getAdvanceQuerySortSql (java.util.Map) throws java.lang.Exception

方法描述:获取高级查询的排序SQL

方法说明:该方法可获取高级查询的排序SQL片段

参数信息:

  • java.util.Map params:SigmaGrid传递参数。

返回值:排序SQL [java.lang.String]

异常信息:Exception 抛出全部异常

getArgsString

方法名称:getArgsString

方法全名:public transient String getArgsString (java.lang.Object[])

方法描述:获取参数列表映射为字符串

方法说明:该方法用于将参数列表转换为字符串,主要用于日志记录

参数信息:

  • java.lang.Object[] args:参数列表,可变参数。

返回值:字符串 [java.lang.String]

异常信息:无异常抛出

自定义标签

Core Classic产品提供一系列自定义标签,所有标签均已首闻首字母“sw”为前缀在jsp文件中执行调用,大部分自定义标签沿用Spring MVC中内置的form标签,少量标签进行了修改和扩展,一下文档将主要阐述对修改部分的使用方式。

sw:button

标签名称:sw:button

标签说明:用于按钮显示,支持按钮级别权限配置,通常操作按钮对应的页面的权限码同按钮权限码相同,由于REST风格URL中会带有参数信息,在核心系统中的功能管理中使用通配符*标识,在标签权限码中使用任意权限码做匹配(如字符“-”)。

参数说明:

  • type:设置按钮类型,可选值为:button-按钮,reset-重置按钮。
  • icon:设置按钮使用图标,使用FontAwesome图标配置,去掉fa前缀,如需要配置用户图标,FontAwesome中的css样式为fa-user,在按钮配置中icon属性设置为user即可。
  • limit:设置按钮挂载权限地址,若不配置此参数,则表示该按钮不需要进行权限控制。按钮的权限控制依赖于系统功能管理中的按钮权限功能,权限码即为功能中的URL地址,支持通配符,例如某按钮为编辑用户,偶遇REST风格URL在某些地址中会带有参数信息,在功能管理中编辑用户中需要传递用户编号,需要使用*通配符来统一拦截,故在功能管理中,编辑用户按钮链接应为:core/system/user/*/edit,其中*表示匹配所有字符,在按钮的limit属性设置中,需设置为:core/system/user/-/edit,中间的-即为一个模拟的调用过程,在这里设置为core/system/user/0/edit也可以,设置此属性后,若当前操作人没有编辑用户的权限,该按钮禁用或不显示(具体是禁用状态还是不显示状态可以在参数管理中进行配置),若操作人绕过按钮控制,直接打开编辑某用户的URL,页面最终也会跳转到权限不足提示页中。
  • value:设置按钮的文字。

继承参数:

  • id、name、title等基础信息参数
  • onclick、ondblclick等事件参数

sw:input

标签名称:sw:input

标签说明:用于文本框显示,集成前台验证组件。后续部分自定义标签也集成了前台验证组件,此处进行统一说明,后续文档中不再冗述。具体验证参数请参考验证组件DLShouWen Validator组件官方网站说明文档及示例程序,官方网站地址:http://os.dlshouwen.com/validator

参数说明:

  • valid:设置验证信息。
  • validTitle:设置验证信息标题。
  • validErrorCss:设置验证信息出现错误后需要追加的Css样式。
  • validUnique:设置唯一验证属性。

继承参数:

  • Spring MVC中input标签所有参数

sw:select

标签名称:sw:select

标签说明:用于下拉框显示,集成前台验证组件。

参数说明:验证参数,参见sw:input标签。

继承参数:

  • Spring MVC中select标签所有参数

sw:textarea

标签名称:sw:textarea

标签说明:用于多行文本框显示,集成前台验证组件。

参数说明:验证参数,参见sw:input标签。

继承参数:

  • Spring MVC中textarea标签所有参数

布局基础CSS样式

大连首闻核心系统Classic版本提供内置的基础CSS样式,便于开发使用。特殊页面请尽量使用自定义样式完成制作,尽量保证新页面设计符合核心系统整体设计。

reset.css

用于重置各大浏览器基础样式。HTML标签在各浏览器里有默认的样式,例如p标签有上下边距,strong标签有字体加粗样式,em标签有字体倾斜样式。不同浏览器的默认样式之间存在一定差异,如ul默认带有缩进的样式,在IE下,它的缩进是通过margin实现的,而Firefox下,它的缩进是由padding实现的。在切换页面的时候,浏览器的默认样式会给影响开发人员的开发效率。reset.css可以就将浏览器的默认样式全部去掉,重新定义标签样式,覆盖浏览器的CSS默认属性。

main.css

用于界面主面板的css样式。

panel

样式名称:panel

样式说明:面板区域样式

panel-header

样式名称:panel-header

样式说明:面板顶部区域样式

panel-title

样式名称:panel-title

样式说明:面板标题样式

panel-title i

样式名称:panel-title i

样式说明:面板标题前缀Font Awesome图标样式

panel-btns

样式名称:panel-btns

样式说明:面板按钮列表区域样式

panel-body

样式名称:panel-body

样式说明:面板内容样式

global.css

全局样式,提供链接、表格、表单等基础样式。

clearfloat

样式名称:clearfloat

样式说明:清除浮动样式,用于漂浮对象换行

a

样式名称:a

样式说明:基础链接样式

a.link-botton

样式名称:a.link-botton

样式说明:连接按钮样式

condition

样式名称:condition

样式说明:适应表格样式

data-list

样式名称:data-list

样式说明:数据展示表格样式

sw-text

样式名称:sw-text

样式说明:文本框样式

select-text

样式名称:select-text

样式说明:选择文本框样式

sw-textarea

样式名称:sw-textarea

样式说明:文本区域样式

sw-select

样式名称:sw-select

样式说明:下拉框样式

shadow-bg

样式名称:shadow-bg

样式说明:阴影背景

ie6-select-hidden

样式名称:ie6-select-hidden

样式说明:阴影启动的情况下屏蔽IE6的select强制浮动

text-primary

样式名称:text-primary

样式说明:文本样式 - 主题

text-success

样式名称:text-success

样式说明:文本样式 - 成功

text-info

样式名称:text-info

样式说明:文本样式 - 信息

text-warning

样式名称:text-warning

样式说明:文本样式 - 警告

text-danger

样式名称:text-danger

样式说明:文本样式 - 错误、危险

button.css

提供按钮样式。

btn

样式名称:btn

样式说明:按钮基础样式

btn i

样式名称:btn i

样式说明:按钮内Font Awesome图标样式

btn-icon i

样式名称:btn-icon i

样式说明:图标按钮内Font Awesome图标样式

btn-default

样式名称:btn-default

样式说明:默认按钮样式

btn-primary

样式名称:btn-primary

样式说明:主题按钮样式

btn-info

样式名称:btn-info

样式说明:信息按钮样式

btn-warning

样式名称:btn-warning

样式说明:警告按钮样式

btn-success

样式名称:btn-success

样式说明:成功按钮样式

btn-danger

样式名称:btn-danger

样式说明:失败、危险按钮样式

btn-disabled

样式名称:btn-disabled

样式说明:按钮禁用样式

btn-hide

样式名称:btn-hide

样式说明:按钮隐藏样式

btn-layout

样式名称:btn-layout

样式说明:布局按钮样式

JavaScript工具

Core Classic产品提供大量的常用JavaScript工具方法,对基础类型进行了扩展,并提供一些常用属性及操作。

utils.js

工具类,提供常用属性及方法。

ie55

属性名称:ie55

属性说明:判断是否为IE5.5浏览器

ie6

属性名称:ie6

属性说明:判断是否为IE6浏览器

isIE6

属性名称:isIE6

属性说明:判断是否为IE6浏览器

getFormParams

方法名称:getFormParams

方法说明:从form中取得元素值封装为参数对象

参数信息:

  • Object formObject:form对象。

返回值:参数对象 [Object]

调用示例:var params = getFormParams(document.forms[0]);

formatNumber

方法名称:formatNumber

方法说明:数字格式化函数[#,0格式]

参数信息:

  • Number number:要格式化的数字。
  • String pattern:要格式化的格式,支持#、0、,、.等符号。

返回值:格式化后的字符串 [String]

调用示例:var n = formatNumber(12138.66, '#,##0.00');

getFileSize

方法名称:getFileSize

方法说明:获取文件大小

参数信息:

  • int value:文件大小原值,单位为B。

返回值:文件大小,包含单位,B、KB、MB、GB等 [String]

调用示例:var fileSize = getFileSize(12138);

getFileTypeIcon

方法名称:getFileTypeIcon

方法说明:获取文件类型图标

参数信息:

  • Strin g fileType:文件类型。

返回值:Font [String]

调用示例:var fileTypeIcon = getFileTypeIcon('rar');

htmlEncode

方法名称:htmlEncode

方法说明:HTML转义

参数信息:

  • String str:待转义的字符串。

返回值:转义后的字符串 [String]

调用示例:var he = htmlEncode('<div>dlshouwen</div>');

htmlDecode

方法名称:htmlDecode

方法说明:HTML反转义

参数信息:

  • String str:待反转义的字符串。

返回值:反转义后的字符串 [String]

调用示例:var he = htmlDecode('>');

format

方法名称:format

方法说明:日期对象格式化方法

参数信息:

  • String format:日期格式:y-年、M-月、d-日、h-时、m-分、s-秒、S-毫秒。

返回值:格式化后的日期字符串 [String]

调用示例:var d = new Date().format('yyyy-MM-dd hh:mm:ss S');

getDateDiff

方法名称:getDateDiff

方法说明:取得两个日期相差的天数,date1-date2

参数信息:

  • String date1:日期字符串,格式:yyyy{任意字符}MM{任意字符}dd。
  • String date2:日期字符串,格式:yyyy{任意字符}MM{任意字符}dd。

返回值:相差天数 [int]

调用示例:var dd = getDateDiff('2015-10-01', '2015-09-18');

equalsIgnoreCase

方法名称:equalsIgnoreCase

方法说明:字符串不区分大小写的比较

参数信息:

  • String str:被比较的字符串。

返回值:比较结果 [Boolean]

调用示例:var isEquals = 'dlshouwen'.equalsIgnoreCase('DLSHOUWEN');

lengthb

方法名称:lengthb

方法说明:取得字符串的长度,双字节按照两个长度计算

参数信息:无参数

返回值:字符串长度 [int]

调用示例:var length = '大连首闻科技有限公司'.lengthb();

equals

方法名称:equals

方法说明:字符串比较

参数信息:

  • String str:被比较的字符串。

返回值:比较结果 [Boolean]

调用示例:var isEquals = 'dlshouwen'.equals('dlshouwen');

trim

方法名称:trim

方法说明:去掉字符串两边的空格

参数信息:无参数

返回值:去掉两边空格后的字符串 [String]

调用示例:var str = ' dlshouwen '.trim();

ltrim

方法名称:ltrim

方法说明:去掉字符串左边的空格

参数信息:无参数

返回值:去掉左边空格后的字符串 [String]

调用示例:var str = ' dlshouwen '.ltrim();

rtrim

方法名称:rtrim

方法说明:去掉字符串右边的空格

参数信息:无参数

返回值:去掉右边空格后的字符串 [String]

调用示例:var str = ' dlshouwen '.rtrim();

startsWith

方法名称:startsWith

方法说明:判断字符串是否从offset位置开始以prefix开头

参数信息:

  • String prefix:进行匹配的前缀字符。
  • int offset:开始匹配的位置,默认为0。

返回值:是否从offset位置开始以prefix开头 [Boolean]

调用示例:var isStart = '大连首闻科技有限公司'.startsWith('首闻', 2);

toDate

方法名称:toDate

方法说明:把字符串转换为Date对象,字符串的格式:yyyy-MM-dd或yyyy/MM/dd

参数信息:无参数

返回值:转换后的Date对象 [Date]

调用示例:var d = '2015-01-01'.toDate();

endsWith

方法名称:endsWith

方法说明:@reruans {Booolean} 是否以suffix结束

参数信息:

  • String suffix:后缀字符串。

返回值:无返回值

调用示例:var isEnd = '大连首闻科技有限公司'.endsWith('公司');

replaceAll

方法名称:replaceAll

方法说明:把字符串中的s1替换为s2

参数信息:

  • String s1:匹配的字符串。
  • String s2:替换为的字符串。

返回值:替换后的字符串 [String]

调用示例:var isEnd = 'dlshouwen'.replaceAll('l', 'o');

isInt

方法名称:isInt

方法说明:判断字符串是否是整型字符串

参数信息:无参数

返回值:是否是整型字符串 [Boolean]

调用示例:var isInt = '12138'.isInt();

isDouble

方法名称:isDouble

方法说明:判断字符串是否是浮点型字符串

参数信息:无参数

返回值:是否是浮点型字符串 [Boolean]

调用示例:var isDouble = '12138.66'.isDouble();

isNumber

方法名称:isNumber

方法说明:判断字符串是否是数字,不包含-和.

参数信息:无参数

返回值:是否是数字 [Boolean]

调用示例:var isNumber = '0012138'.isNumber();

isOnlyEnglish

方法名称:isOnlyEnglish

方法说明:判断字符串是否是纯英文

参数信息:无参数

返回值:是否是纯英文 [Boolean]

调用示例:var isOnlyEnglish = 'dlshouwen'.isOnlyEnglish();

isOnlyChinese

方法名称:isOnlyChinese

方法说明:判断字符串是否是纯中文

参数信息:无参数

返回值:是否是纯中文 [Boolean]

调用示例:var isOnlyChinese = '大连首闻科技有限公司'.isOnlyChinese();

isEmpty

方法名称:isEmpty

方法说明:判断字符串是否是空字符串

参数信息:无参数

返回值:是否空字符串 [Boolean]

调用示例:var isEmpty = ''.isEmpty();

toCase

方法名称:toCase

方法说明:把半角字符转换为全角字符

参数信息:无参数

返回值:转换为全角的字符串 [String]

调用示例:var s = '[]\\{}|:";\'<>?,./'.toCase();

isDate

方法名称:isDate

方法说明:判断字符串是否是日期格式,格式:yyyy-MM-dd、yyyy/MM/dd、yyyy-MM-dd hh:mm:ss、yyyy/MM/dd hh:mm:ss

参数信息:无参数

返回值:否是日期格式 [Boolean]

调用示例:var isDate = '2014-10-01'.isDate();

isShortDate

方法名称:isShortDate

方法说明:判断字符串是否是短日期格式:格式:yyyy-MM-dd、yyyy/MM/dd

参数信息:无参数

返回值:否是短日期格式 [Boolean]

调用示例:var isShortDate = '2014-10-01'.isShortDate();

isLongDate

方法名称:isLongDate

方法说明:判断字符串是否是长日期格式:格式:yyyy-MM-dd hh:mm:ss、yyyy/MM/dd hh:mm:ss

参数信息:无参数

返回值:否是长日期格式 [Boolean]

调用示例:var isLongDate = '2014-10-01 10:10:10'.isLongDate();

isIP

方法名称:isIP

方法说明:判断字符串是否是ip地址

参数信息:无参数

返回值:是否是ip地址 [Boolean]

调用示例:var isIP = '192.168.1.1'.isIP();

left

方法名称:left

方法说明:得到左边的字符串

参数信息:

  • int length:截取长度。

返回值:截取后的字符串 [String]

调用示例:var s = 'dlshouwen'.left(2);

right

方法名称:right

方法说明:得到右边的字符串

参数信息:

  • int length:截取长度。

返回值:截取后的字符串 [String]

调用示例:var s = 'dlshouwen'.right(7);

dlshouwen.js

大连首闻核心系统Classic版本提供的对象处理,调用方式使用sw.***方式进行调用,某些方法引用了utils.js中的方法及第三方组件。

guid

方法名称:guid

方法说明:获取GUID

参数信息:无参数

返回值:GUID [String]

调用示例:var guid = sw.guid();

getTopWindow

方法名称:getTopWindow

方法说明:获取顶级页面对象

参数信息:

  • Obje ct obj:当前页面对象。

返回值:当前页面向上查找的最顶级页面对象 [Object]

调用示例:sw.getTopWindow();

defaultWindowOption

方法名称:defaultWindowOption

方法说明:默认窗口打开参数

参数信息:无参数

返回值:无返回值

调用示例:null

openWindow

方法名称:openWindow

方法说明:打开窗口

参数信息:

  • String url:窗口URL地址。
  • int width:打开窗口宽度。
  • int height:打开窗口高度,若打开窗口中设置了自适应高度则该参数无效。
  • Boolean type:打开类型:true-本窗口内打开;false-最顶级窗口内打开,默认为false。
  • Object option:打开窗口参数。

返回值:无返回值

调用示例:sw.openWindow('http://www.dlshouwen.com', '1024px', '800px');

closeWindow

方法名称:closeWindow

方法说明:关闭窗口

参数信息:

  • Boolean type:关闭类型:true-本窗口内弹出窗体关闭;false-最顶级窗口内弹出窗体关闭,默认为false。

返回值:无返回值

调用示例:sw.closeWindow();

updateSigmaGrid

方法名称:updateSigmaGrid

方法说明:打开窗口,关闭窗口时自动调用表格刷新功能

参数信息:

  • String url:窗口URL地址。
  • int width:打开窗口宽度。
  • int height:打开窗口高度,若打开窗口中设置了自适应高度则该参数无效。
  • Object sigmaGridObj:SigmaGrid表格对象。
  • Boolean type:打开类型:true-本窗口内打开;false-最顶级窗口内打开,默认为false。
  • Object option:打开窗口参数。

返回值:无返回值

调用示例:sw.updateSigmaGrid('http://www.dlshouwen.com', '1024px', '800px', exampleGrid);

alert

方法名称:alert

方法说明:提示方法,开发过程中尽量使用此方法替代window.alert,便于统一修改alert样式

参数信息:

  • String message:提示信息。
  • String type:提示类别,可选:info\warning\success\error。
  • String time:提示守留时间,该参数保留于Toast提示样式。

返回值:无返回值

调用示例:sw.alert('操作执行成功!', 'success', 3000);

toast

方法名称:toast

方法说明:类似手机的Toast提示,方法调用为dlshouwen validator组件

参数信息:

  • String message:提示信息。
  • String type:提示类别,可选:info\warning\success\error。
  • String time:提示守留时间,该参数保留于Toast提示样式。

返回值:无返回值

调用示例:sw.toast('操作执行成功!', 'success', 3000);

showProcessBar

方法名称:showProcessBar

方法说明:显示进度条

参数信息:

  • String message:提示信息。

返回值:无返回值

调用示例:sw.showProcessBar('正在加载,请稍后...');

hideProcessBar

方法名称:hideProcessBar

方法说明:隐藏滚动条

参数信息:无参数

返回值:无返回值

调用示例:sw.hideProcessBar();

getFormParams

方法名称:getFormParams

方法说明:@return {Object} 参数对象

参数信息:

  • Object formObject:form对象。

返回值:无返回值

调用示例:var params = sw.getFormParams(document.forms[0]);

doReset

方法名称:doReset

方法说明:重置表单信息

参数信息:

  • int formIndex:表单索引号,当前页面中从0开始。

返回值:无返回值

调用示例:sw.doReset(0);

htmlEncode

方法名称:htmlEncode

方法说明:HTML转义

参数信息:

  • String str:待转义的字符串。

返回值:转义后的字符串 [String]

调用示例:var he = sw.htmlEncode('<div>dlshouwen</div>');

htmlDecode

方法名称:htmlDecode

方法说明:HTML反转义

参数信息:

  • String str:待反转义的字符串。

返回值:反转义后的字符串 [String]

调用示例:var he = sw.htmlDecode('>');

ajaxSubmit

方法名称:ajaxSubmit

方法说明:Ajax提交

参数信息:

  • String url:Ajax提交地址。
  • Object params:Ajax提交参数。
  • Function successFunc:调用成功时的执行方法。
  • Function errorFunc:调用失败时的执行方法。
  • Boolean async:是否同步,默认false。

返回值:无返回值

调用示例:sw.ajaxSubmit(url, params);

ajaxSubmitJSON

方法名称:ajaxSubmitJSON

方法说明:Ajax提交,直接提交JSON对象,通过Spring MVC可直接转换为后台Controller参数对象

参数信息:

  • String url:Ajax提交地址。
  • Object params:Ajax提交参数。
  • Function successFunc:调用成功时的执行方法。
  • Function errorFunc:调用失败时的执行方法。
  • Boolean async:是否同步,默认false。

返回值:无返回值

调用示例:sw.ajaxSubmitJSON(url, params);

ajaxSubmitRefreshSigmaGrid

方法名称:ajaxSubmitRefreshSigmaGrid

方法说明:调用Ajax方法,调用成功后刷新SgiamGrid表格数据

参数信息:

  • String url:Ajax提交地址。
  • Object params:Ajax提交参数。
  • Object sigmaGridObj:SigmaGrid表格对象。

返回值:无返回值

调用示例:sw.ajaxSubmitRefreshSigmaGrid(url, params, sigmaGridObj);

ajaxSuccessCallback

方法名称:ajaxSuccessCallback

方法说明:若需要获取AjaxResponse对象中的data属性,请在JavaScript中使用data.data调用

参数信息:

  • Object data:Ajax回调数据。
  • Function successFunc:操作成功的回调方法。
  • Function warningFunc:操作警告的回调方法。
  • Function errorFunc:操作错误的回调方法。

返回值:无返回值

调用示例:sw.ajaxSuccessCallback(data);