移行ガイド

前提条件

• JBoss EAP が実行されていない。

• beans.xml ファイルは空のままにしておきますが、Bean 定義アノテーションを必要とするすべてのクラスに追加します。
• クラスを変更しないままにしますが、beans.xml ファイルを空の状態から次の内容を含むファイルに変更します: <beans bean-discovery-mode="all"></beans>
• アプリケーションを変更しないままにします。ただし、サーバーの weld サブシステム設定を変更して、空の beans.xml ファイルの処理を JBoss EAP 7 の動作に戻します。この設定は、サーバー上のすべてのデプロイメントに影響します。たとえば、CLI の場合: /subsystem=weld:write-attribute(name=legacy-empty-beans-xml-treatment,value=true)

• javax.enterprise.inject.spi.Bean.isNullable() メソッドは削除されました。このメソッドは長年にわたって常に false を返してきたため、このメソッドを呼び出すアプリケーションは呼び出しを false に置き換えるか、ブランチロジックを削除して false ブランチの内容だけを保持することができます。
• javax.enterprise.inject.spi.BeanManager.createInjectionTarget(AnnotatedType) メソッドは削除されました。このメソッド呼び出しを BeanManager.getInjectionTargetFactory(AnnotatedType) に置き換え、返されたファクトリーを使用して注入ターゲットを作成します。詳細は、Jakarta Contexts and Dependency Injection 仕様の Obtaining an InjectionTarget for a class を参照してください。
• javax.enterprise.inject.spi.BeanManager.fireEvent(Object, Annotation) メソッドは削除されました。同様の API へのエントリーポイントとして BeanManager.getEvent() を使用します。詳細は、Jakarta Contexts and Dependency Injection 仕様の Firing an event を参照してください。
• javax.enterprise.inject.spi.BeforeBeanDiscovery.addAnnotatedType(AnnotatedType) メソッドは削除されました。アプリケーションがこのメソッドを呼び出している場合は、BeforeBeanDiscovery.addAnnotatedType(AnnotatedType, (String) null) の呼び出しに置き換えることができます。

• 非推奨の javax.ejb.EJBContext.getCallerIdentity() メソッドは削除されました。代わりに EJBContext.getCallerPrincipal() を使用すると、java.security.Principal が返されます。
• 非推奨の javax.ejb.EJBContext.isCallerInRole(Identity role) メソッドは削除されました。代わりに EJBContext.isCallerInRole(String roleName) を使用できます。
• Jakarta XML RPC 仕様は Jakarta EE 10 フルプラットフォームから削除されたため、javax.xml.rpc.handler.MessageContext を返す javax.ejb.SessionContext.getMessageContext() メソッドは削除されました。
• Jakarta XML RPC 仕様は Jakarta EE 8 ではオプションでしたが、Red Hat JBoss EAP 7 ではサポートされていません。この仕様を使用すると IllegalStateException がスローされるため、この EJB API の変更は JBoss EAP 7 で実行されている既存のアプリケーションに影響を与えることは想定されていません。
• 非推奨の javax.ejb.EJBContext.getEnvironment() メソッドは削除されました。JNDI ネーミングコンテキスト java:comp/env を使用して、エンタープライズ Bean の環境にアクセスします。

• parseQueryString(String s) および parsePostData(int len, ServletInputStream in) - ServletRequest.getParameterMap() を使用します。アプリケーションがクエリー文字列パラメーターとリクエスト本文パラメーターを区別する必要がある場合、アプリケーションはクエリー文字列自体を解析してそれを行うコードを実装する必要があります。
• getRequestURL(HttpServletRequest req)- HttpServletRequest.getRequestURL() を使用します。

• com.sun.xml.bind パッケージ内のクラスを使用する場合は、org.glassfish.jaxb.runtime パッケージ内のクラスに置き換える必要があります。com.sun.xml.bind のサブパッケージ内のクラスは、対応する org.glassfish.jaxb.runtime サブパッケージ内のクラスに置き換える必要があります。
• jakarta.xml.bind.Marshaller プロパティー設定の場合、プロパティー定数名を com.sun.xml.bind.* から org.glassfish.jaxb.* に変更します。たとえば、marshaller.setProperty("com.sun.xml.bind.namespacePrefixMapper", mapper) は marshaller.setProperty("org.glassfish.jaxb.namespacePrefixMapper", mapper) になります。

• Server は、以前は JBoss EAP/7 に設定されていました。
• X-Powered-By は、以前は Undertow/1 に設定されていました。

• idle-timeout 属性が非推奨となる
• イーガー (Eager) パッシベーションからレイジー (Lazy) パッシベーションへの移行
• クラスター名の決定
• Jakarta Enterprise Beans キャッシュでのエビクションと有効期限の設定

• ejb3 サブシステムの infinispan passivation-store で設定される idle-timeout 属性は、JBoss EAP 7.1 以上のリリースでは非推奨となりました。JBoss EAP 7.1 以降は、max-size のしきい値に達したときに発生するレイジー (Lazy) パッシベーションのみをサポートします。

  注記

  アイドルタイムアウトによるイーガー (Eager) パッシベーションは、これらのバージョンではサポートされなくなりました。

• JBoss EAP 7.1 以降では、Jakarta Enterprise Beans クライアントによって使用されるクラスター名は、jgroups サブシステムで設定されているチャネルの実際のクラスター名によって決定されます。
• JBoss EAP 7.1 以上のリリースでも、max-size 属性を設定してパッシベーションのしきい値を制御できます。

• JAX-RPC マッピングファイルの存在。これは、root 要素 <java-wsdl-mapping> のある XML ファイルです。

• webservices.xml XML 記述子ファイルの存在。このファイルには <jaxrpc-mapping-file> 子要素が含まれる <webservice-description> 要素があります。以下に JAX-RPC Web サービスを定義する webservices.xml 記述子ファイルの例を示します。

  <webservices xmlns="http://java.sun.com/xml/ns/j2ee"
        xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
        xsi:schemaLocation="http://java.sun.com/xml/ns/j2ee http://www.ibm.com/webservices/xsd/j2ee_web_services_1_1.xsd" version="1.1">
    <webservice-description>
      <webservice-description-name>HelloService</webservice-description-name>
      <wsdl-file>WEB-INF/wsdl/HelloService.wsdl</wsdl-file>
      <jaxrpc-mapping-file>WEB-INF/mapping.xml</jaxrpc-mapping-file>
      <port-component>
        <port-component-name>Hello</port-component-name>
        <wsdl-port>HelloPort</wsdl-port>
        <service-endpoint-interface>org.jboss.chap12.hello.Hello</service-endpoint-interface>
        <service-impl-bean>
          <servlet-link>HelloWorldServlet</servlet-link>
        </service-impl-bean>
      </port-component>
    </webservice-description>
  </webservices>

  Copy to Clipboard Toggle word wrap
