Java Code Formatter

This tool formats Java source code automatically to a defined style. Target users include developers, code reviewers, and instructors who need deterministic styling for large codebases. It solves problems of inconsistent indentation, line wrapping, and import placement that slow reviews. It accepts raw Java sources and returns reformatted code without changing semantics. It preserves comments and generics positions, and supports common Java coding conventions (JLS-inspired). Users specify a line width, brace style, and import ordering. It can operate as a service or library and integrates with CI pipelines to enforce formatting on commits and pull requests. It handles modern constructs (generics, annotations, multi-line strings) and keeps comments attached to their surrounding blocks.
Conceptually the formatter tokenizes input, builds a language-aware representation, and applies a rule set that reflows lines, aligns tokens, and organizes imports (including static imports). It maintains code semantics while adjusting whitespace, alignment, and indentation. It supports multiple configuration profiles and can export a profile for reuse. The initial pass performs a structural parse, followed by targeted re-formatting passes for indentation, line breaks, and braces. The algorithm is idempotent: formatting the same input with the same profile yields the same output, enabling reproducible results across teammates and environments.
Use cases include preparing pull requests, onboarding new codebases, and teaching formatting standards. Unique value lies in AST-based formatting, customizable profiles, strict import grouping, and preservation of comments. It supports typical Java versions, locale-neutral rules, and UTF-8 encoding. The tool suits automation, CI integration, and manual formatting sessions, helping teams maintain a clean, readable codebase with minimal manual edits. It operates without executing code, and it can be invoked as a library or a remote service with predictable outputs.