# webService

**Repository Path**: note-java/web-service

## Basic Information

- **Project Name**: webService
- **Description**: webService的服务端，使用cxf
- **Primary Language**: Java
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2023-05-25
- **Last Updated**: 2025-09-01

## Categories & Tags

**Categories**: Uncategorized

**Tags**: webservice服务端搭建

## README



# Webservice 项目 README

这是一个基于 Spring Boot 的 WebService 服务项目，主要用于提供简单的 Web 服务接口。

## 项目结构

- `WebserviceApplication.java`：Spring Boot 主启动类。
- `AuthInterceptor.java`：用于实现 SOAP 消息的拦截与身份验证逻辑。
- `WsConfig.java`：配置 CXF WebService 的相关 Bean。
- `WebServiceEntity.java`：简单的实体类，封装了用户信息（用户 ID 和密码）。
- `WebServiceTest.java`：定义 WebService 接口。
- `WebServiceTestImpl.java`：实现 WebService 接口的业务逻辑。

## 功能说明

1. **无参接口 `getInfo()`**  
   - 作用：用于测试 WebService 是否正常运行。
   - 返回值：返回字符串 `"hello"`。

2. **有参接口 `requestSend(String webServiceEntity)`**  
   - 作用：接收一个 JSON 格式的字符串参数并解析为 `WebServiceEntity` 对象，随后返回接收到的参数内容。
   - 参数格式：需传入 JSON 字符串，例如：`"{\"userId\":\"123\",\"password\":\"abc"}"`。
   - 返回值：返回 `"接收到了" + 参数内容`。

## 使用技术

- Spring Boot
- Apache CXF 用于 WebService 的构建
- Jackson 用于 JSON 序列化与反序列化
- Maven 作为构建工具

## 配置说明

1. 项目使用 `application.yml` 进行配置（文件暂未在代码地图中找到内容）。
2. WebService 的拦截器 (`AuthInterceptor`) 会在请求处理时进行身份验证。

## 启动方式

1. 使用 Maven 构建项目：
   ```bash
   mvn clean package
   ```
2. 启动服务：
   ```bash
   java -jar target/webservice-0.0.1-SNAPSHOT.jar
   ```

## 测试方式

1. 访问 WSDL：
   - 启动后可以通过 `http://localhost:8080/test?wsdl` 查看 WebService 的 WSDL 文件。

2. 使用 SOAP 客户端测试：
   - 使用 `WebServiceTest` 接口进行测试，可调用 `getInfo()` 和 `requestSend()` 方法。

3. 使用 JUnit 测试：
   - `WebserviceApplicationTests.java` 包含了简单的上下文加载测试，确保 Spring 上下文正常启动。

## 贡献指南

如果你希望为本项目贡献代码，请提交 Pull Request 到本仓库。

## 许可证

本项目遵循 Apache-2.0 许可证。详见 `LICENSE` 文件。

## 注意事项

- 本项目未提供详细的日志配置，需自行补充。
- `application.yml` 文件未在代码地图中体现详细内容，请检查运行环境配置。

如需进一步了解代码实现，可查看具体源码文件。