致远OA——自定义开发rest接口

最新推荐文章于 2025-08-23 19:36:46 发布

原创最新推荐文章于 2025-08-23 19:36:46 发布 · 959 阅读

5 ·

CC 4.0 BY-SA版权

文章标签：

#java #tomcat #spring #经验分享

文章目录

- :apple: 业务流程

🍎 业务流程

代码案例： https://pan.quark.cn/s/57fa808c823f
官方文档：

登录系统 —— 后台管理 —— 切换系统管理员 —— 信息集成配置 —— rest用户管理 —— 新建

在这里插入图片描述

根据上面生成的用户名和密码，发送请求获取 token，后续用于访问自己的定义的 `rest`` 接口使用。

官方文档如下：

在这里插入图片描述

我们自己进行测试获取：
在这里插入图片描述

注意：上面的 token 失效只有十五分钟。

在这里插入图片描述

自定 rest 接口：

根据官方文档，提供的案例我们进行自己的 rest 接口开发，下面是官方文档案例：
在这里插入图片描述

注意：这里我们定义的 rest 接口的包位置一定要放在 com.seeyon.ctp.rest.resources 包的下面。项目是按照一定规则去加载的，如果包名不一致是加载不到的，接口是访问不到的。

在这里插入图片描述

package com.seeyon.ctp.rest.resources;

import java.util.Map;

import javax.ws.rs.Consumes;
import javax.ws.rs.GET;
import javax.ws.rs.POST;
import javax.ws.rs.Path;
import javax.ws.rs.Produces;
import javax.ws.rs.QueryParam;
import javax.ws.rs.core.Response;

import org.apache.commons.logging.Log;
import org.apache.commons.logging.LogFactory;

import com.seeyon.apps.ext.HaiKangDataSysn.manager.HaiKangAllDataSysnManager;
import com.seeyon.ctp.common.AppContext;
import com.seeyon.ctp.common.exceptions.BusinessException;
import com.seeyon.ctp.services.ServiceException;
import com.seeyon.ctp.util.annotation.RestInterfaceAnnotation;

@Path("/custmerBtnRest")
@Produces({ "application/json", "application/xml" })
public class CustmerBtnRestResource extends BaseResource {
	private static final Log log = LogFactory.getLog(CustmerBtnRestResource.class);
	private HaiKangAllDataSysnManager HaiKangAllDataSysnManager=(HaiKangAllDataSysnManager) AppContext.getBean("HaiKangAllDataSysnManager");

	@GET
	@Consumes({ "application/xml", "application/json" })
	@Path("findHaiKangData")
	@RestInterfaceAnnotation
	public Response findHaiKangData(@QueryParam("type") String type) throws ServiceException {
		HaiKangAllDataSysnManager.sysnAllDataToOA(Integer.valueOf(type));
		return success("ok");
		
	}


	@POST
	@Path("finishaffair")
	@Consumes({ "application/xml", "application/json" })
	@RestInterfaceAnnotation
	public Response finishaffair(Map<String, String> param) throws BusinessException {

		return this.ok(Boolean.valueOf(true));
	}

}

将开发好的接口编译成 .class 文件，替换到项目中，重新启动项目常识访问我们的接口即可。访问前需要添加请求头，将我们前面获取到的 token 放到请求头中：

请求头：

key	value
token	d07f4800-6835-4edc-8ff8-d3eff936b91b
Accept	application/json
Content-Type	application/json;charset=UTF-8
User-Agent	Mozilla/5.0 (Windows NT 6.2; WOW64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/32.0.1700.76 Safari/537.36

在这里插入图片描述