jakarta系対応の2.0系を1.3系と並行リリースするための準備・移行作業

[mitonize]

目的

• 1.3系（javax.）と2.0系（jakarta.）を並行でリリース・保守できる状態を整備する

背景

• Spring Boot 3 / Jakarta EE 9以降ではjakarta.*へ移行
• 既存ユーザーのために1.3系を維持しつつ2.0系を提供する必要

影響範囲（想定）

• パッケージ名の変更（javax.* → jakarta.*）
• 依存関係の更新（Servlet, JSP, EL, JAXB/Activation など）
• テスト・ITテストの移行
• ビルド/配布方式（artifactId/classifier/branch戦略）
• ドキュメント（README/COMPATIBILITY/TESTINGなど）

作業項目（案）

1. ブランチ運用方針の決定（例：develop-1.3 / develop-2.0）
2. Jakarta対応の作業ブランチ作成
3. 依存関係棚卸しと移行対象洗い出し
4. ソース移行（パッケージ名置換）
5. 影響のあるAPI/挙動の確認（Servlet仕様差分など）
6. テスト修正・追加
7. ビルド/配布形態の整理（artifactId変更 or classifier運用）
8. ドキュメント更新
9. リリース手順の整備（タグ付け・リリースノート）

受け入れ条件

• 2.0系がjakarta.*でビルド/テスト可能
• 1.3系のメンテが継続可能な運用が確立
• 移行手順と差分が文書化されている

[mitonize]

ブランチ戦略の決定

LTSブランチ方式を採用することにしました。以下の構造で1.3系と2.0系を並行管理します。

ブランチ構造

v1.3 (1.3 LTS - Java 8+, javax.servlet)
　├── v1.3.0, v1.3.1, v1.3.2... (パッチリリース)
　├── 重要なバグ修正・セキュリティパッチのみ
　└── サポート期限: 2027年頃まで（目安）

main (2.0系 - Java 11+, jakarta.servlet)
　├── develop-2.0 (開発用ブランチ)
　├── v2.0.0-alpha, v2.0.0-beta... (プレリリース)
　└── v2.0.0リリース後はここがメインライン

Maven Artifact

• 1.3系: com.github.seasarorg.mayaa:mayaa:1.3.x

• 2.0系: com.github.seasarorg.mayaa:mayaa:2.0.x

  artifactIdは変更せず、バージョン番号で区別します。

Java/Servlet要件

バージョン	Java要件	Servlet API	パッケージ
1.3.x (LTS)	Java 8+	Servlet 3.1+	javax.servlet
2.0.x	Java 21+	Jakarta Servlet 6.1+	jakarta.servlet

サポート方針

1.3系 (LTS)

• 重大なバグ修正
• セキュリティパッチ
• 新機能は追加しない
• サポート期限: 2027年頃まで

2.0系

• アクティブ開発
• 新機能追加
• Jakarta EE 9以降に対応