Instruction file imported from zexion7873/copilot-setting (.github/instructions/xml-config.instructions.md). Copyright stays with the author.

XML Configuration Conventions

Conventions for Spring XML config (applicationContext*.xml), Hibernate hbm.xml mappings, and Maven POM files. Transaction management rules: instructions/spring-hibernate.instructions.md.

Spring XML

• One config file per concern (e.g., applicationContext-dao.xml, applicationContext-service.xml)
• Bean IDs: camelCase, descriptive (orderService, transactionManager)
• Transaction: <tx:advice> + <aop:config> on service layer — see instructions/spring-hibernate.instructions.md

Hibernate hbm.xml

hbm.xml mapping conventions (file-per-entity, root package, lazy/FK naming): see instructions/spring-hibernate.instructions.md.

Maven POM

• Pin all dependency versions — no ranges, no SNAPSHOT in releases, no dynamic LATEST/RELEASE markers
• <dependencyManagement> for version centralization in multi-module
• Scopes: test-only libraries (JUnit, Mockito) use <scope>test</scope>; container-provided APIs (servlet, JSP) use <scope>provided</scope> — never bundle them into the WAR
• maven-compiler-plugin with source/target = 1.8; pin every plugin version (unpinned plugins follow Maven defaults — non-reproducible builds)
• Encoding: <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>

web.xml

This stack bootstraps via web.xml (no servlet initializers — see instructions/spring-hibernate.instructions.md), so these conventions apply:

• <web-app> version matches the container's servlet spec and the Spring 3.2 runtime — do not declare a newer spec than the container provides
• CharacterEncodingFilter set to UTF-8 and mapped first in the filter chain, before any filter that reads request parameters (ties into the JSP output-encoding story — instructions/jsp.instructions.md)
• Context split: ContextLoaderListener loads the root context (services, DAOs); DispatcherServlet loads only its own web context (controllers, view resolvers) — do not redefine the same bean in both
• OpenSessionInViewFilter (OSIV), if used, is configured here — see instructions/spring-hibernate.instructions.md

Version-Lock Traps (silent failures)

• spring-beans-4.0.xsd in a namespace declaration — schema version exceeds the Spring 3.2 runtime and misconfigures silently; use spring-beans-3.2.xsd to match the actual framework version
• <tx:annotation-driven/> conflicts with this project's <tx:advice> + <aop:config> strategy — remove it in greenfield / <tx:advice> modules, but keep it if the module is consistently @Transactional-based: removing it silently disables every annotated transaction (see the legacy exception in instructions/spring-hibernate.instructions.md)
• <context:component-scan base-package="com.example"/> scans the entire package tree and picks up test doubles and unintended beans — narrow it to specific subpackages
• MySQL8Dialect / MySQL57Dialect in a sessionFactory bean — neither exists in Hibernate 4.2 (they arrived in 5.x); use org.hibernate.dialect.MySQL5Dialect or MySQL5InnoDBDialect, and never copy a dialect from a Hibernate 5.x or Spring Boot tutorial (instructions/spring-hibernate.instructions.md)