WXWorkServiceImpl (wxwork-spring-boot-starter 1.2.2 API)

java.lang.Object
- xiongwei.jiang.service.impl.WXWorkServiceImpl

所有已实现的接口:: org.springframework.beans.factory.InitializingBean, WXWorkService

@EnableConfigurationProperties(value=WXWorkProperties.class)
 @Service
public class WXWorkServiceImpl
extends Object
implements WXWorkService, org.springframework.beans.factory.InitializingBean

企业微信服务接口实现类

作者:: 天之蓝

字段概要

字段
限定符和类型字段和说明

static com.google.gson.Gson GSON

static String WXWORK_ALIAS

字段
限定符和类型	字段和说明
`static com.google.gson.Gson`	`GSON`
`static String`	`WXWORK_ALIAS`

构造器概要

构造器
构造器和说明

WXWorkServiceImpl()

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

方法概要

所有方法静态方法实例方法具体方法
限定符和类型	方法和说明
`void`	`afterPropertiesSet()`
`Map<String,Object>`	`callback(Integer callbackIndex, String msg_signature, String timestamp, String nonce, String xml, javax.servlet.http.HttpServletResponse response)` 处理 callback
`static String`	`dealCurrentPageUrl(String currentPageUrl)` 处理当前页面 url
`byte[]`	`downloadTemp(Integer appIndex, String mediaId)` 获取临时素材
`byte[]`	`downloadVoice(Integer appIndex, String mediaId)` 获取高清语音素材
`AgentConfigSignatureResponseDTO`	`getAgentConfigSignature(Integer appIndex, String currentPageUrl)` 获取 agentConfig 签名
`CallbackIpResponseDTO`	`getCallbackIp(Integer appIndex)` 获取企业微信服务器的 ip 段
`CheckinDataResponseDTO`	`getCheckinData(Integer openCheckinDataType, Long startTime, Long endTime, List<String> userIdList)` 获取打卡记录（token 必须由打卡 secret 获取）
`ConfigSignatureResponseDTO`	`getConfigSignature(Integer appIndex, String currentPageUrl)` 获取 config 签名
`DepartmentInfoResponseDTO`	`getDepartmentInfo(Integer appIndex, Integer departmentId)` 获取 department 部门列表
`DepartmentUserResponseDTO`	`getDepartmentUser(Integer appIndex, Integer departmentId, Integer fetchChild)` 获取 department 部门 user 简单信息
`String`	`getJsapiTicket(Integer appIndex)` 获取 jsapi_ticket
`String`	`getJsapiTicketAgent(Integer appIndex)` 获取 jsapi_ticket_agent
`String`	`getJsapiTicketAgentCache(Integer appIndex)` 获取 jsapi_ticket_agent 缓存
`String`	`getJsapiTicketCache(Integer appIndex)` 获取 jsapi_ticket 缓存
`TagInfoResponseDTO`	`getTagInfo()` 获取 tag 标签列表（token 必须由通讯录 secret 获取）
`TagUserResponseDTO`	`getTagUser(Integer tagId)` 获取 tag 标签 user 简单信息（token 必须由通讯录 secret 获取）
`String`	`getToken(Integer appIndex)` 获取 token
`String`	`getTokenCache(Integer appIndex)` 获取 token 缓存
`UserIdResponseDTO`	`getUserId(Integer appIndex, String code)` 获取工号
`UserInfoResponseDTO`	`getUserInfo(Integer appIndex, String userId)` 获取 user 信息
`AppMsgResponseDTO`	`sendAppMarkdownMsg(Integer appIndex, AppMarkdownMsgRequestDTO object)` 发送应用 markdown 消息
`org.springframework.http.HttpEntity<String>`	`sendAppMsg(Integer appIndex, String json)` 发送应用消息
`AppMsgResponseDTO`	`sendAppTextMsg(Integer appIndex, AppTextMsgRequestDTO object)` 发送应用文本消息
`BotMsgResponseDTO`	`sendBotMarkdownMsg(Integer botIndex, BotMarkdownMsgRequestDTO object)` 发送机器人 markdown 消息
`org.springframework.http.HttpEntity<String>`	`sendBotMsg(Integer botIndex, String json)` 发送机器人消息
`BotMsgResponseDTO`	`sendBotTextMsg(Integer botIndex, BotTextMsgRequestDTO object)` 发送机器人文本消息
`AppUploadImageResponseDTO`	`uploadImage(Integer appIndex, String filePath)` 上传图片
`AppUploadTempResponseDTO`	`uploadTemp(Integer appIndex, UploadTempType tempType, String filePath)` 上传临时素材
`boolean`	`verifyUrl(Integer callbackIndex, String msg_signature, String timestamp, String nonce, String echostr, javax.servlet.http.HttpServletResponse response)` 验证 url

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

