Skip to content

feat: add Java/Spring Boot and AI agent docs (first Java content)#193

Open
rkp4u wants to merge 1 commit intoandrewyng:mainfrom
rkp4u:feat/java-spring-boot-content
Open

feat: add Java/Spring Boot and AI agent docs (first Java content)#193
rkp4u wants to merge 1 commit intoandrewyng:mainfrom
rkp4u:feat/java-spring-boot-content

Conversation

@rkp4u
Copy link
Copy Markdown

@rkp4u rkp4u commented Mar 24, 2026

Summary

Adds 8 curated documentation entries for the Java ecosystem — the first Java content in context-hub. This fills a major gap: the registry previously had zero Java coverage despite Java being one of the most widely used enterprise languages.

Spring Boot Ecosystem (6 entries)

  • spring-boot/package — Core setup, dependency injection, profiles, @ConfigurationProperties, actuator
  • spring-boot/rest-api — Controllers, bean validation, ProblemDetail (RFC 7807), exception handling, springdoc-openapi
  • spring-security/packageSecurityFilterChain (6.x), JWT auth, OAuth2 Resource Server, CORS, method security
  • spring-data/jpa — Repository patterns, query methods, pagination, N+1 solutions, @Transactional, auditing, specifications
  • hibernate/package — Entity mapping, fetch strategies, second-level cache, Hibernate 5→6 migration guide
  • junit/testing — JUnit 5, Mockito, @MockitoBean (Boot 3.4+), MockMvc, test slicing, @ServiceConnection with Testcontainers

AI Agent Tooling for Java (2 entries)

  • langchain4j/packageChatModel, AI Services, tool use (@Tool/@P), RAG, structured output, Spring Boot auto-config
  • langgraph4j/packageStateGraph API, channels, agent patterns (ReAct, Supervisor, Plan-and-Execute, Swarm), Spring Boot integration

Why This Matters for AI Agents

Every doc emphasizes what agents get wrong — clearly marking deprecated/removed APIs with "CRITICAL: Do NOT use" sections:

  • WebSecurityConfigurerAdapterSecurityFilterChain (removed in Security 6)
  • javax.persistence.*jakarta.persistence.* (Hibernate 6 / Jakarta EE)
  • antMatchers()requestMatchers() (removed in Security 6)
  • @MockBean@MockitoBean (deprecated in Boot 3.4)
  • springfoxspringdoc-openapi (springfox is abandoned)
  • ChatLanguageModelChatModel, .generate().chat() (LangChain4j 1.0 GA renames)
  • JUnit 4 vs JUnit 5 API mapping table

Validation

  • chub build content/ --validate-only1561 docs, 7 skills, 0 errors
  • All 8 files under 500-line limit
  • Frontmatter schema validated
  • Code examples reviewed for API accuracy against current library versions

Test plan

  • chub build content/ --validate-only passes
  • All YAML frontmatter valid (name, description, metadata fields)
  • All files under 500-line limit
  • No deprecated APIs in code examples (only in "DO NOT USE" warning sections)
  • Cross-file consistency verified (constructor injection, Jakarta imports, record DTOs)
  • Maintainer review of content accuracy

🤖 Generated with Claude Code

… context-hub

Add 8 curated documentation entries for the Java ecosystem, filling a major
gap in context-hub's coverage (previously zero Java content).

Spring Boot ecosystem (6 entries):
- spring-boot/package: Core setup, DI, profiles, configuration properties
- spring-boot/rest-api: Controllers, validation, ProblemDetail, OpenAPI
- spring-security/package: SecurityFilterChain, JWT, OAuth2, CORS (6.x)
- spring-data/jpa: Repositories, queries, pagination, N+1 solutions
- hibernate/package: Entity mapping, fetch strategies, Hibernate 5→6 migration
- junit/testing: JUnit 5, Mockito, MockMvc, test slicing, Testcontainers

AI agent tooling (2 entries):
- langchain4j/package: ChatModel, AI Services, tools, RAG, Spring Boot starter
- langgraph4j/package: StateGraph, agent patterns, checkpointing, Spring Boot integration

All docs focus on preventing common AI agent hallucinations by clearly marking
deprecated/removed APIs (WebSecurityConfigurerAdapter, javax.persistence,
ChatLanguageModel→ChatModel, @MockBean→@MockitoBean, springfox, etc.).

Validated with: chub build content/ --validate-only (1561 docs, 0 errors)

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant