This page provides a generic description of the way commands differ from queries in Fineract CN services.
CQRS stands for Command Query Responsibility Segregation. In the case of REST services, the most common commands are POST, PUT, DELETE, and the most common query is GET. Fineract CN services execute commands asynchronously and queries synchronously.
Asynchronous Command Execution
Asynchronous command execution means that as soon as some basic checks are performed, and the command is persisted to the cassandra repository, the REST controller returns ACCEPTED for a given change request. Actual execution of the command is performed asynchronously in the command handler sometime after the REST controller returns.
The advantage to this approach is that it's really fast. The drawback is that some kinds of errors can only be detected while the command handler is executing and this class of errors will not be surfaced appropriately to the user. The basic sanity checks are intended to ameliorate this.
eyJleHRTcnZJbnRlZ1R5cGUiOiIiLCJnQ2xpZW50SWQiOiIiLCJjcmVhdG9yTmFtZSI6Ik15cmxlIEtyYW50eiIsIm91dHB1dFR5cGUiOiJibG9jayIsImxhc3RNb2RpZmllck5hbWUiOiJNeXJsZSBLcmFudHoiLCJsYW5ndWFnZSI6ImVuIiwiZGlhZ3JhbURpc3BsYXlOYW1lIjoiIiwic0ZpbGVJZCI6IiIsImF0dElkIjoiNzU5NjM2MzYiLCJkaWFncmFtTmFtZSI6IkNvbW1hbmQgY29udHJvbCBmbG93IiwiYXNwZWN0IjoiIiwibGlua3MiOiJhdXRvIiwiY2VvTmFtZSI6IkNRUlMgaW4gRmluZXJhY3QgQ04iLCJ0YnN0eWxlIjoidG9wIiwiY2FuQ29tbWVudCI6ZmFsc2UsImRpYWdyYW1VcmwiOiIiLCJjc3ZGaWxlVXJsIjoiIiwiYm9yZGVyIjp0cnVlLCJtYXhTY2FsZSI6IjEiLCJvd25pbmdQYWdlSWQiOjc1OTYzNjQxLCJlZGl0YWJsZSI6ZmFsc2UsImNlb0lkIjo3NTk2MzY0MSwicGFnZUlkIjoiIiwibGJveCI6dHJ1ZSwic2VydmVyQ29uZmlnIjp7ImVtYWlscHJldmlldyI6IjEifSwib2RyaXZlSWQiOiIiLCJyZXZpc2lvbiI6MiwibWFjcm9JZCI6IjhjMDFmYjk0LTMwNGItNDgzNy04MDE0LTdhZThhMjUxZjE1ZCIsInByZXZpZXdOYW1lIjoiQ29tbWFuZCBjb250cm9sIGZsb3cucG5nIiwibGljZW5zZVN0YXR1cyI6Ik9LIiwic2VydmljZSI6IiIsImlzVGVtcGxhdGUiOiIiLCJ3aWR0aCI6IjEzMzEiLCJzaW1wbGVWaWV3ZXIiOmZhbHNlLCJsYXN0TW9kaWZpZWQiOjE1MTcyMzk4NDMwMDAsImV4Y2VlZFBhZ2VXaWR0aCI6ZmFsc2UsIm9DbGllbnRJZCI6IiJ9
Synchronous Query Response
Query processing is necessarily synchronous. The command database is ignored for the purpose of queries. Only the SQL repository is addressed.
eyJleHRTcnZJbnRlZ1R5cGUiOiIiLCJnQ2xpZW50SWQiOiIiLCJjcmVhdG9yTmFtZSI6Ik15cmxlIEtyYW50eiIsIm91dHB1dFR5cGUiOiJibG9jayIsImxhc3RNb2RpZmllck5hbWUiOiJNeXJsZSBLcmFudHoiLCJsYW5ndWFnZSI6ImVuIiwiZGlhZ3JhbURpc3BsYXlOYW1lIjoiIiwic0ZpbGVJZCI6IiIsImF0dElkIjoiNzU5NjM2NDMiLCJkaWFncmFtTmFtZSI6IlF1ZXJ5IGZsb3ciLCJhc3BlY3QiOiIiLCJsaW5rcyI6ImF1dG8iLCJjZW9OYW1lIjoiQ1FSUyBpbiBGaW5lcmFjdCBDTiIsInRic3R5bGUiOiJ0b3AiLCJjYW5Db21tZW50IjpmYWxzZSwiZGlhZ3JhbVVybCI6IiIsImNzdkZpbGVVcmwiOiIiLCJib3JkZXIiOnRydWUsIm1heFNjYWxlIjoiMSIsIm93bmluZ1BhZ2VJZCI6NzU5NjM2NDEsImVkaXRhYmxlIjpmYWxzZSwiY2VvSWQiOjc1OTYzNjQxLCJwYWdlSWQiOiIiLCJsYm94Ijp0cnVlLCJzZXJ2ZXJDb25maWciOnsiZW1haWxwcmV2aWV3IjoiMSJ9LCJvZHJpdmVJZCI6IiIsInJldmlzaW9uIjoxLCJtYWNyb0lkIjoiNWQyYjZlYTktMDg5YS00ZWVjLThlODQtMzk4OGVlN2M3Njc2IiwicHJldmlld05hbWUiOiJRdWVyeSBmbG93LnBuZyIsImxpY2Vuc2VTdGF0dXMiOiJPSyIsInNlcnZpY2UiOiIiLCJpc1RlbXBsYXRlIjoiIiwid2lkdGgiOiIxMzMxIiwic2ltcGxlVmlld2VyIjpmYWxzZSwibGFzdE1vZGlmaWVkIjoxNTE3MjQwMjQ1MDAwLCJleGNlZWRQYWdlV2lkdGgiOmZhbHNlLCJvQ2xpZW50SWQiOiIifQ==