7.2 旧バージョンと非互換の変更
このドキュメントは、サードパーティのLiferay開発者またはユーザーとの既存の機能、API、または契約に違反する変更の時系列リストを示しています。 私たちはこれらの混乱を最小限にするために最善を尽くしていますが、時には避けられないこともあります。
このファイルに記載されている変更の種類の一部を次に示します。
- 削除または置換される機能
- APIの非互換性:パブリックJavaまたはJavaScript APIの変更
- テンプレートで利用可能なコンテキスト変数の変更
- Liferayテーマおよびポートレットで利用可能なCSSクラスの変更
- 設定の変更:
portal.properties、system.propertiesなどの設定ファイルの変更 - 実行要件:Javaバージョン、Java EEバージョン、ブラウザーバージョンなど
- 非推奨またはサポート終了:たとえば、次のバージョンで特定の機能またはAPIが停止されると警告している
- 推奨事項:たとえば、後方互換性のためにLiferay Portalに古いAPIが保持されているにもかかわらず、古いAPIに代わる、新しく導入されたAPIを使用することを推奨している
旧バージョンと非互換の変更リスト
テーマ内の JSP テンプレートのサポートを削除しました
- 日付: 2018-11-14
- JIRAチケット: LPS-87064
変更点
テーマは JSP テンプレートを活用できなくなりました。 また、関連するロジックは、パブリックAPI com.liferay.portal.kernel.util.ThemeHelperおよびcom.liferay.taglib.util.ThemeUtilから削除されました。
影響を受ける人
これは、JSP テンプレートを使用するテーマを持っているユーザー、または削除されたメソッドを使用しているユーザーに影響します。
コードの更新方法
JSP テンプレートを使用するテーマがある場合は、FreeMarker への移行を検討してください。
変更が行われた理由
JSP は実際のテンプレート エンジンではないため、ほとんど使用されません。 今後は FreeMarker が推奨されるテンプレート エンジンになります。
JSP テンプレートの削除により、既存および新しいテンプレート エンジンに重点を置くことができます。
Lodashはデフォルトで含まれなくなりました
- 日付: 2018-11-27
- JIRAチケット: LPS-87677
変更点
以前は、Lodash はデフォルトですべてのページに含まれており、グローバル window._ およびスコープ付き AUI._ 変数を通じて利用可能でした。 Lodash はデフォルトで含まれなくなり、それらの変数は未定義になりました。
影響を受ける人
これは、カスタム スクリプトで AUI._ または window._ 変数を使用したすべての開発者に影響します。
コードの更新方法
サードパーティのライブラリを追加するための可能な戦略のいずれかに従って、カスタム開発で使用するために独自の Lodash バージョンを提供する必要があります。
一時的な対策として、Liferay Portal の コントロール パネル → 構成 → システム設定 → サードパーティ → Lodash にある Lodash を有効にする プロパティを trueに設定することで、以前の動作に戻すことができます。
変更が行われた理由
この変更は、ほとんどの場合未使用で冗長なすべてのページに追加のライブラリコードをバンドルして提供することを回避するために行われました。
2つのステージングポータルプロパティをOSGi構成に移動
- 日付: 2018年12月12日
- JIRAチケット: LPS-88018
変更点
2 つのステージング プロパティが portal.properties から export-import-service モジュール内の ExportImportServiceConfiguration.java という名前の OSGi 構成に移動されました。
影響を受ける人
これは、次のポータル プロパティを使用するすべてのユーザーに影響します。
staging.delete.temp.lar.on.failurestaging.delete.temp.lar.on.success
コードの更新方法
portal.properties ファイルを上書きする代わりに、ポータルの構成管理者からプロパティを管理できます。 これは、Liferay ポータルの コントロール パネル → 構成 → システム設定 → インフラストラクチャ → エクスポート/インポート に移動して、そこで設定を編集することでアクセスできます。
アプリケーションに新しい構成を含める場合は、「 アプリケーションを構成可能にする」の手順に従ってください。
変更が行われた理由
この変更は、ポータル構成の変更を容易にするためのモジュール化の取り組みの一環として行われました。
ページの機能へのリンクアプリケーションURLを削除
- 日付: 2018年12月14日
- JIRA チケット: LPS-85948
変更点
ルックアンドフィールポートレットの ポートレット URL をページ にリンクするオプションは、Liferay Portal 7.1 で非推奨とマークされ、ユーザーは設定プロパティを通じてこのオプションを表示および非表示にできるようになりました。 Liferay Portal 7.2 では、これは削除されており、設定できなくなりました。
影響を受ける人
これは、UI でオプションを使用した管理者と、ポートレットでオプションを活用した開発者に影響します。
コードの更新方法
ポータルではプロパティへの事前構成された参照は無視されるため、この機能を活用するポートレットを更新する必要があります。
変更が行われた理由
このプロパティを使用するポートレットの数は限られています。同じ結果を得るには、よりよい方法があります。
TermsOfUseContentProvider を kernel.util から移動しました
- 日付: 2019-Jan-07
- JIRA チケット: LPS-88869
変更点
TermsOfUseContentProvider インターフェースのパッケージが変更されました:
com.liferay.portal.kernel.util → com.liferay.portal.kernel.term.of.use
TermsOfUseContentProviderRegistryUtil クラスの名前とパッケージが変更されました:
利用規約コンテンツプロバイダレジストリユーティリティ → 利用規約コンテンツプロバイダユーティリティ
および
com.liferay.portal.kernel.util → com.liferay.portal.internal.terms.of.use
TermsOfUseContentProvider を取得するロジックも変更されました。 登録されたサービスの順序に依存するランダムな最初のサービスを常に返すのではなく、 TermsOfUseContentProvider サービスが追跡され、 com.liferay.portal.kernel.util.ServiceProxyFactoryで更新されます。 その結果、 TermsOfUseContentProvider はサービスランキングを尊重するようになりました。
影響を受ける人
これは、com.liferay.portal.kernel.util.TermsOfUseContentProviderRegistryUtilを使用してcom.liferay.portal.kernel.util.TermsOfUseContentProviderサービスを検索していたすべての人に影響します。
コードの更新方法
com.liferay.portal.kernel.util.TermsOfUseContentProviderを使用する場合は、インポートパッケージ名を更新してください。 portal-webで何か使用している場合は、com.liferay.portal.kernel.util.TermsOfUseContentProviderRegistryUtilをcom.liferay.portal.kernel.term.of.use.TermsOfUseContentProviderUtilに更新してください。 モジュール内のcom.liferay.portal.kernel.util.TermsOfUseContentProviderRegistryUtilの使用を削除し、代わりに@Referenceアノテーションを使用してcom.liferay.portal.kernel.term.of.use.TermsOfUseContentProviderサービスをフェッチします。
変更が行われた理由
これは、パッケージ バージョンがロックダウンされる可能性を減らすためにカーネル プロバイダー インターフェイスをクリーンアップするいくつかの手順のうちの 1 つです。
HibernateConfigurationConverterとConverterを削除しました
- 日付: 2019-Jan-07
- JIRAチケット: LPS-88870
変更点
インターフェイスcom.liferay.portal.kernel.util.Converterとその実装com.liferay.portal.spring.hibernate.HibernateConfigurationConverterが削除されました。
影響を受ける人
これにより、 HibernateConfigurationConverterによって実装されたカスタマイズされた portlet-hbm.xml ファイルの生成のサポートが削除されます。 詳細については、 LPS-5363 を参照してください。
コードの更新方法
HibernateConfigurationConverterの使用を削除する必要があります。 生成された portlet-hbm.xml が正確であることを確認します。
変更が行われた理由
これは、パッケージ バージョンがロックダウンされる可能性を減らすためにカーネル プロバイダー インターフェイスをクリーンアップするいくつかの手順のうちの 1 つです。
JDK関数とサプライヤーを使用するように切り替えました
- 日付: 2019-Jan-08
- JIRA チケット: LPS-88911
変更点
パッケージ com.liferay.portal.kernel.util 内の Function および Supplier インターフェースが削除されました。 それらの使用は、java.util.function.Functionおよびjava.util.function.Supplierに置き換えられました。
影響を受ける人
これは、パッケージ com.liferay.portal.kernel.util内の Function および Supplier インターフェースを実装したすべてのユーザーに影響します。
コードの更新方法
com.liferay.portal.kernel.util.Functionとcom.liferay.portal.kernel.util.Supplierの使用を、それぞれjava.util.function.Functionとjava.util.function.Supplierに置き換える必要があります。
変更が行われた理由
これは、パッケージ バージョンがロックダウンされる可能性を減らすためにカーネル プロバイダー インターフェイスをクリーンアップするいくつかの手順のうちの 1 つです。
com.liferay.portal.service.InvokableServiceインターフェイスを廃止
- 日付: 2019-Jan-08
- JIRAチケット: LPS-88912
変更点
パッケージ com.liferay.portal.kernel.service 内の InvokableService および InvokableLocalService インターフェースが削除されました。
影響を受ける人
これは、パッケージ com.liferay.portal.kernel.service内の InvokableService および InvokableLocalService を使用していたすべてのユーザーに影響します。
コードの更新方法
InvokableService と InvokableLocalServiceの使用を削除する必要があります。 削除後にコンパイル エラーが発生する可能性があるので、サービスの実装を生成するには必ず最新バージョンの Service Builder を使用してください。
変更が行われた理由
これは、パッケージ バージョンがロックダウンされる可能性を減らすためにカーネル プロバイダー インターフェイスをクリーンアップするいくつかの手順のうちの 1 つです。
ServiceLoaderCondition のサポートを終了しました
- 日付: 2019-Jan-08
- JIRAチケット: LPS-88913
変更点
パッケージ com.liferay.portal.kernel.util 内のインターフェース ServiceLoaderCondition とその実装 DefaultServiceLoaderCondition が削除されました。
影響を受ける人
これは、 ServiceLoaderCondition と DefaultServiceLoaderConditionを使用しているすべてのユーザーに影響します。
コードの更新方法
ServiceLoaderConditionの使用を削除する必要があります。 更新されたメソッドシグネチャに従って、com.liferay.portal.kernel.util.ServiceLoaderのloadメソッドの使用を更新します。
変更が行われた理由
これは、パッケージ バージョンがロックダウンされる可能性を減らすためにカーネル プロバイダー インターフェイスをクリーンアップするいくつかの手順のうちの 1 つです。
JDK述語を使用するように切り替えました
- 日付: 2019-Jan-14
- JIRA チケット: LPS-89139
変更点
インターフェイスcom.liferay.portal.kernel.util.PredicateFilterが削除され、java.util.function.Predicateに置き換えられました。 その結果、次の実装は削除されました。
com.liferay.portal.kernel.util.AggregatePredicateFiltercom.liferay.portal.kernel.util.PrefixPredicateFiltercom.liferay.portal.kernel.portlet.JavaScriptPortletResourcePredicateFiltercom.liferay.dynamic.data.mapping.form.values.query.internal.model.DDMFormFieldValuePredicateFilter
com.liferay.portal.kernel.util.ArrayUtil_IW クラスが再生成されました。
影響を受ける人
これは、 PredicateFilter、 AggregatePredicateFilter、 PrefixPredicateFilter、 JavaScriptPortletResourcePredicateFilter、および DDMFormFieldValuePredicateFilterを使用しているすべてのユーザーに影響します。
コードの更新方法
com.liferay.portal.kernel.util.PredicateFilterの使用をjava.util.function.Predicateに置き換える必要があります。 さらに、 AggregatePredicateFilter、 PrefixPredicateFilter、 JavaScriptPortletResourcePredicateFilter、および DDMFormFieldValuePredicateFilterの使用を削除します。
変更が行われた理由
これは、パッケージ バージョンがロックダウンされる可能性を減らすためにカーネル プロバイダー インターフェイスをクリーンアップするいくつかの手順のうちの 1 つです。
com.liferay.portal.kernel.utilパッケージから安全でない機能インターフェイスを削除しました
- 日付: 2019-Jan-15
- JIRA チケット: LPS-89223
変更点
com.liferay.portal.osgi.util.test.OSGiServiceUtil クラスは削除されました。 また、次のインターフェースが com.liferay.portal.kernel.util パッケージから削除されました。
UnsafeConsumerUnsafeFunctionUnsafeRunnable
影響を受ける人
これは、上記のクラス/インターフェースを使用するすべてのユーザーに影響します。
コードの更新方法
com.liferay.portal.osgi.util.test.OSGiServiceUtil クラスは、Liferay Portal 7.1 以降では廃止されています。 このクラスの使用がまだ存在する場合は、直接の代替品に置き換えてください: com.liferay.osgi.util.service.OSGiServiceUtil。 UnsafeConsumer、 UnsafeFunction および UnsafeRunnable の使用箇所を、パッケージ com.liferay.petra.function内の対応するインターフェースに置き換えます。
変更が行われた理由
これは、パッケージ バージョンがロックダウンされる可能性を減らすためにカーネル プロバイダー インターフェイスをクリーンアップするいくつかの手順のうちの 1 つです。
ポータル配布における NTLM の廃止
- 日付: 2019 年 1 月 21 日
- JIRA チケット: LPS-88300
変更点
NTLM モジュールは、 portal-security-sso プロジェクトから portal-security-sso-ntlmという新しいプロジェクトに移動されました。 この新しいプロジェクトは廃止されており、Liferay Marketplace からダウンロードできます。
影響を受ける人
これは、認証システムとして NTLM を使用しているすべてのユーザーに影響します。
コードの更新方法
NTLM を認証システムとして引き続き使用する場合は、Liferay Marketplace から対応するモジュールをダウンロードする必要があります。 あるいは、変更の必要がなく、Liferay Portal 7.0 以降と互換性のある Kerberos (推奨) に移行することもできます。
変更が行われた理由
この変更は、古い独自のソリューション (NTLM) の使用を回避するために行われました。 現在、標準プロトコルであり、NTLM と比較してより安全な認証方法である Kerberos が推奨されています。
ポータル配布における OpenID の廃止
- 日付: 2019 年 1 月 21 日
- JIRAチケット: LPS-88906
変更点
OpenID モジュールは、 portal-security-sso-openidという名前の新しいプロジェクトに移動されました。 この新しいプロジェクトは廃止されており、Liferay Marketplace からダウンロードできます。
影響を受ける人
これは、OpenID を認証システムとして使用しているすべてのユーザーに影響します。
コードの更新方法
OpenID を認証システムとして引き続き使用する場合は、Liferay Marketplace から対応するモジュールをダウンロードする必要があります。 あるいは、Liferay Portal Distribution で利用可能な OpenID Connect に移行する必要があります。
変更が行われた理由
この変更は、非推奨のソリューション (OpenID) の使用を回避するために行われました。 現在、OpenID Connect が推奨されています。これは、OAuth 上で実行されるため、より安全な認証方法です。
ポータル配布における Google SSO のサポート終了
- 日付: 2019 年 1 月 21 日
- JIRAチケット: LPS-88905
変更点
Google SSO モジュールは、 portal-security-sso プロジェクトから portal-security-sso-googleという新しいプロジェクトに移動されました。 この新しいプロジェクトは廃止されており、Liferay Marketplace からダウンロードできます。
影響を受ける人
これは、認証システムとして Google SSO を使用しているすべてのユーザーに影響します。
コードの更新方法
Google SSO を認証システムとして引き続き使用する場合は、Liferay Marketplace から対応するモジュールをダウンロードする必要があります。 あるいは、OpenID Connect を使用することもできます。
変更が行われた理由
この変更は、認証に古いソリューション (Google SSO) を使用することを避けるために行われました。 OpenID Connect は、認証に Google 実装を使用するための推奨仕様です。
liferay-amd-loader から Liferay.Loader.addModules を削除しました
- 日付: 2019年2月1日
- JIRA チケット: LPS-83949
変更点
addModules 関数は、liferay-amd-loader バージョン 4.x 以降から削除されました。
影響を受ける人
これは、liferay-amd-loader を直接使用してモジュールを定義するすべてのユーザーに影響します。
コードの更新方法
Liferay.Loader.addModules に直接代わるものはありません。
もう一つの方法は、モジュールを公開するための JS Toolkit プロジェクトを作成することです: https://github.com/liferay/liferay-frontend-projects/tree/master/maintenance/projects/js-toolkit/docs
変更が行われた理由
すべてのモジュール解決をサーバー側で実行すると、速度とネットワーク パフォーマンスが向上します。
アップデートされたAlloyEditor v2.0にはReactの新しいメジャーバージョンが含まれています
- 日付: 2019年2月4日
- JIRAチケット: LPS-90079
変更点
AlloyEditor はバージョン 2.0.0 にアップグレードされました。これには、React v15 から v16 へのメジャー アップグレードが含まれています。
React.createClass は、React v15.5.0 (2017 年 4 月) で 非推奨となり、React v16.0.0 (2017 年 9 月) で 削除されました。 AlloyEditor にバンドルされているすべてのボタンは、 React.createClassの代わりに ES6 クラス構文を使用するように更新されました。
影響を受ける人
これは、 React.createClassを使用して独自のボタンを作成したすべてのユーザーに影響します。 createClass 関数は使用できなくなり、実行時にアクセスしようとするとエラーが発生します。
コードの更新方法
次の 2 つの方法のいずれかでコードを更新する必要があります。
-
React.createClassAPI からカスタム ボタンを移植して、 React ドキュメントで説明されているように、ES6classAPI を使用します。 たとえば、 以前のcreateClassベースの実装から ES6 クラスベースのボタン に移行する際に加えられた変更を確認してください。 -
互換性アダプタを提供します。 create-react-classパッケージ(ここで説明)をページに注入することで、
createClassAPIを復元することができます。
変更が行われた理由
この変更は、React の新しいメジャー バージョンを使用するために行われました。これにより、パフォーマンスと互換性が向上し、非推奨の API が削除されてバンドル サイズが削減されます。
dl.tabs.visibleポータルプロパティは非推奨になりました
- 日付: 2019年4月10日
- JIRA チケット: LPS-93948
変更点
dl.tabs.visible プロパティを使用すると、ウィジェット ページに配置されたときに、ドキュメント ウィジェットとメディア ウィジェットのナビゲーション タブの表示を切り替えることができます。 この設定オプションは削除されたため、ウィジェット ページにナビゲーション タブは表示されなくなります。
影響を受ける人
これは、 dl.tabs.visible プロパティを trueに設定したすべてのユーザーに影響します。
コードの更新方法
コードの変更は必要ありません。
変更が行われた理由
ドキュメント & メディアは UX の観点からレビューされており、ウィジェット ページのナビゲーション タブの削除は UI クリーンアップ プロセスの一部です。
ユーザーメニューを製品メニューから移動
- 日付: 2019年4月19日
- JIRA チケット: LPS-87868
変更点
ユーザーメニューはプロダクトメニューから削除され、ユーザーメニューエントリは、ユーザーのアバターによってトリガーされるドロップダウンメニューである新しいパーソナルメニューに移動されました。
影響を受ける人
これは、プロダクトメニューのユーザーメニューセクションをカスタマイズしたすべてのユーザーに影響します。
コードの更新方法
カスタム ユーザー メニュー エントリを保持し、それをパーソナル メニューで使用できるようにするには、 PersonalMenuEntry インターフェイスを実装する必要があります。 PanelCategoryKeys.USER、 PanelCategoryKeys.USER_MY_ACCOUNT、および PanelCategoryKeys.USER_SIGN_OUT パネル カテゴリ キーに登録されているすべてのパネル アプリは、 PersonalMenuEntryに変換する必要があります。
変更が行われた理由
製品ナビゲーションはUXの観点から見直されており、プロダクトメニューからユーザーメニューを削除し、メニューを独自のメニューに分割することで、ユーザーエクスペリエンスが向上します。
香港とマカオを国リストから削除
- 日付: 2019年4月26日
- JIRAチケット: LPS-82203
変更点
香港とマカオは国リストから削除され、それぞれ湘港(地域コード:CN-91)と澳門(地域コード:CN-92)として中国の地域としてリストされました。
影響を受ける人
これは、住所に香港またはマカオを使用しているすべての人に影響します。
コードの更新方法
コードの変更は必要ありません。 ただし、コード内で香港とマカオの countryId をハードコードしている場合は、中国の countryIdに更新する必要があります。 香港とマカオへの参照は、対応する regionIdを使用して行う必要があります。
変更が行われた理由
1997年の香港、1999年のマカオの返還後、香港とマカオは現在中国の特別行政区となっている。
JGroups が 3.6.16 から 4.1.1 にアップグレードされました
- 日付: 2019年8月15日
- JIRA チケット: LPS-97897
変更点
JGroups はバージョン 3.6.16 から 4.1.1 にアップグレードされました。
影響を受ける人
これは Cluster Link を使用するすべてのユーザーに影響します。
コードの更新方法
portal.properties の cluster.link.channel.properties.* プロパティは、値として接続文字列を受け入れなくなり、構成 XML ファイルへのファイル パスが必要になりました。 3.6.16 の一部のプロトコル プロパティは削除され、4.1.1 では解析されなくなりました。それに応じてプロトコル プロパティを更新する必要があります。
変更が行われた理由
このアップグレードはセキュリティの問題を修正するために行われました。
Liferay AssetEntries_AssetCategories は使用されなくなりました
変更点
以前は、Liferayは、 AssetEntryLocalService と AssetCategoryLocalService内の AssetEntry と AssetCategory の関係にマッピングテーブルと対応するインターフェースを使用していました。 このマッピング テーブルと対応するインターフェイスは、テーブル AssetEntryAssetCategoryRel とサービス AssetEntryAssetCategoryRelLocalServiceに置き換えられました。
影響を受ける人
これは、 AssetEntries_AssetCategories 関係の古いインターフェイスを AssetEntryLocalService と AssetCategoryLocalServiceを通じて呼び出すことに依存するコンテンツまたはコードに影響します。
コードの更新方法
AssetEntryAssetCategoryRelLocalService の新しいメソッドを使用して、以前と同じデータを取得します。 メソッド シグネチャは変更されていません。別のサービスに再配置されただけです。
例
古い方法:
List<AssetEntry> entries =
AssetEntryLocalServiceUtil.getAssetCategoryAssetEntries(categoryId);
for (AssetEntry entry: entries) {
...
}
新しい方法:
long[] assetEntryPKs =
_assetEntryAssetCategoryRelLocalService.getAssetEntryPrimaryKeys(assetCategoryId);
for (long assetEntryPK: assetEntryPKs) {
AssetEntry = _assetEntryLocalService.getEntry(assetEntryPK);
...
}
...
@Reference
private AssetEntryAssetCategoryRelLocalService _assetEntryAssetCategoryRelLocalService;
@Reference
private AssetEntryLocalService _assetEntryLocalService;
変更が行われた理由
この変更は、開発者が特定のカテゴリのアセットリストの順序を制御できる LPS-76488による変更によって行われました。
自動タグ付けは手動で再構成する必要がある
- 日付: 2019年10月2日
- JIRAチケット: LPS-97123
変更点
自動タグ付け構成の名前が変更され、再編成されました。 自動アップグレード プロセスはなくなったため、自動タグ付けを手動で再構成する必要があります。
影響を受ける人
これは、SP1 にアップグレードされ、自動タグ付けが構成され有効になっている DXP 7.2 インストールに影響します。
コードの更新方法
システム設定を通じて自動タグ付けを再設定する必要があります (詳細については、 公式ドキュメント を参照してください)。 古い構成インターフェースを参照するコードは、新しいインターフェースを使用するように更新する必要があります。
変更が行われた理由
この変更により、以前は分割されていた構成インターフェースが統合され、ユーザー エクスペリエンスが向上します。
ブログ画像ポータルプロパティをシステム設定に移動
- 日付: 2019年10月2日
- JIRA チケット: LPS-95298
変更点
ブログ画像の設定は、 portal.properties からシステム設定に移動されました。 自動アップグレード プロセスはないため、カスタム ブログ画像プロパティを手動で再構成する必要があります。
影響を受ける人
これは、SP1 にアップグレードされ、 blogs.image.max.size および blogs.image.extensions プロパティにカスタム値を持つ DXP 7.2 インストールに影響します。
コードの更新方法
カスタムのブログ画像プロパティ値を保持する場合は、 構成 → ブログ → ファイルのアップロードのシステム設定で再構成する必要があります。 古いプロパティを参照するコードは、新しい構成インターフェースを使用するように更新する必要があります。
変更が行われた理由
この変更は、ブログの画像プロパティを再起動せずに構成できるようにするために行われました。
キャッシュブートストラップ機能を削除
- 日付: 2020-Jan-08
- JIRA チケット: LPS-96563
変更点
キャッシュブートストラップ機能は削除されました。 これらのプロパティは、キャッシュブートストラップを有効化/構成するために使用できなくなりました。
ehcache.bootstrap.cache.loader.enabled、 ehcache.bootstrap.cache.loader.properties.default、 ehcache.bootstrap.cache.loader.properties。${specific.cache.name}。
影響を受ける人
これは、上記のプロパティを使用するすべてのユーザーに影響します。
コードの更新方法
削除された機能を直接置き換えるものはありません。 それに依存するコードがある場合は、自分で実装する必要があります。
変更が行われた理由
この変更は、セキュリティの問題を回避するために行われました。
ContentTransformerListenerをデフォルトで無効化
- 日付: 2020年5月25日
- JIRA チケット: LPS-114239
変更点
ContentTransformerListener はデフォルト設定で無効になりました。
影響を受ける人
これは、ContentTransformerListenerによって提供されるレガシーなWebコンテンツ機能を使用したLiferay Portalのインストールに影響します。例えば、別のWebコンテンツ内にWebコンテンツを埋め込む、レガシーなエディット・イン・プレース・インフラストラクチャ、トークンの置換(23484947、@articleId;elementName@)などです。
コードの更新方法
コードを更新する必要はありません。 それでもContentTransformerListenerを使用する場合は、システム設定で有効にできます。
変更が行われた理由
ContentTransformerListenerは、記事要素に対して多くの文字列プロセスを実行します(記事フィールドに対してHtmlUtil.stripCommentsおよびHtmlUtil.stripHtmlを呼び出します)。 パフォーマンスを向上させるために無効にされました。
DDMDataProviderのメソッドを置き換え
- 日付: 2020-Jul-14
- JIRAチケット: LPS-81563
変更点
com.liferay.dynamic.data.mapping.data.provider.DataProviderのgetDataメソッドのddmDataProviderContextパラメーター(com.liferay.dynamic.data.mapping.data.provider.DDMDataProviderContext型)が、ddmDataProviderRequest(com.liferay.dynamic.data.mapping.data.provider.DDMDataProviderRequest型)に置き換えられました。
影響を受ける人
これは、置き換えられたメソッドを使用するすべてのユーザーに影響します。
コードの更新方法
com.liferay.dynamic.data.mapping.data.provider.DDMDataProviderContext型のパラメーターを、com.liferay.dynamic.data.mapping.data.provider.DDMDataProviderRequest型のパラメーターに置き換えます。
変更が行われた理由
この変更は、 LPS-81563のデータ プロバイダー API リファクタリングの一部です。
DDMDataProviderRequestのコンストラクターを削除
- 日付: 2020-Jul-14
- JIRAチケット: LPS-81563
変更点
コンストラクターメソッドがcom.liferay.dynamic.data.mapping.data.provider.DDMDataProviderRequestから削除されました。
影響を受ける人
これは、削除されたコンストラクターを使用するすべてのユーザーに影響します。
コードの更新方法
com.liferay.dynamic.data.mapping.data.provider.DDMDataProviderRequest.Builderを使用して、コンストラクターではなく、必要なすべてのパラメーターを使用して新しいcom.liferay.dynamic.data.mapping.data.provider.DDMDataProviderRequestを作成します。
変更が行われた理由
この変更は、 LPS-81563のデータ プロバイダー API リファクタリングの一部です。
DDMDataProviderRequestのメソッドを削除
- 日付: 2020-Jul-14
- JIRAチケット: LPS-81563
変更点
次のメソッドがcom.liferay.dynamic.data.mapping.data.provider.DDMDataProviderRequestから削除されました。
getDDMDataProviderContextsetDDMDataProviderContextgetHttpServletRequestgetParameterqueryString
影響を受ける人
これは、削除されたメソッドを使用していたすべてのユーザーに影響します。
コードの更新方法
com.liferay.dynamic.data.mapping.data.provider.DDMDataProviderRequestおよびcom.liferay.dynamic.data.mapping.data.provider.internal.DDMDataProviderInstanceSettingsImplを使用して、com.liferay.dynamic.data.mapping.data.provider.DDMDataProviderContextによって提供されるデータを取得します。
また、メソッドwithParameterを使用してcom.liferay.dynamic.data.mapping.data.provider.DDMDataProviderRequest.Builderを介してjavax.servlet.http.HttpServletRequestオブジェクトを追加し、メソッドgetParameterOptionalを使用してそれを取得します。
getParameterの代わりに既存のメソッドgetParameterOptionalを使用します。 queryStringの使用をcom.liferay.dynamic.data.mapping.data.provider.DDMDataProviderRequest.BuilderのメソッドwithParameterに置き換えて、必要なすべてのパラメーターを追加します。
変更が行われた理由
この変更は、 LPS-81563のデータ プロバイダー API リファクタリングの一部です。
DDMDataProviderRequestのメソッドを置き換え
- 日付: 2020-Jul-14
- JIRAチケット: LPS-81563
変更点
com.liferay.dynamic.data.mapping.data.provider.DDMDataProviderRequestのgetDDMDataProviderInstanceIdメソッドがgetDDMDataProviderIdに置き換えられました。
影響を受ける人
これは、置き換えられたメソッドを使用していたすべてのユーザーに影響します。
コードの更新方法
getDDMDataProviderInstanceIdの使用をgetDDMDataProviderIdに置き換えます。
変更が行われた理由
この変更は、 LPS-81563のデータ プロバイダー API リファクタリングの一部です。
DDMDataProviderResponseのメソッドを削除
- 日付: 2020-Jul-14
- JIRAチケット: LPS-81563
変更点
メソッドerror、of、およびgetDataMapがクラスcom.liferay.dynamic.data.mapping.data.provider.DDMDataProviderResponseから削除されました。
影響を受ける人
これは、削除されたメソッドを使用していたすべてのユーザーに影響します。
コードの更新方法
コードで次の更新されたメソッドを使用します。
errorメソッドを呼び出す代わりに、com.liferay.dynamic.data.mapping.data.provider.DDMDataProviderResponse.BuilderのwithStatusメソッドを使用します。ofメソッドをBuilderのwithStatusおよびwithOutputメソッドに置き換えます。BuilderのwithOutputメソッドを使用してgetDataMap呼び出しを出力追加に置き換え、メソッドgetOutputOptionalを介して取得します。
メソッドwithOutputは、必要な回数だけ呼び出すことができます。
変更が行われた理由
この変更は、 LPS-81563のデータ プロバイダー API リファクタリングの一部です。
DDMDataProviderResponseのメソッドを置き換え
- 日付: 2020-Jul-14
- JIRAチケット: LPS-81563
変更点
com.liferay.dynamic.data.mapping.data.provider.DDMDataProviderResponseのgetメソッドがgetOutputOptionalに置き換えられました。
影響を受ける人
これは、置き換えられたメソッドを使用していたすべてのユーザーに影響します。
コードの更新方法
getの代わりにgetOutputOptionalを使用します。
変更が行われた理由
この変更は、 LPS-81563のデータ プロバイダー API リファクタリングの一部です。
DDMDataProviderResponseのEnumを置き換え
- 日付: 2020-Jul-14
- JIRAチケット: LPS-81563
変更点
ローカルenum com.liferay.dynamic.data.mapping.data.provider.DDMDataProviderResponse.Statusが、com.liferay.dynamic.data.mapping.data.provider.DDMDataProviderResponseからcom.liferay.dynamic.data.mapping.data.provider.DDMDataProviderResponseStatusに移動されました その結果、com.liferay.dynamic.data.mapping.data.provider.DDMDataProviderResponseからのgetStatusのデータ型が、com.liferay.dynamic.data.mapping.data.provider.DDMDataProviderResponse.Statusからcom.liferay.dynamic.data.mapping.data.provider.DDMDataProviderResponseStatusに変更されました。
影響を受ける人
これは、置き換えられたenumを使用していたすべてのユーザーに影響します。
コードの更新方法
com.liferay.dynamic.data.mapping.data.provider.DDMDataProviderResponse.Statusの使用をcom.liferay.dynamic.data.mapping.data.provider.DDMDataProviderResponseStatusに置き換えます。
変更が行われた理由
この変更は、 LPS-81563のデータ プロバイダー API リファクタリングの一部です。
DDMDataProviderResponseOutputを削除
- 日付: 2020-Jul-14
- JIRAチケット: LPS-81563
変更点
com.liferay.dynamic.data.mapping.data.provider.DDMDataProviderResponseOutputが削除されました。
影響を受ける人
これは、削除されたクラスを使用していたすべてのユーザーに影響します。
コードの更新方法
削除されたクラスを直接置き換えるものはありません。 それに依存するコードがある場合は、自分で実装する必要があります。
変更が行われた理由
クラスcom.liferay.dynamic.data.mapping.data.provider.DDMDataProviderResponseOutputは、LPS-81563のデータプロバイダーコードに改善が実装された後に使用されなくなったため、廃止予定の警告なしに削除されました。
DDMDataProviderTrackerのメソッドを削除
- 日付: 2020-Jul-14
- JIRAチケット: LPS-81563
変更点
com.liferay.dynamic.data.mapping.data.provider.DDMDataProviderTrackerのgetDDMDataProviderContextContributorsメソッドが削除されました。
影響を受ける人
これは、削除されたメソッドを使用していたすべてのユーザーに影響します。
コードの更新方法
getDDMDataProviderContextContributorsの代わりにcom.liferay.dynamic.data.mapping.data.provider.DDMDataProviderRequestおよびcom.liferay.dynamic.data.mapping.data.provider.DDMDataProviderInstanceSettingsを使用して、必要なデータを取得します。
変更が行われた理由
com.liferay.dynamic.data.mapping.data.provider.DDMDataProviderContextクラスによって提供されるすべてのデータは、クラスcom.liferay.dynamic.data.mapping.data.provider.DDMDataProviderRequestおよびcom.liferay.dynamic.data.mapping.data.provider.DDMDataProviderInstanceSettingsにあります。 したがって、クラスcom.liferay.dynamic.data.mapping.data.provider.DDMDataProviderContextおよびcom.liferay.dynamic.data.mapping.data.provider.DDMDataProviderContextContributorは不要になりました。 com.liferay.dynamic.data.mapping.data.provider.DDMDataProviderContextContributorがLiferay Portal 7.2で削除されたことに注意してください。
DDMFormInstanceRecordLocalServiceのメソッドを置き換え
- 日付: 2020-Jul-14
- JIRAチケット: LPS-81564
変更点
この変更は、com.liferay.dynamic.data.mapping.service.DDMFormInstanceRecordLocalService、com.liferay.dynamic.data.mapping.service.DDMFormInstanceRecordLocalServiceUtil、およびcom.liferay.dynamic.data.mapping.service.DDMFormInstanceRecordLocalServiceWrapperに対して行われました。
getDDMFormValuesメソッドにはddmStorageId(long型)と呼ばれる単一のパラメーターがありましたが、現在は2つのパラメーターstorageId(ddmStorageIdの置換)とddmForm(com.liferay.dynamic.data.mapping.model.DDMForm型)があります。
影響を受ける人
これは、置き換えられたメソッドを使用していたすべてのユーザーに影響します。
コードの更新方法
メソッドにcom.liferay.dynamic.data.mapping.model.DDMForm型の新しいパラメーターを渡します。
変更が行われた理由
この変更は、 LPS-81564のストレージアダプタ API リファクタリングの一部です。
DDMStructureServiceのメソッドを削除
- 日付: 2020-Jul-14
- JIRA チケット: LPS-91760
変更点
以下にリストされているメソッドが、com.liferay.dynamic.data.mapping.service.DDMStructureService、com.liferay.dynamic.data.mapping.service.DDMStructureServiceUtil、およびcom.liferay.dynamic.data.mapping.service.DDMStructureServiceWrapperクラスから削除されました。
-
addStructure(パラメーターはlong userId、long groupId、long classNameId、Map<Locale, String> nameMap、Map<Locale, String> descriptionMap、com.liferay.dynamic.data.mapping.model.DDMForm ddmForm、com.liferay.dynamic.data.mapping.model.DDMFormLayout ddmFormLayout、String storageType、com.liferay.portal.kernel.service.ServiceContext serviceContext) -
addStructure(パラメーターはlong userId、long groupId、long classNameId、Map<Locale, String> nameMap、Map<Locale, String> descriptionMap、String xsd、com.liferay.portal.kernel.service.ServiceContext serviceContext) -
addStructure(パラメータ付きlong userId、long groupId、String parentStructureKey、long classNameId、String structureKey、Map<Locale, String> nameMap、Map<Locale, String> descriptionMap、文字列 xsd、文字列 storageType、int 型、com.liferay.portal.kernel.service.ServiceContext serviceContext) -
addStructure(パラメータ付きlong groupId、long parentStructureId、long classNameId、String structureKey、Map<Locale, String> nameMap、Map<Locale, String> descriptionMap、String xsd、文字列ストレージタイプ、int 型、com.liferay.portal.kernel.service.ServiceContext サービスコンテキスト) -
addStructure(パラメーターはlong userId、long groupId、String parentStructureKey、long classNameId、String structureKey、Map<Locale, String> nameMap、Map<Locale, String> descriptionMap、com.liferay.dynamic.data.mapping.model.DDMForm ddmForm、com.liferay.dynamic.data.mapping.model.DDMFormLayout ddmFormLayout、String storageType、int type、com.liferay.portal.kernel.service.ServiceContext serviceContext) -
updateStructure(パラメータ付きlong groupId、long parentStructureId、long classNameId、String structureKey、Map<Locale, String> nameMap、Map<Locale, String> descriptionMap、String definition、com.liferay.portal.kernel.service.ServiceContext サービスコンテキスト) -
updateStructure(パラメーターはlong structureId、long parentStructureId、Map<Locale, String> nameMap、Map<Locale, String> descriptionMap、String definition、com.liferay.portal.kernel.service.ServiceContext serviceContext)
影響を受ける人
これは、削除されたメソッドを使用していたすべてのユーザーに影響します。
コードの更新方法
削除されたメソッドを、残りのaddStructureメソッドとupdateStructureメソッドのいずれかに置き換えます。
変更が行われた理由
これらのメソッドは、Liferay Portal 7.0で廃止されました。
動的データマッピング永続性クラスのメソッドを削除
- 日付: 2020-Jul-14
- JIRA チケット: LPS-91760
変更点
メソッドfetchByPrimaryKeysおよびgetBadColumnNamesが次のクラスから削除されました。
com.liferay.dynamic.data.mapping.service.persistence.DDMContentPersistencecom.liferay.dynamic.data.mapping.service.persistence.DDMDataProviderInstancePersistencecom.liferay.dynamic.data.mapping.service.persistence.DDMFormInstancePersistencecom.liferay.dynamic.data.mapping.service.persistence.DDMFormInstanceRecordPersistencecom.liferay.dynamic.data.mapping.service.persistence.DDMFormInstanceVersionPersistencecom.liferay.dynamic.data.mapping.service.persistence.DDMStorageLinkPersistencecom.liferay.dynamic.data.mapping.service.persistence.DDMStructureLayoutPersistencecom.liferay.dynamic.data.mapping.service.persistence.DDMStructurePersistencecom.liferay.dynamic.data.mapping.service.persistence.DDMStructureVersionPersistencecom.liferay.dynamic.data.mapping.service.persistence.DDMTemplatePersistencecom.liferay.dynamic.data.mapping.service.persistence.DDMDataProviderInstanceLinkPersistencecom.liferay.dynamic.data.mapping.service.persistence.DDMFormInstanceRecordVersionPersistencecom.liferay.dynamic.data.mapping.service.persistence.DDMStructureLinkPersistencecom.liferay.dynamic.data.mapping.service.persistence.DDMTemplateLinkPersistencecom.liferay.dynamic.data.mapping.service.persistence.DDMTemplateVersionPersistence
影響を受ける人
これは、削除されたメソッドを使用していたすべてのユーザーに影響します。
コードの更新方法
削除されたメソッドを、基本クラスcom.liferay.portal.kernel.service.persistence.impl.BasePersistenceImplで提供されている対応するメソッドに置き換えます。
変更が行われた理由
基本クラスcom.liferay.portal.kernel.service.persistence.impl.BasePersistenceImplで提供されるデフォルトの実装があるため、fetchByPrimaryKeysのカスタム実装は必要ありません。
getBadColumnNamesは、インターフェイス(com.liferay.dynamic.data.mapping.service.persistence.DDMContentPersistenceなど)から自動的に削除され、クラスがService Builderによって生成されたときに実装クラス(com.liferay.dynamic.data.mapping.service.persistence.impl.DDMContentPersistenceImplなど)に保持されました。
動的データマッピングユーティリティクラスのメソッドを削除
- 日付: 2020-Jul-14
- JIRA チケット: LPS-91760
変更点
メソッドgetBadColumnNamesが次のクラスから削除されました。
com.liferay.dynamic.data.mapping.service.persistence.DDMContentUtilcom.liferay.dynamic.data.mapping.service.persistence.DDMDataProviderInstanceUtilcom.liferay.dynamic.data.mapping.service.persistence.DDMFormInstanceRecordUtilcom.liferay.dynamic.data.mapping.service.persistence.DDMFormInstanceUtilcom.liferay.dynamic.data.mapping.service.persistence.DDMFormInstanceVersionUtilcom.liferay.dynamic.data.mapping.service.persistence.DDMStorageLinkUtilcom.liferay.dynamic.data.mapping.service.persistence.DDMStructureLayoutUtilcom.liferay.dynamic.data.mapping.service.persistence.DDMStructureUtilcom.liferay.dynamic.data.mapping.service.persistence.DDMStructureVersionUtilcom.liferay.dynamic.data.mapping.service.persistence.DDMTemplateUtil
影響を受ける人
これは、削除されたメソッドを使用していたすべてのユーザーに影響します。
コードの更新方法
削除されたメソッドを、基本クラスcom.liferay.portal.kernel.service.persistence.impl.BasePersistenceImplで提供されている対応するメソッドに置き換えます。
変更が行われた理由
getBadColumnNamesは、永続性ユーティリティ(com.liferay.dynamic.data.mapping.service.persistence.DDMContentUtilなど)から自動的に削除され、クラスがService Builderによって生成されたときに永続性の実装(com.liferay.dynamic.data.mapping.service.persistence.impl.DDMContentPersistenceImplなど)に保持されました。
module.framework.properties.felix.fileinstall.* ポータル プロパティの名前を module.framework.properties.file.install.* に変更しました。
- 日付: 2020年8月8日
- JIRAチケット: LPS-115016
変更点
module.framework.properties.felix.fileinstall.で始まるポータルプロパティ module.framework.properties.file.install で始まるように名前が変更されました。。
影響を受ける人
これは、 module.framework.properties.felix.fileinstall.で始まるポータルプロパティを持つすべてのユーザーに影響します。。
コードの更新方法
module.framework.properties.felix.fileinstall.で始まるポータルプロパティの名前を変更します。 module.framework.properties.file.install から始めます。。
変更が行われた理由
この変更は、Apache Felix Fileinstallのインライン化を反映しています。 Liferayがこの機能を管理および維持するようになったため、プロパティの名前が適切に変更されました。
buffered.increment.enabledポータルプロパティの置き換え
- 日付: 2020年10月21日
- JIRAチケット: LPS-122159
変更点
buffered.increment.enabledポータルプロパティを使用したビューカウント管理の有効化と無効化は、view.count.enabledポータルプロパティを使用するように置き換えられました。
ビューカウントのグローバルな有効化と無効化が、view.count.enabledポータルプロパティを使用して実行されるようになりました。
たとえば、特定のエンティティのビューカウントを無効にするには、view.count.enabled[SomeEntity]=falseを設定することで可能になりました。
影響を受ける人
これは、buffered.increment.enabled=falseポータルプロパティ設定を持っているすべてのユーザーに影響します。
これは、buffered.increment.enabled[SomeEntity]=falseポータルプロパティ設定を使用して、一部のエンティティ(SomeEntityなど)のビューカウントを無効にしたすべてのユーザーに影響します。
コードの更新方法
buffered.increment.enabled=falseをview.count.enabled=falseに置き換えます。
buffered.increment.enabled[SomeEntity]=falseをview.count.enabled[SomeEntity]=falseに置き換えます。ここで、SomeEntityは、ビューカウントを無効にするエンティティです。
変更が行われた理由
これにより、ビューカウント動作の管理が容易になります。
module.framework.properties.file.install.optionalImportRefreshScopeポータルプロパティの削除
- 日付: 2021年2月3日
- JIRAチケット: LPS-122008
変更点
module.framework.properties.file.install.optionalImportRefreshScopeポータルプロパティが削除されました。 ファイルのインストールでは、更新が必要なオプションのパッケージを含むバンドルをスキャンするときに、常に管理対象バンドルのみがチェックされるようになりました。
影響を受ける人
これは、module.framework.properties.file.install.optionalImportRefreshScopeポータルプロパティを指定しているすべてのユーザーに影響します。
コードの更新方法
module.framework.properties.file.install.optionalImportRefreshScopeプロパティを削除します。 他の動作を使用するようにファイルのインストールを構成することはできません。
変更が行われた理由
代替動作が望まれるケースはほとんどありませんでした。 ファイルのインストールはバンドルをLiferayにインストールする主な方法であるため、すべてのバンドルはデフォルトでLiferayによって管理されます。 この機能をサポートする分岐ロジックを削除すると、コードの保守性と可読性が向上します。
.cfgファイルに.cfg形式を使用
- 日付: 2021年2月21日
- JIRAチケット: LPS-128031
変更点
この変更の前は、.cfgファイルは.cfgまたは.config形式を使用できました。 ここで、 .cfg 構成ファイルは、 .cfg 定義済み の形式を使用する必要があります。
影響を受ける人
これは、.config形式を使用している.cfgファイルを持っているすべてのユーザーに影響します。
コードの更新方法
.cfgファイルの名前を.configに変更し、.config形式を使用していることを確認するか、.cfgファイルを.cfg形式を使用するように変更します(上記のリンクを参照)。
変更が行われた理由
Apacheのファイルインストール実装により、.cfgファイルで.config形式を使用できるようになりました。 独自のファイルインストール実装を使用するように切り替えたとき、保守性を容易にするために、より厳密なフォーマット処理を行うことにしました。