Compile & Verify

Build the project and run static checks matching CI.

Prerequisites

JDK 11, 17, or 21 (LTS versions)
Maven 3.6+ (use ./mvnw wrapper)

Maven profiles

backend (default): Builds OAP server modules
ui (default): Builds web application
dist (default): Creates distribution packages
all: Builds everything including submodule initialization

Commands by argument

`all` or no argument — full CI build

./mvnw clean flatten:flatten install javadoc:javadoc -B -q -Pall \
  -Dmaven.test.skip \
  -Dcheckstyle.skip \
  -Dgpg.skip

`backend` — backend only (faster)

./mvnw clean flatten:flatten package -Pbackend,dist -Dmaven.test.skip

`javadoc` — javadoc check only

Javadoc requires delombok output, so install must run first:

./mvnw clean flatten:flatten install javadoc:javadoc -B -q -Pall \
  -Dmaven.test.skip \
  -Dcheckstyle.skip \
  -Dgpg.skip

Running javadoc:javadoc alone without install will miss errors because ${delombok.output.dir} won't be populated.

`checkstyle` — checkstyle only

./mvnw -B -q clean flatten:flatten checkstyle:check

Module name — single module build

./mvnw clean flatten:flatten package -pl oap-server/analyzer/<module-name> -Dmaven.test.skip

Reading javadoc output

Maven prefixes all javadoc output with [ERROR], but the actual severity is in the message after the line number. Only lines containing error: fail the build; lines with warning: do not.

[ERROR] Foo.java:42: error: bad use of '>'        ← ACTUAL ERROR (must fix)
[ERROR] Foo.java:50: warning: no @param for <T>   ← WARNING (does not fail build)

Common javadoc errors

Error	Cause	Fix
`bad use of '>'`	Bare `>` in javadoc HTML (e.g., `->` in `<pre>` blocks)	Use `{@code ->}` or `->`
heading out of sequence	Heading level skips the expected hierarchy	See heading rules below
reference not found	`{@link Foo#bar()}` with wrong signature	Match exact parameter types: `{@link Foo#bar(ArgType)}`

Javadoc heading rules (JDK 13+)

Strict heading validation was introduced in JDK 13. JDK 11 does not enforce it, but JDK 17/21/25 do. Write headings correctly for forward compatibility:

Javadoc location	Start heading at
Class, interface, enum, package, module	`<h2>`
Constructor, method, field	`<h4>`
Standalone HTML files (`doc-files/`)	`<h1>`

The generated javadoc page uses <h1> for the class name and <h3> for member sections (Methods, Fields, etc.), so class-level subsections must use <h2> and method-level subsections must use <h4> to maintain proper nesting.

CI reference

CI uses JDK 11 on Linux. The dist-tar job runs:

./mvnw clean flatten:flatten install javadoc:javadoc -B -q -Pall \
  -Dmaven.test.skip \
  -Dcheckstyle.skip \
  -Dgpg.skip

The code-style job runs:

./mvnw -B -q clean flatten:flatten checkstyle:check

compile