# WSS

**Repository Path**: mutongtech/wss

## Basic Information

- **Project Name**: WSS
- **Description**: 对U9服务进行无侵入式包装,服务接口采用Web API Json的形式
- **Primary Language**: C#
- **License**: GPL-2.0
- **Default Branch**: master
- **Homepage**: https://gitee.com/mutongtech/wss
- **GVP Project**: No

## Statistics

- **Stars**: 9
- **Forks**: 6
- **Created**: 2021-08-17
- **Last Updated**: 2025-07-10

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# WS-Simple

#### 介绍

U9-WSS 全称U9 Web Sample Service。

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

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

#### 版本

1. 2022.01.01   1.0 版本发布
2. 2022.07.31   2.0 版本发布
3. 2022.09.16   2.3 版本发布
4. 2024.04.01   2.7 版本发布
5. 2024.05.01   3.0 版本发布

#### 功能介绍

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

#### 安装教程
    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成功即可。

#### 配置说明

    具体请参照web.config中注释。

#### 使用说明

1.  详见功能说明文档

#### 参与贡献

      无

#### 联系方式

    QQ群：866251081