Task 2.2: Migrate JSoup Dependency

Task Description

Replace dot.jsoup with standard org.jsoup:jsoup dependency

Status: 🔄 PENDING

Scope

• Update 6+ import statements from repackaged JSoup to standard
• Remove dot.jsoup from POM files
• Add standard org.jsoup:jsoup dependency to BOM
• Test HTML parsing functionality

Implementation Plan

1. Dependency Update:

   • Remove com.dotcms.lib:dot.jsoup from BOM and dotCMS POM
   • Add standard org.jsoup:jsoup to BOM with appropriate version
   • Update dotCMS POM to use standard dependency

2. Code Migration:

   • Find all imports: com.dotcms.repackage.org.jsoup.*
   • Replace with: org.jsoup.*
   • Update approximately 6+ import statements

3. Testing:

   • Test HTML parsing functionality
   • Verify content processing works correctly
   • Run related unit tests

Acceptance Criteria

• [ ] All JSoup imports updated from repackaged to standard
• [ ] Standard JSoup dependency added to BOM
• [ ] Repackaged JSoup dependency removed from POM files
• [ ] All HTML parsing tests pass
• [ ] No functional regressions in HTML processing
• [ ] Integration tests pass

Claude Assistance Benefits

• Import Updates: Claude can handle bulk import statement changes across multiple files
• Pattern Recognition: Identify all JSoup usage patterns in codebase
• Testing Support: Help identify test cases that need verification
• Risk Assessment: Evaluate potential impact of JSoup version changes

Related

• Epic: #32675 - Remove Repackaged Dependencies
• Phase: 2 - Low-Risk Migrations
• Priority: Medium
• Estimated Effort: 1 day (with Claude assistance)

Technical Notes

• JSoup is used for HTML parsing and manipulation
• Verify version compatibility with existing code
• Check for any custom JSoup extensions or patches

Locate the BOM and dotCMS POM files, then search for com.dotcms.repackage.org.jsoup imports and the dot.jsoup dependency. Review the existing JSoup version and related unit or integration tests before making the migration. Done means standard imports and org.jsoup:jsoup are used, the repackaged dependency is removed, and HTML parsing and integration tests pass.