solon-boot-undertow

此插件，由社区成员（、寒翊）贡献

<dependency>
    <groupId>org.noear</groupId>
    <artifactId>solon-boot-undertow</artifactId>
</dependency>

1、描述

通讯扩展插件，基于 undertow 的http信号服务适配。可用于 Api 开发、Rpc 开发、Mvc web 开发、WebSocket 开发。

undertow 在文件上传时，会先缓存在磁盘，如果空间不够，可以用java.io.tmpdir系统属性换个位置，例：
java -Djava.io.tmpdir=/data/tmp/ -jar demoapp.jar

支持信号：

配套的二级插件：

2、应用示例

Web 示例：

public class DemoApp {
    public static void main(String[] args) {
        Solon.start(DemoApp.class, args);
    }
}

@Controller
public class DemoController{
    @Mapping("/hello")
    public String hello(){
        return "Hello world!";
    }
}

WebSocket 示例：

public class DemoApp {
    public static void main(String[] args) {
        Solon.start(DemoApp.class, args, app->{
            //启用 WebSocket 服务
            app.enableWebSocket(true);
        });
    }
}

@ServerEndpoint("/ws/demo/{id}")
public class WebSocketDemo extends SimpleWebSocketListener {
    @Override
    public void onMessage(WebSocket socket, String text) throws IOException {
        socket.send("我收到了：" + text);
    }
}

更多内容请参考：《Solon WebSocket 开发》

3、添加 ssl 证书配置，启用 https 支持（极少有需求会用到）

server.ssl.keyStore: "/data/_ca/demo.jks" #或 "demo.pfx"
server.ssl.keyPassword: "demo"

更多配置，可参考：《应用常用配置说明》

4、自定义 SSLContext（不走配置，也可以 ssl）

v2.5.9 后支持

public class AppDemo {
    public static void main(String[] args) {
        Solon.start(AppDemo.class, args, app -> {
            SSLContext sslContext = ...;
            app.onEvent(HttpServerConfigure.class, e -> {
                e.enableSsl(true, sslContext);
            });
        });
    }
}

5、启用 http2 （极少有需求会用到）

@SolonMain
public class SeverDemo {
    public static void main(String[] args) {
        Solon.start(SeverDemo.class, args, app -> {
            app.onEvent(HttpServerConfigure.class, e -> {
                e.enableHttp2(true); //v2.3.8 后支持
            });
        });
    }
}

6、添加 http 端口（极少有需求会用到）

一般是在启用 https 或 http2 之后，仍想要有一个 http 端口时，才会使用。 v2.2.18 后支持

@SolonMain
public class SeverDemo {
    public static void main(String[] args) {
        Solon.start(SeverDemo.class, args, app -> {
            app.onEvent(HttpServerConfigure.class, e -> {
                e.addHttpPort(8082);
            });
        });
    }
}