• ejb-jar.xml ファイルの存在。これには、JAX-RPC マッピングファイルを参照する <service-ref> が含まれます。

• アプリケーションに、org.apache.ws.security.WSPasswordCallback クラスにアクセスするカスタムコールバックハンドラーが含まれている場合、このクラスは org.apache.wss4j.common.ext パッケージに移動されたため注意してください。
• org.apache.ws.security.saml.ext パッケージの SAML bean オブジェクトのほとんどは、org.apache.wss4j.common.saml パッケージに移動されました。
• RSA v1.5 キートランスポートおよびすべての関連アルゴリズムの使用は、デフォルトでは許可されていません。
• これまで、セキュリティートークンサービス (STS) は onBehalfOf トークンのみを検証しました。ActAs トークンも検証するようになりました。そのため、ActAs トークンに提供される UsernameToken に有効なユーザー名とパスワードを指定する必要があります。
• SAML Bearer トークンには内部署名が必要になりました。署名の検証を有効または無効にするため、org.apache.wss4j.dom.validate.SamlAssertionValidator クラスに setRequireBearerSignature() メソッドが含まれるようになりました。

• org.jboss.ws.cxf.jaxws-client.bus.strategy システムプロパティーの値を THREAD_BUS に設定して JBoss EAP サーバーを起動します。
• クライアントコードで選択ストラテジーを明示的に設定します。

• ネームスペースを "urn:jboss:messaging-deployment:1.0" から "urn:jboss:messaging-activemq-deployment:1.0" に変更します。
• <hornetq-server> 要素名を <server> に変更します。

• org.jboss.resteasy:resteasy-jackson-provider
• org.jboss.resteasy:resteasy-jettison-provider
• org.jboss.resteasy:resteasy-yaml-provider

• @Suspend と org.jboss.resteasy.spi.AsynchronousResponse は削除され、それぞれ @Suspended と javax.ws.rs.container.AsyncResponse に置き換えられました。
• StringConverter は ParamConverter に置き換えられます。
• org.jboss.resteasy.plugins.providers.SerializableProvider は非推奨となり、削除されました。

• RESTEasy 3.x で非推奨となった次のインターセプターインターフェイスは削除されました。

  • org.jboss.resteasy.spi.interception.PreProcessInterceptor
  • org.jboss.resteasy.spi.interception.PostProcessInterceptor
  • org.jboss.resteasy.spi.interception.ClientExecutionInterceptor
  • org.jboss.resteasy.spi.interception.ClientExecutionContext
  • org.jboss.resteasy.spi.interception.AcceptedByMethod
• org.jboss.resteasy.spi.interception.PreProcessInterceptor インターフェイスは、RESTEasy 3.x の jakarta.ws.rs.container.ContainerRequestFilter インターフェイスに置き換えられました。

• 以下のインターフェイスとクラスは、RESTEasy 3.x および JBoss EAP 8.0 から削除されました。

  • org.jboss.resteasy.spi.interception.MessageBodyReaderInterceptor
  • org.jboss.resteasy.spi.interception.MessageBodyWriterInterceptor
  • org.jboss.resteasy.spi.interception.MessageBodyWriterContext
  • org.jboss.resteasy.spi.interception.MessageBodyReaderContext
  • org.jboss.resteasy.core.interception.InterceptorRegistry
  • org.jboss.resteasy.core.interception.InterceptorRegistryListener
  • org.jboss.resteasy.core.interception.ClientExecutionContextImpl
• org.jboss.resteasy.spi.interception.MessageBodyWriterInterceptor インターフェイスは、jakarta.ws.rs.ext.WriterInterceptor インターフェイスに置き換えられました。

• さらに、jakarta.ws.rs.ext.MessageBodyWriter インターフェイスに対する一部の変更は、JAX-RS 1.x に関して下位互換性がない可能性があります。アプリケーションが JAX-RS 1.x を使用した場合はアプリケーションコードを確認し、エンドポイントに @Produces または @Consumes を定義するようにしてください。この定義を怠ると、以下のようなエラーが発生することがあります。

  org.jboss.resteasy.core.NoMessageBodyWriterFoundFailure: Could not find MessageBodyWriter for response object of type: <OBJECT> of media type:

  Copy to Clipboard Toggle word wrap

  以下に、このエラーの原因となる REST エンドポイントの例を示します。

  @Path("dates")
  public class DateService {
  
      @GET
      @Path("daysuntil/{targetdate}")
      public long showDaysUntil(@PathParam("targetdate") String targetDate) {
          DateLogger.LOGGER.logDaysUntilRequest(targetDate);
          final long days;
  
          try {
              final LocalDate date = LocalDate.parse(targetDate, DateTimeFormatter.ISO_DATE);
              days = ChronoUnit.DAYS.between(LocalDate.now(), date);
          } catch (DateTimeParseException ex) {
            // ** DISCLAIMER **. This example is contrived.
            throw new WebApplicationException(Response.status(400).entity(ex.getLocalizedMessage()).type(MediaType.TEXT_PLAIN)
                .build());
          }
          return days;
      }
  }

  Copy to Clipboard Toggle word wrap

  この問題を解決するには、次のように、jakarta.ws.rs.Produces のインポートと @Produces アノテーションを追加します。

  ...
  import jakarta.ws.rs.Produces;
  ...
  
  @Path("dates")
  public class DateService {
  
      @GET
      @Path("daysuntil/{targetdate}")
      @Produces(MediaType.TEXT_PLAIN)
      public long showDaysUntil(@PathParam("targetdate") String targetDate) {
          DateLogger.LOGGER.logDaysUntilRequest(targetDate);
          final long days;
  
          try {
              final LocalDate date = LocalDate.parse(targetDate, DateTimeFormatter.ISO_DATE);
              days = ChronoUnit.DAYS.between(LocalDate.now(), date);
          } catch (DateTimeParseException ex) {
            // ** DISCLAIMER **. This example is contrived.
            throw new WebApplicationException(Response.status(400).entity(ex.getLocalizedMessage()).type(MediaType.TEXT_PLAIN)
                .build());
          }
          return days;
      }
  }

  Copy to Clipboard Toggle word wrap

