跳到主要内容

附录

ChatGPT-4o-mini 中英对照 Appendix

XML 模式​

本附录的这一部分列出了与集成技术相关的 XML 架构。

jee 模式​

jee 元素处理与 Jakarta EE（企业版）配置相关的问题，例如查找 JNDI 对象和定义 EJB 引用。

要使用 jee 模式中的元素，您需要在 Spring XML 配置文件的顶部添加以下前言。以下代码段中的文本引用了正确的模式，以便您可以使用 jee 命名空间中的元素：

<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xmlns:jee="http://www.springframework.org/schema/jee"
    xsi:schemaLocation="
        http://www.springframework.org/schema/beans
        https://www.springframework.org/schema/beans/spring-beans.xsd
        http://www.springframework.org/schema/jee
        https://www.springframework.org/schema/jee/spring-jee.xsd">

    <!-- bean definitions here -->

</beans>
xml

(简单)​

以下示例展示了如何使用 JNDI 查找一个数据源，而不使用 jee 模式：

<bean id="dataSource" class="org.springframework.jndi.JndiObjectFactoryBean">
    <property name="jndiName" value="jdbc/MyDataSource"/>
</bean>
<bean id="userDao" class="com.foo.JdbcUserDao">
    <!-- Spring will do the cast automatically (as usual) -->
    <property name="dataSource" ref="dataSource"/>
</bean>
xml

以下示例展示了如何使用 JNDI 查找具有 jee 模式的数据源：

<jee:jndi-lookup id="dataSource" jndi-name="jdbc/MyDataSource"/>

<bean id="userDao" class="com.foo.JdbcUserDao">
    <!-- Spring will do the cast automatically (as usual) -->
    <property name="dataSource" ref="dataSource"/>
</bean>
xml

<jee:jndi-lookup/> （带单个 JNDI 环境设置）​

以下示例展示了如何在不使用 jee 的情况下使用 JNDI 查找环境变量：

<bean id="simple" class="org.springframework.jndi.JndiObjectFactoryBean">
    <property name="jndiName" value="jdbc/MyDataSource"/>
    <property name="jndiEnvironment">
        <props>
            <prop key="ping">pong</prop>
        </props>
    </property>
</bean>
xml

以下示例展示了如何使用 JNDI 查找环境变量，使用 jee：

<jee:jndi-lookup id="simple" jndi-name="jdbc/MyDataSource">
    <jee:environment>ping=pong</jee:environment>
</jee:jndi-lookup>
xml

<jee:jndi-lookup/> （带有多个 JNDI 环境设置）​

以下示例展示了如何在不使用 jee 的情况下使用 JNDI 查找多个环境变量：

<bean id="simple" class="org.springframework.jndi.JndiObjectFactoryBean">
    <property name="jndiName" value="jdbc/MyDataSource"/>
    <property name="jndiEnvironment">
        <props>
            <prop key="sing">song</prop>
            <prop key="ping">pong</prop>
        </props>
    </property>
</bean>
xml

以下示例演示如何使用 JNDI 查找多个环境变量，使用 jee：

<jee:jndi-lookup id="simple" jndi-name="jdbc/MyDataSource">
    <!-- newline-separated, key-value pairs for the environment (standard Properties format) -->
    <jee:environment>
        sing=song
        ping=pong
    </jee:environment>
</jee:jndi-lookup>
xml

<jee:jndi-lookup/> (复杂)​

以下示例展示了如何在不使用 jee 的情况下，使用 JNDI 查找数据源和多个不同的属性：

<bean id="simple" class="org.springframework.jndi.JndiObjectFactoryBean">
    <property name="jndiName" value="jdbc/MyDataSource"/>
    <property name="cache" value="true"/>
    <property name="resourceRef" value="true"/>
    <property name="lookupOnStartup" value="false"/>
    <property name="expectedType" value="com.myapp.DefaultThing"/>
    <property name="proxyInterface" value="com.myapp.Thing"/>
</bean>
xml

以下示例展示了如何使用 JNDI 查找数据源和多个不同属性，使用 jee：

<jee:jndi-lookup id="simple"
        jndi-name="jdbc/MyDataSource"
        cache="true"
        resource-ref="true"
        lookup-on-startup="false"
        expected-type="com.myapp.DefaultThing"
        proxy-interface="com.myapp.Thing"/>
xml

<jee:local-slsb/> (简单)​

<jee:local-slsb/> 元素配置对本地 EJB 无状态会话 Bean 的引用。

以下示例展示了如何配置对本地 EJB 无状态会话 Bean 的引用，而不使用 jee：

