WecomServiceImpl

java.lang.Object
- com.kdayun.wecom.service.impl.WecomServiceImpl

所有已实现的接口:: WecomService

@Service
public class WecomServiceImpl
extends java.lang.Object
implements WecomService

嵌套类概要

嵌套类
限定符和类型类和说明

static class WecomServiceImpl.WecomCallbackKey

static class WecomServiceImpl.wecomConfig

static class WecomServiceImpl.WecomSettings

嵌套类
限定符和类型	类和说明
`static class`	`WecomServiceImpl.WecomCallbackKey`
`static class`	`WecomServiceImpl.wecomConfig`
`static class`	`WecomServiceImpl.WecomSettings`

字段概要

字段
限定符和类型	字段和说明
`static java.lang.ThreadLocal<java.lang.String>`	`agentIdThreadLocal`
`(专用程序包) CoreOrgService`	`coreOrgService`
`static java.lang.String`	`KEY_CPWEIX` 企业微信的配置key
`static java.lang.String`	`KEY_CPWEIX_CORPID`
`static java.lang.ThreadLocal<java.lang.String>`	`orgIdThreadLocal`
`javax.servlet.http.HttpServletRequest`	`request`
`static WxCpMessageRouter`	`wxCpMessageRouter`
`static java.lang.ThreadLocal<WxCpServiceImpl>`	`wxCpServiceThreadLocal`

构造器概要

构造器
构造器和说明

WecomServiceImpl()

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

方法概要

所有方法实例方法具体方法
限定符和类型	方法和说明
`void`	`eventCallback(javax.servlet.http.HttpServletRequest request, javax.servlet.http.HttpServletResponse response, java.lang.String orgCode)` 企业微信的事件回调
`java.lang.String`	`getAccessToken()` 获取的访问AccessToken
`WxCpApprovalDetailResult`	`getApprovalDetail(java.lang.String spNo)` 获取审批申请详情企业可通过审批应用或自建应用Secret调用本接口，根据审批单号查询企业微信“审批应用”的审批申请详情。
`WxCpApprovalInfo`	`getApprovalInfo(java.util.Date startTime, java.util.Date endTime, java.lang.Integer cursor, java.lang.Integer size, java.util.List<WxCpApprovalInfoQueryFilter> filters)` 批量获取审批单号审批应用及有权限的自建应用，可通过Secret调用本接口，以获取企业一段时间内企业微信“审批应用”单据的审批编号，支持按模板类型、申请人、部门、申请单审批状态等条件筛选。
`java.util.List<WxCpCheckinData>`	`getCheckinData(java.lang.Number openCheckinDataType, java.lang.String startTime, java.lang.String endTime, java.lang.String[] userIdList)` 获取打卡数据
`java.util.List<WxCpCheckinDayData>`	`getCheckinDayData(java.util.Date startTime, java.util.Date endTime, java.util.List<java.lang.String> userIdList)` 获取打卡日报数据
`java.util.List<WxCpCheckinMonthData>`	`getCheckinMonthData(java.util.Date startTime, java.util.Date endTime, java.util.List<java.lang.String> userIdList)` 获取打卡月报数据
`java.util.List<WxCpCheckinOption>`	`getCheckinOption(java.lang.String datetimeStr, java.util.List<java.lang.String> userIdList)` 获取打卡规则 API doc : https://work.weixin.qq.com/api/doc#90000/90135/90263
`java.util.List<WxCpCheckinSchedule>`	`getCheckinScheduleList(java.util.Date startTime, java.util.Date endTime, java.util.List<java.lang.String> userIdList)` 获取打卡人员排班信息
`WxCpCorpConfInfo`	`getCorpConf()` 获取企业假期管理配置企业可通过审批应用或自建应用Secret调用本接口，获取可见范围内员工的“假期管理”配置，包括：各个假期的id、名称、请假单位、时长计算方式、发放规则等。
`WxCpService`	`getCpService(java.lang.Boolean isMessageEvent)` 获取当前单位对应的agentid的微信服务
`java.util.List<WxCpDepart>`	`getDepartList(java.lang.Long id)` 获取部门数据
`java.util.List<WxCpDialRecord>`	`getDialRecord(java.util.Date startTime, java.util.Date endTime, java.lang.Integer offset, java.lang.Integer limit)` 获取公费电话拨打记录
`WxCpTemplateResult`	`getTemplateDetail(java.lang.String templateId)` 获取审批模板详情
`java.util.List<WxCpUser>`	`getUserDtlInfoByDeprtId(java.lang.Long departId, java.lang.Boolean fetchChild, java.lang.Integer status)` 获取部门成员详情.
`java.util.List<WxCpUser>`	`getUserInfoByDeprtId(java.lang.Long departId, java.lang.Boolean fetchChild, java.lang.Integer status)` 获取部门成员.
`WxCpUser`	`getUserInfoById(java.lang.String userid)` 获取用户信息
`void`	`init()`
`java.lang.String`	`refreshAccessToken()` 刷新的访问AccessToken 失效时候使用
`void`	`setCheckinScheduleList(WxCpSetCheckinSchedule wxCpSetCheckinSchedule)` 为打卡人员排班

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

