Guidance for Claude Code when working in this repository.
Independent Java sample projects, each demonstrating one technique (a design pattern, an XML API, servlet scheduling, logging setup, etc.). No shared code between modules — each is self-contained with its own README explaining purpose and usage. Read that module's README before working on it.
The root pom.xml is a Maven aggregator (packaging=pom); its <modules> list is the authoritative index of active modules:
patterns/simple-factory— Factory Method GOF patternservlet/simple— minimal HTTP servlet (health check), runs in embedded Jetty or Tomcatservlet/simple-schedule-configurer— stateless scheduling viajava.util.Timerin aServletContextListenertesting/logback-logging-to-in-memory-stream— reconfiguring Logback to capture logs in-memory for testsxml/jaxb/generate-code-from-xsd— generating Java from XSD viamaven-jaxb2-plugin+jaxb2-basicsxml/schema-validation— validating XML against XSD withjavax.xml.validationxml/testing/comparing-with-xmlunit— comparing XML with XMLUnit 1.xxml/xpath-query— evaluating XPath expressions withjavax.xml.xpath
Dependency versions (JUnit, Mockito, SLF4J/Logback, JAXB, servlet-api) are centralized in the root POM's <dependencyManagement>; module POMs should inherit these rather than pinning their own.
Build/test everything:
mvn verifyBuild/test one module (from repo root, or cd into the module and run mvn verify directly):
mvn -pl <module-path> -am verifyStatic analysis, matching CI (.github/workflows/build-with-maven.yml):
mvn checkstyle:checkstyle -Dcheckstyle.config.location=google_checks.xml -Dcheckstyle.suppressions.location=./checkstyle-suppressions.xml
mvn pmd:check pmd:cpd -DlinkXRef=false
mvn com.github.spotbugs:spotbugs-maven-plugin:4.9.8.2:spotbugs -Dspotbugs.xmlOutput=true -Dspotbugs.effort=max -Dspotbugs.threshold=low -Dspotbugs.failOnError=trueCheckstyle uses Google's rules; repo-wide suppressions (indentation, star imports, some Javadoc checks) are in checkstyle-suppressions.xml.
servlet/simple-schedule-configurer and xml/testing/comparing-with-xmlunit also support Gradle (gradle test).
Module-specific run instructions (e.g. launching servlet/simple's server, or running XPathEvaluator/XmlValidator as CLI tools) live in each module's README.
GitHub Actions (.github/workflows/build-with-maven.yml) is the active CI: mvn verify plus separate SpotBugs, Checkstyle, and PMD jobs on every push. circle.yml (CircleCI) and Jenkinsfile are legacy and not actively used.