• 以下のクラスは JBoss EAP 8.0 から削除されました。

  • org.jboss.resteasy.client.ClientRequest
  • org.jboss.resteasy.client.ClientRequestFactory
  • org.jboss.resteasy.client.ClientResponse
  • org.jboss.resteasy.client.ProxyBuilder
  • org.jboss.resteasy.client.ProxyConfig
  • org.jboss.resteasy.client.ProxyFactory
• org.jboss.resteasy.client.ClientResponseFailure 例外、org.jboss.resteasy.client.ClientExecutor インターフェイスおよび org.jboss.resteasy.client.EntityTypeFactory インターフェイスも非推奨になりました。

• org.jboss.resteasy.client.ClientRequest クラスおよび org.jboss.resteasy.client.ClientResponse クラスを、それぞれ org.jboss.resteasy.client.jaxrs.ResteasyClient および jakarta.ws.rs.core.Response に置き換える必要があります。

  以下は RESTEasy 2.3.x の RESTEasy クライアントでリンクヘッダーを送信する例です。

  ClientRequest request = new ClientRequest(generateURL("/linkheader/str"));
  request.addLink("previous chapter", "previous", "http://example.com/TheBook/chapter2", null);
  ClientResponse response = request.post();
  LinkHeader header = response.getLinkHeader();

  Copy to Clipboard Toggle word wrap

  以下は RESTEasy 3 の RESTEasy クライアントで上記と同じタスクを実行する例です。

  ResteasyClient client = new ResteasyClientBuilder().build();
  Response response = client.target(generateURL("/linkheader/str")).request()
      .header("Link", "<http://example.com/TheBook/chapter2>; rel=\"previous\";
  title=\"previous chapter\"").post(Entity.text(new String()));
  jakarta.ws.rs.core.Link link = response.getLink("previous");

  Copy to Clipboard Toggle word wrap

  Jakarta REST Web サービスと対話する外部 Jakarta REST RESTEasy クライアントの例については、resteasy-jaxrs-client クイックスタートを参照してください。

• org.jboss.resteasy.client.cache パッケージのクラスおよびインターフェイスも非推奨になりました。これらは org.jboss.resteasy.annotations.cache パッケージ内の同等のクラスとインターフェイスに置き換えられました。

• resteasy-crypto の SignedInput および SignedOutput では、Content-Type を Request または Response オブジェクトのいずれかで multipart/signed に設定する必要があります。そうでない場合は、@Consumes または @Produces アノテーションを使用する必要があります。
• SignedOutput および SignedInput を使用すると、@Produces または @Consumes アノテーションにタイプを設定することで、application/pkcs7-signature MIME タイプ形式をバイナリー形式で返すことができます。
• @Produces または @Consumes が text/plain MIME タイプの場合、SignedOutput は base64 でエンコードされ、文字列として送信されます。

• アーカイブでは、beans.xml にバージョン番号の有無は区別されません。
• アーカイブには、ビルド互換エクステンションに加えて、beans.xml ファイルを含まないアーカイブも含まれます。ビルド互換エクステンションは Bean アーカイブではありません。
• 空の beans.xml ファイルを含むアーカイブのデフォルトの検出モードは、all ではなく annotated に設定されています。たとえば、beans.xml ファイルが空の場合、それは明示的な Bean アーカイブではなく、暗黙的な Bean アーカイブになります。
• どちらの場合も、Bean 検出要素は、beans.xml ファイルがあるアーカイブとないアーカイブの間で影響を受けません。

• bean-discovery-mode が none である beans.xml ファイルが含まれる場合。
• これにはポータブルエクステンションまたはビルド互換エクステンションが含まれていますが、beans.xml ファイルは含まれていません。

• アーカイブには、bean-discovery-mode が all の beans.xml ファイルが含まれています。

• アーカイブには空の beans.xml ファイルが含まれています。
• アーカイブに beans.xml ファイルが含まれなくても、bean を定義するアノテーションを持つ bean クラスが 1 つ以上含まれるか、セッション bean が 1 つ以上含まれる場合。

• @ApplicationScoped、@SessionScoped、@ConversationScoped、および @RequestScoped アノテーション
• その他すべての通常スコープタイプ
• @Interceptor および @Decorator アノテーション
• @Stereotype アノテーションが付けられた stereotype アノテーションすべて
• @Dependent スコープアノテーション

• Java 11 は、Hibernate 6.0 の互換性のある最小のベースラインバージョンです。
• Jakarta Persistence: Hibernate ORM 6.0 リリースのもう 1 つの重要な変更には、Jakarta EE 仕様で定義された Java Persistence から Java EE 仕様で定義された Jakarta Persistence への移行が含まれます。この変更による最も重要な影響には、Java Persistence クラス javax.persistence.* の代わりに Jakarta Persistence クラス jakarta.persistence.* が使用されることが含まれます。
• JDBC からの読み取り: Hibernate ORM 6.0 バージョンの開発のもう 1 つの理由は、JDBC ResultSet からの結果の名前での読み取り (read-by-name) から、位置による結果の読み取り (read-by-position) に移行することでした。この変更は、スループットテストを実施することでスケーリングを改善するために行われました。

• 生成された SQL: この機能により、次の機能が強化されました。

  • 列のエイリアスが生成されなくなる
  • 列参照は "unique-d"
  • 結合の定義が改善され、不要な結合 (セカンダリーテーブル、継承テーブル) がより適切に判断される