- 字段详细资料
  - agentIdThreadLocal
```
public static java.lang.ThreadLocal<java.lang.String> agentIdThreadLocal
```
  - orgIdThreadLocal
```
public static java.lang.ThreadLocal<java.lang.String> orgIdThreadLocal
```
  - wxCpServiceThreadLocal
```
public static java.lang.ThreadLocal<WxCpServiceImpl> wxCpServiceThreadLocal
```
  - wxCpMessageRouter
```
public static WxCpMessageRouter wxCpMessageRouter
```
  - coreOrgService
```
@Autowired
CoreOrgService coreOrgService
```
  - KEY_CPWEIX
```
public static final java.lang.String KEY_CPWEIX
```
    企业微信的配置key
    
    另请参阅:
    
    常量字段值
  - KEY_CPWEIX_CORPID
```
public static final java.lang.String KEY_CPWEIX_CORPID
```
    另请参阅:
    
    常量字段值
  - request
```
@Autowired
public javax.servlet.http.HttpServletRequest request
```
- 构造器详细资料
  - WecomServiceImpl
```
public WecomServiceImpl()
```
- 方法详细资料
  - init
```
@PostConstruct
public void init()
                          throws java.lang.Exception
```
    抛出:
    
    java.lang.Exception
  - getCpService
```
public WxCpService getCpService(java.lang.Boolean isMessageEvent)
                         throws java.lang.Exception
```
    从接口复制的说明: WecomService
    
    获取当前单位对应的agentid的微信服务
    
    指定者:
    
    getCpService 在接口中 WecomService
    
    参数:
    
    isMessageEvent - 是否消息的回调如果是允许agentid为空
    
    返回:
    
    WxCpService
    
    抛出:
    
    java.lang.Exception - 出错会抛出异常
  - getAccessToken
```
public java.lang.String getAccessToken()
                                throws java.lang.Exception
```
    从接口复制的说明: WecomService
    
    获取的访问AccessToken
    
    指定者:
    
    getAccessToken 在接口中 WecomService
    
    返回:
    
    accesstoken
    
    抛出:
    
    java.lang.Exception - 出错会抛出异常
  - refreshAccessToken
```
public java.lang.String refreshAccessToken()
                                    throws java.lang.Exception
```
    从接口复制的说明: WecomService
    
    刷新的访问AccessToken 失效时候使用
    
    指定者:
    
    refreshAccessToken 在接口中 WecomService
    
    返回:
    
    AccessToken
    
    抛出:
    
    java.lang.Exception - 出错会抛出异常
  - getCheckinData
```
public java.util.List<WxCpCheckinData> getCheckinData(java.lang.Number openCheckinDataType,
                                                      java.lang.String startTime,
                                                      java.lang.String endTime,
                                                      java.lang.String[] userIdList)
                                               throws java.lang.Exception
```
    从接口复制的说明: WecomService
    
    获取打卡数据
    
    指定者:
    
    getCheckinData 在接口中 WecomService
    
    参数:
    
    openCheckinDataType - 打卡类型。1：上下班打卡；2：外出打卡；3：全部打卡
    
    startTime - 获取打卡记录的开始时间
    
    endTime - 获取打卡记录的结束时间
    
    userIdList - 需要获取打卡记录的用户列表注意这个每次最多能获取100个人的打卡数据如果需要更多请求分批获取
    
    返回:
    
    打卡数据列表
    
    抛出:
    
    java.lang.Exception - 出错会抛出异常
  - getDepartList
