legacy-knowledge-base
公開されました Sep. 10, 2025

2024.q1からプログラムでCXFエンドポイントとSoapエクステンダーを構成する

written-by

Jose Bodega

How To articles are not official guidelines or officially supported documentation. They are community-contributed content and may not always reflect the latest updates to Liferay DXP. We welcome your feedback to improve How To articles!

While we make every effort to ensure this Knowledge Base is accurate, it may not always reflect the most recent updates or official guidelines.We appreciate your understanding and encourage you to reach out with any feedback or concerns.

legacy-article

learn-legacy-article-disclaimer-text

問題

  • 新しいエンドポイントを作成するには、次のドキュメントに従ってカスタマイズSOAP拡張モジュールを作成します。

  • コンポーネントは、フォルダ resources → configuration next files の中にある:

    1. com.liferay.portal.remote.cxf.common.configuration.CXFEndpointPublisherConfiguration-authservice.config

    2. com.liferay.portal.remote.soap.extender.internal.configuration.SoapExtenderConfiguration-authservicejaxws.config

  • このコンフィギュレーションは、以下のコンフィギュレーションを作成した:
コントロールパネル -> システム設定 -> Web API → CXF Endopint および SOAP Extender は四半期ごとにバージョンアップします。
  • この設定方法は、現在の四半期バージョンで変更されています。

:以下の解決策はカスタマイズが必要であり、チームの裁量によってのみ実施されるべきである。 Liferayサポートはカスタマイズの設計や実装を支援することはできません。

環境

  • 2024.Q1+

解像度

  • 2024.q1 以降、カスタム・モジュールのコンフィギュレーションの作成方法が変更されました。 このコンフィギュレーションを正しく作成するための手順:
    • configuratorという名前のフォルダを作成し、モジュールのルートにconfigurations.jsonというファイルを1つ置く。 このファイルは、以前にconfigsファイルに保存されたコンフィギュレーションを含むJSONファイルでなければならない。 SoapExtenderConfigurationコンフィギュレーションの具体的なケースでは、Liferayソースコードのクラス自体を参照し、同じフィールドとフォーマットでJSONを記入してください。 同じことが CXFEndpointPublisherConfiguration.
    • モジュールがこのコンフィギュレーションを受け入れるように、bndファイルを以下のように更新する:
Require-Capability:♪
osgi.extender;♪
filter := "(&(osgi.extender=osgi.configurator)(version>=1.0)(!(version>=2.0)))"
-includeresource:OSGI-INF/configurator=configurator
    • 以下はconfigurations.jsonファイルの例である:
{
"com.liferay.portal.remote.soap.extender.internal.configuration.SoapExtenderConfiguration~testjaxws": {
"contextPaths": [
"/test"
],
"jaxWsHandlerFilterStrings":[],
"jaxWsServiceFilterStrings":[
"(jaxws.application=true)",
"(component.name=com.liferay.XXXX)"
],
"soapDescriptorBuilderFilter":""
},
"com.liferay.portal.remote.cxf.common.configuration.CXFEndpointPublisherConfiguration~test": {
"contextPath": "/test",
"authVerifierProperties":[
"auth.verifier.PortalSessionAuthVerifier.urls.includes=*",
"auth.verifier.BasicAuthHeaderAuthVerifier.urls.includes=*"
],
"extensions":[]
}
}

追加情報

  • このカスタマイズされた開発とは別に、コンフィギュレーションは、従来の.configコンフィギュレーションファイルを使用して、ポータル(LIFERAY_HOME-> osgi -> configs)を介して追加することができます。
  • ポータル自体(LIFERAY_HOME-> osgi -> configs)とカスタムモジュールの両方に同じ設定のコンフィギュレーションが同時に存在する場合、ポータルのコンフィギュレーションがカスタムのものより優先されます。

did-this-article-resolve-your-issue

legacy-knowledge-base