- 字段详细资料
  - GSON
```
public static final com.google.gson.Gson GSON
```
  - WXWORK_ALIAS
```
public static final String WXWORK_ALIAS
```
    另请参阅:
    
    常量字段值
- 构造器详细资料
  - WXWorkServiceImpl
```
public WXWorkServiceImpl()
```
- 方法详细资料
  - afterPropertiesSet
```
public void afterPropertiesSet()
```
    指定者:
    
    afterPropertiesSet 在接口中 org.springframework.beans.factory.InitializingBean
  - getUserId
```
public UserIdResponseDTO getUserId(Integer appIndex,
                                   String code)
```
    从接口复制的说明: WXWorkService
    
    获取工号
    
    指定者:
    
    getUserId 在接口中 WXWorkService
    
    参数:
    
    appIndex - 索引
    
    code - 企业微信返回一次性 code，5 分钟内有效
    
    返回:
    
    UserIdResponseDTO
  - getUserInfo
```
public UserInfoResponseDTO getUserInfo(Integer appIndex,
                                       String userId)
```
    从接口复制的说明: WXWorkService
    
    获取 user 信息
    
    指定者:
    
    getUserInfo 在接口中 WXWorkService
    
    参数:
    
    appIndex - 索引
    
    userId - 工号
    
    返回:
    
    UserInfoResponseDTO
  - getDepartmentInfo
```
public DepartmentInfoResponseDTO getDepartmentInfo(Integer appIndex,
                                                   Integer departmentId)
```
    从接口复制的说明: WXWorkService
    
    获取 department 部门列表
    
    指定者:
    
    getDepartmentInfo 在接口中 WXWorkService
    
    参数:
    
    appIndex - 索引
    
    departmentId - 部门 id，获取指定部门及其下的子部门（以及及子部门的子部门等等，递归），如果不填，默认获取全量组织架构
    
    返回:
    
    DepartmentInfoResponseDTO
  - getDepartmentUser
```
public DepartmentUserResponseDTO getDepartmentUser(Integer appIndex,
                                                   Integer departmentId,
                                                   Integer fetchChild)
```
    从接口复制的说明: WXWorkService
    
    获取 department 部门 user 简单信息
    
    指定者:
    
    getDepartmentUser 在接口中 WXWorkService
    
    参数:
    
    appIndex - 索引
    
    departmentId - 部门 id
    
    fetchChild - 是否递归获取子部门下面的成员（1-递归获取，0-只获取本部门）
    
    返回:
    
    DepartmentUserResponseDTO
  - getTagInfo
```
public TagInfoResponseDTO getTagInfo()
```
    从接口复制的说明: WXWorkService
    
    获取 tag 标签列表（token 必须由通讯录 secret 获取）
    
    指定者:
    
    getTagInfo 在接口中 WXWorkService
    
    返回:
    
    TagInfoResponseDTO
  - getTagUser
```
public TagUserResponseDTO getTagUser(Integer tagId)
```
    从接口复制的说明: WXWorkService
    
    获取 tag 标签 user 简单信息（token 必须由通讯录 secret 获取）
    
    指定者:
    
    getTagUser 在接口中 WXWorkService
    
    参数:
    
    tagId - 标签 id
    
    返回:
    
    TagUserResponseDTO
  - sendAppTextMsg
```
public AppMsgResponseDTO sendAppTextMsg(Integer appIndex,
                                        AppTextMsgRequestDTO object)
```
    从接口复制的说明: WXWorkService
    
    发送应用文本消息
    
    指定者:
    
    sendAppTextMsg 在接口中 WXWorkService
    
    参数:
    
    appIndex - 索引
    
    object - AppTextMsgRequestDTO
    
    返回:
    
    AppMsgResponseDTO
  - sendAppMarkdownMsg
```
public AppMsgResponseDTO sendAppMarkdownMsg(Integer appIndex,
                                            AppMarkdownMsgRequestDTO object)
```
    从接口复制的说明: WXWorkService
    
    发送应用 markdown 消息
    
    指定者:
    
    sendAppMarkdownMsg 在接口中 WXWorkService
    
    参数:
    
    appIndex - 索引
    
    object - AppMarkdownMsgRequestDTO
    
    返回:
    
    AppMsgResponseDTO
  - sendAppMsg
```
public org.springframework.http.HttpEntity<String> sendAppMsg(Integer appIndex,
                                                              String json)
```
    发送应用消息
    
    参数:
    
    appIndex - 索引
    
    json - JSON
    
    返回:
    
    HttpEntity
  - uploadTemp