```
public java.util.List<WxCpDepart> getDepartList(java.lang.Long id)
                                         throws java.lang.Exception
```
    从接口复制的说明: WecomService
    
    获取部门数据
    
    指定者:
    
    getDepartList 在接口中 WecomService
    
    参数:
    
    id - 部门id。获取指定部门及其下的子部门。非必需，可为null
    
    返回:
    
    获取的部门列表
    
    抛出:
    
    java.lang.Exception - 出错会抛出异常
  - getUserInfoById
```
public WxCpUser getUserInfoById(java.lang.String userid)
                         throws java.lang.Exception
```
    从接口复制的说明: WecomService
    
    获取用户信息
    
    指定者:
    
    getUserInfoById 在接口中 WecomService
    
    参数:
    
    userid - 用户id
    
    返回:
    
    the by id
    
    抛出:
    
    java.lang.Exception - 出错会抛出异常
  - getUserInfoByDeprtId
```
public java.util.List<WxCpUser> getUserInfoByDeprtId(java.lang.Long departId,
                                                     java.lang.Boolean fetchChild,
                                                     java.lang.Integer status)
                                              throws java.lang.Exception
```
    从接口复制的说明: WecomService
    
    获取部门成员. http://qydev.weixin.qq.com/wiki/index.php?title=管理成员#.E8.8E.B7.E5.8F.96.E9.83.A8.E9.97.A8.E6.88.90.E5.91.98
    
    指定者:
    
    getUserInfoByDeprtId 在接口中 WecomService
    
    参数:
    
    departId - 必填。部门id
    
    fetchChild - 非必填。获取方式: 1/0：是否递归获取子部门下面的成员
    
    status - 非必填。员工的状态: 0获取全部员工，1获取已关注成员列表，2获取禁用成员列表，4获取未关注成员列表。status可叠加
    
    返回:
    
    the list
    
    抛出:
    
    java.lang.Exception - 出错会抛出异常
  - getUserDtlInfoByDeprtId
```
public java.util.List<WxCpUser> getUserDtlInfoByDeprtId(java.lang.Long departId,
                                                        java.lang.Boolean fetchChild,
                                                        java.lang.Integer status)
                                                 throws java.lang.Exception
```
    从接口复制的说明: WecomService
    
    获取部门成员详情. https://work.weixin.qq.com/api/doc/90000/90135/90201
    
    指定者:
    
    getUserDtlInfoByDeprtId 在接口中 WecomService
    
    参数:
    
    departId - 必填。部门id
    
    fetchChild - 非必填。获取方式: 1/0：是否递归获取子部门下面的成员
    
    status - 非必填。员工的状态: 0获取全部员工，1获取已关注成员列表，2获取禁用成员列表，4获取未关注成员列表。status可叠加
    
    返回:
    
    the list
    
    抛出:
    
    java.lang.Exception - 出错会抛出异常
  - getCheckinOption
```
public java.util.List<WxCpCheckinOption> getCheckinOption(java.lang.String datetimeStr,
                                                          java.util.List<java.lang.String> userIdList)
                                                   throws java.lang.Exception
```
    从接口复制的说明: WecomService
```
   获取打卡规则
   API doc : https://work.weixin.qq.com/api/doc#90000/90135/90263
 
```
    指定者:
    
    getCheckinOption 在接口中 WecomService
    
    参数:
    
    datetimeStr - 需要获取规则的当天日期
    
    userIdList - 需要获取打卡规则的用户列表
    
    返回:
    
    打卡规则列表 checkin option
    
    抛出:
    
    java.lang.Exception - 出错会抛出异常
  - getApprovalDetail
```
public WxCpApprovalDetailResult getApprovalDetail(java.lang.String spNo)
                                           throws java.lang.Exception
```
    从接口复制的说明: WecomService
