CommonTools (ctp-common 7.0SP2-SNAPSHOT API)

java.lang.Object
- com.seeyon.ctp.util.CommonTools

```
public class CommonTools
extends Object
```

构造器概要

构造器
构造器和说明

CommonTools()

构造器
构造器和说明
`CommonTools()`

方法概要

所有方法静态方法具体方法
限定符和类型	方法和说明
`static List`	`collectProperty(Collection<? extends com.seeyon.ctp.common.po.BasePO> models, String propertyName)` 获取领域模型的某种属性集合
`static boolean`	`equals(String s1, String s2)` 判断两个字符串是否相等，如果两个字符串为null或空白，也视为相等，如： FormBizConfigUtils.equals(null, null) = true FormBizConfigUtils.equals(null, "") = true FormBizConfigUtils.equals("", "") = true FormBizConfigUtils.equals("", " ") = true FormBizConfigUtils.equals("abc", "ABC") = false
`static void`	`filterInvalidEntities(Collection<? extends com.seeyon.ctp.organization.bo.V3xOrgEntity> entities)` 过滤掉组织模型集合中无效的实体，如：过滤掉离职人员传入的实体集合，在方法执行完后发生了变化，适合用于过滤完即返回结果值的情况
`static List<Long>`	`getEntityIds(Collection<? extends com.seeyon.ctp.organization.bo.V3xOrgEntity> entities)` 获取组织模型ID集合，过滤掉其中无效实体，如：过滤掉离职人员
`static List<Long>`	`getIds(Collection<? extends com.seeyon.ctp.common.po.BasePO> models)` 收集领域模型的ID集合，便于复用
`static String`	`getIdStrs(Collection<? extends com.seeyon.v3x.common.domain.BaseModel> models, char joinChar)` 将领域模型的ID按照某个字符串(比如",")拼接起来
`static List<Long>`	`getMemberIdsByTypeAndId(String typeAndIds, com.seeyon.ctp.organization.manager.OrgManager orgManager)` 获取选人界面字符串解析后所得人员的ID集合
`static List<Long>`	`getSharerAndCreatorIds(String shareScopeTypeAndIds, Long creatorId, com.seeyon.ctp.organization.manager.OrgManager orgManager)` 获取表单业务配置共享范围内的所有人员ID集合，并加上创建者自身，用于删除个性化菜单设置等场合
`static List<Long>`	`getSharerIds(String shareScopeTypeAndIds, Long creatorId, com.seeyon.ctp.organization.manager.OrgManager orgManager)` 获取表单业务配置共享范围内的所有人员ID集合，过滤创建者自身，用于发送消息等场合
`static <T> List<T>`	`getSubList(List<T> source, int first, int end)` 获取集合的子集，对传入集合进行有效性校验；对传入参数进行越界校验，不会出现越界异常
`static String`	`getTypeAndIdStrs(List<Object[]> typeAndIds)` 将List转换为字符串拼接形式：Type\|Id,Type\|Id,Type\|Id...
`static <T> ArrayList<T>`	`newArrayList(T... elements)` 通过给定的元素集构造一个ArrayList
`static Map<String,Object>`	`newHashMap(String[] keys, Object[] values)` 根据给出的key数组 - value数组快速构建一个HashMap 在Dao层场景中有许多需要构造HashMap的地方，封装此方法避免无聊重复
`static Map<String,Object>`	`newHashMap(String key, Object value)` 根据给出的key - value快速构建一个HashMap 在Dao层场景中有许多需要构造HashMap的地方，封装此方法避免无聊重复
`static <T> List<T>`	`pagenate(List<T> list)` 辅助在Manager层进行分页，避免此方法重复、散见于各处
`static <T> List<T>`	`pagenate(List<T> list, boolean needCount)`
`static <T> List<T>`	`parseArr2List(T[] arr)` 将数组转换为对应的集合
`static List<Long>`	`parseStr2Ids(javax.servlet.http.HttpServletRequest request, String parameterName)` 辅助方法：将ID字符串如-1223423423,3245232134,2344565788...解析为 `List<Long>`
`static List<Long>`	`parseStr2Ids(String idStrs)` 辅助方法：将ID字符串如-1223423423,3245232134,2344565788...解析为 `List<Long>`
`static List<Long>`	`parseStr2Ids(String idStrs, String seperator)` 辅助方法：将以分隔符拼接起来的ID字符串解析为`List<Long>`
`static List<Long>`	`parseStrArr2Ids(String[] idStrArray)` 将常见的id字符串数据解析为Long型数据集合
`static List<Long>`	`parseTypeAndIdStr2Ids(String typeAndIds)` 用于将同类组织模型的类型和ID拼接字符串解析为ID集合

