Aspectran 9.5 Release Notes

This release enhances the framework’s flexibility and performance by introducing a sophisticated frame-based Hint mechanism and intelligent database routing for MyBatis and JPA. Additionally, it strengthens modern architectural standards through the standardization of core interfaces and the adoption of Primary-Replica terminology.

✨ New Features

• Advanced Hint Mechanism with Frame-based Isolation
  • Introduced a sophisticated Hint system to convey execution “intents” from business logic to framework modules without tight coupling.
  • Implemented a logical “call frame” structure to strictly control hint visibility and isolation across nested method calls.
  • Added a propagated attribute to the @Hint annotation to manage whether a hint leaks into nested frames.
  • Enhanced traceability by capturing and logging the origin (source method) of each hint, helping developers trace where execution intents are coming from.
• Database Routing Capabilities for MyBatis and JPA
  • Introduced intelligent routing of SqlSession and EntityManager operations between read-write and read-only contexts.
  • Added RoutingSqlSessionAgent and RoutingEntityQuery to support modern Primary-Replica architectures.
  • Implemented fail-fast constraints to prevent unauthorized data modification when a read-only transactional hint is present.
• Enhanced InstantActivity and InstantTranslet Support
  • Introduced InstantTranslet to provide a Translet context in non-translet environments, significantly increasing framework flexibility and component reusability.

🚀 Improvements

• Standardization of Core Interfaces and Terminology
  • Renamed rule management interfaces (e.g., HasAttributes to HasAttributeRules, HasParameters to HasParameterRules) to clarify their responsibilities.
  • Replaced Master-Slave terminology with Primary-Replica across all components and documentation to align with modern inclusive standards.
• Enhanced Test Infrastructure and Code Quality
  • Simplified test configurations and ensured consistency by adopting the @AspectranTest annotation and migrating test resources to dedicated packages.
  • Added comprehensive test cases for AnnotatedMethodInvoker to verify various parameter binding and type conversion scenarios.

🛠️ Dependency Upgrades

• JLine (4.0.12)
• Jetty (12.1.8)
• Lettuce (7.5.1.RELEASE)
• OGNL (3.4.11)
• Hibernate Core (7.3.1.Final)