/ doc / toc / ARCCore / Enum / ARConcepts / GettingStarted

GettingStarted

Edit keys at this level only

Edit keys at all sub levels.
NOTE: Edits are always additive. Use 'Invalid' in order to delete keys.

__TOCDet/Assembly = ARCCore
__TOCDet/Description = AgoRapide 2020 is an open source library for building data-oriented backend applications using .NET.0x000D0x000A0x000D0x000AWith AgoRapide the impedance mismatch problem between database tables and in-memory objects is eliminated through the -PropertyStream- concept.0x000D0x000A0x000D0x000AData is created, stored and transported at the key-value level.0x000D0x000A0x000D0x000ANOTE: This text is an 'inside-out' approach to documentation best suited for developers of AgoRapide.0x000D0x000ANOTE: A better introductory top-down presentation is found at0x000D0x000ANOTE: 0x000D0x000ANOTE: http://bef.no/AgoRapide 0x000D0x000A0x000D0x000AThe source code, including this documentation, is found at0x000D0x000A0x000D0x000Ahttps://bitbucket.org/BjornErlingFloetten/arcore 0x000D0x000A0x000D0x000A0x000D0x000AAgoRapide 2020 can be used as:0x000D0x000A0x000D0x000A1) A distributed in-memory backend processor of events / listener to events.0x000D0x000AThe -PropertyStream--format lends itself well to distribution of loads. Each processing node subscribes to sub-sets of the entire property stream.0x000D0x000AThe -Subscription-s consists of the events to which the node has to respond, plus other necessary data in order to correctly process the events. 0x000D0x000AAny output from the node is placed back out in the property stream, either back upstream, or further downstream for other nodes to process.0x000D0x000ASee -ARCCore-.0x000D0x000A0x000D0x000A2) A 'single-endpoint' API.0x000D0x000AAll data is exposed through a standardized API query mechanism (REST or GraphQL) with no need for writing application specific endpoints.0x000D0x000ASince APIs should expose well defined DTO's and not entire entities, AgoRapide APIs are therefore normally established as separate nodes.0x000D0x000AEach node has a well defined -Subscription- to a sub-set of your entire database (also reducing the memory footprint).0x000D0x000AThe API will then in effect offer DTO's with very little coding needed.0x000D0x000ASee -ARCAPI-.0x000D0x000A0x000D0x000A3) A reporting tool / query tool ("Express BI").0x000D0x000AAn API as in 2) combined with the query library. 0x000D0x000AThe query library enables report generation directly from the web-browser (as a single bookmark-able URL).0x000D0x000ASee -ARCQuery-.0x000D0x000A0x000D0x000A4) (New from December 2021) An -EventSourcing- engine offering a unique -PropertyStream2D- concept where processes (of some business domain) can be expressed in very compact manner through the concept of -IRegHandler-.0x000D0x000ASee -ARCEvent-.0x000D0x000A0x000D0x000AFor all cases above the following also applies:0x000D0x000A0x000D0x000AA) An in-memory database which is continously updated through the property stream is provided by AgoRapide. 0x000D0x000AThis ensures short response times and significantly reduces network traffic. 0x000D0x000ASee -StreamProcessor-.0x000D0x000A0x000D0x000AB) The core database storage is either provided directly by AgoRapide, or you can use an established 'key-value' database like Apache Kafka, AWS DynamoDB or Azure Cosmos DB.0x000D0x000ASee -ARCSync-.0x000D0x000A0x000D0x000AC) High performance thread-safe "simultaneous" read and writes is supported in all scenarios.0x000D0x000A0x000D0x000AD) AgoRapide works better the more strongly typed schema you specify (see -TaggingOfPropertyKeys-). 0x000D0x000AYou can however start out without any schema at all. Duck typing is then used instead. 0x000D0x000AEven relational queries are possible straight out-of-the-box without any schema, as long as some naming conventions are followed 0x000D0x000A(like Order.CustomerId for instance, in order to relate an Order to a Customer)0x000D0x000AStrong typing is used by AgoRapide whenever specified by the schema.0x000D0x000A0x000D0x000AE) Scaling and redundancy is supported by flexible routing of the -PropertyStream- to multiple nodes.0x000D0x000A0x000D0x000AF) No dependencies to other libraries apart from .NET itself.0x000D0x000A0x000D0x000ASee -ARCDoc- for practical examples for using AgoRapide, especially class -Demonstrator-.0x000D0x000A0x000D0x000AAgoRapide is the result of a strong wish of -AvoidingRepetition-.0x000D0x000A0x000D0x000AThree very important concepts in AgoRapide are:0x000D0x000A0x000D0x000A1) -PropertyStream-: The concept of how all data is broken down into single 'key and value' pairs which are then stored as plain text format lines and then never changed.0x000D0x000A0x000D0x000A2) -TaggingOfPropertyKeys-: The concept of specifying in a single place all relevant information about a given property (data field).0x000D0x000A0x000D0x000A3) -PropertyAccess-: The general mechanism for accessing properties of objects in AgoRapide.0x000D0x000A0x000D0x000AAgoRapide is split into different -ARComponents-. You can have a functional distributed storage mechanism including -app--consoles by linking only to -ARCCore-.0x000D0x000AChoose from the other components based on your security needs (-ARCSec-), the complexity of your data (-ARCQuery-) or other needs (see -ARComponents- in general).0x000D0x000A0x000D0x000ASee also -ARConcepts- and -AgoRapideHistory-.0x000D0x000A0x000D0x000ASome online applications demonstrating AgoRapide are:0x000D0x000Ahttp://ARNorthwind.AgoRapide.com and0x000D0x000Ahttp://ARAdventureWorksOLAP.AgoRapide.com 0x000D0x000A
__TOCDet/DocFragType = EnumMember
__TOCDet/Name = GettingStarted
__TOCDet/Namespace = ARCCore
__TOCDet/Type = ARConcepts
__TOCDet/Attribute/Description = AgoRapide 2020 is an open source library for building data-oriented backend applications using .NET.0x000D0x000A0x000D0x000AWith AgoRapide the impedance mismatch problem between database tables and in-memory objects is eliminated through the -PropertyStream- concept.0x000D0x000A0x000D0x000AData is created, stored and transported at the key-value level.0x000D0x000A0x000D0x000ANOTE: This text is an 'inside-out' approach to documentation best suited for developers of AgoRapide.0x000D0x000ANOTE: A better introductory top-down presentation is found at0x000D0x000ANOTE: 0x000D0x000ANOTE: http://bef.no/AgoRapide 0x000D0x000A0x000D0x000AThe source code, including this documentation, is found at0x000D0x000A0x000D0x000Ahttps://bitbucket.org/BjornErlingFloetten/arcore 0x000D0x000A0x000D0x000A0x000D0x000AAgoRapide 2020 can be used as:0x000D0x000A0x000D0x000A1) A distributed in-memory backend processor of events / listener to events.0x000D0x000AThe -PropertyStream--format lends itself well to distribution of loads. Each processing node subscribes to sub-sets of the entire property stream.0x000D0x000AThe -Subscription-s consists of the events to which the node has to respond, plus other necessary data in order to correctly process the events. 0x000D0x000AAny output from the node is placed back out in the property stream, either back upstream, or further downstream for other nodes to process.0x000D0x000ASee -ARCCore-.0x000D0x000A0x000D0x000A2) A 'single-endpoint' API.0x000D0x000AAll data is exposed through a standardized API query mechanism (REST or GraphQL) with no need for writing application specific endpoints.0x000D0x000ASince APIs should expose well defined DTO's and not entire entities, AgoRapide APIs are therefore normally established as separate nodes.0x000D0x000AEach node has a well defined -Subscription- to a sub-set of your entire database (also reducing the memory footprint).0x000D0x000AThe API will then in effect offer DTO's with very little coding needed.0x000D0x000ASee -ARCAPI-.0x000D0x000A0x000D0x000A3) A reporting tool / query tool ("Express BI").0x000D0x000AAn API as in 2) combined with the query library. 0x000D0x000AThe query library enables report generation directly from the web-browser (as a single bookmark-able URL).0x000D0x000ASee -ARCQuery-.0x000D0x000A0x000D0x000A4) (New from December 2021) An -EventSourcing- engine offering a unique -PropertyStream2D- concept where processes (of some business domain) can be expressed in very compact manner through the concept of -IRegHandler-.0x000D0x000ASee -ARCEvent-.0x000D0x000A0x000D0x000AFor all cases above the following also applies:0x000D0x000A0x000D0x000AA) An in-memory database which is continously updated through the property stream is provided by AgoRapide. 0x000D0x000AThis ensures short response times and significantly reduces network traffic. 0x000D0x000ASee -StreamProcessor-.0x000D0x000A0x000D0x000AB) The core database storage is either provided directly by AgoRapide, or you can use an established 'key-value' database like Apache Kafka, AWS DynamoDB or Azure Cosmos DB.0x000D0x000ASee -ARCSync-.0x000D0x000A0x000D0x000AC) High performance thread-safe "simultaneous" read and writes is supported in all scenarios.0x000D0x000A0x000D0x000AD) AgoRapide works better the more strongly typed schema you specify (see -TaggingOfPropertyKeys-). 0x000D0x000AYou can however start out without any schema at all. Duck typing is then used instead. 0x000D0x000AEven relational queries are possible straight out-of-the-box without any schema, as long as some naming conventions are followed 0x000D0x000A(like Order.CustomerId for instance, in order to relate an Order to a Customer)0x000D0x000AStrong typing is used by AgoRapide whenever specified by the schema.0x000D0x000A0x000D0x000AE) Scaling and redundancy is supported by flexible routing of the -PropertyStream- to multiple nodes.0x000D0x000A0x000D0x000AF) No dependencies to other libraries apart from .NET itself.0x000D0x000A0x000D0x000ASee -ARCDoc- for practical examples for using AgoRapide, especially class -Demonstrator-.0x000D0x000A0x000D0x000AAgoRapide is the result of a strong wish of -AvoidingRepetition-.0x000D0x000A0x000D0x000AThree very important concepts in AgoRapide are:0x000D0x000A0x000D0x000A1) -PropertyStream-: The concept of how all data is broken down into single 'key and value' pairs which are then stored as plain text format lines and then never changed.0x000D0x000A0x000D0x000A2) -TaggingOfPropertyKeys-: The concept of specifying in a single place all relevant information about a given property (data field).0x000D0x000A0x000D0x000A3) -PropertyAccess-: The general mechanism for accessing properties of objects in AgoRapide.0x000D0x000A0x000D0x000AAgoRapide is split into different -ARComponents-. You can have a functional distributed storage mechanism including -app--consoles by linking only to -ARCCore-.0x000D0x000AChoose from the other components based on your security needs (-ARCSec-), the complexity of your data (-ARCQuery-) or other needs (see -ARComponents- in general).0x000D0x000A0x000D0x000ASee also -ARConcepts- and -AgoRapideHistory-.0x000D0x000A0x000D0x000ASome online applications demonstrating AgoRapide are:0x000D0x000Ahttp://ARNorthwind.AgoRapide.com and0x000D0x000Ahttp://ARAdventureWorksOLAP.AgoRapide.com 0x000D0x000A
__TOCDet/Attribute/EnumMember = GettingStarted
__TOCDet/Attribute/EnumType = ARConcepts

Edit single sub keys only: __TOCDet

Generated 2025-05-23 14:36:18.535 UTC