Ossendorf.Csla.DataPortalExtensionGenerator
0.2.0-preview1.9
See the version list below for details.
dotnet add package Ossendorf.Csla.DataPortalExtensionGenerator --version 0.2.0-preview1.9
NuGet\Install-Package Ossendorf.Csla.DataPortalExtensionGenerator -Version 0.2.0-preview1.9
<PackageReference Include="Ossendorf.Csla.DataPortalExtensionGenerator" Version="0.2.0-preview1.9"> <PrivateAssets>all</PrivateAssets> <IncludeAssets>runtime; build; native; contentfiles; analyzers</IncludeAssets> </PackageReference>
paket add Ossendorf.Csla.DataPortalExtensionGenerator --version 0.2.0-preview1.9
#r "nuget: Ossendorf.Csla.DataPortalExtensionGenerator, 0.2.0-preview1.9"
// Install Ossendorf.Csla.DataPortalExtensionGenerator as a Cake Addin #addin nuget:?package=Ossendorf.Csla.DataPortalExtensionGenerator&version=0.2.0-preview1.9&prerelease // Install Ossendorf.Csla.DataPortalExtensionGenerator as a Cake Tool #tool nuget:?package=Ossendorf.Csla.DataPortalExtensionGenerator&version=0.2.0-preview1.9&prerelease
DataPortal extensions for CSLA.NET
A Source Generator package that generates extension methods for IDataPortal<T>
and IChildDataPortal<T>
.
The extension methods are derived from annotated methods of business objects using CSLA.NET attributes like Fetch
, Create
, ...
.
How to install
dotnet add package Ossendorf.Csla.DataPortalExtensionsGenerator
<PackageReference Include="Ossendorf.Csla.DataPortalExtensionsGenerator" Version="0.1.0-preview1" PrivateAssets="all" ExcludeAssets="runtime" />
Either way adds the source generator to your project. Make sure to add PrivateAssets="all" ExcludeAssets="runtime"
to mark it as a build dependency. Otherwise it flows to projects which depend on your project.
To use the generator, add the [Ossendorf.Csla.DataPortalExtensionsGenerator.DataPortalExtensions]
attribute to a class which should containt the extensions.
For example:
[Ossendorf.Csla.DataPortalExtensionsGenerator.DataPortalExtensions]
public static partial class DataPortalExtensions {
}
Your business object:
namespace MyNamespace;
public class Address : BusinessBase<Address> {
[Create]
private void CreateLocally() {
// creation logic
}
[Fetch]
private async Task ById(Guid id) {
// fetch logic
}
[Fetch]
private async Task Fetch(string foo) {
// fetch logic
}
}
This will generate the following code:
static partial class DataPortalExtensions {
public static global::System.Threading.Tasks.Task<global::MyNamespace.Address> CreateLocally(this global::Csla.IDataPortal<global::MyNamespace.Address> portal) => portal.CreateAsync();
public static global::System.Threading.Tasks.Task<global::MyNamespace.Address> ById(this global::Csla.IDataPortal<global::MyNamespace.Address> portal, global::System.Guid id) => portal.FetchAsync(id);
public static global::System.Threading.Tasks.Task<global::MyNamespace.Address> Fetch(this global::Csla.IDataPortal<global::MyNamespace.Address> portal, string foo) => portal.FetchAsync(foo);
}
[!WARNING]
In the example above the last extension methods has the nameFetch
which is already defined by theIDataPortal
interface. That means the extension method is never used, because the compiler resolves the instance method and not the extension method to be used.
To avoid that use the configuration explained next.
How to configure the generator
You can configure the following for the generator to respect
- method prefix (default = "")
- method suffix (default = "")
- Enable/Disable nullable annotation context (default = Enable)
- SuppressWarningCS8669 (default = false)
The fetch named method example from above can be resolved with a prefix/suffix to generate a method with the name YourFetch
which in turn can be used and provides reliable compiler support.
You can add the following properties to your csproj-file to configure the generator.
<PropertyGroup>
<DataPortalExtensionGen_MethodPrefix>Prefix</DataPortalExtensionGen_MethodPrefix>
<DataPortalExtensionGen_MethodSuffix>Suffix</DataPortalExtensionGen_MethodSuffix>
<DataPortalExtensionGen_NullableContext>Enable/Disable</DataPortalExtensionGen_NullableContext>
<DataPortalExtensionGen_SuppressWarningCS8669>true/false</DataPortalExtensionGen_SuppressWarningCS8669>
</PropertyGroup>
With this added the consuming project the generator picks the values up and adds them as prefix or suffix.
[!TIP] To avoid wrong method resolution when your CSLA methods have the same name as the operation they perform. E.g. the method name is
Fetch()
for the[Fetch]
attribute. Use either the prefix or suffix configuration to make them different from the methods provided fromIDataPortal
.
Raodmap
- Special case commands to an extension like
commandPortal.ExecuteCommand(<params>)
which combinesCreate
+Execute
. - Support for generic business objects
- Add attribute to exclude methods explicitly
A lot of implementation details are derived/taken from the great series Andrew Lock: Creating a source generator. If you want to create your own source generator I can recommend that series wholeheartedly.
Why isn't this generator adding the Async
suffix for it's generated methods?
First of all in the current day nearly everything is async by default and not exception. That mean's I'm expecting that the data portals are used over some kind of wire which is async in nature.
So since I don't want to support sync-methods (currently, maybe someone wants them badly?) and I only have async methods why should I add noise to the method name?
A great post which explains the point in great detail is No Async Suffix - NServiceBus.
If you want the suffix for your code, just add it via the prefix configuration property 😃.
Learn more about Target Frameworks and .NET Standard.
-
.NETStandard 2.0
- No dependencies.
NuGet packages
This package is not used by any NuGet packages.
GitHub repositories
This package is not used by any popular GitHub repositories.
Version | Downloads | Last updated | |
---|---|---|---|
1.0.0 | 889 | 10/7/2024 | |
0.5.0-preview1 | 2,626 | 3/31/2024 | |
0.4.1-preview1 | 143 | 3/1/2024 | |
0.4.0-preview1 | 95 | 2/27/2024 | |
0.3.0-preview3 | 355 | 2/25/2024 | |
0.3.0-preview2 | 75 | 2/25/2024 | |
0.2.0-preview1.9 | 54 | 2/25/2024 | |
0.2.0-preview1 | 102 | 2/22/2024 | |
0.1.0-preview2 | 78 | 2/21/2024 | |
0.1.0-preview1 | 88 | 2/11/2024 | |
0.0.1-alpha4.7 | 71 | 2/10/2024 | |
0.0.1-alpha4.6 | 61 | 2/10/2024 | |
0.0.1-alpha4.3 | 59 | 2/10/2024 |