Solon v3.0.3

打包 war(for Servlet 容器)

</> markdown

Solon 是一个强调自启动的框架,原则上是不推荐 war 方式运行(有点过时了)。但总会有需要的时候。

兼容中间件说明
WebLogic
Jboss
WildFly
Tomcat
Jetty
TongWeb东方通(国产)
等...

1、操作指南:

在普通项目增加几项内容即可打 war 包(仍可打 jar 包):

  • 添加 webapp/WEB-INF/web.xml 配置(参考模板里的内容)
  • 添加 solon-web-servlet(for javax)或者 solon-web-servlet-jakarta(for jakarta)插件依赖
  • 使用 solon-maven-plugin 或者 maven-war-plugin 打包

具体模板下载:

2、具体说明:

a) 添加 webapp/WEB-INF/web.xml 配置,把 solonStartClass 的参数值改成 main 函数类

<?xml version="1.0" encoding="UTF-8"?>
<web-app xmlns="http://xmlns.jcp.org/xml/ns/javaee"
		 xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
		 xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/javaee http://xmlns.jcp.org/xml/ns/javaee/web-app_4_0.xsd"
		 version="4.0">
	<display-name>Solon war app</display-name>

	<context-param>
		<param-name>solonMainClass</param-name>
		<param-value>org.example.demo.DemoApp</param-value>
	</context-param>
	
	<listener>
		<listener-class>org.noear.solon.web.servlet.SolonServletContextListener</listener-class>
	</listener>

	<welcome-file-list>
		<welcome-file>/</welcome-file>
	</welcome-file-list>
</web-app>

b) 添加 solon-web-servlet 插件依赖

提供 servlet 容器对接支持。注意下面的包注释说明:

<!-- javax 的用这个包 -->
<dependency>
  <groupId>org.noear</groupId>
  <artifactId>solon-web-servlet</artifactId>
</dependency>

<!-- jakarta 的用这个包(v2.4.1 后支持) -->
<dependency>
    <groupId>org.noear</groupId>
    <artifactId>solon-web-servlet-jakarta</artifactId>
</dependency>

c) 使用 solon-maven-plugin 或者 maven-war-plugin 打包

solon-maven-plugin 同时支持打 jar 和 war(由 packaging 配置指定)

<parent>
    <groupId>org.noear</groupId>
    <artifactId>solon-parent</artifactId>
    <version>${solon.version}</version>
    <relativePath />
</parent>

<packaging>war</packaging>
...
<plugin>
  <groupId>org.noear</groupId>
  <artifactId>solon-maven-plugin</artifactId>
</plugin>

或者 maven-war-plugin,它只支持打 war 包(如果不使用 solon-parent,需要指定插件版本)

<parent>
    <groupId>org.noear</groupId>
    <artifactId>solon-parent</artifactId>
    <version>${solon.version}</version>
    <relativePath />
</parent>

<packaging>war</packaging>
...
<plugin>
  <groupId>org.apache.maven.plugins</groupId>
  <artifactId>maven-war-plugin</artifactId>
</plugin>