```
public AppUploadTempResponseDTO uploadTemp(Integer appIndex,
                                           UploadTempType tempType,
                                           String filePath)
                                    throws IOException
```
    从接口复制的说明: WXWorkService
    
    上传临时素材
    
    指定者:
    
    uploadTemp 在接口中 WXWorkService
    
    参数:
    
    appIndex - 索引
    
    tempType - UploadTempType
    
    filePath - 临时素材绝对路径
    
    返回:
    
    AppUploadTempResponseDTO
    
    抛出:
    
    IOException - 异常
  - uploadImage
```
public AppUploadImageResponseDTO uploadImage(Integer appIndex,
                                             String filePath)
                                      throws IOException
```
    从接口复制的说明: WXWorkService
    
    上传图片
    
    指定者:
    
    uploadImage 在接口中 WXWorkService
    
    参数:
    
    appIndex - 索引
    
    filePath - 图片绝对路径
    
    返回:
    
    AppUploadImageResponseDTO
    
    抛出:
    
    IOException - 异常
  - downloadTemp
```
public byte[] downloadTemp(Integer appIndex,
                           String mediaId)
```
    从接口复制的说明: WXWorkService
    
    获取临时素材
    
    指定者:
    
    downloadTemp 在接口中 WXWorkService
    
    参数:
    
    appIndex - 索引
    
    mediaId - 媒体文件 id
    
    返回:
    
    字节数组
  - downloadVoice
```
public byte[] downloadVoice(Integer appIndex,
                            String mediaId)
```
    从接口复制的说明: WXWorkService
    
    获取高清语音素材
    
    指定者:
    
    downloadVoice 在接口中 WXWorkService
    
    参数:
    
    appIndex - 索引
    
    mediaId - 媒体文件 id
    
    返回:
    
    字节数组
  - getCheckinData
```
public CheckinDataResponseDTO getCheckinData(Integer openCheckinDataType,
                                             Long startTime,
                                             Long endTime,
                                             List<String> userIdList)
```
    从接口复制的说明: WXWorkService
    
    获取打卡记录（token 必须由打卡 secret 获取）
    
    指定者:
    
    getCheckinData 在接口中 WXWorkService
    
    参数:
    
    openCheckinDataType - 打卡类型（1-上下班打卡，2-外出打卡，3-全部打卡）
    
    startTime - 获取打卡记录的开始时间（10 位 Unix 时间戳）
    
    endTime - 获取打卡记录的结束时间（10 位 Unix 时间戳）
    
    userIdList - 工号集合（至多 100 个）
    
    返回:
    
    CheckinDataResponseDTO
  - getTokenCache
```
public String getTokenCache(Integer appIndex)
```
    从接口复制的说明: WXWorkService
    
    获取 token 缓存
    
    指定者:
    
    getTokenCache 在接口中 WXWorkService
    
    参数:
    
    appIndex - 索引
    
    返回:
    
    token
  - getToken
```
public String getToken(Integer appIndex)
```
    获取 token
    
    参数:
    
    appIndex - 索引
    
    返回:
    
    token
  - getJsapiTicketCache
```
public String getJsapiTicketCache(Integer appIndex)
```
    从接口复制的说明: WXWorkService
    
    获取 jsapi_ticket 缓存
    
    指定者:
    
    getJsapiTicketCache 在接口中 WXWorkService
    
    参数:
    
    appIndex - 索引
    
    返回:
    
    JsapiTicket
  - getJsapiTicket
```
public String getJsapiTicket(Integer appIndex)
```
    获取 jsapi_ticket
    
    参数:
    
    appIndex - 索引
    
    返回:
    
    jsapiTicket
  - getJsapiTicketAgentCache
```
public String getJsapiTicketAgentCache(Integer appIndex)
```
    从接口复制的说明: WXWorkService
    
    获取 jsapi_ticket_agent 缓存
    
    指定者:
    
    getJsapiTicketAgentCache 在接口中 WXWorkService
    
    参数:
    
    appIndex - 索引
    
    返回:
    
    JsapiTicketAgent
  - getJsapiTicketAgent
```
public String getJsapiTicketAgent(Integer appIndex)
```
    获取 jsapi_ticket_agent
    
    参数:
    
    appIndex - 索引
    
    返回:
    
    jsapiTicketAgent
  - verifyUrl
```
public boolean verifyUrl(Integer callbackIndex,
                         String msg_signature,
                         String timestamp,
                         String nonce,
                         String echostr,
                         javax.servlet.http.HttpServletResponse response)
```
    从接口复制的说明: WXWorkService
    
    验证 url
    
    指定者:
    
    verifyUrl 在接口中 WXWorkService
    
    参数:
    
    callbackIndex - 索引
    
    msg_signature - 企业微信加密签名，msg_signature计算结合了企业填写的token、请求中的timestamp、nonce、加密的消息体
    
    timestamp - 时间戳（与nonce结合使用，用于防止请求重放攻击）
    
    nonce - 随机数（与timestamp结合使用，用于防止请求重放攻击）
    
    echostr - 加密的字符串（需要解密得到消息内容明文，解密后有random、msg_len、msg、receiveid四个字段，其中msg即为消息内容明文）
    
    response - 响应
    
    返回:
    
    true-成功，false-失败
  - callback