<bean id="simple"
        class="org.springframework.ejb.access.LocalStatelessSessionProxyFactoryBean">
    <property name="jndiName" value="ejb/RentalServiceBean"/>
    <property name="businessInterface" value="com.foo.service.RentalService"/>
</bean>
xml

以下示例展示了如何使用 jee 配置对本地 EJB 无状态会话 Bean 的引用：

<jee:local-slsb id="simpleSlsb" jndi-name="ejb/RentalServiceBean"
        business-interface="com.foo.service.RentalService"/>
xml

<jee:local-slsb/> (复杂)​

<jee:local-slsb/> 元素配置对本地 EJB 无状态会话 Bean 的引用。

以下示例展示了如何配置对本地 EJB 无状态会话 Bean 的引用以及一些属性，而不使用 jee：

<bean id="complexLocalEjb"
        class="org.springframework.ejb.access.LocalStatelessSessionProxyFactoryBean">
    <property name="jndiName" value="ejb/RentalServiceBean"/>
    <property name="businessInterface" value="com.example.service.RentalService"/>
    <property name="cacheHome" value="true"/>
    <property name="lookupHomeOnStartup" value="true"/>
    <property name="resourceRef" value="true"/>
</bean>
xml

以下示例展示了如何使用 jee 配置对本地 EJB 无状态会话 Bean 的引用以及一些属性：

<jee:local-slsb id="complexLocalEjb"
        jndi-name="ejb/RentalServiceBean"
        business-interface="com.foo.service.RentalService"
        cache-home="true"
        lookup-home-on-startup="true"
        resource-ref="true">
xml

​

<jee:remote-slsb/> 元素配置对 remote EJB 无状态会话 Bean 的引用。

以下示例展示了如何配置对远程 EJB 无状态会话 Bean 的引用，而不使用 jee：

<bean id="complexRemoteEjb"
        class="org.springframework.ejb.access.SimpleRemoteStatelessSessionProxyFactoryBean">
    <property name="jndiName" value="ejb/MyRemoteBean"/>
    <property name="businessInterface" value="com.foo.service.RentalService"/>
    <property name="cacheHome" value="true"/>
    <property name="lookupHomeOnStartup" value="true"/>
    <property name="resourceRef" value="true"/>
    <property name="homeInterface" value="com.foo.service.RentalService"/>
    <property name="refreshHomeOnConnectFailure" value="true"/>
</bean>
xml

以下示例展示了如何使用 jee 配置对远程 EJB 无状态会话 Bean 的引用：

<jee:remote-slsb id="complexRemoteEjb"
        jndi-name="ejb/MyRemoteBean"
        business-interface="com.foo.service.RentalService"
        cache-home="true"
        lookup-home-on-startup="true"
        resource-ref="true"
        home-interface="com.foo.service.RentalService"
        refresh-home-on-connect-failure="true">
xml

jms 模式​

jms 元素用于配置与 JMS 相关的 bean，例如 Spring 的 消息监听容器。这些元素在 JMS 章节 中的 JMS 命名空间支持 部分有详细说明。有关此支持和 jms 元素本身的完整细节，请参阅该章节。

为了完整性，使用 jms 模式中的元素，您需要在 Spring XML 配置文件的顶部添加以下前言。以下代码片段中的文本引用了正确的模式，以便您可以使用 jms 命名空间中的元素：

<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xmlns:jms="http://www.springframework.org/schema/jms"
    xsi:schemaLocation="
        http://www.springframework.org/schema/beans
        https://www.springframework.org/schema/beans/spring-beans.xsd
        http://www.springframework.org/schema/jms
        https://www.springframework.org/schema/jms/spring-jms.xsd">

    <!-- bean definitions here -->

</beans>
xml

使用 <context:mbean-export/>​

该元素在 基于注解的 MBean 导出配置 中有详细说明。

cache 模式​

您可以使用 cache 元素来启用对 Spring 的 @CacheEvict、@CachePut 和 @Caching 注解的支持。它还支持基于 XML 的声明式缓存。有关详细信息，请参见 启用缓存注解 和 声明式基于 XML 的缓存。

要使用 cache 模式中的元素，您需要在 Spring XML 配置文件的顶部添加以下前言。以下代码片段中的文本引用了正确的模式，以便您可以使用 cache 命名空间中的元素：

<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xmlns:cache="http://www.springframework.org/schema/cache"
    xsi:schemaLocation="
        http://www.springframework.org/schema/beans
        https://www.springframework.org/schema/beans/spring-beans.xsd
        http://www.springframework.org/schema/cache
        https://www.springframework.org/schema/cache/spring-cache.xsd">

    <!-- bean definitions here -->

</beans>
xml