# mulesoft Spring Module - Full Documentation

<!-- document id=ed8fb2f765eb100ffa1b2c9b1c46953b6932f9928e1a0f965414ad9bd5be6b11 url=/mulesoft/current/ja-jp/spring-module/1.3/index.md -->

# Spring Module

Spring Module v1.3

Spring Module により、Mule アプリケーションで Spring Framework を使用できます。

リリースノート: [Spring Module リリースノート](https://docs.mulesoft.com/jp/release-notes/connector/spring-module-release-notes)​  
Exchange: [Spring Module](https://www.mulesoft.com/exchange/org.mule.modules/mule-spring-module/)

## [](#プロジェクトへの-spring-module-の追加)プロジェクトへの Spring Module の追加

Anypoint Studio 7 では、デフォルト設定で Spring Module が提供されます。

**\[Mule Palette (Mule パレット)\]**​ で、「Spring」を検索し、Authorization Filter 操作を Studio キャンバスにドラッグします。

## [](#spring-module-を設定する)Spring Module を設定する

1. 次の設定を追加します。
    
    ```xml
    <?xml version="1.0" encoding="UTF-8"?>
    
    <mule xmlns:spring="http://www.mulesoft.org/schema/mule/spring"
          xmlns="http://www.mulesoft.org/schema/mule/core"
          xmlns:doc="http://www.mulesoft.org/schema/mule/documentation"
          xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
          xsi:schemaLocation="http://www.mulesoft.org/schema/mule/core
            http://www.mulesoft.org/schema/mule/core/current/mule.xsd
            http://www.mulesoft.org/schema/mule/spring
            http://www.mulesoft.org/schema/mule/spring/current/mule-spring.xsd">
    
        <spring:config name="springConfig" files="beans.xml" />
    
    </mule>
    ```
2. `beans.xml`​ ファイルを ​`src/main/resources`​ に格納します。
    
    Spring 設定が有効でなければなりません。beans.xml ファイルの例を次に示します。
    
    ```xml
    <beans xmlns="http://www.springframework.org/schema/beans"
        xmlns:context="http://www.springframework.org/schema/context"
        xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
        xmlns:jdbc="http://www.springframework.org/schema/jdbc"
    
        xsi:schemaLocation="http://www.springframework.org/schema/beans
          http://www.springframework.org/schema/beans/spring-beans-4.2.xsd
          http://www.springframework.org/schema/jdbc
          http://www.springframework.org/schema/jdbc/spring-jdbc-4.2.xsd
          http://www.springframework.org/schema/context
          http://www.springframework.org/schema/context/spring-context-4.2.xsd
          http://www.springframework.org/schema/security
          http://www.springframework.org/schema/security/spring-security-4.2.xsd">
    
        <jdbc:embedded-database id="dataSource" type="DERBY">
            <jdbc:script location="classpath:db/sql/create-db.sql" />
            <jdbc:script location="classpath:db/sql/insert-data.sql" />
        </jdbc:embedded-database>
    
    </beans>
    ```

アプリケーションを起動するには、Spring Module で使用する beans ファイルをエクスポートする必要があります。​[「リソースのエクスポート方法」](https://docs.mulesoft.com/mule-runtime/latest/how-to-export-resources)​を参照してください。

Anypoint Studio 7.2 以降を使用している場合、​`mule-artifact.json`​ ファイルを手動で更新する必要はありません。

Mule では、Spring bean が宣言される記述子も必要であるため、Studio 内の埋め込みパッケージャーにより、プロジェクトから取得するすべてのリソースを使用して自動的に生成されます。ただし、エクスポートする必要のあるリソースを宣言する場合、Studio によってそれらのリソースのみがパッケージ化されます。

次の例では、​`mule-artifact.json`​ で ​`beans.xml`​ ファイルを宣言できるようにしています。

```example
{
    "name": "MyApp",
    "minMuleVersion": "4.2.1",
    "classLoaderModelLoaderDescriptor": {
        "id": "mule",
        "attributes": {
            "exportedResources": [
                "/org/mule/myapp/beans.xml"
            ]
        }
    }
  }
}
```

## [](#mule-コンポーネントの-spring-オブジェクト)Mule コンポーネントの Spring オブジェクト

次のように Spring オブジェクトを Mule 設定コンポーネントで使用することで、たとえば、Spring Bean で作成した Derby データソースを参照できます。

```xml
<?xml version="1.0" encoding="UTF-8"?>

<mule xmlns:db="http://www.mulesoft.org/schema/mule/db"
      xmlns:spring="http://www.mulesoft.org/schema/mule/spring"
      xmlns="http://www.mulesoft.org/schema/mule/core"
      xmlns:doc="http://www.mulesoft.org/schema/mule/documentation"
      xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
      xsi:schemaLocation="http://www.mulesoft.org/schema/mule/core
        http://www.mulesoft.org/schema/mule/core/current/mule.xsd
        http://www.mulesoft.org/schema/mule/spring
        http://www.mulesoft.org/schema/mule/spring/current/mule-spring.xsd
        http://www.mulesoft.org/schema/mule/db
        http://www.mulesoft.org/schema/mule/db/current/mule-db.xsd">

    <spring:config name="springConfig" files="beans.xml" />

    <db:config name="derbyConfig" doc:name="Database Config"  >
        <db:derby-connection database="datasource" create="true" />
    </db:config>
</mule>
```

## [](#spring-プロパティプレースホルダー)Spring プロパティプレースホルダー

Spring プロパティプレースホルダーで定義されたプロパティを Mule アプリケーション内で使用することはできません。これらは、Spring 設定ファイルでのみ使用できます。ただし、Mule で ​`<configuration-properties/>`​ を使用して定義したプロパティは、Spring 設定ファイルで使用できます。

## [](#spring-オブジェクトの制限)Spring オブジェクトの制限

Spring Module を使用するには、実装と挿入の制限を考慮してください。

- Spring オブジェクトでは、Mule API ライフサイクルメソッドを実装することはできません。
- Spring オブジェクトは、Mule API サービスでは挿入できません。使用できる唯一のサービスは ​`org.mule.runtime.api.artifact.Registry`​ で、Mule API 内の他のすべてのサービスへのアクセスに使用できます。この場合は、​`@PostConstruct`​ をメソッドに対して使用することで、オブジェクトを初期化して Mule API サービスを取得します。

## [](#spring-セキュリティのセキュリティマネージャーとしての使用)Spring セキュリティのセキュリティマネージャーとしての使用

<table><tbody><tr><td class="icon"><i class="fa icon-important" title="Important"></i></td><td class="content">プレーンテキストのパスワードで Spring Framework 5.x を使用している場合は、パスワード値の先頭に ​<code>{noop}</code>​ を付ける必要があります。たとえば、パスワード ​<code>admin</code>​ は ​<code>{noop}admin</code>​ になります。</td></tr></tbody></table>

Spring Module では、Spring セキュリティを Mule アプリケーションのセキュリティマネージャーとして使用できます。 Spring 設定ファイルで認証マネージャーを定義する必要があります。

```xml
<beans xmlns="http://www.springframework.org/schema/beans"
  xmlns:context="http://www.springframework.org/schema/context"
  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  xmlns:jdbc="http://www.springframework.org/schema/jdbc"
  xmlns:ss="http://www.springframework.org/schema/security"

  xsi:schemaLocation="http://www.springframework.org/schema/beans
      http://www.springframework.org/schema/beans/spring-beans-4.2.xsd
      http://www.springframework.org/schema/jdbc
      http://www.springframework.org/schema/jdbc/spring-jdbc-4.2.xsd
      http://www.springframework.org/schema/context
      http://www.springframework.org/schema/context/spring-context-4.2.xsd
      http://www.springframework.org/schema/security
      http://www.springframework.org/schema/security/spring-security-4.2.xsd">

  <ss:authentication-manager alias="authenticationManager">
    <ss:authentication-provider>
      <ss:user-service id="userService">
        <ss:user name="admin" password="admin" authorities="ROLE_ADMIN" />
        <ss:user name="joe" password="secret" authorities="ROLE_ADMIN" />
        <ss:user name="anon" password="anon" authorities="ROLE_ANON" />
        <ss:user name="user" password="password" authorities="ROLE_ANON" />
        <ss:user name="ross" password="ross" authorities="ROLE_ANON" />
        <ss:user name="marie" password="marie" authorities="ROLE_ANON" />
      </ss:user-service>
    </ss:authentication-provider>
  </ss:authentication-manager>

</beans>
```

Spring 認証マネージャーを活用した Mule アプリケーションのセキュリティマネージャーは、次のように定義できます。

```xml
<?xml version="1.0" encoding="UTF-8"?>
<mule
  xmlns:spring="http://www.mulesoft.org/schema/mule/spring"
  xmlns="http://www.mulesoft.org/schema/mule/core"
  xmlns:doc="http://www.mulesoft.org/schema/mule/documentation"
  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  xsi:schemaLocation="http://www.springframework.org/schema/beans
    http://www.springframework.org/schema/beans/spring-beans-current.xsd
    http://www.mulesoft.org/schema/mule/core
    http://www.mulesoft.org/schema/mule/core/current/mule.xsd
    http://www.mulesoft.org/schema/mule/spring
    http://www.mulesoft.org/schema/mule/spring/current/mule-spring.xsd">

  <spring:config name="springConfig" files="beans.xml" />

  <spring:security-manager>
    <spring:delegate-security-provider
      name="memory-provider"
      delegate-ref="authenticationManager" />
  </spring:security-manager>

</mule>
```

## [](#spring_auth_filter)Spring 認証検索条件を使用した認証の検証

Spring Module は、Mule セキュリティマネージャーを使用して認証を検証できない場合に失敗する検索条件をサポートします。

```xml
<?xml version="1.0" encoding="UTF-8"?>
<mule
  xmlns:http="http://www.mulesoft.org/schema/mule/http"
  xmlns:db="http://www.mulesoft.org/schema/mule/db"
  xmlns:spring="http://www.mulesoft.org/schema/mule/spring"
  xmlns="http://www.mulesoft.org/schema/mule/core"
  xmlns:doc="http://www.mulesoft.org/schema/mule/documentation"
  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  xsi:schemaLocation="http://www.springframework.org/schema/beans
    http://www.springframework.org/schema/beans/spring-beans-current.xsd
    http://www.mulesoft.org/schema/mule/core
    http://www.mulesoft.org/schema/mule/core/current/mule.xsd
    http://www.mulesoft.org/schema/mule/spring
    http://www.mulesoft.org/schema/mule/spring/current/mule-spring.xsd
    http://www.mulesoft.org/schema/mule/db
    http://www.mulesoft.org/schema/mule/db/current/mule-db.xsd
    http://www.mulesoft.org/schema/mule/http
    http://www.mulesoft.org/schema/mule/http/current/mule-http.xsd">

  <spring:config name="springConfig" files="beans.xml" />

  <spring:security-manager>
    <spring:delegate-security-provider
      name="memory-provider"
      delegate-ref="authenticationManager" />
  </spring:security-manager>

  <http:listener-config
    name="HTTP_Listener_config"
     doc:name="HTTP Listener config"  >
      <http:listener-connection
        host="0.0.0.0"
        port="9090" />
  </http:listener-config>

  <flow name="spring-exampleFlow"  >
    <http:listener
      config-ref="HTTP_Listener_config"
      path="/"
      doc:name="Listener"  />
    <http:basic-security-filter
      realm="mule" />
      <spring:authorization-filter
        requiredAuthorities="ROLE_ADMIN" />
  </flow>
</mule>
```

`http:basic-security-filter`​ は、基本認証を使用してユーザーを認証しようとします。認証に成功すると、Mule はユーザー名を取得し、Spring の ​`authorization-filter`​ で使用してそのユーザーを検索し、ROLE\_ADMIN 権限で要求を認証しようとします。

## [](#関連情報)関連情報

- [Mule アプリケーションのプロパティプレースホルダー](https://docs.mulesoft.com/mule-runtime/latest/configuring-properties)
- [Mule 4 への Spring Module の移行](https://docs.mulesoft.com/mule-runtime/latest/)
- [MuleSoft ヘルプセンター](https://help.mulesoft.com)

<!-- document id=85635001b9e8363d448b4adbfcb7fc6ec0d65ad189ea60ec5f7ff597f75b60d3 url=/mulesoft/current/ja-jp/spring-module/1.4/index.md -->

# Spring Module 1.4

Spring Module により、Mule アプリケーションで Spring Framework を使用できます。

リリースノート: [Spring Module リリースノート](https://docs.mulesoft.com/jp/release-notes/connector/spring-module-release-notes)​  
Exchange: [Spring Module](https://www.mulesoft.com/exchange/org.mule.modules/mule-spring-module/)

## [](#プロジェクトへの-spring-module-の追加)プロジェクトへの Spring Module の追加

Anypoint Studio 7 では、デフォルト設定で Spring Module が提供されます。

**\[Mule Palette (Mule パレット)\]**​ で、「Spring」を検索し、Authorization Filter 操作を Studio キャンバスにドラッグします。

## [](#spring-module-を設定する)Spring Module を設定する

1. 次の設定を追加します。
    
    ```xml
    <?xml version="1.0" encoding="UTF-8"?>
    
    <mule xmlns:spring="http://www.mulesoft.org/schema/mule/spring"
          xmlns="http://www.mulesoft.org/schema/mule/core"
          xmlns:doc="http://www.mulesoft.org/schema/mule/documentation"
          xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
          xsi:schemaLocation="http://www.mulesoft.org/schema/mule/core
            http://www.mulesoft.org/schema/mule/core/current/mule.xsd
            http://www.mulesoft.org/schema/mule/spring
            http://www.mulesoft.org/schema/mule/spring/current/mule-spring.xsd">
    
        <spring:config name="springConfig" files="beans.xml" />
    
    </mule>
    ```
2. `beans.xml`​ ファイルを ​`src/main/resources`​ に格納します。
    
    Spring 設定が有効でなければなりません。beans.xml ファイルの例を次に示します。
    
    ```xml
    <beans xmlns="http://www.springframework.org/schema/beans"
        xmlns:context="http://www.springframework.org/schema/context"
        xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
        xmlns:jdbc="http://www.springframework.org/schema/jdbc"
    
        xsi:schemaLocation="http://www.springframework.org/schema/beans
          http://www.springframework.org/schema/beans/spring-beans-4.2.xsd
          http://www.springframework.org/schema/jdbc
          http://www.springframework.org/schema/jdbc/spring-jdbc-4.2.xsd
          http://www.springframework.org/schema/context
          http://www.springframework.org/schema/context/spring-context-4.2.xsd
          http://www.springframework.org/schema/security
          http://www.springframework.org/schema/security/spring-security-4.2.xsd">
    
        <jdbc:embedded-database id="dataSource" type="DERBY">
            <jdbc:script location="classpath:db/sql/create-db.sql" />
            <jdbc:script location="classpath:db/sql/insert-data.sql" />
        </jdbc:embedded-database>
    
    </beans>
    ```

アプリケーションを起動するには、Spring Module で使用する beans ファイルをエクスポートする必要があります。​[「リソースのエクスポート方法」](https://docs.mulesoft.com/mule-runtime/latest/how-to-export-resources)​を参照してください。

Anypoint Studio 7.2 以降を使用している場合、​`mule-artifact.json`​ ファイルを手動で更新する必要はありません。

Mule では、Spring bean が宣言される記述子も必要であるため、Studio 内の埋め込みパッケージャーにより、プロジェクトから取得するすべてのリソースを使用して自動的に生成されます。ただし、エクスポートする必要のあるリソースを宣言する場合、Studio によってそれらのリソースのみがパッケージ化されます。

次の例では、​`mule-artifact.json`​ で ​`beans.xml`​ ファイルを宣言できるようにしています。

```example
{
    "name": "MyApp",
    "minMuleVersion": "4.2.1",
    "classLoaderModelLoaderDescriptor": {
        "id": "mule",
        "attributes": {
            "exportedResources": [
                "/org/mule/myapp/beans.xml"
            ]
        }
    }
  }
}
```

## [](#mule-コンポーネントの-spring-オブジェクト)Mule コンポーネントの Spring オブジェクト

次のように Spring オブジェクトを Mule 設定コンポーネントで使用することで、たとえば、Spring Bean で作成した Derby データソースを参照できます。

```xml
<?xml version="1.0" encoding="UTF-8"?>

<mule xmlns:db="http://www.mulesoft.org/schema/mule/db"
      xmlns:spring="http://www.mulesoft.org/schema/mule/spring"
      xmlns="http://www.mulesoft.org/schema/mule/core"
      xmlns:doc="http://www.mulesoft.org/schema/mule/documentation"
      xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
      xsi:schemaLocation="http://www.mulesoft.org/schema/mule/core
        http://www.mulesoft.org/schema/mule/core/current/mule.xsd
        http://www.mulesoft.org/schema/mule/spring
        http://www.mulesoft.org/schema/mule/spring/current/mule-spring.xsd
        http://www.mulesoft.org/schema/mule/db
        http://www.mulesoft.org/schema/mule/db/current/mule-db.xsd">

    <spring:config name="springConfig" files="beans.xml" />

    <db:config name="derbyConfig" doc:name="Database Config"  >
        <db:derby-connection database="datasource" create="true" />
    </db:config>
</mule>
```

## [](#spring-プロパティプレースホルダー)Spring プロパティプレースホルダー

Spring プロパティプレースホルダーで定義されたプロパティを Mule アプリケーション内で使用することはできません。これらは、Spring 設定ファイルでのみ使用できます。ただし、Mule で ​`<configuration-properties/>`​ を使用して定義したプロパティは、Spring 設定ファイルで使用できます。

## [](#spring-オブジェクトの制限)Spring オブジェクトの制限

Spring Module を使用するには、実装と挿入の制限を考慮してください。

- Spring オブジェクトでは、Mule API ライフサイクルメソッドを実装することはできません。
- Spring オブジェクトは、Mule API サービスでは挿入できません。使用できる唯一のサービスは ​`org.mule.runtime.api.artifact.Registry`​ で、Mule API 内の他のすべてのサービスへのアクセスに使用できます。この場合は、​`@PostConstruct`​ をメソッドに対して使用することで、オブジェクトを初期化して Mule API サービスを取得します。

## [](#spring-セキュリティのセキュリティマネージャーとしての使用)Spring セキュリティのセキュリティマネージャーとしての使用

<table><tbody><tr><td class="icon"><i class="fa icon-important" title="Important"></i></td><td class="content">プレーンテキストのパスワードで Spring Framework 5.x を使用している場合は、パスワード値の先頭に ​<code>{noop}</code>​ を付ける必要があります。たとえば、パスワード ​<code>admin</code>​ は ​<code>{noop}admin</code>​ になります。</td></tr></tbody></table>

Spring Module では、Spring セキュリティを Mule アプリケーションのセキュリティマネージャーとして使用できます。 Spring 設定ファイルで認証マネージャーを定義する必要があります。

```xml
<beans xmlns="http://www.springframework.org/schema/beans"
  xmlns:context="http://www.springframework.org/schema/context"
  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  xmlns:jdbc="http://www.springframework.org/schema/jdbc"
  xmlns:ss="http://www.springframework.org/schema/security"

  xsi:schemaLocation="http://www.springframework.org/schema/beans
      http://www.springframework.org/schema/beans/spring-beans-4.2.xsd
      http://www.springframework.org/schema/jdbc
      http://www.springframework.org/schema/jdbc/spring-jdbc-4.2.xsd
      http://www.springframework.org/schema/context
      http://www.springframework.org/schema/context/spring-context-4.2.xsd
      http://www.springframework.org/schema/security
      http://www.springframework.org/schema/security/spring-security-4.2.xsd">

  <ss:authentication-manager alias="authenticationManager">
    <ss:authentication-provider>
      <ss:user-service id="userService">
        <ss:user name="admin" password="admin" authorities="ROLE_ADMIN" />
        <ss:user name="joe" password="secret" authorities="ROLE_ADMIN" />
        <ss:user name="anon" password="anon" authorities="ROLE_ANON" />
        <ss:user name="user" password="password" authorities="ROLE_ANON" />
        <ss:user name="ross" password="ross" authorities="ROLE_ANON" />
        <ss:user name="marie" password="marie" authorities="ROLE_ANON" />
      </ss:user-service>
    </ss:authentication-provider>
  </ss:authentication-manager>

</beans>
```

Spring 認証マネージャーを活用した Mule アプリケーションのセキュリティマネージャーは、次のように定義できます。

```xml
<?xml version="1.0" encoding="UTF-8"?>
<mule
  xmlns:spring="http://www.mulesoft.org/schema/mule/spring"
  xmlns="http://www.mulesoft.org/schema/mule/core"
  xmlns:doc="http://www.mulesoft.org/schema/mule/documentation"
  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  xsi:schemaLocation="http://www.springframework.org/schema/beans
    http://www.springframework.org/schema/beans/spring-beans-current.xsd
    http://www.mulesoft.org/schema/mule/core
    http://www.mulesoft.org/schema/mule/core/current/mule.xsd
    http://www.mulesoft.org/schema/mule/spring
    http://www.mulesoft.org/schema/mule/spring/current/mule-spring.xsd">

  <spring:config name="springConfig" files="beans.xml" />

  <spring:security-manager>
    <spring:delegate-security-provider
      name="memory-provider"
      delegate-ref="authenticationManager" />
  </spring:security-manager>

</mule>
```

## [](#spring_auth_filter)Spring 認証検索条件を使用した認証の検証

Spring Module は、Mule セキュリティマネージャーを使用して認証を検証できない場合に失敗する検索条件をサポートします。

```xml
<?xml version="1.0" encoding="UTF-8"?>
<mule
  xmlns:http="http://www.mulesoft.org/schema/mule/http"
  xmlns:db="http://www.mulesoft.org/schema/mule/db"
  xmlns:spring="http://www.mulesoft.org/schema/mule/spring"
  xmlns="http://www.mulesoft.org/schema/mule/core"
  xmlns:doc="http://www.mulesoft.org/schema/mule/documentation"
  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  xsi:schemaLocation="http://www.springframework.org/schema/beans
    http://www.springframework.org/schema/beans/spring-beans-current.xsd
    http://www.mulesoft.org/schema/mule/core
    http://www.mulesoft.org/schema/mule/core/current/mule.xsd
    http://www.mulesoft.org/schema/mule/spring
    http://www.mulesoft.org/schema/mule/spring/current/mule-spring.xsd
    http://www.mulesoft.org/schema/mule/db
    http://www.mulesoft.org/schema/mule/db/current/mule-db.xsd
    http://www.mulesoft.org/schema/mule/http
    http://www.mulesoft.org/schema/mule/http/current/mule-http.xsd">

  <spring:config name="springConfig" files="beans.xml" />

  <spring:security-manager>
    <spring:delegate-security-provider
      name="memory-provider"
      delegate-ref="authenticationManager" />
  </spring:security-manager>

  <http:listener-config
    name="HTTP_Listener_config"
     doc:name="HTTP Listener config"  >
      <http:listener-connection
        host="0.0.0.0"
        port="9090" />
  </http:listener-config>

  <flow name="spring-exampleFlow"  >
    <http:listener
      config-ref="HTTP_Listener_config"
      path="/"
      doc:name="Listener"  />
    <http:basic-security-filter
      realm="mule" />
      <spring:authorization-filter
        requiredAuthorities="ROLE_ADMIN" />
  </flow>
</mule>
```

`http:basic-security-filter`​ は、基本認証を使用してユーザーを認証しようとします。認証に成功すると、Mule はユーザー名を取得し、Spring の ​`authorization-filter`​ で使用してそのユーザーを検索し、ROLE\_ADMIN 権限で要求を認証しようとします。

## [](#関連情報)関連情報

- [Mule アプリケーションのプロパティプレースホルダー](https://docs.mulesoft.com/mule-runtime/latest/configuring-properties)
- [Mule 4 への Spring Module の移行](https://docs.mulesoft.com/mule-runtime/latest/)
- [MuleSoft ヘルプセンター](https://help.mulesoft.com)

<!-- document id=bb4dce68141e7897388929c84fc6c649e3ab6d74f0f96ed1bb76378ce13210c7 url=/mulesoft/current/ja-jp/spring-module/1.4/spring-module-reference.md -->

# Spring Module 1.4 リファレンス

Spring Module により、Mule アプリケーションで Spring Framework を使用できます。

## [](#設定)設定

* * *

### [](#config)設定

一連の spring XML ファイルを定義したり、Mule アーティファクトで使用するオブジェクトを使用してアプリケーションコンテキストを作成できるようにする Spring 設定。

#### [](#パラメーター)パラメーター

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 20%;">
<col style="width: 35%;">
<col style="width: 20%;">
<col style="width: 5%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">名前</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Name (名前)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>この設定の名前。コネクタはこの名前の設定を参照します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Files (ファイル)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Spring bean ファイル。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
</tbody>
</table>

## [](#操作)操作

### [](#authorization-filter)Authorization Filter

`<spring:authorization-filter>`

必要な認証機関のセットに対してユーザーを認証します。

#### [](#パラメーター-2)パラメーター

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 20%;">
<col style="width: 35%;">
<col style="width: 20%;">
<col style="width: 5%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">名前</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Required Authorities (必要な認証機関)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>ユーザーにフローへの追加のアクセス権 (​<code>ROLE_ADMIN</code>​ や ​<code>ROLE_USER</code>​ など) を付与する認証機関。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
</tbody>
</table>

#### [](#スロー)スロー

- MULE:NOT\_PERMITTED
- MULE:SERVER\_SECURITY

## [](#型)型

### [](#DelegateSecurityProvider)Delegate Security Provider (代理セキュリティプロバイダー)

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 25%;">
<col style="width: 30%;">
<col style="width: 15%;">
<col style="width: 10%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">項目</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Name (名前)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>参照するプロバイダー名。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Delegate Ref (代理参照)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Spring セキュリティマネージャー。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
</tbody>
</table>

## [](#関連情報)関連情報

- [MuleSoft ヘルプセンター](https://help.mulesoft.com)

<!-- document id=376921a6e14c4a1ef8234044086348eb500bd3a65a22bd3f82eaa6898616c93b url=/mulesoft/current/ja-jp/spring-module/1.5/index.md -->

# Spring Module 1.5

Spring Module により、Mule アプリケーションで Spring Framework を使用できます。

リリースノート: [Spring Module リリースノート](https://docs.mulesoft.com/jp/release-notes/connector/spring-module-release-notes)​  
Exchange: [Spring Module](https://www.mulesoft.com/exchange/org.mule.modules/mule-spring-module/)

## [](#プロジェクトへの-spring-module-の追加)プロジェクトへの Spring Module の追加

Anypoint Studio 7 では、デフォルト設定で Spring Module が提供されます。

**\[Mule Palette (Mule パレット)\]**​ で、「Spring」を検索し、Authorization Filter 操作を Studio キャンバスにドラッグします。

## [](#spring-module-を設定する)Spring Module を設定する

1. 次の設定を追加します。
    
    ```xml
    <?xml version="1.0" encoding="UTF-8"?>
    
    <mule xmlns:spring="http://www.mulesoft.org/schema/mule/spring"
          xmlns="http://www.mulesoft.org/schema/mule/core"
          xmlns:doc="http://www.mulesoft.org/schema/mule/documentation"
          xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
          xsi:schemaLocation="http://www.mulesoft.org/schema/mule/core
            http://www.mulesoft.org/schema/mule/core/current/mule.xsd
            http://www.mulesoft.org/schema/mule/spring
            http://www.mulesoft.org/schema/mule/spring/current/mule-spring.xsd">
    
        <spring:config name="springConfig" files="beans.xml" />
    
    </mule>
    ```
2. `beans.xml`​ ファイルを ​`src/main/resources`​ に格納します。
    
    Spring 設定が有効でなければなりません。beans.xml ファイルの例を次に示します。
    
    ```xml
    <beans xmlns="http://www.springframework.org/schema/beans"
        xmlns:context="http://www.springframework.org/schema/context"
        xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
        xmlns:jdbc="http://www.springframework.org/schema/jdbc"
    
        xsi:schemaLocation="http://www.springframework.org/schema/beans
          http://www.springframework.org/schema/beans/spring-beans-4.2.xsd
          http://www.springframework.org/schema/jdbc
          http://www.springframework.org/schema/jdbc/spring-jdbc-4.2.xsd
          http://www.springframework.org/schema/context
          http://www.springframework.org/schema/context/spring-context-4.2.xsd
          http://www.springframework.org/schema/security
          http://www.springframework.org/schema/security/spring-security-4.2.xsd">
    
        <jdbc:embedded-database id="dataSource" type="DERBY">
            <jdbc:script location="classpath:db/sql/create-db.sql" />
            <jdbc:script location="classpath:db/sql/insert-data.sql" />
        </jdbc:embedded-database>
    
    </beans>
    ```

アプリケーションを起動するには、Spring Module で使用する beans ファイルをエクスポートする必要があります。​[「リソースのエクスポート方法」](https://docs.mulesoft.com/mule-runtime/latest/how-to-export-resources)​を参照してください。

Anypoint Studio 7.2 以降を使用している場合、​`mule-artifact.json`​ ファイルを手動で更新する必要はありません。

Mule では、Spring bean が宣言される記述子も必要であるため、Studio 内の埋め込みパッケージャーにより、プロジェクトから取得するすべてのリソースを使用して自動的に生成されます。ただし、エクスポートする必要のあるリソースを宣言する場合、Studio によってそれらのリソースのみがパッケージ化されます。

次の例では、​`mule-artifact.json`​ で ​`beans.xml`​ ファイルを宣言できるようにしています。

```example
{
    "name": "MyApp",
    "minMuleVersion": "4.2.1",
    "classLoaderModelLoaderDescriptor": {
        "id": "mule",
        "attributes": {
            "exportedResources": [
                "/org/mule/myapp/beans.xml"
            ]
        }
    }
  }
}
```

## [](#mule-コンポーネントの-spring-オブジェクト)Mule コンポーネントの Spring オブジェクト

次のように Spring オブジェクトを Mule 設定コンポーネントで使用することで、たとえば、Spring Bean で作成した Derby データソースを参照できます。

```xml
<?xml version="1.0" encoding="UTF-8"?>

<mule xmlns:db="http://www.mulesoft.org/schema/mule/db"
      xmlns:spring="http://www.mulesoft.org/schema/mule/spring"
      xmlns="http://www.mulesoft.org/schema/mule/core"
      xmlns:doc="http://www.mulesoft.org/schema/mule/documentation"
      xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
      xsi:schemaLocation="http://www.mulesoft.org/schema/mule/core
        http://www.mulesoft.org/schema/mule/core/current/mule.xsd
        http://www.mulesoft.org/schema/mule/spring
        http://www.mulesoft.org/schema/mule/spring/current/mule-spring.xsd
        http://www.mulesoft.org/schema/mule/db
        http://www.mulesoft.org/schema/mule/db/current/mule-db.xsd">

    <spring:config name="springConfig" files="beans.xml" />

    <db:config name="derbyConfig" doc:name="Database Config"  >
        <db:derby-connection database="datasource" create="true" />
    </db:config>
</mule>
```

## [](#spring-プロパティプレースホルダー)Spring プロパティプレースホルダー

Spring プロパティプレースホルダーで定義されたプロパティを Mule アプリケーション内で使用することはできません。これらは、Spring 設定ファイルでのみ使用できます。ただし、Mule で ​`<configuration-properties/>`​ を使用して定義したプロパティは、Spring 設定ファイルで使用できます。

## [](#spring-オブジェクトの制限)Spring オブジェクトの制限

Spring Module を使用するには、実装と挿入の制限を考慮してください。

- Spring オブジェクトでは、Mule API ライフサイクルメソッドを実装することはできません。
- Spring オブジェクトは、Mule API サービスでは挿入できません。使用できる唯一のサービスは ​`org.mule.runtime.api.artifact.Registry`​ で、Mule API 内の他のすべてのサービスへのアクセスに使用できます。この場合は、​`@PostConstruct`​ をメソッドに対して使用することで、オブジェクトを初期化して Mule API サービスを取得します。

## [](#spring-セキュリティのセキュリティマネージャーとしての使用)Spring セキュリティのセキュリティマネージャーとしての使用

<table><tbody><tr><td class="icon"><i class="fa icon-important" title="Important"></i></td><td class="content">プレーンテキストのパスワードで Spring Framework 5.x を使用している場合は、パスワード値の先頭に ​<code>{noop}</code>​ を付ける必要があります。たとえば、パスワード ​<code>admin</code>​ は ​<code>{noop}admin</code>​ になります。</td></tr></tbody></table>

Spring Module では、Spring セキュリティを Mule アプリケーションのセキュリティマネージャーとして使用できます。 Spring 設定ファイルで認証マネージャーを定義する必要があります。

```xml
<beans xmlns="http://www.springframework.org/schema/beans"
  xmlns:context="http://www.springframework.org/schema/context"
  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  xmlns:jdbc="http://www.springframework.org/schema/jdbc"
  xmlns:ss="http://www.springframework.org/schema/security"

  xsi:schemaLocation="http://www.springframework.org/schema/beans
      http://www.springframework.org/schema/beans/spring-beans-4.2.xsd
      http://www.springframework.org/schema/jdbc
      http://www.springframework.org/schema/jdbc/spring-jdbc-4.2.xsd
      http://www.springframework.org/schema/context
      http://www.springframework.org/schema/context/spring-context-4.2.xsd
      http://www.springframework.org/schema/security
      http://www.springframework.org/schema/security/spring-security-4.2.xsd">

  <ss:authentication-manager alias="authenticationManager">
    <ss:authentication-provider>
      <ss:user-service id="userService">
        <ss:user name="admin" password="admin" authorities="ROLE_ADMIN" />
        <ss:user name="joe" password="secret" authorities="ROLE_ADMIN" />
        <ss:user name="anon" password="anon" authorities="ROLE_ANON" />
        <ss:user name="user" password="password" authorities="ROLE_ANON" />
        <ss:user name="ross" password="ross" authorities="ROLE_ANON" />
        <ss:user name="marie" password="marie" authorities="ROLE_ANON" />
      </ss:user-service>
    </ss:authentication-provider>
  </ss:authentication-manager>

</beans>
```

Spring 認証マネージャーを活用した Mule アプリケーションのセキュリティマネージャーは、次のように定義できます。

```xml
<?xml version="1.0" encoding="UTF-8"?>
<mule
  xmlns:spring="http://www.mulesoft.org/schema/mule/spring"
  xmlns="http://www.mulesoft.org/schema/mule/core"
  xmlns:doc="http://www.mulesoft.org/schema/mule/documentation"
  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  xsi:schemaLocation="http://www.springframework.org/schema/beans
    http://www.springframework.org/schema/beans/spring-beans-current.xsd
    http://www.mulesoft.org/schema/mule/core
    http://www.mulesoft.org/schema/mule/core/current/mule.xsd
    http://www.mulesoft.org/schema/mule/spring
    http://www.mulesoft.org/schema/mule/spring/current/mule-spring.xsd">

  <spring:config name="springConfig" files="beans.xml" />

  <spring:security-manager>
    <spring:delegate-security-provider
      name="memory-provider"
      delegate-ref="authenticationManager" />
  </spring:security-manager>

</mule>
```

## [](#spring_auth_filter)Spring 認証検索条件を使用した認証の検証

Spring Module は、Mule セキュリティマネージャーを使用して認証を検証できない場合に失敗する検索条件をサポートします。

```xml
<?xml version="1.0" encoding="UTF-8"?>
<mule
  xmlns:http="http://www.mulesoft.org/schema/mule/http"
  xmlns:db="http://www.mulesoft.org/schema/mule/db"
  xmlns:spring="http://www.mulesoft.org/schema/mule/spring"
  xmlns="http://www.mulesoft.org/schema/mule/core"
  xmlns:doc="http://www.mulesoft.org/schema/mule/documentation"
  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  xsi:schemaLocation="http://www.springframework.org/schema/beans
    http://www.springframework.org/schema/beans/spring-beans-current.xsd
    http://www.mulesoft.org/schema/mule/core
    http://www.mulesoft.org/schema/mule/core/current/mule.xsd
    http://www.mulesoft.org/schema/mule/spring
    http://www.mulesoft.org/schema/mule/spring/current/mule-spring.xsd
    http://www.mulesoft.org/schema/mule/db
    http://www.mulesoft.org/schema/mule/db/current/mule-db.xsd
    http://www.mulesoft.org/schema/mule/http
    http://www.mulesoft.org/schema/mule/http/current/mule-http.xsd">

  <spring:config name="springConfig" files="beans.xml" />

  <spring:security-manager>
    <spring:delegate-security-provider
      name="memory-provider"
      delegate-ref="authenticationManager" />
  </spring:security-manager>

  <http:listener-config
    name="HTTP_Listener_config"
     doc:name="HTTP Listener config"  >
      <http:listener-connection
        host="0.0.0.0"
        port="9090" />
  </http:listener-config>

  <flow name="spring-exampleFlow"  >
    <http:listener
      config-ref="HTTP_Listener_config"
      path="/"
      doc:name="Listener"  />
    <http:basic-security-filter
      realm="mule" />
      <spring:authorization-filter
        requiredAuthorities="ROLE_ADMIN" />
  </flow>
</mule>
```

`http:basic-security-filter`​ は、基本認証を使用してユーザーを認証しようとします。認証に成功すると、Mule はユーザー名を取得し、Spring の ​`authorization-filter`​ で使用してそのユーザーを検索し、ROLE\_ADMIN 権限で要求を認証しようとします。

## [](#関連情報)関連情報

- [Mule アプリケーションのプロパティプレースホルダー](https://docs.mulesoft.com/mule-runtime/latest/configuring-properties)
- [Mule 4 への Spring Module の移行](https://docs.mulesoft.com/mule-runtime/latest/)
- [MuleSoft ヘルプセンター](https://help.mulesoft.com)

<!-- document id=1866046fdb090e246759a717d3f35755051e5a496f13537340a352f07bfbe115 url=/mulesoft/current/ja-jp/spring-module/1.5/spring-module-reference.md -->

# Spring Module 1.5 リファレンス

Spring Module により、Mule アプリケーションで Spring Framework を使用できます。

## [](#設定)設定

* * *

### [](#config)設定

一連の spring XML ファイルを定義したり、Mule アーティファクトで使用するオブジェクトを使用してアプリケーションコンテキストを作成できるようにする Spring 設定。

#### [](#パラメーター)パラメーター

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 20%;">
<col style="width: 35%;">
<col style="width: 20%;">
<col style="width: 5%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">名前</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Name (名前)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>この設定の名前。コネクタはこの名前の設定を参照します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Files (ファイル)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Spring bean ファイル。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
</tbody>
</table>

## [](#操作)操作

### [](#authorization-filter)Authorization Filter

`<spring:authorization-filter>`

必要な認証機関のセットに対してユーザーを認証します。

#### [](#パラメーター-2)パラメーター

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 20%;">
<col style="width: 35%;">
<col style="width: 20%;">
<col style="width: 5%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">名前</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Required Authorities (必要な認証機関)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>ユーザーにフローへの追加のアクセス権 (​<code>ROLE_ADMIN</code>​ や ​<code>ROLE_USER</code>​ など) を付与する認証機関。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
</tbody>
</table>

#### [](#スロー)スロー

- MULE:NOT\_PERMITTED
- MULE:SERVER\_SECURITY

## [](#型)型

### [](#DelegateSecurityProvider)Delegate Security Provider (代理セキュリティプロバイダー)

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 25%;">
<col style="width: 30%;">
<col style="width: 15%;">
<col style="width: 10%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">項目</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Name (名前)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>参照するプロバイダー名。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Delegate Ref (代理参照)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Spring セキュリティマネージャー。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
</tbody>
</table>

## [](#関連情報)関連情報

- [MuleSoft ヘルプセンター](https://help.mulesoft.com)

<!-- document id=da8dab9597e842ecd2e18c050d9ce614d35c0d10996f3cdfdc9169abd5f32cd5 url=/mulesoft/current/ja-jp/spring-module/2.0/index.md -->

# Spring Module 2.0

Spring Module により、Mule アプリケーションで Spring Framework を使用できます。

リリースノート: [Spring Module リリースノート](https://docs.mulesoft.com/jp/release-notes/connector/spring-module-release-notes)​  
Exchange: [Spring Module](https://www.mulesoft.com/exchange/org.mule.modules/mule-spring-module/)

## [](#プロジェクトへの-spring-module-の追加)プロジェクトへの Spring Module の追加

Anypoint Studio 7 では、デフォルト設定で Spring Module が提供されます。

**\[Mule Palette (Mule パレット)\]**​ で、「Spring」を検索し、Authorization Filter 操作を Studio キャンバスにドラッグします。

## [](#spring-module-を設定する)Spring Module を設定する

1. 次の設定を追加します。
    
    ```xml
    <?xml version="1.0" encoding="UTF-8"?>
    
    <mule xmlns:spring="http://www.mulesoft.org/schema/mule/spring"
          xmlns="http://www.mulesoft.org/schema/mule/core"
          xmlns:doc="http://www.mulesoft.org/schema/mule/documentation"
          xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
          xsi:schemaLocation="http://www.mulesoft.org/schema/mule/core
            http://www.mulesoft.org/schema/mule/core/current/mule.xsd
            http://www.mulesoft.org/schema/mule/spring
            http://www.mulesoft.org/schema/mule/spring/current/mule-spring.xsd">
    
        <spring:config name="springConfig" files="beans.xml" />
    
    </mule>
    ```
2. `beans.xml`​ ファイルを ​`src/main/resources`​ に格納します。
    
    Spring 設定が有効でなければなりません。beans.xml ファイルの例を次に示します。
    
    ```xml
    <beans xmlns="http://www.springframework.org/schema/beans"
        xmlns:context="http://www.springframework.org/schema/context"
        xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
        xmlns:jdbc="http://www.springframework.org/schema/jdbc"
    
        xsi:schemaLocation="http://www.springframework.org/schema/beans
          http://www.springframework.org/schema/beans/spring-beans-4.2.xsd
          http://www.springframework.org/schema/jdbc
          http://www.springframework.org/schema/jdbc/spring-jdbc-4.2.xsd
          http://www.springframework.org/schema/context
          http://www.springframework.org/schema/context/spring-context-4.2.xsd
          http://www.springframework.org/schema/security
          http://www.springframework.org/schema/security/spring-security-4.2.xsd">
    
        <jdbc:embedded-database id="dataSource" type="DERBY">
            <jdbc:script location="classpath:db/sql/create-db.sql" />
            <jdbc:script location="classpath:db/sql/insert-data.sql" />
        </jdbc:embedded-database>
    
    </beans>
    ```

アプリケーションを起動するには、Spring Module で使用する beans ファイルをエクスポートする必要があります。​[「リソースのエクスポート方法」](https://docs.mulesoft.com/mule-runtime/latest/how-to-export-resources)​を参照してください。

Anypoint Studio 7.2 以降を使用している場合、​`mule-artifact.json`​ ファイルを手動で更新する必要はありません。

Mule では、Spring bean が宣言される記述子も必要であるため、Studio 内の埋め込みパッケージャーにより、プロジェクトから取得するすべてのリソースを使用して自動的に生成されます。ただし、エクスポートする必要のあるリソースを宣言する場合、Studio によってそれらのリソースのみがパッケージ化されます。

次の例では、​`mule-artifact.json`​ で ​`beans.xml`​ ファイルを宣言できるようにしています。

```example
{
    "name": "MyApp",
    "minMuleVersion": "4.2.1",
    "classLoaderModelLoaderDescriptor": {
        "id": "mule",
        "attributes": {
            "exportedResources": [
                "/org/mule/myapp/beans.xml"
            ]
        }
    }
  }
}
```

## [](#mule-コンポーネントの-spring-オブジェクト)Mule コンポーネントの Spring オブジェクト

次のように Spring オブジェクトを Mule 設定コンポーネントで使用することで、たとえば、Spring Bean で作成した Derby データソースを参照できます。

```xml
<?xml version="1.0" encoding="UTF-8"?>

<mule xmlns:db="http://www.mulesoft.org/schema/mule/db"
      xmlns:spring="http://www.mulesoft.org/schema/mule/spring"
      xmlns="http://www.mulesoft.org/schema/mule/core"
      xmlns:doc="http://www.mulesoft.org/schema/mule/documentation"
      xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
      xsi:schemaLocation="http://www.mulesoft.org/schema/mule/core
        http://www.mulesoft.org/schema/mule/core/current/mule.xsd
        http://www.mulesoft.org/schema/mule/spring
        http://www.mulesoft.org/schema/mule/spring/current/mule-spring.xsd
        http://www.mulesoft.org/schema/mule/db
        http://www.mulesoft.org/schema/mule/db/current/mule-db.xsd">

    <spring:config name="springConfig" files="beans.xml" />

    <db:config name="derbyConfig" doc:name="Database Config"  >
        <db:derby-connection database="datasource" create="true" />
    </db:config>
</mule>
```

## [](#spring-プロパティプレースホルダー)Spring プロパティプレースホルダー

Spring プロパティプレースホルダーで定義されたプロパティを Mule アプリケーション内で使用することはできません。これらは、Spring 設定ファイルでのみ使用できます。ただし、Mule で ​`<configuration-properties/>`​ を使用して定義したプロパティは、Spring 設定ファイルで使用できます。

## [](#spring-オブジェクトの制限)Spring オブジェクトの制限

Spring Module を使用するには、実装と挿入の制限を考慮してください。

- Spring オブジェクトでは、Mule API ライフサイクルメソッドを実装することはできません。
- Spring オブジェクトは、Mule API サービスでは挿入できません。使用できる唯一のサービスは ​`org.mule.runtime.api.artifact.Registry`​ で、Mule API 内の他のすべてのサービスへのアクセスに使用できます。この場合は、​`@PostConstruct`​ をメソッドに対して使用することで、オブジェクトを初期化して Mule API サービスを取得します。

## [](#spring-セキュリティのセキュリティマネージャーとしての使用)Spring セキュリティのセキュリティマネージャーとしての使用

<table><tbody><tr><td class="icon"><i class="fa icon-important" title="Important"></i></td><td class="content">プレーンテキストのパスワードで Spring Framework 5.x を使用している場合は、パスワード値の先頭に ​<code>{noop}</code>​ を付ける必要があります。たとえば、パスワード ​<code>admin</code>​ は ​<code>{noop}admin</code>​ になります。</td></tr></tbody></table>

Spring Module では、Spring セキュリティを Mule アプリケーションのセキュリティマネージャーとして使用できます。 Spring 設定ファイルで認証マネージャーを定義する必要があります。

```xml
<beans xmlns="http://www.springframework.org/schema/beans"
  xmlns:context="http://www.springframework.org/schema/context"
  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  xmlns:jdbc="http://www.springframework.org/schema/jdbc"
  xmlns:ss="http://www.springframework.org/schema/security"

  xsi:schemaLocation="http://www.springframework.org/schema/beans
      http://www.springframework.org/schema/beans/spring-beans-4.2.xsd
      http://www.springframework.org/schema/jdbc
      http://www.springframework.org/schema/jdbc/spring-jdbc-4.2.xsd
      http://www.springframework.org/schema/context
      http://www.springframework.org/schema/context/spring-context-4.2.xsd
      http://www.springframework.org/schema/security
      http://www.springframework.org/schema/security/spring-security-4.2.xsd">

  <ss:authentication-manager alias="authenticationManager">
    <ss:authentication-provider>
      <ss:user-service id="userService">
        <ss:user name="admin" password="admin" authorities="ROLE_ADMIN" />
        <ss:user name="joe" password="secret" authorities="ROLE_ADMIN" />
        <ss:user name="anon" password="anon" authorities="ROLE_ANON" />
        <ss:user name="user" password="password" authorities="ROLE_ANON" />
        <ss:user name="ross" password="ross" authorities="ROLE_ANON" />
        <ss:user name="marie" password="marie" authorities="ROLE_ANON" />
      </ss:user-service>
    </ss:authentication-provider>
  </ss:authentication-manager>

</beans>
```

Spring 認証マネージャーを活用した Mule アプリケーションのセキュリティマネージャーは、次のように定義できます。

```xml
<?xml version="1.0" encoding="UTF-8"?>
<mule
  xmlns:spring="http://www.mulesoft.org/schema/mule/spring"
  xmlns="http://www.mulesoft.org/schema/mule/core"
  xmlns:doc="http://www.mulesoft.org/schema/mule/documentation"
  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  xsi:schemaLocation="http://www.springframework.org/schema/beans
    http://www.springframework.org/schema/beans/spring-beans-current.xsd
    http://www.mulesoft.org/schema/mule/core
    http://www.mulesoft.org/schema/mule/core/current/mule.xsd
    http://www.mulesoft.org/schema/mule/spring
    http://www.mulesoft.org/schema/mule/spring/current/mule-spring.xsd">

  <spring:config name="springConfig" files="beans.xml" />

  <spring:security-manager>
    <spring:delegate-security-provider
      name="memory-provider"
      delegate-ref="authenticationManager" />
  </spring:security-manager>

</mule>
```

## [](#spring_auth_filter)Spring 認証検索条件を使用した認証の検証

Spring Module は、Mule セキュリティマネージャーを使用して認証を検証できない場合に失敗する検索条件をサポートします。

```xml
<?xml version="1.0" encoding="UTF-8"?>
<mule
  xmlns:http="http://www.mulesoft.org/schema/mule/http"
  xmlns:db="http://www.mulesoft.org/schema/mule/db"
  xmlns:spring="http://www.mulesoft.org/schema/mule/spring"
  xmlns="http://www.mulesoft.org/schema/mule/core"
  xmlns:doc="http://www.mulesoft.org/schema/mule/documentation"
  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  xsi:schemaLocation="http://www.springframework.org/schema/beans
    http://www.springframework.org/schema/beans/spring-beans-current.xsd
    http://www.mulesoft.org/schema/mule/core
    http://www.mulesoft.org/schema/mule/core/current/mule.xsd
    http://www.mulesoft.org/schema/mule/spring
    http://www.mulesoft.org/schema/mule/spring/current/mule-spring.xsd
    http://www.mulesoft.org/schema/mule/db
    http://www.mulesoft.org/schema/mule/db/current/mule-db.xsd
    http://www.mulesoft.org/schema/mule/http
    http://www.mulesoft.org/schema/mule/http/current/mule-http.xsd">

  <spring:config name="springConfig" files="beans.xml" />

  <spring:security-manager>
    <spring:delegate-security-provider
      name="memory-provider"
      delegate-ref="authenticationManager" />
  </spring:security-manager>

  <http:listener-config
    name="HTTP_Listener_config"
     doc:name="HTTP Listener config"  >
      <http:listener-connection
        host="0.0.0.0"
        port="9090" />
  </http:listener-config>

  <flow name="spring-exampleFlow"  >
    <http:listener
      config-ref="HTTP_Listener_config"
      path="/"
      doc:name="Listener"  />
    <http:basic-security-filter
      realm="mule" />
      <spring:authorization-filter
        requiredAuthorities="ROLE_ADMIN" />
  </flow>
</mule>
```

`http:basic-security-filter`​ は、基本認証を使用してユーザーを認証しようとします。認証に成功すると、Mule はユーザー名を取得し、Spring の ​`authorization-filter`​ で使用してそのユーザーを検索し、ROLE\_ADMIN 権限で要求を認証しようとします。

## [](#関連情報)関連情報

- [Mule アプリケーションのプロパティプレースホルダー](https://docs.mulesoft.com/mule-runtime/latest/configuring-properties)
- [Mule 4 への Spring Module の移行](https://docs.mulesoft.com/mule-runtime/latest/)
- [MuleSoft ヘルプセンター](https://help.mulesoft.com)

<!-- document id=79e64fc5b45d5a26a680d8977672594bae9a80e7ada591f7590dd070e3dfc5e6 url=/mulesoft/current/ja-jp/spring-module/2.0/spring-module-reference.md -->

# Spring Module 2.0 リファレンス

Spring Module により、Mule アプリケーションで Spring Framework を使用できます。

## [](#設定)設定

* * *

### [](#config)設定

一連の spring XML ファイルを定義したり、Mule アーティファクトで使用するオブジェクトを使用してアプリケーションコンテキストを作成できるようにする Spring 設定。

#### [](#パラメーター)パラメーター

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 20%;">
<col style="width: 35%;">
<col style="width: 20%;">
<col style="width: 5%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">名前</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Name (名前)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>この設定の名前。コネクタはこの名前の設定を参照します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Files (ファイル)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Spring bean ファイル。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Name (名前)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>他のコンポーネント内のこの要素を参照するために使用するこの要素の識別子。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
</tbody>
</table>

## [](#操作)操作

### [](#authorization-filter)Authorization Filter

`<spring:authorization-filter>`

必要な認証機関のセットに対してユーザーを認証します。

#### [](#パラメーター-2)パラメーター

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 20%;">
<col style="width: 35%;">
<col style="width: 20%;">
<col style="width: 5%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">名前</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Required Authorities (必要な認証機関)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>ユーザーにフローへの追加のアクセス権 (​<code>ROLE_ADMIN</code>​ や ​<code>ROLE_USER</code>​ など) を付与する認証機関。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>エラーのマッピング</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="#ErrorMapping">エラーのマッピング</a>​ の配列</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>エラーのマッピングのセット。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
</tr>
</tbody>
</table>

#### [](#スロー)スロー

- MULE:NOT\_PERMITTED
- MULE:SERVER\_SECURITY

## [](#型)型

### [](#ErrorMapping)エラーのマッピング

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 25%;">
<col style="width: 30%;">
<col style="width: 15%;">
<col style="width: 10%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-middle">項目</th>
<th class="tableblock halign-left valign-middle">型</th>
<th class="tableblock halign-left valign-middle">説明</th>
<th class="tableblock halign-left valign-middle">デフォルト値</th>
<th class="tableblock halign-left valign-middle">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-middle"><p class="tableblock">Source (ソース)</p></td>
<td class="tableblock halign-left valign-middle"><div class="content"><div class="paragraph">
<p>Enumeration (列挙)。次のいずれかになります。</p>
</div>
<div class="ulist">
<ul>
<li>
<p>ANY</p>
</li>
<li>
<p>REDELIVERY_EXHAUSTED</p>
</li>
<li>
<p>TRANSFORMATION</p>
</li>
<li>
<p>EXPRESSION</p>
</li>
<li>
<p>SECURITY</p>
</li>
<li>
<p>CLIENT_SECURITY</p>
</li>
<li>
<p>SERVER_SECURITY</p>
</li>
<li>
<p>ROUTING</p>
</li>
<li>
<p>CONNECTIVITY</p>
</li>
<li>
<p>RETRY_EXHAUSTED</p>
</li>
<li>
<p>TIMEOUT</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-middle"><p class="tableblock">エラーのソース。</p></td>
<td class="tableblock halign-left valign-middle"></td>
<td class="tableblock halign-left valign-middle"></td>
</tr>
<tr>
<td class="tableblock halign-left valign-middle"><p class="tableblock">Target (対象)</p></td>
<td class="tableblock halign-left valign-middle"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-middle"><p class="tableblock">エラーの対象。</p></td>
<td class="tableblock halign-left valign-middle"></td>
<td class="tableblock halign-left valign-middle"><p class="tableblock">x</p></td>
</tr>
</tbody>
</table>

### [](#DelegateSecurityProvider)Delegate Security Provider (代理セキュリティプロバイダー)

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 25%;">
<col style="width: 30%;">
<col style="width: 15%;">
<col style="width: 10%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">項目</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Name (名前)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>参照するプロバイダー名。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Delegate Ref (代理参照)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Spring セキュリティマネージャー。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
</tbody>
</table>

## [](#関連情報)関連情報

- [MuleSoft ヘルプセンター](https://help.mulesoft.com)

<!-- document id=d5b8a94481981b5b25bb819211bd16e5567b8b2ba95f1acde60fa084a88feb0c url=/mulesoft/current/ja-jp/spring-module/1.3/spring-xml-maven.md -->

# Spring Module の XML と Maven のサポート

XML で Mule アプリケーションを手動でコーディングすることもできますが、Anypoint Studio を使用した方が効率的です。

Anypoint Studio の XML エディターまたはテキストエディターから Mule Runtime Engine (Mule) アプリケーションを手動でコーディングする場合、参照ステートメントを XML Mule フローと Apache Maven ​`pom.xml`​ ファイルの両方に追加することで、アプリケーションでコネクタにアクセスできます。

コネクタを Studio に追加すると、Studio は自動的に XML コードにコネクタの名前空間およびスキーマの場所を入力します。さらに、​`pom.xml`​ ファイルに連動関係を追加します。

## [](#コネクタの名前空間の追加)コネクタの名前空間の追加

次のコードを設定 XML のヘッダーの ​`<mule>`​ タグ内に貼り付けます。

```xml
http://www.mulesoft.org/schema/mule/spring
http://www.mulesoft.org/schema/mule/spring/current/mule-spring.xsd
```

次の例は、​`<mule>`​ XML ブロック内に名前空間ステートメントが配置される方法を示しています。

```xml
<mule xmlns:spring="http://www.mulesoft.org/schema/mule/spring"
	xmlns:ee="http://www.mulesoft.org/schema/mule/ee/core"
	xmlns:http="http://www.mulesoft.org/schema/mule/http"
	xmlns:file="http://www.mulesoft.org/schema/mule/file"
	xmlns="http://www.mulesoft.org/schema/mule/core"
	xmlns:doc="http://www.mulesoft.org/schema/mule/documentation"
	xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
	xsi:schemaLocation="http://www.mulesoft.org/schema/mule/core
	http://www.mulesoft.org/schema/mule/core/current/mule.xsd
	http://www.mulesoft.org/schema/mule/file
	http://www.mulesoft.org/schema/mule/file/current/mule-file.xsd
	http://www.mulesoft.org/schema/mule/http
	http://www.mulesoft.org/schema/mule/http/current/mule-http.xsd
	http://www.mulesoft.org/schema/mule/ee/core
	http://www.mulesoft.org/schema/mule/ee/core/current/mule-ee.xsd
	http://www.mulesoft.org/schema/mule/spring
	http://www.mulesoft.org/schema/mule/spring/current/mule-spring.xsd">
```

## [](#pom-ファイルの連動関係の追加)POM ファイルの連動関係の追加

Apache Maven ​`pom.xml`​ ファイルは Anypoint Studio によって生成され、Mule アプリケーションの連動関係が含まれます。Mule アプリケーションを手動でコーディングする場合、次の XML スニペットを ​`pom.xml`​ ファイルに含めてこのコネクタにアクセスできるようにします:

```xml
<dependency>
  <groupId>org.mule.modules</groupId>
  <artifactId>mule-spring-module</artifactId>
  <version>x.x.x</version>
  <classifier>mule-plugin</classifier>
</dependency>
```

`x.x.x`​ を使用しているコネクタに対応するバージョンに置き換えます。

最新の ​`pom.xml`​ ファイル情報を取得する手順は、次のとおりです。

1. [Anypoint Exchange](https://www.mulesoft.com/exchange/)​ に移動します。
2. Exchange で、​**\[Login (ログイン)\]**​ をクリックし、Anypoint Platform のユーザー名とパスワードを指定します。
3. Exchange で、「​`spring module`​」を検索します。
4. コネクタを選択します。
5. 画面の右上付近にある ​**\[Dependency Snippets (連動関係スニペット)\]**​ をクリックします。

## [](#関連情報)関連情報

- [Anypoint Connector の概要](https://docs.mulesoft.com/connectors/introduction/introduction-to-anypoint-connectors)
- [MuleSoft ヘルプセンター](https://help.mulesoft.com)

<!-- document id=b164a55d9152968782d25bf30b4680253e09a8bc6f474091647d4cedf30e9e9f url=/mulesoft/current/ja-jp/spring-module/1.4/spring-xml-maven.md -->

# Spring Module の XML と Maven のサポート

XML で Mule アプリケーションを手動でコーディングすることもできますが、Anypoint Studio を使用した方が効率的です。

Anypoint Studio の XML エディターまたはテキストエディターから Mule Runtime Engine (Mule) アプリケーションを手動でコーディングする場合、参照ステートメントを XML Mule フローと Apache Maven ​`pom.xml`​ ファイルの両方に追加することで、アプリケーションでコネクタにアクセスできます。

コネクタを Studio に追加すると、Studio は自動的に XML コードにコネクタの名前空間およびスキーマの場所を入力します。さらに、​`pom.xml`​ ファイルに連動関係を追加します。

## [](#コネクタの名前空間の追加)コネクタの名前空間の追加

次のコードを設定 XML のヘッダーの ​`<mule>`​ タグ内に貼り付けます。

```xml
http://www.mulesoft.org/schema/mule/spring
http://www.mulesoft.org/schema/mule/spring/current/mule-spring.xsd
```

次の例は、​`<mule>`​ XML ブロック内に名前空間ステートメントが配置される方法を示しています。

```xml
<mule xmlns:spring="http://www.mulesoft.org/schema/mule/spring"
	xmlns:ee="http://www.mulesoft.org/schema/mule/ee/core"
	xmlns:http="http://www.mulesoft.org/schema/mule/http"
	xmlns:file="http://www.mulesoft.org/schema/mule/file"
	xmlns="http://www.mulesoft.org/schema/mule/core"
	xmlns:doc="http://www.mulesoft.org/schema/mule/documentation"
	xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
	xsi:schemaLocation="http://www.mulesoft.org/schema/mule/core
	http://www.mulesoft.org/schema/mule/core/current/mule.xsd
	http://www.mulesoft.org/schema/mule/file
	http://www.mulesoft.org/schema/mule/file/current/mule-file.xsd
	http://www.mulesoft.org/schema/mule/http
	http://www.mulesoft.org/schema/mule/http/current/mule-http.xsd
	http://www.mulesoft.org/schema/mule/ee/core
	http://www.mulesoft.org/schema/mule/ee/core/current/mule-ee.xsd
	http://www.mulesoft.org/schema/mule/spring
	http://www.mulesoft.org/schema/mule/spring/current/mule-spring.xsd">
```

## [](#pom-ファイルの連動関係の追加)POM ファイルの連動関係の追加

Apache Maven ​`pom.xml`​ ファイルは Anypoint Studio によって生成され、Mule アプリケーションの連動関係が含まれます。Mule アプリケーションを手動でコーディングする場合、次の XML スニペットを ​`pom.xml`​ ファイルに含めてこのコネクタにアクセスできるようにします:

```xml
<dependency>
  <groupId>org.mule.modules</groupId>
  <artifactId>mule-spring-module</artifactId>
  <version>x.x.x</version>
  <classifier>mule-plugin</classifier>
</dependency>
```

`x.x.x`​ を使用しているコネクタに対応するバージョンに置き換えます。

最新の ​`pom.xml`​ ファイル情報を取得する手順は、次のとおりです。

1. [Anypoint Exchange](https://www.mulesoft.com/exchange/)​ に移動します。
2. Exchange で、​**\[Login (ログイン)\]**​ をクリックし、Anypoint Platform のユーザー名とパスワードを指定します。
3. Exchange で、「​`spring module`​」を検索します。
4. コネクタを選択します。
5. 画面の右上付近にある ​**\[Dependency Snippets (連動関係スニペット)\]**​ をクリックします。

## [](#関連情報)関連情報

- [Anypoint Connector の概要](https://docs.mulesoft.com/connectors/introduction/introduction-to-anypoint-connectors)
- [MuleSoft ヘルプセンター](https://help.mulesoft.com)

<!-- document id=fb5dae6e94a28ddd59c9b377db12e6be2a39a09037718865a8703fa0c908ee2c url=/mulesoft/current/ja-jp/spring-module/1.5/spring-xml-maven.md -->

# Spring Module の XML と Maven のサポート

XML で Mule アプリケーションを手動でコーディングすることもできますが、Anypoint Studio を使用した方が効率的です。

Anypoint Studio の XML エディターまたはテキストエディターから Mule Runtime Engine (Mule) アプリケーションを手動でコーディングする場合、参照ステートメントを XML Mule フローと Apache Maven ​`pom.xml`​ ファイルの両方に追加することで、アプリケーションでコネクタにアクセスできます。

コネクタを Studio に追加すると、Studio は自動的に XML コードにコネクタの名前空間およびスキーマの場所を入力します。さらに、​`pom.xml`​ ファイルに連動関係を追加します。

## [](#コネクタの名前空間の追加)コネクタの名前空間の追加

次のコードを設定 XML のヘッダーの ​`<mule>`​ タグ内に貼り付けます。

```xml
http://www.mulesoft.org/schema/mule/spring
http://www.mulesoft.org/schema/mule/spring/current/mule-spring.xsd
```

次の例は、​`<mule>`​ XML ブロック内に名前空間ステートメントが配置される方法を示しています。

```xml
<mule xmlns:spring="http://www.mulesoft.org/schema/mule/spring"
	xmlns:ee="http://www.mulesoft.org/schema/mule/ee/core"
	xmlns:http="http://www.mulesoft.org/schema/mule/http"
	xmlns:file="http://www.mulesoft.org/schema/mule/file"
	xmlns="http://www.mulesoft.org/schema/mule/core"
	xmlns:doc="http://www.mulesoft.org/schema/mule/documentation"
	xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
	xsi:schemaLocation="http://www.mulesoft.org/schema/mule/core
	http://www.mulesoft.org/schema/mule/core/current/mule.xsd
	http://www.mulesoft.org/schema/mule/file
	http://www.mulesoft.org/schema/mule/file/current/mule-file.xsd
	http://www.mulesoft.org/schema/mule/http
	http://www.mulesoft.org/schema/mule/http/current/mule-http.xsd
	http://www.mulesoft.org/schema/mule/ee/core
	http://www.mulesoft.org/schema/mule/ee/core/current/mule-ee.xsd
	http://www.mulesoft.org/schema/mule/spring
	http://www.mulesoft.org/schema/mule/spring/current/mule-spring.xsd">
```

## [](#pom-ファイルの連動関係の追加)POM ファイルの連動関係の追加

Apache Maven ​`pom.xml`​ ファイルは Anypoint Studio によって生成され、Mule アプリケーションの連動関係が含まれます。Mule アプリケーションを手動でコーディングする場合、次の XML スニペットを ​`pom.xml`​ ファイルに含めてこのコネクタにアクセスできるようにします:

```xml
<dependency>
  <groupId>org.mule.modules</groupId>
  <artifactId>mule-spring-module</artifactId>
  <version>x.x.x</version>
  <classifier>mule-plugin</classifier>
</dependency>
```

`x.x.x`​ を使用しているコネクタに対応するバージョンに置き換えます。

最新の ​`pom.xml`​ ファイル情報を取得する手順は、次のとおりです。

1. [Anypoint Exchange](https://www.mulesoft.com/exchange/)​ に移動します。
2. Exchange で、​**\[Login (ログイン)\]**​ をクリックし、Anypoint Platform のユーザー名とパスワードを指定します。
3. Exchange で、「​`spring module`​」を検索します。
4. コネクタを選択します。
5. 画面の右上付近にある ​**\[Dependency Snippets (連動関係スニペット)\]**​ をクリックします。

## [](#関連情報)関連情報

- [Anypoint Connector の概要](https://docs.mulesoft.com/connectors/introduction/introduction-to-anypoint-connectors)
- [MuleSoft ヘルプセンター](https://help.mulesoft.com)

<!-- document id=523560fb863286f6f51ca97afee966dcefe7a43e0f740c62159311f511a8c8b5 url=/mulesoft/current/ja-jp/spring-module/2.0/spring-xml-maven.md -->

# Spring Module の XML と Maven のサポート

XML で Mule アプリケーションを手動でコーディングすることもできますが、Anypoint Studio を使用した方が効率的です。

Anypoint Studio の XML エディターまたはテキストエディターから Mule Runtime Engine (Mule) アプリケーションを手動でコーディングする場合、参照ステートメントを XML Mule フローと Apache Maven ​`pom.xml`​ ファイルの両方に追加することで、アプリケーションでコネクタにアクセスできます。

コネクタを Studio に追加すると、Studio は自動的に XML コードにコネクタの名前空間およびスキーマの場所を入力します。さらに、​`pom.xml`​ ファイルに連動関係を追加します。

## [](#コネクタの名前空間の追加)コネクタの名前空間の追加

次のコードを設定 XML のヘッダーの ​`<mule>`​ タグ内に貼り付けます。

```xml
http://www.mulesoft.org/schema/mule/spring
http://www.mulesoft.org/schema/mule/spring/current/mule-spring.xsd
```

次の例は、​`<mule>`​ XML ブロック内に名前空間ステートメントが配置される方法を示しています。

```xml
<mule xmlns:spring="http://www.mulesoft.org/schema/mule/spring"
	xmlns:ee="http://www.mulesoft.org/schema/mule/ee/core"
	xmlns:http="http://www.mulesoft.org/schema/mule/http"
	xmlns:file="http://www.mulesoft.org/schema/mule/file"
	xmlns="http://www.mulesoft.org/schema/mule/core"
	xmlns:doc="http://www.mulesoft.org/schema/mule/documentation"
	xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
	xsi:schemaLocation="http://www.mulesoft.org/schema/mule/core
	http://www.mulesoft.org/schema/mule/core/current/mule.xsd
	http://www.mulesoft.org/schema/mule/file
	http://www.mulesoft.org/schema/mule/file/current/mule-file.xsd
	http://www.mulesoft.org/schema/mule/http
	http://www.mulesoft.org/schema/mule/http/current/mule-http.xsd
	http://www.mulesoft.org/schema/mule/ee/core
	http://www.mulesoft.org/schema/mule/ee/core/current/mule-ee.xsd
	http://www.mulesoft.org/schema/mule/spring
	http://www.mulesoft.org/schema/mule/spring/current/mule-spring.xsd">
```

## [](#pom-ファイルの連動関係の追加)POM ファイルの連動関係の追加

Apache Maven ​`pom.xml`​ ファイルは Anypoint Studio によって生成され、Mule アプリケーションの連動関係が含まれます。Mule アプリケーションを手動でコーディングする場合、次の XML スニペットを ​`pom.xml`​ ファイルに含めてこのコネクタにアクセスできるようにします:

```xml
<dependency>
  <groupId>org.mule.modules</groupId>
  <artifactId>mule-spring-module</artifactId>
  <version>x.x.x</version>
  <classifier>mule-plugin</classifier>
</dependency>
```

`x.x.x`​ を使用しているコネクタに対応するバージョンに置き換えます。

最新の ​`pom.xml`​ ファイル情報を取得する手順は、次のとおりです。

1. [Anypoint Exchange](https://www.mulesoft.com/exchange/)​ に移動します。
2. Exchange で、​**\[Login (ログイン)\]**​ をクリックし、Anypoint Platform のユーザー名とパスワードを指定します。
3. Exchange で、「​`spring module`​」を検索します。
4. コネクタを選択します。
5. 画面の右上付近にある ​**\[Dependency Snippets (連動関係スニペット)\]**​ をクリックします。

## [](#関連情報)関連情報

- [Anypoint Connector の概要](https://docs.mulesoft.com/connectors/introduction/introduction-to-anypoint-connectors)
- [MuleSoft ヘルプセンター](https://help.mulesoft.com)

<!-- document id=c7580202c48708039253051416c4fd91a3fd70c2b26fe6c8c735c1596569f7a3 url=/mulesoft/current/ja-jp/spring-module/1.3/spring-module-troubleshooting.md -->

# Spring Module のトラブルシューティング

Spring Module のトラブルシューティングを行うには、冗長ログの有効化と、スローされる一般的なメッセージの解釈に関する情報を理解しておきます。

## [](#冗長ログの有効化)冗長ログの有効化

アプリケーションと Spring Module のやりとりが失敗する理由の理解を深めるには、モジュールの冗長ログを一時的に有効にします。

Mule アプリケーションのパフォーマンスに影響するため、トラブルシューティングが完了したら、必ず拡張された冗長性を無効にしてください。

設定ファイルで冗長ログを有効にする手順は、次のとおりです。

1. Anypoint Studio にアクセスし、​**\[Package Explorer\]**​ ビューに移動します。
2. アプリケーションのプロジェクト名を開きます。
3. `src/main/resources`​ パスフォルダーを開きます。
4. フォルダー内の ​`log4j2.xml`​ ファイルを開きます。
5. `<Loggers>`​ タグ内に ​`<AsyncLogger>`​ タグを追加します。
    
    ```xml
    			<Loggers>
    				...
    				<AsyncLogger name="org.mule.extension.spring" level="DEBUG"/>
    				...
    			</Loggers>
    ```
6. アプリケーションの変更を保存します。
7. **Package Explorer**​ でプロジェクト名をクリックし、​**\[Run (実行)\]**​ > ​**\[Run As (別のユーザーとして実行)\]**​ > ​**\[Mule Application (Mule アプリケーション)\]**​ をクリックします。

## [](#一般的なスローを理解する)一般的なスローを理解する

ここでは、一般的なスローメッセージとその解決方法を示します。

- MULE:NOT\_PERMITTED
    
    Occurs when there is a security restriction enforced by a filter; for example, when using the authorization filter of the Spring module. (検索条件によってセキュリティ制限が適用された場合に発生します (Spring Module の認証検索条件を使用する場合など)。)
- MULE:SERVER\_SECURITY
    
    Occurs when there is a security error enforced by Mule runtime engine (Mule). (Mule Runtime Engine (Mule) によってセキュリティエラーが適用された場合に発生します。)

## [](#関連情報)関連情報

- [MuleSoft ヘルプセンター](https://help.mulesoft.com)

<!-- document id=0ba5eaa7dadbe08cda7a3e5968c3c5d630133a42cf6f9619d04d143b78cb342e url=/mulesoft/current/ja-jp/spring-module/1.4/spring-module-troubleshooting.md -->

# Spring Module のトラブルシューティング

Spring Module のトラブルシューティングを行うには、冗長ログの有効化と、スローされる一般的なメッセージの解釈に関する情報を理解しておきます。

## [](#冗長ログの有効化)冗長ログの有効化

アプリケーションと Spring Module のやりとりが失敗する理由の理解を深めるには、モジュールの冗長ログを一時的に有効にします。

Mule アプリケーションのパフォーマンスに影響するため、トラブルシューティングが完了したら、必ず拡張された冗長性を無効にしてください。

設定ファイルで冗長ログを有効にする手順は、次のとおりです。

1. Anypoint Studio にアクセスし、​**\[Package Explorer\]**​ ビューに移動します。
2. アプリケーションのプロジェクト名を開きます。
3. `src/main/resources`​ パスフォルダーを開きます。
4. フォルダー内の ​`log4j2.xml`​ ファイルを開きます。
5. `<Loggers>`​ タグ内に ​`<AsyncLogger>`​ タグを追加します。
    
    ```xml
    			<Loggers>
    				...
    				<AsyncLogger name="org.mule.extension.spring" level="DEBUG"/>
    				...
    			</Loggers>
    ```
6. アプリケーションの変更を保存します。
7. **Package Explorer**​ でプロジェクト名をクリックし、​**\[Run (実行)\]**​ > ​**\[Run As (別のユーザーとして実行)\]**​ > ​**\[Mule Application (Mule アプリケーション)\]**​ をクリックします。

## [](#一般的なスローを理解する)一般的なスローを理解する

ここでは、一般的なスローメッセージとその解決方法を示します。

- MULE:NOT\_PERMITTED
    
    Occurs when there is a security restriction enforced by a filter; for example, when using the authorization filter of the Spring module. (検索条件によってセキュリティ制限が適用された場合に発生します (Spring Module の認証検索条件を使用する場合など)。)
- MULE:SERVER\_SECURITY
    
    Occurs when there is a security error enforced by Mule runtime engine (Mule). (Mule Runtime Engine (Mule) によってセキュリティエラーが適用された場合に発生します。)

## [](#関連情報)関連情報

- [MuleSoft ヘルプセンター](https://help.mulesoft.com)
- [Known Issues](https://help.salesforce.com/s/issues)

<!-- document id=40778626af658f02c76c509a6fdc4d07419764cd3082cdc3652afa1a48393bea url=/mulesoft/current/ja-jp/spring-module/1.5/spring-module-troubleshooting.md -->

# Spring Module のトラブルシューティング

Spring Module のトラブルシューティングを行うには、冗長ログの有効化と、スローされる一般的なメッセージの解釈に関する情報を理解しておきます。

## [](#冗長ログの有効化)冗長ログの有効化

アプリケーションと Spring Module のやりとりが失敗する理由の理解を深めるには、モジュールの冗長ログを一時的に有効にします。

Mule アプリケーションのパフォーマンスに影響するため、トラブルシューティングが完了したら、必ず拡張された冗長性を無効にしてください。

設定ファイルで冗長ログを有効にする手順は、次のとおりです。

1. Anypoint Studio にアクセスし、​**\[Package Explorer\]**​ ビューに移動します。
2. アプリケーションのプロジェクト名を開きます。
3. `src/main/resources`​ パスフォルダーを開きます。
4. フォルダー内の ​`log4j2.xml`​ ファイルを開きます。
5. `<Loggers>`​ タグ内に ​`<AsyncLogger>`​ タグを追加します。
    
    ```xml
    			<Loggers>
    				...
    				<AsyncLogger name="org.mule.extension.spring" level="DEBUG"/>
    				...
    			</Loggers>
    ```
6. アプリケーションの変更を保存します。
7. **Package Explorer**​ でプロジェクト名をクリックし、​**\[Run (実行)\]**​ > ​**\[Run As (別のユーザーとして実行)\]**​ > ​**\[Mule Application (Mule アプリケーション)\]**​ をクリックします。

## [](#一般的なスローを理解する)一般的なスローを理解する

ここでは、一般的なスローメッセージとその解決方法を示します。

- MULE:NOT\_PERMITTED
    
    Occurs when there is a security restriction enforced by a filter; for example, when using the authorization filter of the Spring module. (検索条件によってセキュリティ制限が適用された場合に発生します (Spring Module の認証検索条件を使用する場合など)。)
- MULE:SERVER\_SECURITY
    
    Occurs when there is a security error enforced by Mule runtime engine (Mule). (Mule Runtime Engine (Mule) によってセキュリティエラーが適用された場合に発生します。)

## [](#関連情報)関連情報

- [MuleSoft ヘルプセンター](https://help.mulesoft.com)
- [Known Issues](https://help.salesforce.com/s/issues)

<!-- document id=c88163578fed49afbcc69166630defe3027c34ff077008c7d0f00893790b953c url=/mulesoft/current/ja-jp/spring-module/2.0/spring-module-troubleshooting.md -->

# Spring Module のトラブルシューティング

Spring Module のトラブルシューティングを行うには、冗長ログの有効化と、スローされる一般的なメッセージの解釈に関する情報を理解しておきます。

## [](#冗長ログの有効化)冗長ログの有効化

アプリケーションと Spring Module のやりとりが失敗する理由の理解を深めるには、モジュールの冗長ログを一時的に有効にします。

Mule アプリケーションのパフォーマンスに影響するため、トラブルシューティングが完了したら、必ず拡張された冗長性を無効にしてください。

設定ファイルで冗長ログを有効にする手順は、次のとおりです。

1. Anypoint Studio にアクセスし、​**\[Package Explorer\]**​ ビューに移動します。
2. アプリケーションのプロジェクト名を開きます。
3. `src/main/resources`​ パスフォルダーを開きます。
4. フォルダー内の ​`log4j2.xml`​ ファイルを開きます。
5. `<Loggers>`​ タグ内に ​`<AsyncLogger>`​ タグを追加します。
    
    ```xml
    			<Loggers>
    				...
    				<AsyncLogger name="org.mule.extension.spring" level="DEBUG"/>
    				...
    			</Loggers>
    ```
6. アプリケーションの変更を保存します。
7. **Package Explorer**​ でプロジェクト名をクリックし、​**\[Run (実行)\]**​ > ​**\[Run As (別のユーザーとして実行)\]**​ > ​**\[Mule Application (Mule アプリケーション)\]**​ をクリックします。

## [](#一般的なスローを理解する)一般的なスローを理解する

ここでは、一般的なスローメッセージとその解決方法を示します。

- MULE:NOT\_PERMITTED
    
    Occurs when there is a security restriction enforced by a filter; for example, when using the authorization filter of the Spring module. (検索条件によってセキュリティ制限が適用された場合に発生します (Spring Module の認証検索条件を使用する場合など)。)
- MULE:SERVER\_SECURITY
    
    Occurs when there is a security error enforced by Mule runtime engine (Mule). (Mule Runtime Engine (Mule) によってセキュリティエラーが適用された場合に発生します。)

## [](#関連情報)関連情報

- [MuleSoft ヘルプセンター](https://help.mulesoft.com)
- [Known Issues](https://help.salesforce.com/s/issues)

<!-- document id=3f7c8b587dd9b704674e23d02b04ea22b4299c07b260cc0d24295684736979f8 url=/mulesoft/current/ja-jp/spring-module/2.0/spring-module-upgrade-migrate.md -->

# Spring Module のバージョン 2.0 へのアップグレードおよび移行

Spring Module をバージョン 2.x にアップグレードします。

## [](#サポートされているアップグレードパス)サポートされているアップグレードパス

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 50%;">
<col style="width: 50%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">開始バージョン</th>
<th class="tableblock halign-left valign-top">終了バージョン</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>1.x</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>2.x</p>
</div></div></td>
</tr>
</tbody>
</table>

## [](#このリリースでの変更)このリリースでの変更

Spring Module 2.0 には次の変更内容が含まれます。

- Spring Module (およびその連動関係) が Java 17 のみと互換性があるようになりました。
- 最新の開発プラクティスに沿い、引き続きセキュアでサポートされているライブラリとの互換性を保てるように、Spring Module は Spring 5.x から Spring 6.x にアップグレードされます。
- DSL に関する検証の問題を解決できるように、​`spring:security-manager`​ 要素の構造が更新されます。以前は、​`delegate-security-providers`​ を直接 ​`spring:security-manager`​ 内で定義することができました。すべての ​`spring:delegate-security-provider`​ 要素を新しい ​`spring:delegate-security-providers`​ 要素内にラップする必要があるようになりました。
    
    - 以前の構造 (サポートされなくなりました):
        
        ```xml
        <spring:security-manager doc:name="Spring Security Manager">
           <spring:delegate-security-provider name="memory-provider" delegate-ref="authenticationManager" />
        </spring:security-manager>
        ```
    - 新しい構造 (必須):
        
        ```xml
        <spring:security-manager doc:name="Spring Security Manager">
           <spring:delegate-security-providers>
             <spring:delegate-security-provider name="memory-provider" delegate-ref="authenticationManager" />
           </spring:delegate-security-providers>
        </spring:security-manager>
        ```

## [](#アップグレード前提条件)アップグレード前提条件

アップグレードを実行する前に、復元する必要がある場合に備えて、ファイル、データ、および設定のバックアップを作成する必要があります。

## [](#アップグレード手順)アップグレード手順

以下の手順でアップグレードを実行します。

1. Anypoint Studio で、プロジェクトを右クリックし、​**\[Manage Dependencies (連動関係の管理)\]**​ > ​**\[Manage Modules (モジュールを管理)\]**​ を選択します。
2. `[Spring Module - Mule 4]`​ を選択し、​**\[Update version (バージョンを更新)\]**​ をクリックします。
3. **\[Apply and Close (適用して閉じる)\]**​ をクリックします。
4. Mule プロジェクトの ​`pom.xml`​ ファイルで Spring Module 連動関係のバージョンが ​`2.0.0`​ であることを確認します。

または、Mule プロジェクトの ​`pom.xml`​ ファイルで Spring Module 連動関係を手動で更新するか、単に更新済みのモジュールをプロジェクトに追加することもできます。

### [](#アップグレードを確認する)アップグレードを確認する

コネクタをアップグレードしたら、次の手順に従ってアップグレードを検証します。

1. Studio の ​**\[Problems (問題)\]**​ または ​**\[Console (コンソール)\]**​ ビューでエラーがないことを確認します。
2. プロジェクトの ​`pom.xml`​ ファイルに問題がないことを確認します。
3. 接続をテストして、操作が機能することを確認します。

## [](#トラブルシューティング)トラブルシューティング

パラメーターのキャッシュおよびメタデータのキャッシュで問題がある場合、Anypoint Studio の再起動をお試しください。

### [](#アップグレードの復元)アップグレードの復元

前のバージョンの Spring Module に戻す必要がある場合、プロジェクトの ​`pom.xml`​ で Spring Module 連動関係バージョン ​`2.0.0`​ を前のバージョンに変更します。

Anypoint Studio でプロジェクトの ​`pom.xml`​ を更新する必要があります。

## [](#関連情報)関連情報

- [Anypoint Connector の概要](https://docs.mulesoft.com/connectors/introduction/introduction-to-anypoint-connectors)
- [Spring Module リファレンス](https://docs.mulesoft.com/jp/spring-module/2.0/spring-module-reference)
- [MuleSoft ヘルプセンター](https://help.mulesoft.com)

<!-- document id=9321a580e5b3b0834531f4b0dbe87e0d91a11fe305a918455c27db0a9e7bd3f7 url=/mulesoft/current/ja-jp/spring-module/1.3/spring-module-reference.md -->

# Spring Module リファレンス

Spring Module v1.3

Spring Module により、Mule アプリケーションで Spring Framework を使用できます。

## [](#設定)設定

* * *

### [](#config)設定

一連の spring XML ファイルを定義したり、Mule アーティファクトで使用するオブジェクトを使用してアプリケーションコンテキストを作成できるようにする Spring 設定。

#### [](#パラメーター)パラメーター

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 20%;">
<col style="width: 35%;">
<col style="width: 20%;">
<col style="width: 5%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">名前</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Name (名前)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>この設定の名前。コネクタはこの名前の設定を参照します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Files (ファイル)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Spring bean ファイル。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
</tbody>
</table>

## [](#操作)操作

### [](#authorization-filter)Authorization Filter

`<spring:authorization-filter>`

必要な認証機関のセットに対してユーザーを認証します。

#### [](#パラメーター-2)パラメーター

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 20%;">
<col style="width: 35%;">
<col style="width: 20%;">
<col style="width: 5%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">名前</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Required Authorities (必要な認証機関)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>ユーザーにフローへの追加のアクセス権 (​<code>ROLE_ADMIN</code>​ や ​<code>ROLE_USER</code>​ など) を付与する認証機関。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
</tbody>
</table>

#### [](#スロー)スロー

- MULE:NOT\_PERMITTED
- MULE:SERVER\_SECURITY

## [](#型)型

### [](#DelegateSecurityProvider)Delegate Security Provider (代理セキュリティプロバイダー)

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 25%;">
<col style="width: 30%;">
<col style="width: 15%;">
<col style="width: 10%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">項目</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Name (名前)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>参照するプロバイダー名。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Delegate Ref (代理参照)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>String (文字列)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Spring セキュリティマネージャー。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>x</p>
</div></div></td>
</tr>
</tbody>
</table>

## [](#関連情報)関連情報

- [MuleSoft ヘルプセンター](https://help.mulesoft.com)