3.4.0

Author: noear

pom.xml

@@ -7,7 +7,7 @@
     <parent>
         <groupId>org.noear</groupId>
         <artifactId>solon-parent</artifactId>
-        <version>3.3.3</version>
+        <version>3.4.0</version>
         <relativePath />
     </parent>
 
@@ -31,5 +31,6 @@
         <module>solon-jakarta-projects/solon-render/solon-view-jsp-jakarta</module>
 
         <module>solon-jakarta-projects/solon-web/solon-web-servlet-jakarta</module>
+        <module>solon-jakarta-projects/solon-web/solonx-web-webservices-jakarta</module>
     </modules>
 </project>

solon-jakarta-projects/solon-boot/solon-boot-jetty-add-jsp-jakarta/pom.xml

@@ -7,7 +7,7 @@
     <parent>
         <groupId>org.noear</groupId>
         <artifactId>solon-parent</artifactId>
-        <version>3.3.3</version>
+        <version>3.4.0</version>
         <relativePath />
     </parent>
 

solon-jakarta-projects/solon-boot/solon-boot-jetty-jakarta/pom.xml

@@ -7,7 +7,7 @@
     <parent>
         <groupId>org.noear</groupId>
         <artifactId>solon-parent</artifactId>
-        <version>3.3.3</version>
+        <version>3.4.0</version>
         <relativePath />
     </parent>
 

solon-jakarta-projects/solon-boot/solon-boot-undertow-add-jsp-jakarta/pom.xml

@@ -7,7 +7,7 @@
     <parent>
         <groupId>org.noear</groupId>
         <artifactId>solon-parent</artifactId>
-        <version>3.3.3</version>
+        <version>3.4.0</version>
         <relativePath />
     </parent>
 

solon-jakarta-projects/solon-boot/solon-boot-undertow-jakarta/pom.xml

@@ -7,7 +7,7 @@
     <parent>
         <groupId>org.noear</groupId>
         <artifactId>solon-parent</artifactId>
-        <version>3.3.3</version>
+        <version>3.4.0</version>
         <relativePath />
     </parent>
 

solon-jakarta-projects/solon-data/hibernate-jakarta-solon-plugin/pom.xml

@@ -7,7 +7,7 @@
     <parent>
         <groupId>org.noear</groupId>
         <artifactId>solon-parent</artifactId>
-        <version>3.3.3</version>
+        <version>3.4.0</version>
         <relativePath />
     </parent>
 

solon-jakarta-projects/solon-logging/solon-logging-logback-jakarta/pom.xml

@@ -7,7 +7,7 @@
     <parent>
         <groupId>org.noear</groupId>
         <artifactId>solon-parent</artifactId>
-        <version>3.3.3</version>
+        <version>3.4.0</version>
         <relativePath/>
     </parent>
 

solon-jakarta-projects/solon-render/solon-view-jsp-jakarta/pom.xml

@@ -7,7 +7,7 @@
     <parent>
         <groupId>org.noear</groupId>
         <artifactId>solon-parent</artifactId>
-        <version>3.3.3</version>
+        <version>3.4.0</version>
         <relativePath />
     </parent>
 

solon-jakarta-projects/solon-web/solon-web-servlet-jakarta/pom.xml

@@ -7,7 +7,7 @@
     <parent>
         <groupId>org.noear</groupId>
         <artifactId>solon-parent</artifactId>
-        <version>3.3.3</version>
+        <version>3.4.0</version>
         <relativePath />
     </parent>
 

solon-jakarta-projects/solon-web/solonx-web-webservices-jakarta/README.md

@@ -0,0 +1,91 @@
+动手前，先添加 Solon WebServices 插件（暂未发布）：
+
+```xml
+<dependency>
+    <groupId>org.noear</groupId>
+    <artifactId>solonx-webservices</artifactId>
+</dependency>
+```
+
+
+### 1、服务端示例
+
+服务端需要与 solon.boot.jetty、solon.boot.unertow 或者 war 部署方式，配合使用。
+
+* 添加配置（指定 web service 路径段）
+
+```yaml
+server.webservices.path: "/ws/" #默认为 ws
+```
+
+* 添加服务代码
+
+```java
+public class ServerTest {
+    public static void main(String[] args) {
+        Solon.start(ServerTest.class, args);
+    }
+
+    @WebService(serviceName = "HelloService", targetNamespace = "http://demo.solon.io")
+    public static class HelloServiceImpl {
+        public String hello(String name) {
+            return "hello " + name;
+        }
+    }
+}
+```
+
+启动后，可以通过 `http://localhost:8080/ws/HelloService?wsdl` 查看 wsdl 信息。
+
+### 2、客户端示例
+
+* 手写模式
+
+```java
+public class ClientTest {
+    public static void main(String[] args) {
+        String wsAddress = "http://localhost:8080/ws/HelloService";
+        HelloService helloService = WebServiceHelper.createWebClient(wsAddress, HelloService.class);
+
+        System.out.println("rst::" + helloService.hello("noear"));
+    }
+
+    @WebService(serviceName = "HelloService", targetNamespace = "http://demo.solon.io")
+    public interface HelloService {
+        @WebMethod
+        String hello(String name);
+    }
+}
+```
+
+* 容器模式
+
+使用 `@WebServiceReference` 注解，直接注入服务。
+
+```java
+//定义测试控制器
+@Controller
+public static class DemoController {
+    @WebServiceReference("http://localhost:8080/ws/HelloService")
+    private HelloService helloService;
+
+    @Mapping("/test")
+    public String test() {
+        return helloService.hello("noear");
+    }
+}
+
+//配置 WebService 接口
+@WebService(serviceName = "HelloService", targetNamespace = "http://demo.solon.io")
+public interface HelloService {
+    @WebMethod
+    String hello(String name);
+}
+
+//启动 Solon
+public class ClientTest {
+    public static void main(String[] args) {
+        Solon.start(ClientTest2.class, args);
+    }
+}
+```