Many applications contain similar business classes: Person, Address, Organization, PhoneNumber and so on. There is no need to develop these classes from scratch and modify them for use in the eXpressApp Framework applications. We provide you with the Business Class Library - a set of classes that you will need most frequently. This library also includes a number of interfaces you will need to provide proper interaction of your data with some XAF modules. This topic details the Business Class Library.
The Business Class Library consists of three assemblies.
||Contains ready-to-use XPO persistent classes.
||Contains ready-to-use Entity Framework Code First classes.
||Contains interfaces and helper classes used in XAF Extra Modules. Classes implementing these interfaces are available in the two DevExpress.Persistent.BaseImpl.* assemblies listed above.
The Business Class Library provides the following capabilities.
- You can use classes from the DevExpress.Persistent.BaseImpl.v19.1.dll and DevExpress.Persistent.BaseImpl.EF.v19.1.dll assemblies as they are.
- You can extend persistent classes from the DevExpress.Persistent.BaseImpl.v19.1.dll and DevExpress.Persistent.BaseImpl.EF.v19.1.dll assemblies assembly to add a specific functionality.
- The eXpressApp Framework installation provides sources of the DevExpress.Persistent.BaseImpl.v19.1.dll and DevExpress.Persistent.BaseImpl.EF.v19.1.dll assemblies. They are located at %PROGRAMFILES(x86)%\DevExpress 19.1\Components\Sources\DevExpress.Persistent\ by default. You can use the sources as an example when developing your own business class library. In addition, you can modify the sources and recompile this assembly if required. For details, refer to the How to: Recompile the Business Class Library topic.
- You can provide custom implementation for a particular interface from the DevExpress.Persistent.Base.v19.1.dll assembly and your custom class will be properly handled by XAF.
- The Business Class Library assemblies do not have references to other XAF assemblies. This allows you to use services defined there (like validation, audit trail, etc.) in non-XAF applications.
To add a class from the Business Class Library to the UI construction process, use the ModuleBase.AdditionalExportedTypes property, or use the Exported Types section of the Module Designer.
UI settings for Business Class Library classes (represented by the Application Model differences) are provided by the Business Class Library Customization Module.