```
   获取审批申请详情

   企业可通过审批应用或自建应用Secret调用本接口，根据审批单号查询企业微信“审批应用”的审批申请详情。

   API Doc : https://work.weixin.qq.com/api/doc/90000/90135/91983
 
```
    指定者:
    
    getApprovalDetail 在接口中 WecomService
    
    参数:
    
    spNo - 审批单编号。
    
    返回:
    
    WxCpApprovaldetail approval detail
    
    抛出:
    
    java.lang.Exception - 出错会抛出异常 .
  - getCorpConf
```
public WxCpCorpConfInfo getCorpConf()
                             throws java.lang.Exception
```
    从接口复制的说明: WecomService
    
    获取企业假期管理配置企业可通过审批应用或自建应用Secret调用本接口，获取可见范围内员工的“假期管理”配置，包括：各个假期的id、名称、请假单位、时长计算方式、发放规则等。第三方应用可获取应用可见范围内员工的“假期管理”配置，包括：各个假期的id、名称、请假单位、时长计算方式、发放规则等。请求方式：GET(HTTPS) 请求地址：https://qyapi.weixin.qq.com/cgi-bin/oa/vacation/getcorpconf?access_token=ACCESS_TOKEN
    
    指定者:
    
    getCorpConf 在接口中 WecomService
    
    返回:
    
    WxCpCorpConfInfo
    
    抛出:
    
    java.lang.Exception - 出错会抛出异常
  - getDialRecord
```
public java.util.List<WxCpDialRecord> getDialRecord(java.util.Date startTime,
                                                    java.util.Date endTime,
                                                    java.lang.Integer offset,
                                                    java.lang.Integer limit)
                                             throws java.lang.Exception
```
    从接口复制的说明: WecomService
    
    获取公费电话拨打记录
    
    指定者:
    
    getDialRecord 在接口中 WecomService
    
    参数:
    
    startTime - 查询的起始时间戳
    
    endTime - 查询的结束时间戳
    
    offset - 分页查询的偏移量
    
    limit - 分页查询的每页大小,默认为100条，如该参数大于100则按100处理
    
    返回:
    
    . dial record
    
    抛出:
    
    java.lang.Exception - 出错会抛出异常 .
  - getTemplateDetail
```
public WxCpTemplateResult getTemplateDetail(java.lang.String templateId)
                                     throws java.lang.Exception
```
    从接口复制的说明: WecomService
    
    获取审批模板详情
    
    指定者:
    
    getTemplateDetail 在接口中 WecomService
    
    参数:
    
    templateId - 模板ID
    
    返回:
    
    . template detail
    
    抛出:
    
    java.lang.Exception - 出错会抛出异常 .
  - getCheckinDayData
```
public java.util.List<WxCpCheckinDayData> getCheckinDayData(java.util.Date startTime,
                                                            java.util.Date endTime,
                                                            java.util.List<java.lang.String> userIdList)
                                                     throws java.lang.Exception
```
    从接口复制的说明: WecomService
    
    获取打卡日报数据
    
    指定者:
    
    getCheckinDayData 在接口中 WecomService
    
    参数:
    
    startTime - 获取日报的开始时间
    
    endTime - 获取日报的结束时间
    
    userIdList - 获取日报的userid列表
    
    返回:
    
    日报数据列表 checkin day data
    
    抛出:
    
    java.lang.Exception - 出错会抛出异常 the wx error exception
  - getCheckinMonthData
```
public java.util.List<WxCpCheckinMonthData> getCheckinMonthData(java.util.Date startTime,
                                                                java.util.Date endTime,
                                                                java.util.List<java.lang.String> userIdList)
                                                         throws java.lang.Exception
```
    从接口复制的说明: WecomService
    
    获取打卡月报数据
    
    指定者:
    
    getCheckinMonthData 在接口中 WecomService
    
    参数:
    
    startTime - 获取月报的开始时间
    
    endTime - 获取月报的结束时间
    
    userIdList - 获取月报的userid列表
    
    返回:
    
    月报数据列表
    
    抛出:
    
    java.lang.Exception - 出错会抛出异常 the wx error exception
  - getCheckinScheduleList
