4. Reference (Maintainer Track)

For Java developers maintaining or extending the framework itself.

This chapter is for the people who will modify BusinessBaseController, add a new metadata table to the gds* family, or wire in a new third-party integration.

• Running xlyEntry locally — first-run setup for developers (prereqs, profile, DB override, smoke check).
• Tech stack — library inventory by category (versions, where each is used, and why).
• The runtime: BusinessBaseController & friends — the metadata-driven dispatch loop.
• Generic procedure dispatch — GenericProcedureCallController deep dive.
• Cache invalidation on metadata change — synchronous @CacheEvict, and why similarly named JMS consumers are not cache-bust.
• SQL templates (xlyEntry/templesql/) — proc scaffolds engineers fill in.
• Multi-service deployment — xlyApi vs xlyEntry vs xlyInterface.
• Metadata-management services (xlyManage) — the Gds*ServiceImpl family behind the BACK builder.
• BI / KPI / Charts engine — the homebrewed dashboard layer.
• Activiti integration — version skew, schemas, custom delegates.