前書き
今回の記事は「SE入門編」シリーズの一部です。完全版はこちらにあります：
今回の記事のソースはGithubにアップロードしております：
1. 前提条件
今回の記事は【番外編】となっており、MybatisとLOG4J2の知識があれば十分です。
Mybatisのログレベルの理解：
- ログレベル＝DEBUG:実行されるＳＱＬ文やパラメータが出力される
- ログレベル＝TRACE:ＳＱＬ文の実行結果（検索データ、件数など）が出力される
ただし、既に本編で構築したソースの上に、SQL文をログに出力するように追加を設定したため、興味をお持ちの方は本編から着手してください。
２. 今回の記事で出来たこと
-
各トランザクションで発行されたＳＱＬ文をログ（コンソルやログファイル）に出力することが出来た
-
ログ出力レベルを変えるだけで、出力内容が変わることが出来た
-
ログ出力レベル＝traceを設定した時に出力されたログ：DEBUG、TRACEのログが出力される（実際にはERROR、WARN、INFOも出力されるが、今回は例を作ってなかったです）
2024-02-04 10:53:38.088, [demo], [ DEBUG ], com.example.demo.repository.UserRepository.selectByPK, ==> Preparing: SELECT USER_ID, USER_NAME, PASSWORD, EMAIL, ROLE, TO_CHAR(LAST_LOGIN_DATE, 'YYYY/MM/DD HH24:MI:SS') LAST_LOGIN_DATE, LANG, DEL_FLG, DECODE(DEL_FLG, '1', 'Deleted', 'Active') DEL_FLG_TEXT, TO_CHAR(CREATE_DATE, 'YYYY/MM/DD HH24:MI:SS') CREATE_DATE, CREATE_USER, TO_CHAR(UPDATE_DATE, 'YYYY/MM/DD HH24:MI:SS') UPDATE_DATE, UPDATE_USER FROM USERS WHERE USER_ID = ?
2024-02-04 10:53:38.096, [demo], [ DEBUG ], com.example.demo.repository.UserRepository.selectByPK, ==> Parameters: ADMIN(String)
2024-02-04 10:53:38.103, [demo], [ TRACE ], com.example.demo.repository.UserRepository.selectByPK, <== Columns: USER_ID, USER_NAME, PASSWORD, EMAIL, ROLE, LAST_LOGIN_DATE, LANG, DEL_FLG, DEL_FLG_TEXT, CREATE_DATE, CREATE_USER, UPDATE_DATE, UPDATE_USER
2024-02-04 10:53:38.103, [demo], [ TRACE ], com.example.demo.repository.UserRepository.selectByPK, <== Row: ADMIN, システム 管理者, ADMIN, admin@test.com, ADMIN, 2024/02/03 21:19:32, en, 0, Active, 2023/12/31 17:15:58, ADMIN, 2023/12/31 17:15:58, ADMIN
- ログ出力レベル＝debugを設定した時に出力されたログ：DEBUGのログが出力される、TRACEのログが出力されない（実際にはERROR、WARN、INFOも出力されるが、今回は例を作ってなかったです）
2024-02-04 11:00:30.454, [demo], [ DEBUG ], com.example.demo.repository.UserRepository.selectByPK, ==> Preparing: SELECT USER_ID, USER_NAME, PASSWORD, EMAIL, ROLE, TO_CHAR(LAST_LOGIN_DATE, 'YYYY/MM/DD HH24:MI:SS') LAST_LOGIN_DATE, LANG, DEL_FLG, DECODE(DEL_FLG, '1', 'Deleted', 'Active') DEL_FLG_TEXT, TO_CHAR(CREATE_DATE, 'YYYY/MM/DD HH24:MI:SS') CREATE_DATE, CREATE_USER, TO_CHAR(UPDATE_DATE, 'YYYY/MM/DD HH24:MI:SS') UPDATE_DATE, UPDATE_USER FROM USERS WHERE USER_ID = ?
2024-02-04 11:00:30.454, [demo], [ DEBUG ], com.example.demo.repository.UserRepository.selectByPK, ==> Parameters: ADMIN(String)
2024-02-04 11:00:30.456, [demo], [ DEBUG ], com.example.demo.repository.UserRepository.selectByPK, <== Total: 1
- ログ出力レベル＝infoを設定した時、DEBUG、TRACEのログが出力されない（実際にはERROR、WARNも出力されるが、今回は例を作ってなかったです）
３. 実装(設定)
SQL文をLOG4J2ログに出力するには２つファイルの設定が必要です。ファイルの位置は下図をご確認ください。
- log4j2.xml：
name：リポジトリのJAVAファイル名を指定するか、リポジトリのフォルダ（package）を指定するか。JAVAファイル名を指定した場合、指定されたJAVAファイル名だけのSQL文を出力する、packageを指定する場合、指定されたpackageの全てリポジトリのSQL文を出力する
level: 設定したレベルよりも高いレベルのログが出力されるため、本番環境ではSQL文を出力することでレスポンスに影響が生じる可能性があり、そのためには通常 level="info" で設定されます。一方、テスト環境では debug か trace を設定することが一般的です。
<logger name="com.example.demo.repository" level="info" />
- mybatis-config.xml：ロギング実装をlog4j2で指定します
<setting name="logImpl" value="LOG4J2"/>
おわりに
プロジェクト全体のソースコードはGitHubにアップロードしました、ぜひダウンロードして確認してください。
それではまた。