[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M72YN5WFCK1BK6W22CBXA7KA":3,"skill-same:01M72YN5WFCK1BK6W22CBXA7KA":48},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":25,"commitSha":26,"skillDirectory":27,"forksCount":28,"repositoryHtmlUrl":29,"repositoryHomepageUrl":6,"ownerHtmlUrl":30,"ownerBlogUrl":31,"ownerDescription":32,"updatedAt":33,"install":34,"resources":47},"01M72YN5WFCK1BK6W22CBXA7KA","java-coding-standards",null,"Java coding standards for Spring Boot and Quarkus services: naming, immutability, Optional usage, streams, exceptions, generics, CDI, reactive patterns, and project layout. Automatically applies framework-specific conventions.","SriramGandhiS\u002FSkills","SriramGandhiS","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F211849986?v=4","01M72WQCW12BYX71C6WN584TTA","Sriram S","01M72WQCWTJ2RD0ET1X31AF1RC",1,"MIT","https:\u002F\u002Fgithub.com\u002FSriramGandhiS\u002FSkills\u002Fblob\u002Fmaster\u002Feverything-claude-code\u002Fskills\u002Fjava-coding-standards\u002FSKILL.md",[],[],"2026-11-11 15:11:14",false,"---\nname: java-coding-standards\ndescription: \"Java coding standards for Spring Boot and Quarkus services: naming, immutability, Optional usage, streams, exceptions, generics, CDI, reactive patterns, and project layout. Automatically applies framework-specific conventions.\"\norigin: ECC\n---\n\n# Java Coding Standards\n\nStandards for readable, maintainable Java (17+) code in Spring Boot and Quarkus services.\n\n## When to Use\n\n- Writing or reviewing Java code in Spring Boot or Quarkus projects\n- Enforcing naming, immutability, or exception handling conventions\n- Working with records, sealed classes, or pattern matching (Java 17+)\n- Reviewing use of Optional, streams, or generics\n- Structuring packages and project layout\n- **[QUARKUS]**: Working with CDI scopes, Panache entities, or reactive pipelines\n\n## How It Works\n\n### Framework Detection\n\nBefore applying standards, determine the framework from the build file:\n\n- Build file contains `quarkus` → apply **[QUARKUS]** conventions\n- Build file contains `spring-boot` → apply **[SPRING]** conventions\n- Neither detected → apply shared conventions only\n\n## Core Principles\n\n- Prefer clarity over cleverness\n- Immutable by default; minimize shared mutable state\n- Fail fast with meaningful exceptions\n- Consistent naming and package structure\n- **[QUARKUS]**: Favor build-time over runtime processing; avoid runtime reflection where possible\n\n## Examples\n\nThe sections below show concrete Spring Boot, Quarkus, and shared Java examples\nfor naming, immutability, dependency injection, reactive code, exceptions,\nproject layout, logging, configuration, and tests.\n\n## Naming\n\n```java\n\u002F\u002F PASS: Classes\u002FRecords: PascalCase\npublic class MarketService {}\npublic record Money(BigDecimal amount, Currency currency) {}\n\n\u002F\u002F PASS: Methods\u002Ffields: camelCase\nprivate final MarketRepository marketRepository;\npublic Market findBySlug(String slug) {}\n\n\u002F\u002F PASS: Constants: UPPER_SNAKE_CASE\nprivate static final int MAX_PAGE_SIZE = 100;\n\n\u002F\u002F PASS: [QUARKUS] JAX-RS resources named as *Resource, not *Controller\npublic class MarketResource {}\n\n\u002F\u002F PASS: [SPRING] REST controllers named as *Controller\npublic class MarketController {}\n```\n\n## Immutability\n\n```java\n\u002F\u002F PASS: Favor records and final fields\npublic record MarketDto(Long id, String name, MarketStatus status) {}\n\npublic class Market {\n  private final Long id;\n  private final String name;\n  \u002F\u002F getters only, no setters\n}\n\n\u002F\u002F PASS: [QUARKUS] Panache active-record entities use public fields (Quarkus convention)\n@Entity\npublic class Market extends PanacheEntity {\n  public String name;\n  public MarketStatus status;\n  \u002F\u002F Panache generates accessors at build time; public fields are idiomatic here\n}\n\n\u002F\u002F PASS: [QUARKUS] Panache MongoDB entities\n@MongoEntity(collection = \"markets\")\npublic class Market extends PanacheMongoEntity {\n  public String name;\n  public MarketStatus status;\n}\n```\n\n## Optional Usage\n\n```java\n\u002F\u002F PASS: Return Optional from find* methods\n\u002F\u002F [SPRING]\nOptional\u003CMarket> market = marketRepository.findBySlug(slug);\n\n\u002F\u002F [QUARKUS] Panache\nOptional\u003CMarket> market = Market.find(\"slug\", slug).firstResultOptional();\n\n\u002F\u002F PASS: Map\u002FflatMap instead of get()\nreturn market\n    .map(MarketResponse::from)\n    .orElseThrow(() -> new EntityNotFoundException(\"Market not found\"));\n```\n\n## Streams Best Practices\n\n```java\n\u002F\u002F PASS: Use streams for transformations, keep pipelines short\nList\u003CString> names = markets.stream()\n    .map(Market::name)\n    .filter(Objects::nonNull)\n    .toList();\n\n\u002F\u002F FAIL: Avoid complex nested streams; prefer loops for clarity\n```\n\n## Dependency Injection\n\n```java\n\u002F\u002F PASS: [SPRING] Constructor injection (preferred over @Autowired on fields)\n@Service\npublic class MarketService {\n  private final MarketRepository marketRepository;\n\n  public MarketService(MarketRepository marketRepository) {\n    this.marketRepository = marketRepository;\n  }\n}\n\n\u002F\u002F PASS: [QUARKUS] Constructor injection\n@ApplicationScoped\npublic class MarketService {\n  private final MarketRepository marketRepository;\n\n  @Inject\n  public MarketService(MarketRepository marketRepository) {\n    this.marketRepository = marketRepository;\n  }\n}\n\n\u002F\u002F PASS: [QUARKUS] Package-private field injection (acceptable in Quarkus — avoids proxy issues)\n@ApplicationScoped\npublic class MarketService {\n  @Inject\n  MarketRepository marketRepository;\n}\n\n\u002F\u002F FAIL: [SPRING] Field injection with @Autowired\n@Autowired\nprivate MarketRepository marketRepository; \u002F\u002F use constructor injection\n\n\u002F\u002F FAIL: [QUARKUS] @Singleton when interception or lazy init is needed\n@Singleton \u002F\u002F non-proxyable — use @ApplicationScoped instead\npublic class MarketService {}\n```\n\n## Reactive Patterns [QUARKUS]\n\n```java\n\u002F\u002F PASS: Return Uni\u002FMulti from reactive endpoints\n@GET\n@Path(\"\u002F{slug}\")\npublic Uni\u003CMarket> findBySlug(@PathParam(\"slug\") String slug) {\n  return Market.find(\"slug\", slug)\n      .\u003CMarket>firstResult()\n      .onItem().ifNull().failWith(() -> new MarketNotFoundException(slug));\n}\n\n\u002F\u002F PASS: Non-blocking pipeline composition\npublic Uni\u003COrderConfirmation> placeOrder(OrderRequest req) {\n  return validateOrder(req)\n      .chain(valid -> persistOrder(valid))\n      .chain(order -> notifyFulfillment(order));\n}\n\n\u002F\u002F FAIL: Blocking call inside a Uni\u002FMulti pipeline\npublic Uni\u003CMarket> find(String slug) {\n  Market m = Market.find(\"slug\", slug).firstResult(); \u002F\u002F BLOCKING — breaks event loop\n  return Uni.createFrom().item(m);\n}\n\n\u002F\u002F FAIL: Subscribing more than once to a shared Uni\nUni\u003CMarket> shared = fetchMarket(slug);\nshared.subscribe().with(m -> log(m));\nshared.subscribe().with(m -> cache(m)); \u002F\u002F double subscribe — use Uni.memoize()\n```\n\n## Exceptions\n\n- Use unchecked exceptions for domain errors; wrap technical exceptions with context\n- Create domain-specific exceptions (e.g., `MarketNotFoundException`)\n- Avoid broad `catch (Exception ex)` unless rethrowing\u002Flogging centrally\n\n```java\nthrow new MarketNotFoundException(slug);\n```\n\n### Centralised Exception Handling\n\n```java\n\u002F\u002F [SPRING]\n@RestControllerAdvice\npublic class GlobalExceptionHandler {\n  @ExceptionHandler(MarketNotFoundException.class)\n  public ResponseEntity\u003CErrorResponse> handle(MarketNotFoundException ex) {\n    return ResponseEntity.status(404).body(ErrorResponse.from(ex));\n  }\n}\n\n\u002F\u002F [QUARKUS] Option A: ExceptionMapper\n@Provider\npublic class MarketNotFoundMapper implements ExceptionMapper\u003CMarketNotFoundException> {\n  @Override\n  public Response toResponse(MarketNotFoundException ex) {\n    return Response.status(404).entity(ErrorResponse.from(ex)).build();\n  }\n}\n\n\u002F\u002F [QUARKUS] Option B: @ServerExceptionMapper (RESTEasy Reactive)\n@ServerExceptionMapper\npublic RestResponse\u003CErrorResponse> handle(MarketNotFoundException ex) {\n  return RestResponse.status(Status.NOT_FOUND, ErrorResponse.from(ex));\n}\n```\n\n## Generics and Type Safety\n\n- Avoid raw types; declare generic parameters\n- Prefer bounded generics for reusable utilities\n\n```java\npublic \u003CT extends Identifiable> Map\u003CLong, T> indexById(Collection\u003CT> items) { ... }\n```\n\n## Project Structure\n\n### [SPRING] Maven\u002FGradle\n\n```\nsrc\u002Fmain\u002Fjava\u002Fcom\u002Fexample\u002Fapp\u002F\n  config\u002F\n  controller\u002F\n  service\u002F\n  repository\u002F\n  domain\u002F\n  dto\u002F\n  util\u002F\nsrc\u002Fmain\u002Fresources\u002F\n  application.yml\nsrc\u002Ftest\u002Fjava\u002F... (mirrors main)\n```\n\n### [QUARKUS] Maven\u002FGradle\n\n```\nsrc\u002Fmain\u002Fjava\u002Fcom\u002Fexample\u002Fapp\u002F\n  config\u002F              # @ConfigMapping, @ConfigProperty beans, Producers\n  resource\u002F            # JAX-RS resources (not \"controller\")\n  service\u002F\n  repository\u002F          # PanacheRepository implementations (if not using active record)\n  domain\u002F              # JPA\u002FPanache entities, MongoDB entities\n  dto\u002F\n  util\u002F\n  mapper\u002F              # MapStruct mappers (if used)\nsrc\u002Fmain\u002Fresources\u002F\n  application.properties   # Quarkus convention (YAML supported with quarkus-config-yaml)\n  import.sql               # Hibernate auto-import for dev\u002Ftest\nsrc\u002Ftest\u002Fjava\u002F... (mirrors main)\n```\n\n## Formatting and Style\n\n- Use 2 or 4 spaces consistently (project standard)\n- One public top-level type per file\n- Keep methods short and focused; extract helpers\n- Order members: constants, fields, constructors, public methods, protected, private\n\n## Code Smells to Avoid\n\n- Long parameter lists → use DTO\u002Fbuilders\n- Deep nesting → early returns\n- Magic numbers → named constants\n- Static mutable state → prefer dependency injection\n- Silent catch blocks → log and act or rethrow\n- **[QUARKUS]**: `@Singleton` where `@ApplicationScoped` is intended — breaks proxying and interception\n- **[QUARKUS]**: Mixing `quarkus-resteasy-reactive` and `quarkus-resteasy` (classic) — pick one stack\n- **[QUARKUS]**: Panache active-record + repository pattern in the same bounded context — pick one\n\n## Logging\n\n```java\n\u002F\u002F [SPRING] SLF4J\nprivate static final Logger log = LoggerFactory.getLogger(MarketService.class);\nlog.info(\"fetch_market slug={}\", slug);\nlog.error(\"failed_fetch_market slug={}\", slug, ex);\n\n\u002F\u002F [QUARKUS] JBoss Logging (default, zero-cost at build time)\nprivate static final Logger log = Logger.getLogger(MarketService.class);\nlog.infof(\"fetch_market slug=%s\", slug);\nlog.errorf(ex, \"failed_fetch_market slug=%s\", slug);\n\n\u002F\u002F [QUARKUS] Alternative: simplified logging with @Inject\n@Inject\nLogger log; \u002F\u002F CDI-injected, scoped to declaring class\n```\n\n## Null Handling\n\n- Accept `@Nullable` only when unavoidable; otherwise use `@NonNull`\n- Use Bean Validation (`@NotNull`, `@NotBlank`) on inputs\n- **[QUARKUS]**: Apply `@Valid` on `@BeanParam`, `@RestForm`, and request body parameters\n\n## Configuration\n\n```java\n\u002F\u002F [SPRING] @ConfigurationProperties\n@ConfigurationProperties(prefix = \"market\")\npublic record MarketProperties(int maxPageSize, Duration cacheTtl) {}\n\n\u002F\u002F [QUARKUS] @ConfigMapping (type-safe, build-time validated)\n@ConfigMapping(prefix = \"market\")\npublic interface MarketConfig {\n  int maxPageSize();\n  Duration cacheTtl();\n}\n\n\u002F\u002F [QUARKUS] Simple values with @ConfigProperty\n@ConfigProperty(name = \"market.max-page-size\", defaultValue = \"100\")\nint maxPageSize;\n```\n\n## Testing Expectations\n\n### Shared\n- JUnit 5 + AssertJ for fluent assertions\n- Mockito for mocking; avoid partial mocks where possible\n- Favor deterministic tests; no hidden sleeps\n\n### [SPRING]\n- `@WebMvcTest` for controller slices, `@DataJpaTest` for repository slices\n- `@SpringBootTest` reserved for full integration tests\n- `@MockBean` for replacing beans in Spring context\n\n### [QUARKUS]\n- Plain JUnit 5 + Mockito for unit tests (no `@QuarkusTest`)\n- `@QuarkusTest` reserved for CDI integration tests\n- `@InjectMock` for replacing CDI beans in integration tests\n- Dev Services for database\u002FKafka\u002FRedis — avoid manual Testcontainers setup when Dev Services suffice\n- `@QuarkusTestResource` for custom external service lifecycle\n\n```java\n\u002F\u002F [SPRING] Controller test\n@WebMvcTest(MarketController.class)\nclass MarketControllerTest {\n  @Autowired MockMvc mockMvc;\n  @MockBean MarketService marketService;\n}\n\n\u002F\u002F [QUARKUS] Integration test\n@QuarkusTest\nclass MarketResourceTest {\n  @InjectMock\n  MarketService marketService;\n\n  @Test\n  void should_return_404_when_market_not_found() {\n    given().when().get(\"\u002Fmarkets\u002Funknown\").then().statusCode(404);\n  }\n}\n\n\u002F\u002F [QUARKUS] Unit test (no CDI, no @QuarkusTest)\n@ExtendWith(MockitoExtension.class)\nclass MarketServiceTest {\n  @Mock MarketRepository marketRepository;\n  @InjectMocks MarketService marketService;\n}\n```\n\n**Remember**: Keep code intentional, typed, and observable. Optimize for maintainability over micro-optimizations unless proven necessary.\n","# Java Coding Standards\n\nStandards for readable, maintainable Java (17+) code in Spring Boot and Quarkus services.\n\n## When to Use\n\n- Writing or reviewing Java code in Spring Boot or Quarkus projects\n- Enforcing naming, immutability, or exception handling conventions\n- Working with records, sealed classes, or pattern matching (Java 17+)\n- Reviewing use of Optional, streams, or generics\n- Structuring packages and project layout\n- **[QUARKUS]**: Working with CDI scopes, Panache entities, or reactive pipelines\n\n## How It Works\n\n### Framework Detection\n\nBefore applying standards, determine the framework from the build file:\n\n- Build file contains `quarkus` → apply **[QUARKUS]** conventions\n- Build file contains `spring-boot` → apply **[SPRING]** conventions\n- Neither detected → apply shared conventions only\n\n## Core Principles\n\n- Prefer clarity over cleverness\n- Immutable by default; minimize shared mutable state\n- Fail fast with meaningful exceptions\n- Consistent naming and package structure\n- **[QUARKUS]**: Favor build-time over runtime processing; avoid runtime reflection where possible\n\n## Examples\n\nThe sections below show concrete Spring Boot, Quarkus, and shared Java examples\nfor naming, immutability, dependency injection, reactive code, exceptions,\nproject layout, logging, configuration, and tests.\n\n## Naming\n\n```java\n\u002F\u002F PASS: Classes\u002FRecords: PascalCase\npublic class MarketService {}\npublic record Money(BigDecimal amount, Currency currency) {}\n\n\u002F\u002F PASS: Methods\u002Ffields: camelCase\nprivate final MarketRepository marketRepository;\npublic Market findBySlug(String slug) {}\n\n\u002F\u002F PASS: Constants: UPPER_SNAKE_CASE\nprivate static final int MAX_PAGE_SIZE = 100;\n\n\u002F\u002F PASS: [QUARKUS] JAX-RS resources named as *Resource, not *Controller\npublic class MarketResource {}\n\n\u002F\u002F PASS: [SPRING] REST controllers named as *Controller\npublic class MarketController {}\n```\n\n## Immutability\n\n```java\n\u002F\u002F PASS: Favor records and final fields\npublic record MarketDto(Long id, String name, MarketStatus status) {}\n\npublic class Market {\n  private final Long id;\n  private final String name;\n  \u002F\u002F getters only, no setters\n}\n\n\u002F\u002F PASS: [QUARKUS] Panache active-record entities use public fields (Quarkus convention)\n@Entity\npublic class Market extends PanacheEntity {\n  public String name;\n  public MarketStatus status;\n  \u002F\u002F Panache generates accessors at build time; public fields are idiomatic here\n}\n\n\u002F\u002F PASS: [QUARKUS] Panache MongoDB entities\n@MongoEntity(collection = \"markets\")\npublic class Market extends PanacheMongoEntity {\n  public String name;\n  public MarketStatus status;\n}\n```\n\n## Optional Usage\n\n```java\n\u002F\u002F PASS: Return Optional from find* methods\n\u002F\u002F [SPRING]\nOptional\u003CMarket> market = marketRepository.findBySlug(slug);\n\n\u002F\u002F [QUARKUS] Panache\nOptional\u003CMarket> market = Market.find(\"slug\", slug).firstResultOptional();\n\n\u002F\u002F PASS: Map\u002FflatMap instead of get()\nreturn market\n    .map(MarketResponse::from)\n    .orElseThrow(() -> new EntityNotFoundException(\"Market not found\"));\n```\n\n## Streams Best Practices\n\n```java\n\u002F\u002F PASS: Use streams for transformations, keep pipelines short\nList\u003CString> names = markets.stream()\n    .map(Market::name)\n    .filter(Objects::nonNull)\n    .toList();\n\n\u002F\u002F FAIL: Avoid complex nested streams; prefer loops for clarity\n```\n\n## Dependency Injection\n\n```java\n\u002F\u002F PASS: [SPRING] Constructor injection (preferred over @Autowired on fields)\n@Service\npublic class MarketService {\n  private final MarketRepository marketRepository;\n\n  public MarketService(MarketRepository marketRepository) {\n    this.marketRepository = marketRepository;\n  }\n}\n\n\u002F\u002F PASS: [QUARKUS] Constructor injection\n@ApplicationScoped\npublic class MarketService {\n  private final MarketRepository marketRepository;\n\n  @Inject\n  public MarketService(MarketRepository marketRepository) {\n    this.marketRepository = marketRepository;\n  }\n}\n\n\u002F\u002F PASS: [QUARKUS] Package-private field injection (acceptable in Quarkus — avoids proxy issues)\n@ApplicationScoped\npublic class MarketService {\n  @Inject\n  MarketRepository marketRepository;\n}\n\n\u002F\u002F FAIL: [SPRING] Field injection with @Autowired\n@Autowired\nprivate MarketRepository marketRepository; \u002F\u002F use constructor injection\n\n\u002F\u002F FAIL: [QUARKUS] @Singleton when interception or lazy init is needed\n@Singleton \u002F\u002F non-proxyable — use @ApplicationScoped instead\npublic class MarketService {}\n```\n\n## Reactive Patterns [QUARKUS]\n\n```java\n\u002F\u002F PASS: Return Uni\u002FMulti from reactive endpoints\n@GET\n@Path(\"\u002F{slug}\")\npublic Uni\u003CMarket> findBySlug(@PathParam(\"slug\") String slug) {\n  return Market.find(\"slug\", slug)\n      .\u003CMarket>firstResult()\n      .onItem().ifNull().failWith(() -> new MarketNotFoundException(slug));\n}\n\n\u002F\u002F PASS: Non-blocking pipeline composition\npublic Uni\u003COrderConfirmation> placeOrder(OrderRequest req) {\n  return validateOrder(req)\n      .chain(valid -> persistOrder(valid))\n      .chain(order -> notifyFulfillment(order));\n}\n\n\u002F\u002F FAIL: Blocking call inside a Uni\u002FMulti pipeline\npublic Uni\u003CMarket> find(String slug) {\n  Market m = Market.find(\"slug\", slug).firstResult(); \u002F\u002F BLOCKING — breaks event loop\n  return Uni.createFrom().item(m);\n}\n\n\u002F\u002F FAIL: Subscribing more than once to a shared Uni\nUni\u003CMarket> shared = fetchMarket(slug);\nshared.subscribe().with(m -> log(m));\nshared.subscribe().with(m -> cache(m)); \u002F\u002F double subscribe — use Uni.memoize()\n```\n\n## Exceptions\n\n- Use unchecked exceptions for domain errors; wrap technical exceptions with context\n- Create domain-specific exceptions (e.g., `MarketNotFoundException`)\n- Avoid broad `catch (Exception ex)` unless rethrowing\u002Flogging centrally\n\n```java\nthrow new MarketNotFoundException(slug);\n```\n\n### Centralised Exception Handling\n\n```java\n\u002F\u002F [SPRING]\n@RestControllerAdvice\npublic class GlobalExceptionHandler {\n  @ExceptionHandler(MarketNotFoundException.class)\n  public ResponseEntity\u003CErrorResponse> handle(MarketNotFoundException ex) {\n    return ResponseEntity.status(404).body(ErrorResponse.from(ex));\n  }\n}\n\n\u002F\u002F [QUARKUS] Option A: ExceptionMapper\n@Provider\npublic class MarketNotFoundMapper implements ExceptionMapper\u003CMarketNotFoundException> {\n  @Override\n  public Response toResponse(MarketNotFoundException ex) {\n    return Response.status(404).entity(ErrorResponse.from(ex)).build();\n  }\n}\n\n\u002F\u002F [QUARKUS] Option B: @ServerExceptionMapper (RESTEasy Reactive)\n@ServerExceptionMapper\npublic RestResponse\u003CErrorResponse> handle(MarketNotFoundException ex) {\n  return RestResponse.status(Status.NOT_FOUND, ErrorResponse.from(ex));\n}\n```\n\n## Generics and Type Safety\n\n- Avoid raw types; declare generic parameters\n- Prefer bounded generics for reusable utilities\n\n```java\npublic \u003CT extends Identifiable> Map\u003CLong, T> indexById(Collection\u003CT> items) { ... }\n```\n\n## Project Structure\n\n### [SPRING] Maven\u002FGradle\n\n```\nsrc\u002Fmain\u002Fjava\u002Fcom\u002Fexample\u002Fapp\u002F\n  config\u002F\n  controller\u002F\n  service\u002F\n  repository\u002F\n  domain\u002F\n  dto\u002F\n  util\u002F\nsrc\u002Fmain\u002Fresources\u002F\n  application.yml\nsrc\u002Ftest\u002Fjava\u002F... (mirrors main)\n```\n\n### [QUARKUS] Maven\u002FGradle\n\n```\nsrc\u002Fmain\u002Fjava\u002Fcom\u002Fexample\u002Fapp\u002F\n  config\u002F              # @ConfigMapping, @ConfigProperty beans, Producers\n  resource\u002F            # JAX-RS resources (not \"controller\")\n  service\u002F\n  repository\u002F          # PanacheRepository implementations (if not using active record)\n  domain\u002F              # JPA\u002FPanache entities, MongoDB entities\n  dto\u002F\n  util\u002F\n  mapper\u002F              # MapStruct mappers (if used)\nsrc\u002Fmain\u002Fresources\u002F\n  application.properties   # Quarkus convention (YAML supported with quarkus-config-yaml)\n  import.sql               # Hibernate auto-import for dev\u002Ftest\nsrc\u002Ftest\u002Fjava\u002F... (mirrors main)\n```\n\n## Formatting and Style\n\n- Use 2 or 4 spaces consistently (project standard)\n- One public top-level type per file\n- Keep methods short and focused; extract helpers\n- Order members: constants, fields, constructors, public methods, protected, private\n\n## Code Smells to Avoid\n\n- Long parameter lists → use DTO\u002Fbuilders\n- Deep nesting → early returns\n- Magic numbers → named constants\n- Static mutable state → prefer dependency injection\n- Silent catch blocks → log and act or rethrow\n- **[QUARKUS]**: `@Singleton` where `@ApplicationScoped` is intended — breaks proxying and interception\n- **[QUARKUS]**: Mixing `quarkus-resteasy-reactive` and `quarkus-resteasy` (classic) — pick one stack\n- **[QUARKUS]**: Panache active-record + repository pattern in the same bounded context — pick one\n\n## Logging\n\n```java\n\u002F\u002F [SPRING] SLF4J\nprivate static final Logger log = LoggerFactory.getLogger(MarketService.class);\nlog.info(\"fetch_market slug={}\", slug);\nlog.error(\"failed_fetch_market slug={}\", slug, ex);\n\n\u002F\u002F [QUARKUS] JBoss Logging (default, zero-cost at build time)\nprivate static final Logger log = Logger.getLogger(MarketService.class);\nlog.infof(\"fetch_market slug=%s\", slug);\nlog.errorf(ex, \"failed_fetch_market slug=%s\", slug);\n\n\u002F\u002F [QUARKUS] Alternative: simplified logging with @Inject\n@Inject\nLogger log; \u002F\u002F CDI-injected, scoped to declaring class\n```\n\n## Null Handling\n\n- Accept `@Nullable` only when unavoidable; otherwise use `@NonNull`\n- Use Bean Validation (`@NotNull`, `@NotBlank`) on inputs\n- **[QUARKUS]**: Apply `@Valid` on `@BeanParam`, `@RestForm`, and request body parameters\n\n## Configuration\n\n```java\n\u002F\u002F [SPRING] @ConfigurationProperties\n@ConfigurationProperties(prefix = \"market\")\npublic record MarketProperties(int maxPageSize, Duration cacheTtl) {}\n\n\u002F\u002F [QUARKUS] @ConfigMapping (type-safe, build-time validated)\n@ConfigMapping(prefix = \"market\")\npublic interface MarketConfig {\n  int maxPageSize();\n  Duration cacheTtl();\n}\n\n\u002F\u002F [QUARKUS] Simple values with @ConfigProperty\n@ConfigProperty(name = \"market.max-page-size\", defaultValue = \"100\")\nint maxPageSize;\n```\n\n## Testing Expectations\n\n### Shared\n- JUnit 5 + AssertJ for fluent assertions\n- Mockito for mocking; avoid partial mocks where possible\n- Favor deterministic tests; no hidden sleeps\n\n### [SPRING]\n- `@WebMvcTest` for controller slices, `@DataJpaTest` for repository slices\n- `@SpringBootTest` reserved for full integration tests\n- `@MockBean` for replacing beans in Spring context\n\n### [QUARKUS]\n- Plain JUnit 5 + Mockito for unit tests (no `@QuarkusTest`)\n- `@QuarkusTest` reserved for CDI integration tests\n- `@InjectMock` for replacing CDI beans in integration tests\n- Dev Services for database\u002FKafka\u002FRedis — avoid manual Testcontainers setup when Dev Services suffice\n- `@QuarkusTestResource` for custom external service lifecycle\n\n```java\n\u002F\u002F [SPRING] Controller test\n@WebMvcTest(MarketController.class)\nclass MarketControllerTest {\n  @Autowired MockMvc mockMvc;\n  @MockBean MarketService marketService;\n}\n\n\u002F\u002F [QUARKUS] Integration test\n@QuarkusTest\nclass MarketResourceTest {\n  @InjectMock\n  MarketService marketService;\n\n  @Test\n  void should_return_404_when_market_not_found() {\n    given().when().get(\"\u002Fmarkets\u002Funknown\").then().statusCode(404);\n  }\n}\n\n\u002F\u002F [QUARKUS] Unit test (no CDI, no @QuarkusTest)\n@ExtendWith(MockitoExtension.class)\nclass MarketServiceTest {\n  @Mock MarketRepository marketRepository;\n  @InjectMocks MarketService marketService;\n}\n```\n\n**Remember**: Keep code intentional, typed, and observable. Optimize for maintainability over micro-optimizations unless proven necessary.\n",{"name":5,"origin":24,"description":7},"ECC","master","d6ca01da0f24a3b0e26e4a8b7b66cbd25d429f5d","everything-claude-code\u002Fskills\u002Fjava-coding-standards",0,"https:\u002F\u002Fgithub.com\u002FSriramGandhiS\u002FSkills","https:\u002F\u002Fgithub.com\u002FSriramGandhiS","https:\u002F\u002Fsriram.website\u002F","Curious guy who keeps tinkering until something works","2026-05-20 16:21:34",{"source":8,"skillName":5,"commands":35,"prompt":45,"zipAvailable":46},[36,39,42],{"tool":37,"command":38},"npx","npx skills add SriramGandhiS\u002FSkills --skill java-coding-standards",{"tool":40,"command":41},"bunx","bunx skills add SriramGandhiS\u002FSkills --skill java-coding-standards",{"tool":43,"command":44},"pnpm","pnpm dlx skills add SriramGandhiS\u002FSkills --skill java-coding-standards","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002FSriramGandhiS\u002FSkills\u002Fblob\u002Fmaster\u002Feverything-claude-code\u002Fskills\u002Fjava-coding-standards\u002FSKILL.md",true,[],[49,56,61,67,74,81],{"skillNo":50,"name":51,"nameZh":6,"description":52,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":53,"categories":54,"keywords":55,"publishedAt":19},"01M732609EPJWV13PVTX3GT4TM","webgpu-threejs-tsl","Comprehensive guide for developing WebGPU-enabled Three.js applications using TSL (Three.js Shading Language). Covers WebGPU renderer setup, TSL syntax and node materials, compute shaders, post-processing effects, and WGSL integration. Use this skill when working with Three.js WebGPU, TSL shaders, node materials, or GPU compute in Three.js.","https:\u002F\u002Fgithub.com\u002FSriramGandhiS\u002FSkills\u002Fblob\u002Fmaster\u002Fwebgpu-threejs-tsl\u002Fskills\u002Fwebgpu-threejs-tsl\u002FSKILL.md",[],[],{"skillNo":57,"name":51,"nameZh":6,"description":52,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":58,"categories":59,"keywords":60,"publishedAt":19},"01M7325XM47AGWB6K6C4VXKE6B","https:\u002F\u002Fgithub.com\u002FSriramGandhiS\u002FSkills\u002Fblob\u002Fmaster\u002Fwebgpu-threejs-tsl\u002FSKILL.md",[],[],{"skillNo":62,"name":63,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":64,"categories":65,"keywords":66,"publishedAt":19},"01M7325WP6DES69JKC840VMFEP","verification-loop","https:\u002F\u002Fgithub.com\u002FSriramGandhiS\u002FSkills\u002Fblob\u002Fmaster\u002Fweb-assets\u002Fdocs\u002Fzh-TW\u002Fskills\u002Fverification-loop\u002FSKILL.md",[],[],{"skillNo":68,"name":69,"nameZh":6,"description":70,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":71,"categories":72,"keywords":73,"publishedAt":19},"01M7325TFQF1DZTQ6J3WGQQ1VR","tdd-workflow","Use this skill when writing new features, fixing bugs, or refactoring code. Enforces test-driven development with 80%+ coverage including unit, integration, and E2E tests.","https:\u002F\u002Fgithub.com\u002FSriramGandhiS\u002FSkills\u002Fblob\u002Fmaster\u002Fweb-assets\u002Fdocs\u002Fzh-TW\u002Fskills\u002Ftdd-workflow\u002FSKILL.md",[],[],{"skillNo":75,"name":76,"nameZh":6,"description":77,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":78,"categories":79,"keywords":80,"publishedAt":19},"01M7325RGV9AY9PK92D2V8KKPW","strategic-compact","Suggests manual context compaction at logical intervals to preserve context through task phases rather than arbitrary auto-compaction.","https:\u002F\u002Fgithub.com\u002FSriramGandhiS\u002FSkills\u002Fblob\u002Fmaster\u002Fweb-assets\u002Fdocs\u002Fzh-TW\u002Fskills\u002Fstrategic-compact\u002FSKILL.md",[],[],{"skillNo":82,"name":83,"nameZh":6,"description":84,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":85,"categories":86,"keywords":87,"publishedAt":19},"01M7325MZC28SE86E7NMCNEFS4","security-review","Use this skill when adding authentication, handling user input, working with secrets, creating API endpoints, or implementing payment\u002Fsensitive features. Provides comprehensive security checklist and patterns.","https:\u002F\u002Fgithub.com\u002FSriramGandhiS\u002FSkills\u002Fblob\u002Fmaster\u002Fweb-assets\u002Fdocs\u002Fzh-TW\u002Fskills\u002Fsecurity-review\u002FSKILL.md",[],[]]