从类继承的方法 java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- 构造器详细资料
  - CommonTools
```
public CommonTools()
```
- 方法详细资料
  - parseStrArr2Ids
```
public static List<Long> parseStrArr2Ids(String[] idStrArray)
```
    将常见的id字符串数据解析为Long型数据集合
    
    参数:
    
    idStrArray - id字符串数组
    
    返回:
    
    List<Long> ids
  - parseStr2Ids
```
public static List<Long> parseStr2Ids(String idStrs,
                                      String seperator)
```
    辅助方法：将以分隔符拼接起来的ID字符串解析为List<Long>
    
    参数:
    
    idStrs - 字符串
    
    seperator - 分隔符
  - parseStr2Ids
```
public static List<Long> parseStr2Ids(String idStrs)
```
    辅助方法：将ID字符串如-1223423423,3245232134,2344565788...解析为 List<Long>
  - parseStr2Ids
```
public static List<Long> parseStr2Ids(javax.servlet.http.HttpServletRequest request,
                                      String parameterName)
```
    辅助方法：将ID字符串如-1223423423,3245232134,2344565788...解析为 List<Long>
    
    参数:
    
    parameterName - 所要获取的变量名称：request.getParameter("parameterName")
  - getTypeAndIdStrs
```
public static String getTypeAndIdStrs(List<Object[]> typeAndIds)
```
    将List转换为字符串拼接形式：Type|Id,Type|Id,Type|Id...
    
    参数:
    
    typeAndIds - List object[0] - type, object[1] - id
  - collectProperty
```
public static List collectProperty(Collection<? extends com.seeyon.ctp.common.po.BasePO> models,
                                   String propertyName)
```
    获取领域模型的某种属性集合
    
    参数:
    
    models - 模型集合
    
    propertyName - 属性名称
  - getIds
```
public static List<Long> getIds(Collection<? extends com.seeyon.ctp.common.po.BasePO> models)
```
    收集领域模型的ID集合，便于复用
    
    参数:
    
    models - 领域模型集合，要求继承基类BaseModel
    
    返回:
    
    领域模型的ID集合
  - newHashMap
```
public static Map<String,Object> newHashMap(String[] keys,
                                            Object[] values)
```
    根据给出的key数组 - value数组快速构建一个HashMap 在Dao层场景中有许多需要构造HashMap的地方，封装此方法避免无聊重复
  - newArrayList
```
public static <T> ArrayList<T> newArrayList(T... elements)
```
    通过给定的元素集构造一个ArrayList
    
    类型参数:
    
    T - 类型
    
    参数:
    
    elements - 元素集
    
    返回:
    
    包含给定元素的ArrayList，其大小为给定元素的个数
  - newHashMap
```
public static Map<String,Object> newHashMap(String key,
                                            Object value)
```
    根据给出的key - value快速构建一个HashMap 在Dao层场景中有许多需要构造HashMap的地方，封装此方法避免无聊重复
  - parseTypeAndIdStr2Ids
```
public static List<Long> parseTypeAndIdStr2Ids(String typeAndIds)
```
    用于将同类组织模型的类型和ID拼接字符串解析为ID集合
    
    参数:
    
    typeAndIds - 如："Member|-123123123123,Member|3443434343434343,Member|233233223"
  - pagenate
```
public static <T> List<T> pagenate(List<T> list)
```
    辅助在Manager层进行分页，避免此方法重复、散见于各处
    
    参数:
    
    list - 待分页的结果集
    
    返回:
    
    按照分页数据所得的结果集子集
  - pagenate
```
public static <T> List<T> pagenate(List<T> list,
                                   boolean needCount)
```
  - getSubList
```
public static <T> List<T> getSubList(List<T> source,
                                     int first,
                                     int end)
```
    获取集合的子集，对传入集合进行有效性校验；对传入参数进行越界校验，不会出现越界异常
    
    参数:
    
    source - 源集合
    
    first - 开始位标，可能无效（大于集合元素总数或小于0）
    
    end - 结束位标，可能无效（大于集合元素总数或小于0）
    
    返回:
    
    结果子集合，可能为空
  - parseArr2List
```
public static <T> List<T> parseArr2List(T[] arr)
```
    将数组转换为对应的集合
  - equals
```
public static boolean equals(String s1,
                             String s2)
```
    判断两个字符串是否相等，如果两个字符串为null或空白，也视为相等，如：
```
 FormBizConfigUtils.equals(null, null)   = true
 FormBizConfigUtils.equals(null, "")     = true
 FormBizConfigUtils.equals("", "")         = true
 FormBizConfigUtils.equals("", " ")        = true
 FormBizConfigUtils.equals("abc", "ABC") = false
 
```
  - getEntityIds
```
public static List<Long> getEntityIds(Collection<? extends com.seeyon.ctp.organization.bo.V3xOrgEntity> entities)
```
    获取组织模型ID集合，过滤掉其中无效实体，如：过滤掉离职人员
    
    参数:
    
    entities - 组织模型集合
  - getMemberIdsByTypeAndId
```
public static List<Long> getMemberIdsByTypeAndId(String typeAndIds,
                                                 com.seeyon.ctp.organization.manager.OrgManager orgManager)
```
    获取选人界面字符串解析后所得人员的ID集合
  - filterInvalidEntities
```
public static void filterInvalidEntities(Collection<? extends com.seeyon.ctp.organization.bo.V3xOrgEntity> entities)
```
    过滤掉组织模型集合中无效的实体，如：过滤掉离职人员
    传入的实体集合，在方法执行完后发生了变化，适合用于过滤完即返回结果值的情况
    
    参数:
    
    entities - 组织模型实体集合
  - getSharerIds
```
public static List<Long> getSharerIds(String shareScopeTypeAndIds,
                                      Long creatorId,
                                      com.seeyon.ctp.organization.manager.OrgManager orgManager)
```
    获取表单业务配置共享范围内的所有人员ID集合，过滤创建者自身，用于发送消息等场合
    
    参数:
    
    shareScopeTypeAndIds - 共享范围Type|Ids...
    
    creatorId - 创建者
  - getSharerAndCreatorIds
```
public static List<Long> getSharerAndCreatorIds(String shareScopeTypeAndIds,
                                                Long creatorId,
                                                com.seeyon.ctp.organization.manager.OrgManager orgManager)
```
    获取表单业务配置共享范围内的所有人员ID集合，并加上创建者自身，用于删除个性化菜单设置等场合
    
    参数:
    
    shareScopeTypeAndIds - 共享范围Type|Ids...
    
    creatorId - 创建者
  - getIdStrs
```
public static String getIdStrs(Collection<? extends com.seeyon.v3x.common.domain.BaseModel> models,
                               char joinChar)
```
    将领域模型的ID按照某个字符串(比如",")拼接起来
    
    参数:
    
    models - 领域模型集合，要求继承基类BaseModel
    
    joinChar - 拼接的字符

类 CommonTools

构造器概要

方法概要

从类继承的方法 java.lang.Object

构造器详细资料

CommonTools

方法详细资料

parseStrArr2Ids

parseStr2Ids

parseStr2Ids

parseStr2Ids

getTypeAndIdStrs

collectProperty

getIds

newHashMap

newArrayList

newHashMap

parseTypeAndIdStr2Ids

pagenate

pagenate

getSubList

parseArr2List

equals

getEntityIds

getMemberIdsByTypeAndId

filterInvalidEntities

getSharerIds

getSharerAndCreatorIds

getIdStrs