# openapi-demo-java-master

**Repository Path**: mgp2018/openapi-demo-java-master

## Basic Information

- **Project Name**: openapi-demo-java-master
- **Description**: 企业应用接入钉钉DEMO
- **Primary Language**: Java
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 2
- **Created**: 2020-06-04
- **Last Updated**: 2021-05-10

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

### 软件依赖
* java version "1.7"
* maven3

## Getting Started

1. 将工程clone到本地：`git clone https://github.com/open-dingtalk/openapi-demo-java.git`
2. 使用IDE导入工程，比如eclipse点击`File->import`(推荐使用maven导入), IDEA点击`File->New->Project from Existing Sources...`, 文件编码都是UTF-8
3. 打开工程的Env.java文件，填入企业的CORP_ID和SECRET（CORP_ID和SECRET可以在企业OA后台找到）
```

    public static final String CORP_ID = "your CORP_ID";
    public static final String CORP_SECRET = "your CORP_SECRET";
``` 
4. 部署工程，建议使用mvn -DskipTests=true jetty:run运行或者IDE中的maven插件运行
5. OA后台创建微应用，并把工程的首页地址/index.jsp填到微应用**首页地址**中。
[如何创建微应用？](http://ddtalk.github.io/dingTalkDoc/#step-2-创建微应用)


## DEMO具体实现

#### 1. jsapi权限验证配置流程

请查看[文档](http://ddtalk.github.io/dingTalkDoc/#页面引入js文件)
- 前端文件:WebContent/index.jsp，WebContent/javascripts/demo.js
- 后端文件:[链接](https://github.com/open-dingtalk/openapi-demo-java/blob/master/src/com/alibaba/dingtalk/openapi/demo/auth/AuthHelper.java)

2.免登流程

请查看[文档](http://ddtalk.github.io/dingTalkDoc/#手机客户端微应用中调用免登)
- 前端文件:WebContent/javascripts/demo.js和
- 后端文件:[链接](https://github.com/open-dingtalk/openapi-demo-java/blob/master/src/com/alibaba/dingtalk/openapi/servlet/UserInfoServlet.java)


3.部门的操作
请查看[文档](http://ddtalk.github.io/dingTalkDoc/#管理通讯录)
- 后端文件：[链接](https://github.com/open-dingtalk/openapi-demo-java/blob/master/src/com/alibaba/dingtalk/openapi/demo/department)

4.员工的操作
请查看[文档](http://ddtalk.github.io/dingTalkDoc/#管理通讯录)
- 后端文件：[链接](https://github.com/open-dingtalk/openapi-demo-java/blob/master/src/com/alibaba/dingtalk/openapi/demo/user)

5.通讯录事件（比如用户的离职，部门的删除）回调
请查看[文档](http://ddtalk.github.io/dingTalkDoc/#通讯录及群会话变更事件回调接口)
- 后端文件：[链接](https://github.com/open-dingtalk/openapi-demo-java/blob/master/src/com/alibaba/dingtalk/openapi/servlet/EventChangeReceiveServlet.java)

6.发送消息
请查看[文档](http://ddtalk.github.io/dingTalkDoc/#发送普通会话消息)
- 后端文件：[链接](https://github.com/open-dingtalk/openapi-demo-java/blob/master/src/com/alibaba/dingtalk/openapi/demo/message)



eclipse的maven web项目如何运行（使用jetty）
https://blog.csdn.net/xiaobao5214/article/details/52116546
同样打开浏览器输入：http://localhost:8080/ 即可验证web项目是否启动正常。






【JS普通篇】
jquery最新版
http://www.jq22.com/jquery-info122

jQuery ajax跨域请求的解决方法 
https://www.cnblogs.com/freeweb/p/4908832.html

通过Jquery和Ajax初始化加载页面数据
https://blog.csdn.net/sss1342746626/article/details/80270361
https://www.cnblogs.com/lengzhijun/p/4708431.html
https://www.cnblogs.com/wdlhao/p/5360262.html
var _config = <%= //com.alibaba.dingtalk.openapi.demo.auth.AuthHelper.getConfig(request) %>;