• オブジェクトとしての識別子 - Hibernate の以前のバージョンでは、すべての識別子のタイプが Serializable を実装する必要がありましたが、Hibernate 6.0 では識別子を任意の Object にできるため、この制限がなくなりました。この変更は、Serializable を使用して以前に定義された多くの API および SPI メソッドに影響します。
• @IdGeneratorType: このリリースでは、@IdGeneratorType アノテーションを使用して、識別子生成用のカスタムジェネレーターを定義するタイプセーフな方法を向上させることができます。
• 暗黙的な識別子のシーケンスとテーブル名: Hibernate が識別子の生成に関連付けられたシーケンスとテーブルの暗黙的な名前を決定する方法が Hibernate 6.0 で変更されました。これはユーザーのアプリケーションの移行に影響を与える可能性があります。このリリースでは、Hibernate はデフォルトで単一のシーケンス hibernate_sequence ではなく、エンティティー階層ごとにシーケンスを作成します。
• 暗黙的シーケンスジェネレーターのデフォルト: 前述の hibernate_sequence のような暗黙的シーケンスは、JPA @SequenceGenerator アノテーションのデフォルト値に従うようになりました。これは、シーケンスの割り当てサイズが 50 であることを意味します。
• タイプシステム: Hibernate 6.0 はメジャーリリースであるため、もう 1 つの重要な変更は Hibernate のマッピングアノテーションを変更し、よりタイプセーフにすることでした。read-by-position の変更を実装するためにタイプ関連のコントラクトがすでに変更されていたため、この機能はこのリリースで提供されることが決定されました。
• クエリー: クエリーの機能に多くの変更が導入されました。HQL および Criteria クエリーをモデル化するための専用ツリー構造への移行、挿入、更新、削除などの一括 SQM DML ステートメントの実装の改善、hibernate.criteria.copy_tree プロパティーの動作の変更などのクエリー機能と、パススルートークンのインクルージョンがこのリリースで導入されました。
• #onSave メソッドのシグネチャーの変更: #onSave メソッドのシグネチャーは、boolean onSave(Object entity, Serializable id, Object[] state, String[] propertyNames, Type[] types) から boolean onSave(Object entity, Object id, Object[] state, String[] propertyNames, Type[] types) へ変更されました。これは、想定される ID タイプが Serializable から Object に変更されたことに対応するものです。
• フェッチの循環性の決定: Hibernate の以前のバージョンでは、深さ優先のアプローチを使用してフェッチを決定していましたが、これにより、奇妙な"循環性" が決定されることがありました。Hibernate 6.0 以降、幅優先アプローチを使用してフェッチの決定が実行されるようになりました。
• org.hibernate.loader の再構築: loader.collection パッケージの内容は、loader.ast.spi および loader.ast.internal に再構築され、SQM API にも適合されました。
• SQL パッケージの再構築: sql.ordering の内容は metamodel.mapping.ordering.ast に移動されました。
• hbm.xml マッピングの非推奨: レガシー hbm.xml マッピング形式は非推奨となり、6.x 以降はサポートされなくなります。
• レイジー (Lazy) 関連付けの遵守: Hibernate 6.0 より前では、fetch="join" or @Fetch(FetchMode.JOIN) を使用したレイジー関連付けは、クエリーの関連付けがレイジーとして扱われても、ID によって (Session#get/EntityManager#find を介して) ロードされると、イーガー (Eager) と見なされました。Hibernate 6.0 以降では、フェッチメカニズムに関係なく、このようなレイジー関連付けが適切に扱われるようになりました。下位互換性は、lazy="false" or @ManyToOne(fetch = EAGER)/@OneToOne(fetch = EAGER)/@OneToMany(fetch = EAGER)/@ManyToMany(fetch = EAGER) を指定することで実現できます。
• hbm.xml <return-join/> の動作の変更: Hibernate 6.0 に従って、<return-join/>` により、選択項目を追加するのではなく、関連付けがフェッチされます。

• hbm.xml の複数の <column/> が許可されなくなる - 6.0 では、複数の列を使用した基本的なプロパティーマッピングのサポートが削除されました。コンポーネントクラス属性は、CompositeUserType クラスの適切な解釈をサポートするようになりました。
• レガシー Hibernate Criteria API - Hibernate 5.x で非推奨となったレガシー Hibernate Criteria API は、Hibernate 6.0 で削除されました。
• NativeQuery 経由で呼び出し可能 - NativeQuery を使用した SQL 関数およびプロシージャーの呼び出しは、サポートされなくなりました。代わりに、org.hibernate.procedure.ProcedureCall または jakarta.persistence.StoredProcedureQuery などのメソッドを使用してください。
• HQL fetch all properties 句 - fetch all properties 句が HQL 言語から削除されました。
• JMX 統合 - Hibernate は、JMX 環境と統合するための組み込みサポートを提供しなくなりました。
• JACC の統合 - Hibernate は、JACC 環境と統合するための組み込みサポートを提供しなくなりました。

• 基本アレイ: byte[]/Byte[] および char[]/Character[] 以外の基本アレイ、および基本コレクション (Collection のサブタイプのみ) は、デフォルトで型コード SqlTypes.ARRAY にマップされるようになり、これは、org.hibernate.dialect.Dialect の新しいメソッド getArrayTypeName および supportsStandardArrays によって決定される SQL 標準アレイタイプにマップされます。
• Enum マッピングの変更: Enum は、以前は TINYINT にマップされていましたが、現在はデフォルトで型コード SqlType.SMALLINT にマップされるようになりました。Java では実質的に最大 32K の enum エントリーが許可されていますが、TINYINT は 1 バイトのタイプにすぎないため、このマッピングは正しくありませんでした。

• OffsetTime マッピングの変更 - このリリースでは、OffsetTime は @TimeZoneStorage と hibernate.timezone.default_storage 設定に依存します。デフォルト設定は TimeZoneStorageType.DEFAULT であるため、そのような列に対する DDL の期待値が変更されたことを意味します。
• MariaDB での UUID マッピングの変更 - MariaDB では、binary(16) を使用していた以前と比較して、型コード SqlTypes.UUID はデフォルトで DDL 型 uuid を参照します。この変更により、既存のデータベースでスキーマ検証エラーが発生する可能性があります。
• SQL Server での UUID マッピングの変更 - SQL Server では、binary(16) を使用していた以前と比較して、型コード SqlTypes.UUID はデフォルトで DDL 型 uniqueidentifier を参照します。この変更により、既存のデータベースでスキーマ検証エラーが発生する可能性があります。
• Oracle での JSON マッピングの変更 - Oracle 12.1 以降では、clob を使用していた以前と比較して、型コード SqlTypes.JSON はデフォルトで DDL 型 blob を参照し、21 以降では json を参照します。この変更により、既存のデータベースでスキーマ検証エラーが発生する可能性があります。
• H2 での JSON マッピングの変更 - H2 1.4.200 以降では、clob を使用していた以前と比較して、型コード SqlTypes.JSON はデフォルトで DDL 型 JSON を参照します。この変更により、既存のデータベースでスキーマ検証エラーが発生する可能性があります。
• enum のデータ型 - Hibernate 6.2 以降、enum を格納するための暗黙的な SQL データ型の選択は、enum クラスで定義されたエントリーの数に影響されます。
• タイムゾーンとオフセットのストレージ - hibernate.timezone.default_storage のデフォルトが DEFAULT になりました。
• Byte[]/Character[] マッピングの変更 - Hibernate 6.2 では、ドメインモデル内の Byte[] のマッピングおよび Character[] マッピングの変更を処理するように設定できます。
• オプションの 1 対 1 マッピングの UNIQUE 制約 - Hibernate の以前のバージョンでは、optional とマークされた論理 1 対 1 関連付けに対する UNIQUE 制約がデータベースに作成されませんでした。Hibernate 6.2 以降では、これらの UNIQUE 制約が作成されるようになりました。
• Oracle でのネイティブ SQL クエリーにおける number (n,0) の列型推論 - Hibernate 6.0 以降、Oracle でスケール 0 の number 型の列は、精度に応じて boolean、tinyint、smallint、int、または bigint と解釈されました。現在、スケール 0 の数値型の列は、精度に応じて int または bigint として解釈されます。
• レガシーデータベースバージョンのサポートの削除 - Hibernate 6.2 では、Hibernate でサポートされているほとんどのデータベースダイアレクトに対して、サポートされる最小データベースバージョンの概念が導入されています。
• CDI 処理の変更 - CDI が使用可能で設定されている場合、Hibernate は CDI BeanManager を使用してさまざまな Bean 参照を解決できます。Hibernate 6.2 以降では、hibernate.cdi.extensions が true に設定されている場合、これらのエクステンションは CDI BeanManager からのみ解決されます。
• 拡張デフォルトの変更と非推奨 - enableLazyInitialization および enableDirtyTracking 拡張ツールオプション、グローバルプロパティー hibernate.bytecode.use_reflection_optimizer、およびそれぞれの hibernate.enhancer.enableLazyInitialization および hibernate.enhancer.enableDirtyTracking 設定は、デフォルト値を true に切り替え、これらの設定は現在は非推奨となりました。
• org.hibernate.cfg および org.hibernate.loader のパッケージ更新: org.hibernate.cfg および org.hibernate.loader パッケージが更新され、API、SPI、および内部とみなされるコントラクトの違いが明確に表示されます。
• 統合コントラクト (SPI) の変更 - Hibernate ORM 6.2 の開発中に、EntityPersister#lock、EntityPersister#multiLoad、Executable#afterDeserialize、および JdbcType#getJdbcRecommendedJavaTypeMapping() の SPI が変更されました。
• クエリーパスの比較: Hibernate 6.2 に従って、パスの比較は早期に型チェックされます。
• バッチフェッチと LockMode - LockMode が READ より大きい場合、Hibernate はバッチフェッチを実行しないため、初期化されていない既存のプロキシーは初期化されません。これは、ロックモードがバッチフェッチキュー内のプロキシーの 1 つと異なるためです。

• org.hibernate.cfg.AnnotationConfiguration
• org.hibernate.id.TableGenerator
• org.hibernate.id.TableHiLoGenerator
• org.hibernate.id.SequenceGenerator

• ブートストラップの再設計に合わせて、org.hibernate.integrator.spi.Integrator インターフェイスが変更になりました。
• 新しいパッケージ org.hibernate.engine.jdbc.env.spi が作成されました。これには、org.hibernate.engine.jdbc.spi.JdbcServices インターフェイスからデプロイメントされた org.hibernate.engine.jdbc.env.spi.JdbcEnvironment インターフェイスが含まれます。
• org.hibernate.id.PersistentIdentifierGenerator 実装に影響する、新しい org.hibernate.boot.model.relational.ExportableProducer インターフェイスが導入されました。
• org.hibernate.id.Configurable の署名が変更になり、org.hibernate.dialect.Dialect のみでなく org.hibernate.service.ServiceRegistry を許可するようになりました。
• org.hibernate.metamodel.spi.TypeContributor インターフェイスは org.hibernate.boot.model.TypeContributor に移行されました。
• org.hibernate.metamodel.spi.TypeContributions インターフェイスは org.hibernate.boot.model.TypeContributions に移行されました。

• 組み込みの org.hibernate.type.descriptor.sql.SqlTypeDescriptor 実装は、org.hibernate.type.descriptor.sql.SqlTypeDescriptorRegistry で自動登録しないようになりました。組み込みの実装を拡張し、その動作に依存するカスタム SqlTypeDescriptor 実装を使用するアプリケーションを更新し、SqlTypeDescriptorRegistry.addDescriptor() を呼び出すようにする必要があります。
• 生成された UUID として定義された ID では、BINARY(16) を生成して適切に比較が行われるようにするため、一部のデータベースでは @Column(length=16) を明示的に設定する必要があります。
• hbm.xml で定義された EnumType マッピングの場合、javax.persistence.EnumType.STRING name-mapping が必要な場合は、useNamed(true) 設定を使用するか、VARCHAR 値を 12 に指定して、この設定を明示的に指定する必要があります。

• Hibernate ORM 5 では、トランザクション SPI が大幅に再設計されました。Hibernate ORM 4.3 では、org.hibernate.Transaction API を使用して異なるバックエンドトランザクションストラテジーに直接アクセスしました。Hibernate ORM 5 には間接参照のレベルが導入されました。org.hibernate.Transaction 実装はバックエンドで、バックエンドストラテジーに応じて指定のセッションのトランザクションコンテキストを表す org.hibernate.resource.transaction.TransactionCoordinator と対話するようになりました。開発者への直接的な影響はありませんが、ブートストラップの設定に影響する可能性があります。これまで、アプリケーションは非推奨となった hibernate.transaction.factory_class プロパティーを指定し、org.hibernate.engine.transaction.spi.TransactionFactory FQN (完全修飾名) を参照しました。Hibernate ORM 5 では、hibernate.transaction.coordinator_class 設定を指定し、org.hibernate.resource.transaction.TransactionCoordinatorBuilder を参照します。詳細は、org.hibernate.cfg.AvailableSettings.TRANSACTION_COORDINATOR_STRATEGY を参照してください。

• 以下の短縮名が認識されるようになりました。

  • jdbc: JDBC java.sql.Connection を使用してトランザクションを管理します。これは、Jakarta Persistence 以外のトランザクションのデフォルトです。

  • jta: Jakarta Transactions を使用してトランザクションを管理します。

    重要

    Jakarta Persistence アプリケーションが hibernate.transaction.coordinator_class プロパティーの設定を提供しない場合、Hibernate は永続化ユニットのトランザクションタイプを基にして自動的に適切なトランザクションコーディネーターを構築します。

    Jakarta 永続アプリケーションが hibernate.transaction.coordinator_class プロパティーの設定を提供しない場合、Hibernate はデフォルトで jdbc を使用してトランザクションを管理します。アプリケーションが実際に Jakarta Transactions を使用する場合は、このデフォルトによって問題が発生します。Jakarta Transaction を使用する JPA でないアプリケーションでは、hibernate.transaction.coordinator_class プロパティーの値を明示的に jta に設定するか、JTA ベースのトランザクションを適切に調整する org.hibernate.resource.transaction.TransactionCoordinator を構築するカスタムの org.hibernate.resource.transaction.TransactionCoordinatorBuilder を提供する必要があります。

• cfg.xml ファイルは完全に解析され、イベント、セキュリティー、およびその他の関数と統合されます。
• EntityManagerFactory を使用して cfg.xml からロードされたプロパティーは、これまで名前の前に hibernate が付きませんでした。これにより、一貫性が確立されました。
• 設定がシリアライズ不可能になりました。
• org.hibernate.dialect.Dialect.getQuerySequencesString() メソッドがカタログ、スキーマ、およびインクリメントの値を取得するようになりました。
• AuditConfiguration は org.hibernate.envers.boot.internal.EnversService から削除されました。
• AuditStrategy メソッドが変更され、廃止された AuditConfiguration を削除し、新しい EnversService を使用するようになりました。
• org.hibernate.hql.spi パッケージおよびサブパッケージの複数のクラスおよびインターフェイスが新しい org.hibernate.hql.spi.id に移動されました。これには MultiTableBulkIdStrategy クラスが含まれ、さらに AbstractTableBasedBulkIdHandler、TableBasedDeleteHandlerImpl、および TableBasedUpdateHandlerImpl インターフェイスとそれらのサブクラスが含まれます。
• プロパティーアクセスコントラクトが完全に再設計されました。
• 有効な hibernate.cache.default_cache_concurrency_strategy 設定の値は、org.hibernate.cache.spi.access.AccessType 列挙定数ではなく、org.hibernate.cache.spi.access.AccessType.getExternalName() メソッドを使用して定義されるようになりました。これにより、他の Hibernate 設定と統一されます。

• hbm2ddl.auto の処理と Hibernate の Jakarta Persistence schema-generation のサポートを統合します。
• NoSQL データストアの Jakarta Persistence サポートを提供する永続化エンジンである Hibernate OGM の置き換えを容易にするため、SPI から JDBC の懸念事項を削除。

• org.hibernate.tool.hbm2ddl.SchemaExport
• org.hibernate.tool.hbm2ddl.SchemaUpdate
• org.hibernate.tool.hbm2ddl.SchemaValidator
• org.hibernate.tool.schema.spi.SchemaManagementTool、またはその委譲

• The hibernate-java8 モジュールは hibernate-core にマージされ、Java 8 date/time データ型はネイティブにサポートされるようになりました。
• hibernate-entitymanager モジュールは hibernate-core にマージされました。HibernateEntityManager および HibernateEntityManagerFactory は非推奨となりました。
• 非推奨のクラスを削除し、Jakarta Persistence Metamodel API と適合させるため、Session、StatelessSession、および SessionFactory クラスの階層がリファクタリングされました。
• org.hibernate.persister および org.hibernate.tuple パッケージの SPI が変更になりました。これらの SPI を使用したカスタムクラスをすべて確認および更新する必要があります。
• LimitHandler の変更によって、レガシー Hibernate 4.3 の制限ハンドラーの動作を有効にできる新しい hibernate.legacy_limit_handler 設定が追加されました。これはデフォルトで false に設定されています。これは一部のダイアレクトに影響します。
• SchemaMigrator および SchemaValidator のパフォーマンスを向上する、データベーステーブル取得の新しいストラテジーが導入されました。
• 本リリースでは、PostgreSQL81Dialect とそのサブクラスの使用時に、@Lob アノテーションが付けられた String、character[]、および Character[] 属性の CLOB 値を処理する方法が変更になりました。
• @TableGenerator および @SequenceGenerator 名の範囲がグローバルからローカルに変更になりました。

• 位置クエリーパラメーター処理の変更により、以下が変更になりました。

  • HQL/JPQL クエリーの JDBC スタイルパラメーター宣言のサポートが削除されました。
  • Jakarta Persistence 位置パラメーターは名前付きパラメーターのように動作します。
  • ネイティブクエリーの JDBC スタイルパラメーター宣言は、Jakarta Persistence との一貫性を保つため、ゼロベースではなく 1 ベースのパラメーターバインディングを使用します。ゼロベースのバインディングに戻すには、hibernate.query.sql.jdbc_style_params_base プロパティーを true に設定します。
• Jakarta Persistence に準拠するため、@TableGenerator 値によって保存されるシーケンス値は最後に生成された値になります。これまで Hibernate は、次のシーケンス値を保存しました。このレガシー動作を有効にするには、hibernate.id.generator.stored_last_used プロパティーを使用します。@TableGenerator を使用し、Hibernate 5.3 に移行する既存のアプリケーションは hibernate.id.generator.stored_last_used configuration プロパティーを false に設定する必要があります。
• org.hibernate.query.QueryParameter クラスの getType() メソッドの名前が getHibernateType() に変更されました。
• さまざまなキャッシングプロバイダーの要件により多く適合するため、Hibernate の 2 次レベルキャッシュ SPI が再設計されました。詳細は HHH-11356 を参照してください。
• HHH-11356 の変更により、コンシューマーの変更も必要になりました。これは Hibernate Statistics システムに影響します。
• ネイティブアプリケーションの Hibernate ORM 5.1 から 5.3 への移行を容易にし、Hibernate 5.1 の改ページ調整動作を維持するため、一部のメソッドが一時的に org.hibernate.Query クラスに追加されましたが、これらのメソッドは非推奨となりました。今後のバージョンの Hibernate に移植できるようにするため、Jakarta Persistence メソッドを使用するようアプリケーションを更新する必要があります。
• Infinispan を Hibernate の 2 次キャッシュプロバイダーとして使用するためのサポートは、Infinispan プロジェクトに移されました。そのため、hibernate-infinispan モジュールは削除されました。
• org.hibernate.tool.enhance.EnhancementTask Ant タスクの API が変更になりました。setBase() および setDir() メソッドが推奨されるため、addFileset() メソッドは削除されました。詳細は HHH-11795 を参照してください。
• Hibernate 4.3 で見つかったバグにより、明示的にレイジー (Lazy) としてマップした場合でも、埋め込み可能なコレクション要素と複合 ID の多対 1 の関連が集中的に取得されました。Hibernate 5.3.2 ではこのバグが修正されました。そのため、このような関連はマッピングで指定されたとおりに取得されるようになりました。詳細は HHH-12687 を参照してください。
• 本リリースでは、Hibernate イベントリスナーの Jakarta Persistence およびネイティブ実装が統一されました。そのため、JpaIntegrator クラスは廃止されました。org.hibernate.jpa.event.spi.JpaIntegrator を拡張するクラスを変更し、org.hibernate.integrator.spi.Integrator インターフェイスを実装するように変更する必要があります。詳細は、HHH-11264 を参照してください。
• org.hibernate.persister パッケージの SPI が変更になりました。これらの SPI を使用したカスタムクラスをすべて確認および更新する必要があります。

• Hibernate51CompatibilityTransformer システムプロパティーを true に設定すると、トランスフォーマーをすべてのアプリケーションに対してグローバルに有効化できます。

• jboss-deployment-structure.xml ファイルを使用すると、アプリケーションレベルでトランスフォーマーを有効にできます。

  <jboss-deployment-structure>
    <deployment>
      <transformers>
        <transformer class="org.jboss.as.hibernate.Hibernate51CompatibilityTransformer"/>
      </transformers>
    </deployment>
    <sub-deployment name="main.war">
      <transformers>
        <transformer class="org.jboss.as.hibernate.Hibernate51CompatibilityTransformer"/>
      </transformers>
    </sub-deployment>
  </jboss-deployment-structure>

  Copy to Clipboard Toggle word wrap

• アプリケーションを Hibernate Search 5 から移行するには、Hibernate Search 6.0 の移行ガイド を参照してください。
• アプリケーションを Hibernate Search 6.0 から 6.1 に移行するには、Hibernate Search 6.1 の移行ガイド を参照してください。
• アプリケーションを Hibernate Search 6.1 から 6.2 に移行するには、Hibernate Search 6.2 の移行ガイド を参照してください。

• org.ejb.client.EJBClientInvocationContext クラスには、次の新しいメソッドが追加されます。

  Expand

  メソッド	型	説明
  isBlockingCaller()	boolean	この呼び出しによって呼び出しているスレッドが現在ブロックされているかどうかを判断します。
  isClientAsync()	boolean	メソッドがクライアント非同期としてマークされているか確認します。つまり、サーバー側のメソッドが非同期であるかに関係なく、呼び出しは非同期である必要があります。
  isIdempotent()	boolean	メソッドが冪等 (idempotent) としてマークされているか判断します。つまり、マークされていると、メソッドは追加の効果なしで複数回呼び出されることを意味します。
  setBlockingCaller(boolean)	void	この呼び出しによって呼び出しているスレッドが現在ブロックされているかどうかを確定します。
  setLocator(EJBLocator<T>)	<T> void	呼び出し先のロケーターを設定します。

  Show more

• org.ejb.client.EJBLocator クラスは以下の新しいメソッドに追加されました。

  Expand

  メソッド	型	説明
  asStateful()	StatefulEJBLocator<T>	ある場合、このロケーターをステートフルロケーターとして返します。
  asStateless()	StatelessEJBLocator<T>	ある場合、このロケーターをステートレスロケーターとして返します。
  isEntity()	boolean	これがエンティティーロケーターであるか判断します。
  isHome()	boolean	これがホームロケーターであるかどうかを判断します。
  isStateful()	boolean	これがステートフルロケーターであるかどうかを判断します。
  isStateless()	boolean	これがステートレスロケーターであるかどうかを判断します。
  withNewAffinity(Affinity)	abstract EJBLocator<T>	このロケーターのコピーを新しいアフィニティーで作成します。

  Show more

• java.security.Permission のサブクラスである新しい org.ejb.client.EJBClientPermission クラスは、特権のある Enterprise Java Beans 操作へのアクセスを制御するために導入されました。以下のコンストラクターを提供します。

  • EJBClientPermission(String name)
  • EJBClientPermission(String name, String actions)

• 以下のメソッドを提供します。

  Expand

  メソッド	型	説明
  equals(EJBClientPermission obj)	boolean	2 つの EJBClientPermission オブジェクトが等値であるかをチェックします。
  equals(Object obj)	boolean	2 つの Permission オブジェクトが等値であるかをチェックします。
  equals(Permission obj)	boolean	2 つの Permission オブジェクトが等値であるかをチェックします。
  getActions()	String	アクションを文字列として返します。
  hashcode()	int	この Permission オブジェクトのハッシュコード値を返します。
  implies(EJBClientPermission permission)	boolean	指定パーミッションのアクションが、この EJBClientPermission オブジェクトのアクションによって 暗示 されたかどうかをチェックします。
  implies(Permission permission)	boolean	指定パーミッションのアクションが、この Permission オブジェクトのアクションによって 暗示 されたかどうかをチェックします。

  Show more

• 特定の Enterprise Java Beans メソッドを検索するために、新しい org.ejb.client.EJBMethodLocator クラスが導入されました。以下のコンストラクターを提供します。

  • EJBMethodLocator(String methodName, String…​ parameterTypeNames)

• 以下のメソッドを提供します。

  Expand

  メソッド	型	説明
  equals(EJBMethodLocator other)	boolean	このオブジェクトが別のオブジェクトと等しいかどうかを判断します。
  equals(Object other)	boolean	このオブジェクトが別のオブジェクトと等しいかどうかを判断します。
  forMethod(Method method)	static EJBMethodLocator	指定のリフレクションメソッドのメソッドロケーターを取得します。
  getMethodName()	String	メソッド名を取得します。
  getParameterCount()	int	パラメーターの数を取得します。
  getParameterTypeName(int index)	String	指定インデックスのパラメーターの名前を取得します。
  hashCode()	int	ハッシュコードを取得します。

  Show more

• 失敗した場合のために、新しい org.jboss.ejb.client.EJBReceiverInvocationContext.ResultProducer.Failed クラスが導入されました。以下のコンストラクターを提供します。

  • Failed(Exception cause)

• 以下のメソッドを提供します。

  Expand

  メソッド	型	説明
  discardResult()	void	結果を破棄し、使用されないことを示します。
  getResult()	オブジェクト	結果を取得します。

  Show more

• 即座に結果を得るために、新しい org.jboss.ejb.client.EJBReceiverInvocationContext.ResultProducer.Immediate クラスが導入されました。以下のコンストラクターを提供します。

  • Failed(Exception cause)

• 以下のメソッドを提供します。

  Expand

  メソッド	型	説明
  discardResult()	void	結果を破棄し、使用されないことを示します。
  getResult()	オブジェクト	結果を取得します。

  Show more
• org.jboss.ejb.client.Affinity のサブクラスである新しい org.jboss.ejb.client.URIAffinity クラスが URI アフィニティー仕様に導入されました。これは、Affinity.forUri(URI) を使用して作成されます。

• 以下のメソッドを提供します。

  Expand

  メソッド	型	説明
  equals(Affinity other)	boolean	別のオブジェクトがこのオブジェクトと等しいかどうかを示します。
  equals(Object other)	boolean	別のオブジェクトがこのオブジェクトと等しいかどうかを示します。
  equals(URIAffinity other)	boolean	別のオブジェクトがこのオブジェクトと等しいかどうかを示します。
  getURI()	URI	関連する URI を取得します。
  hashCode()	int	ハッシュコードを取得します。
  toString()	String	オブジェクトの文字列表現を返します。

  Show more

• org.jboss.ejb.client.EJBMetaDataImpl クラスは次のメソッドを非推奨とします。

  • toAbstractEJBMetaData()
  • EJBMetaDataImpl(AbstractEJBMetaData<?,?>)

• Keycloak SAML クライアントを JBoss EAP 8.0 にインストールします。詳細は以下を参照してください。

  • jboss-eap-installation-manager を使用して JBoss EAP 8.0 をインストールする
  • SAML を使用してアプリケーションを保護するための Keycloak SAML アダプター機能パック
• 必要に応じて、PicketLink IdP の代わりに Keycloak SAML を設定します。Keycloak SAML を使用して SP アプリケーションを保護するには、SAML クライアントを作成する必要があります。Keycloak SAML クライアントの作成の詳細は、JBoss EAP 7.5 サーバー管理ガイド の SAML クライアントの作成 を参照してください。
• Keycloak SAML アダプターを使用するようにアプリケーションを更新します。アプリケーションの更新に関する詳細は、SAML を使用した Web アプリケーションの保護 を参照してください。

• アプリケーションの web.xml ファイル内の <auth-method>KEYCLOAK</auth-method> を確認し、デプロイメントの web.xml ファイル内の <auth-method>OIDC</auth-method> に置き換えます。
• WEB-INF/keycloak.json があることを確認し、その名前を WEB-INF/oidc.json に変更します。

• NegotiationAuthenticator バルブは jboss-web.xml には必要ありませんが、web.xml には <security-constraint> 要素と <login-config> 要素が定義されている必要があります。これらの要素は、セキュアなリソースを決定するのに使用されます。
• <login-config> 要素の auth-method 要素はコンマ区切りリストになりました。正確な値 SPNEGO が存在する必要があり、そのリストの最初に表示される必要があります。フォールバックとして FORM 認証が必要な場合、正確な値は SPNEGO,FORM になります。
• jboss-deployment-structure.xml ファイルは必要ありません。

• JBoss EAP 7 には、シングルトンサービスのビルドを大幅に簡易化する、新しいパブリック API が導入されました。シングルトンサービスの詳細は JBoss EAP 7.4 開発ガイド の HA シングルトンサービス を参照してください。
• 一度にクラスターで単一のノードのみをデプロイおよび開始するよう、シングルトンデプロイメントを設定できます。詳細は、JBoss EAP 7.4 開発ガイド の HA シングルトンデプロイメント を参照してください。
• クラスター化されたシングルトン MDB を定義できるようになりました。詳細は、JBoss EAP 7.4 Jakarta Enterprise Beans アプリケーションの開発 の クラスター化されたシングルトン MDB を参照してください。
• JBoss EAP 8.0 には Undertow mod_cluster 実装が含まれています。これは、http web サーバーを必要としない純粋な Java ロードバランシングソリューションを提供します。詳細は、JBoss EAP 7.4 設定ガイド の JBoss EAP をフロントエンドロードバランサーとして設定する を参照してください。

• 名前によるセッション管理プロファイルの参照
• デプロイメント固有のセッション管理設定の指定

• 既存の分散可能なセッション管理プロファイルを使用するには、アプリケーションの /WEB-INF ディレクトリーにある分散可能な distributable-web.xml デプロイメント記述子を含めます。以下に例を示します。

• または、既存の jboss-all.xml デプロイメント記述子に、ターゲット分散セッション管理プロファイルを定義します。

• デプロイメント記述子内にカスタムセッション管理設定を定義します。以下に例を示します。

• または、既存の jboss-all.xml デプロイメント記述子内にセッション管理設定を定義します。

• セッション Bean に org.jboss.ejb3.annotation.Clustered アノテーションを追加。

  @Stateful
  @Clustered
  public class MyBean implements MySessionInt {
  
     public void myMethod() {
        //
     }
  }

  Copy to Clipboard Toggle word wrap

• <clustered> 要素を jboss-ejb3.xml ファイルに追加。

  <c:clustering>
    <ejb-name>DDBasedClusteredSFSB</ejb-name>
    <c:clustered>true</c:clustered>
  </c:clustering>

  Copy to Clipboard Toggle word wrap

• Enterprise Java Beans 3.2 仕様の新機能である @Stateful(passivationCapable=false) を使用すると、単一のステートフルセッション Bean のデフォルト動作を無効にできます。
• サーバー設定の ejb3 サブシステムの設定で、この動作をグローバルに無効化します。

• 新しい org.wildfly.clustering.group.Group インターフェイスを使用すると、現在のクラスター状態へアクセスでき、クラスターメンバーシップの変更をリッスンできます。
• 新しい org.wildfly.clustering.dispatcher.CommandDispatcher インターフェイスを使用すると、すべてのノードまたはノードの選択されたサブセットのクラスターでコードを実行できます。

• wmq.jmsra.rar の以前のリソースアダプター設定を削除してデプロイ解除し、wmq.jakarta.jmsra.rar を使用します。
• wmq.jakarta.jmsra.rar をデプロイし、このセクションで説明されている手順に従って設定します。

• IBM MQ リソースアダプターは、wmq.jakarta.jmsra.rar というリソースアーカイブ (RAR) ファイルとして提供されます。wmq.jakarta.jmsra.rar ファイルは /opt/mqm/java/lib/jca/wmq.jakarta.jmsra.rar から取得できます。JBoss EAP の各リリースでサポートされる特定のバージョンに関する詳細は、JBoss EAP でサポートされる構成 を参照してください。

• 以下の IBM MQ 設定値を知っている必要があります。これらの値については、IBM MQ 製品のドキュメントを参照してください。

  • MQ_QUEUE_MANAGER: IBM MQ キューマネージャーの名前
  • MQ_HOST_NAME: IBM MQ キューマネージャーへの接続に使用されるホスト名
  • MQ_CHANNEL_NAME: IBM MQ キューマネージャーへの接続に使用されるサーバーチャネル
  • MQ_QUEUE_NAME: 宛先キューの名前
  • MQ_TOPIC_NAME: 宛先トピックの名前
  • MQ_PORT: IBM MQ キューマネージャーへの接続に使用されるポート
  • MQ_CLIENT: トランスポートタイプ

• 送信接続の場合は、以下の設定値も理解している必要があります。

  • MQ_CONNECTIONFACTORY_NAME: リモートシステムへの接続を提供する接続ファクトリーインスタンスの名前