```
public java.util.List<WxCpCheckinSchedule> getCheckinScheduleList(java.util.Date startTime,
                                                                  java.util.Date endTime,
                                                                  java.util.List<java.lang.String> userIdList)
                                                           throws java.lang.Exception
```
    从接口复制的说明: WecomService
    
    获取打卡人员排班信息
    
    指定者:
    
    getCheckinScheduleList 在接口中 WecomService
    
    参数:
    
    startTime - 获取排班信息的开始时间。Unix时间戳
    
    endTime - 获取排班信息的结束时间。Unix时间戳（与starttime跨度不超过一个月）
    
    userIdList - 需要获取排班信息的用户列表（不超过100个）
    
    返回:
    
    排班表信息
    
    抛出:
    
    java.lang.Exception - 出错会抛出异常 the wx error exception
  - setCheckinScheduleList
```
public void setCheckinScheduleList(WxCpSetCheckinSchedule wxCpSetCheckinSchedule)
                            throws java.lang.Exception
```
    从接口复制的说明: WecomService
    
    为打卡人员排班
    
    指定者:
    
    setCheckinScheduleList 在接口中 WecomService
    
    参数:
    
    wxCpSetCheckinSchedule - the wx cp set checkin schedule
    
    抛出:
    
    java.lang.Exception - 出错会抛出异常 the wx error exception
  - getApprovalInfo
```
public WxCpApprovalInfo getApprovalInfo(java.util.Date startTime,
                                        java.util.Date endTime,
                                        java.lang.Integer cursor,
                                        java.lang.Integer size,
                                        java.util.List<WxCpApprovalInfoQueryFilter> filters)
                                 throws java.lang.Exception
```
    从接口复制的说明: WecomService
```
 批量获取审批单号

 审批应用及有权限的自建应用，可通过Secret调用本接口，以获取企业一段时间内企业微信“审批应用”单据的审批编号，支持按模板类型、申请人、部门、申请单审批状态等条件筛选。
 自建应用调用此接口，需在“管理后台-应用管理-审批-API-审批数据权限”中，授权应用允许提交审批单据。

 一次拉取调用最多拉取100个审批记录，可以通过多次拉取的方式来满足需求，但调用频率不可超过600次/分。

 API doc : https://work.weixin.qq.com/api/doc/90000/90135/91816
 
```
    指定者:
    
    getApprovalInfo 在接口中 WecomService
    
    参数:
    
    startTime - 开始时间
    
    endTime - 结束时间
    
    cursor - 分页查询游标，默认为0，后续使用返回的next_cursor进行分页拉取
    
    size - 一次请求拉取审批单数量，默认值为100，上限值为100
    
    filters - 筛选条件，可对批量拉取的审批申请设置约束条件，支持设置多个条件,nullable
    
    返回:
    
    WxCpApprovalInfo approval info
    
    抛出:
    
    java.lang.Exception - 出错会抛出异常
  - eventCallback
```
public void eventCallback(javax.servlet.http.HttpServletRequest request,
                          javax.servlet.http.HttpServletResponse response,
                          java.lang.String orgCode)
                   throws java.lang.Exception
```
    从接口复制的说明: WecomService
    
    企业微信的事件回调
    
    指定者:
    
    eventCallback 在接口中 WecomService
    
    参数:
    
    request - 请求对象
    
    response - 相应对象
    
    orgCode - 机构编码
    
    抛出:
    
    java.lang.Exception - 出错会抛出异常

类 WecomServiceImpl

嵌套类概要

字段概要

构造器概要

方法概要

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

字段详细资料

agentIdThreadLocal

orgIdThreadLocal

wxCpServiceThreadLocal

wxCpMessageRouter

coreOrgService

KEY_CPWEIX

KEY_CPWEIX_CORPID

request

构造器详细资料

WecomServiceImpl

方法详细资料

init

getCpService

getAccessToken

refreshAccessToken

getCheckinData

getDepartList

getUserInfoById

getUserInfoByDeprtId

getUserDtlInfoByDeprtId

getCheckinOption

getApprovalDetail

getCorpConf

getDialRecord

getTemplateDetail

getCheckinDayData

getCheckinMonthData

getCheckinScheduleList

setCheckinScheduleList

getApprovalInfo

eventCallback