Java后端-JavaEE-Java EE应用服务器与容器原理-10

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11

┌─────────────────────────────────────────────────────────────┐
│                    Bootstrap（启动引导层）                   │
├─────────────────────────────────────────────────────────────┤
│                    Module Core（模块核心层）                 │
├─────────────────────────────────────────────────────────────┤
│      Subsystem（子系统层）                                  │
│  ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐      │
│  │ Servlet  │ │   EJB    │ │   JMS    │ │   JPA    │      │
│  │ 子系统   │ │  子系统   │ │  子系统   │ │  子系统   │      │
│  └──────────┘ └──────────┘ └──────────┘ └──────────┘      │
└─────────────────────────────────────────────────────────────┘

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58

<?xml version="1.0" encoding="UTF-8"?>
<web-app xmlns="https://jakarta.ee/xml/ns/jakartaee"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="https://jakarta.ee/xml/ns/jakartaee
         https://jakarta.ee/xml/ns/jakartaee/web-app_6_0.xsd"
         version="6.0">

    <!-- 1. Servlet 配置（覆盖注解） -->
    <servlet>
        <servlet-name>LoginServlet</servlet-name>
        <servlet-class>com.example.LoginServlet</servlet-class>
        <init-param>
            <param-name>encoding</param-name>
            <param-value>UTF-8</param-value>
        </init-param>
        <load-on-startup>1</load-on-startup>
    </servlet>
    <servlet-mapping>
        <servlet-name>LoginServlet</servlet-name>
        <url-pattern>/login</url-pattern>
    </servlet-mapping>

    <!-- 2. 安全约束 -->
    <security-constraint>
        <web-resource-collection>
            <web-resource-name>Admin Area</web-resource-name>
            <url-pattern>/admin/*</url-pattern>
        </web-resource-collection>
        <auth-constraint>
            <role-name>admin</role-name>
        </auth-constraint>
    </security-constraint>

    <!-- 3. 认证方式 -->
    <login-config>
        <auth-method>FORM</auth-method>
        <form-login-config>
            <form-login-page>/login.html</form-login-page>
            <form-error-page>/login-error.html</form-error-page>
        </form-login-config>
    </login-config>

    <!-- 4. 全局参数 -->
    <context-param>
        <param-name>appName</param-name>
        <param-value>MyApp</param-value>
    </context-param>

    <!-- 5. Session 超时 -->
    <session-config>
        <session-timeout>30</session-timeout>
    </session-config>

    <!-- 6. 欢迎页面 -->
    <welcome-file-list>
        <welcome-file>index.html</welcome-file>
    </welcome-file-list>
</web-app>

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45

<?xml version="1.0" encoding="UTF-8"?>
<ejb-jar xmlns="https://jakarta.ee/xml/ns/jakartaee"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="https://jakarta.ee/xml/ns/jakartaee
         https://jakarta.ee/xml/ns/jakartaee/ejb-jar_4_0.xsd"
         version="4.0">

    <!-- 1. 企业 Bean 声明（覆盖注解） -->
    <enterprise-beans>
        <session>
            <ejb-name>OrderService</ejb-name>
            <ejb-class>com.example.OrderService</ejb-class>
            <session-type>Stateless</session-type>
            <transaction-type>Container</transaction-type>
            
            <!-- EJB 局部参数 -->
            <env-entry>
                <env-entry-name>maxRetryCount</env-entry-name>
                <env-entry-type>java.lang.Integer</env-entry-type>
                <env-entry-value>3</env-entry-value>
            </env-entry>
        </session>
    </enterprise-beans>

    <!-- 2. 事务属性（覆盖注解） -->
    <assembly-descriptor>
        <container-transaction>
            <method>
                <ejb-name>OrderService</ejb-name>
                <method-name>createOrder</method-name>
            </method>
            <trans-attribute>Required</trans-attribute>
        </container-transaction>
    </assembly-descriptor>

    <!-- 3. 安全角色 -->
    <assembly-descriptor>
        <security-role>
            <role-name>admin</role-name>
        </security-role>
        <security-role>
            <role-name>user</role-name>
        </security-role>
    </assembly-descriptor>
</ejb-jar>

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28

<?xml version="1.0" encoding="UTF-8"?>
<application xmlns="https://jakarta.ee/xml/ns/jakartaee"
             xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
             xsi:schemaLocation="https://jakarta.ee/xml/ns/jakartaee
             https://jakarta.ee/xml/ns/jakartaee/application_10_0.xsd"
             version="10.0">

    <display-name>My Enterprise Application</display-name>

    <!-- 应用包含的模块 -->
    <module>
        <web>
            <web-uri>myapp-web.war</web-uri>
            <context-root>/myapp</context-root>
        </web>
    </module>
    <module>
        <ejb>myapp-ejb.jar</ejb>
    </module>

    <!-- 安全角色（全局） -->
    <security-role>
        <role-name>admin</role-name>
    </security-role>
    <security-role>
        <role-name>user</role-name>
    </security-role>
</application>

1
2
3
4
5

Bootstrap ClassLoader（启动类加载器）
    ↑ 父
Extension / Platform ClassLoader（扩展/平台类加载器）
    ↑ 父
System / Application ClassLoader（系统/应用类加载器）

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23

┌──────────────────────────────────────────────────────────────────┐
│                    Bootstrap Classloader                        │
│                    （加载 JDK 核心类）               │
├──────────────────────────────────────────────────────────────────┤
│                    System Classloader                           │
│              （加载应用服务器核心类）               │
├──────────────────────────────────────────────────────────────────┤
│                    Common Classloader                           │
│          （加载 domain-dir/lib/ 下的共享库）       │
├──────────────────────────────────────────────────────────────────┤
│                    Connector Classloader                        │
│        （加载连接器模块，所有应用共享）            │
├────────────────────────────┬─────────────────────────────────────┤
│    LifeCycleModule CL      │           EJB Classloader          │
│  （生命周期模块）│    （加载 EJB 模块类）│
│                            │                 ↑ 父               │
│                            │         Web Classloader            │
│                            │    （加载 Web 模块类）│
│                            │                 ↑ 父               │
│                            │       JSP Engine Classloader       │
│                            │    （加载编译后的 JSP 类）         │
│                            │                      │
└────────────────────────────┴─────────────────────────────────────┘

1
2

<class-loader delegate="false"/>  <!-- 本地优先（打破双亲委派） -->
<class-loader delegate="true"/>   <!-- 标准双亲委派（默认） -->

 1
 2
 3
 4
 5
 6
 7
 8
 9
10

<!-- module.xml 示例 -->
<module xmlns="urn:module:1.9" name="com.example.custom">
    <resources>
        <resource-root path="example.jar"/>
    </resources>
    <dependencies>
        <module name="javax.api"/>
        <module name="org.hibernate"/>
    </dependencies>
</module>

1
2
3
4
5
6
7
8

# 方式1：使用 jar 命令
jar -cvf myapp.war *

# 方式2：使用 Maven（pom.xml）
mvn package

# 方式3：使用 Gradle
gradle war

1
2
3
4
5

# 使用 jar 命令
jar -cvf myapp.ear *

# 使用 Maven（pom.xml 中 packaging 为 ear）
mvn package

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13

# 下载并解压
wget https://download.jboss.org/wildfly/26.1.0.Final/wildfly-26.1.0.Final.zip
unzip wildfly-26.1.0.Final.zip
cd wildfly-26.1.0.Final/bin

# 启动服务器（绑定所有 IP）
./standalone.sh -b 0.0.0.0

# 部署应用（复制到部署目录）
cp myapp.war standalone/deployments/

# 使用 CLI 部署
./jboss-cli.sh --connect command="deploy /path/to/myapp.war"

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29

1. 启动脚本（standalone.sh / domain.sh）启动 JVM
         ↓
2. 加载 Bootstrap Classloader → 加载 JDK 核心类
         ↓
3. 加载 System Classloader → 加载服务器核心类
         ↓
4. 解析服务器配置（standalone.xml / domain.xml）
         ↓
5. 初始化核心服务（日志、命名、安全管理器）
         ↓
6. 加载并初始化各子系统（Subsystem）
   - Web 子系统（Undertow）
   - EJB 子系统
   - JMS 子系统
   - JPA 子系统
   - 事务子系统（Narayana）
         ↓
7. 扫描部署目录，发现待部署的应用
         ↓
8. 解析部署描述符（web.xml / ejb-jar.xml / application.xml）
         ↓
9. 创建类加载器（EJB Classloader / Web Classloader）
         ↓
10. 加载应用类，创建并初始化组件实例
    - Servlet 实例化 + init()
    - EJB 实例化 + 依赖注入
    - 注册 JNDI 名称
         ↓
11. 启动完成，监听端口，接受请求

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19

1. 核心服务层（Core Services）
   - 日志（Logging）
   - 命名服务（Naming）
   - 安全管理器（Security Manager）

2. 基础设施层（Infrastructure）
   - 事务管理器（Transaction）
   - 数据源（Datasources）

3. 组件容器层（Component Containers）
   - EJB 容器
   - Web 容器（Undertow）

4. 集成层（Integration）
   - JMS 消息服务
   - JCA 连接器

5. 应用层（Applications）
   - 部署的应用（WAR / EAR）

1

加载类 → 实例化 → init() → service()（多次）→ destroy()

1
2
3

无状态：实例化 → 依赖注入 → @PostConstruct → 业务方法（多次）→ @PreDestroy
有状态：实例化 → 依赖注入 → @PostConstruct → 业务方法 → @Remove → @PreDestroy
单例：实例化 → 依赖注入 → @PostConstruct → 业务方法 → @PreDestroy（应用关闭时）

1
2
3
4
5

@Dependent：随注入者
@RequestScoped：随 HTTP 请求
@SessionScoped：随 HTTP Session
@ApplicationScoped：随应用
@ConversationScoped：手动控制（begin/end）

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16

import javax.naming.InitialContext;
import javax.naming.Context;

public class JndiLookupExample {
    public static void main(String[] args) throws Exception {
        Context ctx = new InitialContext();
        
        // 查找数据源
        DataSource ds = (DataSource) ctx.lookup("java:jboss/datasources/MySQLDS");
        Connection conn = ds.getConnection();
        
        // 查找 EJB（远程）
        OrderService service = (OrderService) ctx.lookup(
            "java:global/myapp/OrderService");
    }
}

1
2
3
4
5
6
7
8

@Stateless
public class MyService {
    @Resource(lookup = "java:jboss/datasources/MySQLDS")
    private DataSource dataSource;
    
    @Resource(lookup = "java:jboss/queue/orderQueue")
    private Queue orderQueue;
}

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13

1. 容器启动，解析配置文件（standalone.xml / domain.xml）
         ↓
2. 根据配置创建服务实例（数据源、连接工厂、JMS 目的地等）
         ↓
3. 将服务实例绑定到 JNDI 名称
         ↓
4. 应用部署时，解析 @Resource 注解
         ↓
5. 通过 JNDI 查找对应的服务实例
         ↓
6. 将服务实例注入到应用的字段或方法参数
         ↓
7. 应用运行时通过注入的实例使用服务

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52

<?xml version="1.0" encoding="UTF-8"?>
<web-app xmlns="https://jakarta.ee/xml/ns/jakartaee"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="https://jakarta.ee/xml/ns/jakartaee
         https://jakarta.ee/xml/ns/jakartaee/web-app_6_0.xsd"
         version="6.0">

    <display-name>MyApp Web Module</display-name>

    <!-- JAX-RS 应用配置 -->
    <servlet>
        <servlet-name>JAXRSApplication</servlet-name>
        <servlet-class>jakarta.ws.rs.core.Application</servlet-class>
    </servlet>
    <servlet-mapping>
        <servlet-name>JAXRSApplication</servlet-name>
        <url-pattern>/api/*</url-pattern>
    </servlet-mapping>

    <!-- 安全约束 -->
    <security-constraint>
        <web-resource-collection>
            <web-resource-name>Admin Resources</web-resource-name>
            <url-pattern>/admin/*</url-pattern>
        </web-resource-collection>
        <auth-constraint>
            <role-name>admin</role-name>
        </auth-constraint>
    </security-constraint>

    <!-- 表单登录配置 -->
    <login-config>
        <auth-method>FORM</auth-method>
        <form-login-config>
            <form-login-page>/login.html</form-login-page>
            <form-error-page>/login-error.html</form-error-page>
        </form-login-config>
    </login-config>

    <!-- 安全角色 -->
    <security-role>
        <role-name>admin</role-name>
    </security-role>
    <security-role>
        <role-name>user</role-name>
    </security-role>

    <!-- Session 超时 -->
    <session-config>
        <session-timeout>30</session-timeout>
    </session-config>
</web-app>

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31

<?xml version="1.0" encoding="UTF-8"?>
<application xmlns="https://jakarta.ee/xml/ns/jakartaee"
             xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
             xsi:schemaLocation="https://jakarta.ee/xml/ns/jakartaee
             https://jakarta.ee/xml/ns/jakartaee/application_10_0.xsd"
             version="10.0">

    <display-name>My Enterprise Application</display-name>

    <!-- 模块列表（加载顺序：按声明顺序） -->
    <module>
        <ejb>myapp-ejb.jar</ejb>
    </module>
    <module>
        <web>
            <web-uri>myapp-web.war</web-uri>
            <context-root>/myapp</context-root>
        </web>
    </module>

    <!-- 安全角色（全局） -->
    <security-role>
        <role-name>admin</role-name>
    </security-role>
    <security-role>
        <role-name>user</role-name>
    </security-role>

    <!-- 库目录（EAR 级共享库） -->
    <library-directory>lib</library-directory>
</application>

1
2
3
4
5
6

# 使用 Maven 构建
cd my-enterprise-app
mvn clean package

# 生成的 EAR 文件位置：
# myapp-ear/target/myapp-ear-1.0.0.ear

1
2

cd wildfly-26.1.0.Final/bin
./standalone.sh -b 0.0.0.0

1
2
3
4
5
6
7
8

# 方式1：复制到部署目录（热部署）
cp myapp-ear-1.0.0.ear wildfly-26.1.0.Final/standalone/deployments/

# 方式2：使用 CLI
./jboss-cli.sh --connect command="deploy /path/to/myapp-ear-1.0.0.ear"

# 方式3：管理控制台
# 访问 http://localhost:9990，上传 EAR 文件

1
2
3
4
5

# 查看部署状态
./jboss-cli.sh --connect command="ls deployment"

# 查看日志
tail -f wildfly-26.1.0.Final/standalone/log/server.log

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36

┌─────────────────────────────────────────────────────────────────────┐
│                        WildFly 应用服务器                          │
│  ┌─────────────────────────────────────────────────────────────┐  │
│  │                     myapp-ear.ear                          │  │
│  │  ┌──────────────────────────────────────────────────────┐   │  │
│  │  │                myapp-ejb.jar                        │   │  │
│  │  │  ┌────────────────────────────────────────────────┐  │   │  │
│  │  │  │  EJB 容器                                      │  │   │  │
│  │  │  │  - UserService (@Stateless)                   │  │   │  │
│  │  │  │  - OrderService (@Stateless)                  │  │   │  │
│  │  │  │  - AuditService (@Stateless)                  │  │   │  │
│  │  │  └────────────────────────────────────────────────┘  │   │  │
│  │  └──────────────────────────────────────────────────────┘   │  │
│  │  ┌──────────────────────────────────────────────────────┐   │  │
│  │  │               myapp-web.war                         │   │  │
│  │  │  ┌────────────────────────────────────────────────┐  │   │  │
│  │  │  │  Web 容器                                      │  │   │  │
│  │  │  │  - LoginServlet                               │  │   │  │
│  │  │  │  - UserResource (JAX-RS)                     │  │   │  │
│  │  │  │  - JSP 页面                                    │  │   │  │
│  │  │  └────────────────────────────────────────────────┘  │   │  │
│  │  └──────────────────────────────────────────────────────┘   │  │
│  │  ┌──────────────────────────────────────────────────────┐   │  │
│  │  │  lib/（共享库）                                      │   │  │
│  │  │  - myapp-common.jar                                │   │  │
│  │  │  - shared-utils.jar                                │   │  │
│  │  └──────────────────────────────────────────────────────┘   │  │
│  └─────────────────────────────────────────────────────────────┘  │
│                                                                   │
│  ┌─────────────────────────────────────────────────────────────┐  │
│  │              核心服务（全局）                                │  │
│  │  - 事务管理器（Narayana）                          │  │
│  │  - 数据源（MySQLDS）                                       │  │
│  │  - JMS 服务（ActiveMQ Artemis）                            │  │
│  └─────────────────────────────────────────────────────────────┘  │
└─────────────────────────────────────────────────────────────────────┘