U9C WSS项目的学习成果

yujunl2026-10-12 8:29

从一个用友U9的一个客开高手学习了WSS开发技巧，积累了不少可用于实际工作的经验值。记录一下它的优秀所在。

U9-WSS 全称U9 Web Sample Service。

WSS对U9服务进行无侵入式包装,采用Web API Json的服务架构。

WSS部署简单、快速应用、可灵活、按需扩展。

功能介绍

支持U9 5.0、U9 6.0、U9 Cloud等版本。
统一的调用路径，支持调用BP、SV、轻量化服务。
统一的请求格式及数据返回格式。
统一的异常处理机制。
采用Newtonsoft.Json进行消息序列化。
采用Log4Net记录服务的调用日志及数据库日志(DBLog)功能。
提供多种认证方式。
支持代理服务调用白名单。
通过灵活的配置，可支持不同的应用场景。
提供代理测试工具(ProxyTool)
提供自定义代理功能。自定义代理无需构建服务模型，全代码实现，支持热加载

安装教程

复制代码

1.	服务器安装.net framework 4.5及以上和WCF相关功能。

2.	将发布文件中Portal文件夹覆盖到U9安装目录中Portal。
    发布目录	        名称	        说明
    Portal/wss/	web.config	配置文件
                Proxy.svc	通用代理服务入口
	            ProxyTest.svc	代理测试工具服务入口
	            AuthService.svc	认证服务入口
	            System.svc	系统服务
	            Common.svc	通用服务
	            accessProxy.config	代理服务的调用白名单
				CustomProxy	自定义代理存放目录
    Portal/bin/	UFIDA.U9.WSS.ProxyService.dll	通用代理服务dll
                UFIDA.U9.WSS.ProxyService.pdb	通用代理服务pdb
                UFIDA.U9.WSS.ProxyTestService.dll	代理测试工具服务dll
	            UFIDA.U9.WSS.ProxyTestService.pdb	代理测试工具服务pdb
	            UFIDA.U9.WSS.SystemService.dll	系统服务，提供获取企业、获取语言、获取用户组织、登录等功能
	        	UFIDA.U9.WSS.SystemService.pdb	系统服务pdb
	            UFIDA.U9.WSS.CommonService.dll	通用服务，提供实体查询、SQL查询等功能
	            UFIDA.U9.WSS.CommonService.pdb	通用服务pdb
	            UFIDA.U9.WSS.Proxy.Json.dll	代理测试工具Json解析dll
	            UFIDA.U9.WSS.Proxy.Json.pdb	代理测试工具Json解析pdb
	            UFIDA.U9.WSS.DBLog.dll	数据库日志功能dll
	            UFIDA.U9.WSS.DBLog.pdb	数据库日志功能pdb

3.	如需要启用DBLog功能，需安装DBLog相关的U9补丁。
4.	浏览器中访问http://服务器地址/U9(C)/wss/proxy.svc成功即可。