```
public Map<String,Object> callback(Integer callbackIndex,
                                   String msg_signature,
                                   String timestamp,
                                   String nonce,
                                   String xml,
                                   javax.servlet.http.HttpServletResponse response)
```
    从接口复制的说明: WXWorkService
    
    处理 callback
    
    指定者:
    
    callback 在接口中 WXWorkService
    
    参数:
    
    callbackIndex - 索引
    
    msg_signature - 企业微信加密签名，msg_signature结合了企业填写的token、请求中的timestamp、nonce参数、加密的消息体
    
    timestamp - 时间戳（与nonce结合使用，用于防止请求重放攻击）
    
    nonce - 随机数（与timestamp结合使用，用于防止请求重放攻击）
    
    xml - 回调数据（放在 HTTP 请求体中，使用 @RequestBody 注解接收）
    
    response - 响应
    
    返回:
    
    Map
  - getConfigSignature
```
public ConfigSignatureResponseDTO getConfigSignature(Integer appIndex,
                                                     String currentPageUrl)
```
    从接口复制的说明: WXWorkService
    
    获取 config 签名
    
    指定者:
    
    getConfigSignature 在接口中 WXWorkService
    
    参数:
    
    appIndex - 索引
    
    currentPageUrl - 当前页面 url
    
    返回:
    
    ConfigSignatureResponseDTO
  - getAgentConfigSignature
```
public AgentConfigSignatureResponseDTO getAgentConfigSignature(Integer appIndex,
                                                               String currentPageUrl)
```
    从接口复制的说明: WXWorkService
    
    获取 agentConfig 签名
    
    指定者:
    
    getAgentConfigSignature 在接口中 WXWorkService
    
    参数:
    
    appIndex - 索引
    
    currentPageUrl - 当前页面 url
    
    返回:
    
    AgentConfigSignatureResponseDTO
  - dealCurrentPageUrl
```
public static String dealCurrentPageUrl(String currentPageUrl)
```
    处理当前页面 url
    
    参数:
    
    currentPageUrl - 当前页面 url
    
    返回:
    
    字符串
  - getCallbackIp
```
public CallbackIpResponseDTO getCallbackIp(Integer appIndex)
```
    从接口复制的说明: WXWorkService
    
    获取企业微信服务器的 ip 段
    
    指定者:
    
    getCallbackIp 在接口中 WXWorkService
    
    参数:
    
    appIndex - 索引
    
    返回:
    
    CallbackIpResponseDTO
  - sendBotTextMsg
```
public BotMsgResponseDTO sendBotTextMsg(Integer botIndex,
                                        BotTextMsgRequestDTO object)
```
    从接口复制的说明: WXWorkService
    
    发送机器人文本消息
    
    指定者:
    
    sendBotTextMsg 在接口中 WXWorkService
    
    参数:
    
    botIndex - 索引
    
    object - BotTextMsgRequestDTO
    
    返回:
    
    BotMsgResponseDTO
  - sendBotMarkdownMsg
```
public BotMsgResponseDTO sendBotMarkdownMsg(Integer botIndex,
                                            BotMarkdownMsgRequestDTO object)
```
    从接口复制的说明: WXWorkService
    
    发送机器人 markdown 消息
    
    指定者:
    
    sendBotMarkdownMsg 在接口中 WXWorkService
    
    参数:
    
    botIndex - 索引
    
    object - BotMarkdownMsgRequestDTO
    
    返回:
    
    BotMsgResponseDTO
  - sendBotMsg
```
public org.springframework.http.HttpEntity<String> sendBotMsg(Integer botIndex,
                                                              String json)
```
    发送机器人消息
    
    参数:
    
    botIndex - 索引
    
    json - JSON
    
    返回:
    
    HttpEntity

类 WXWorkServiceImpl

字段概要

构造器概要

方法概要

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

字段详细资料

GSON

WXWORK_ALIAS

构造器详细资料

WXWorkServiceImpl

方法详细资料

afterPropertiesSet

getUserId

getUserInfo

getDepartmentInfo

getDepartmentUser

getTagInfo

getTagUser

sendAppTextMsg

sendAppMarkdownMsg

sendAppMsg

uploadTemp

uploadImage

downloadTemp

downloadVoice

getCheckinData

getTokenCache

getToken

getJsapiTicketCache

getJsapiTicket

getJsapiTicketAgentCache

getJsapiTicketAgent

verifyUrl

callback

getConfigSignature

getAgentConfigSignature

dealCurrentPageUrl

getCallbackIp

sendBotTextMsg

sendBotMarkdownMsg

sendBotMsg