Skip to main content
net9.0

an abp module that provider dynamic dictionary management service

Published
Nov 25, 2024
1y ago
Total Downloads
1.2K
1,245

Install

dotnet add package Passingwind.Abp.DictionaryManagement.MongoDB.Tests --version 1.6.0
ProductVersions
.NET
net9.0

README

Dictionary management

Provides dictionary items and groups data

How to use

Domain

Start from IDictionaryManager

  /// <summary>
  ///  Get items
  /// </summary>
  Task<IReadOnlyList<DictionaryItemDescriptor>> GetItemsAsync(string groupName, bool onlyEnabled = true, CancellationToken cancellationToken = default);
  /// <summary>
  ///  Get groups
  /// </summary>
  Task<IReadOnlyList<DictionaryGroupDescriptor>> GetGroupsAsync(string? parentName = null, bool onlyPublic = true, CancellationToken cancellationToken = default);

  /// <summary>
  ///  Get item value by name
  /// </summary>
  Task<string?> GetItemValueAsync(string itemName, string? defaultValue = null, CancellationToken cancellationToken = default);
  /// <summary>
  ///  set an item value by name
  /// </summary>
  Task SetItemValueAsync(string name, string value, CancellationToken cancellationToken = default);

  /// <summary>
  /// Set item is enabled
  /// </summary>
  Task SetItemEnabledAsync(string name, bool isEnabled, CancellationToken cancellationToken = default);
  /// <summary>
  /// Set group is public
  /// </summary>
  Task SetGroupPublicAsync(string name, bool isPublic, CancellationToken cancellationToken = default);

  /// <summary>
  ///  Get item descriptor by name
  /// </summary>
  Task<DictionaryItemDescriptor> GetItemAsync(string name, CancellationToken cancellationToken = default);
  /// <summary>
  /// Get group descriptor by name
  /// </summary>
  Task<DictionaryGroupDescriptor> GetGroupAsync(string name, CancellationToken cancellationToken = default);

  /// <summary>
  ///  Check group is exists by name
  /// </summary>
  Task<bool> IsGroupExistsAsync(string name, CancellationToken cancellationToken = default);
  /// <summary>
  ///  Check item is exists by name
  /// </summary>
  Task<bool> IsItemExistsAsync(string name, CancellationToken cancellationToken = default);

  /// <summary>
  /// Create item
  /// </summary>
  Task<DictionaryItem> CreateItemAsync(string name, string displayName, string? value = null, string? description = null, string? groupName = null, int displayOrder = 100, bool isEnabled = true, CancellationToken cancellationToken = default);
  /// <summary>
  ///  Create group
  /// </summary>
  Task<DictionaryGroup> CreateGroupAsync(string name, string displayName, string? parentName = null, string? description = null, bool isPublic = false, CancellationToken cancellationToken = default);

  /// <summary>
  ///  Delete item by name
  /// </summary>
  Task DeleteItemAsync(string name, CancellationToken cancellationToken = default);
  /// <summary>
  /// Delete group by name
  /// </summary>
  Task DeleteGroupAsync(string name, bool removeAllItems = true, CancellationToken cancellationToken = default);

App Service

Start from IDictionaryAppService

Changes from Previous Version

v1.3.0v1.6.0
Added Frameworks
net9.0
Removed Frameworks
net8.0

Adoption Assessment

Assess this package against its supported frameworks, license, maintenance signals and dependency graph before making it a project standard.

Compatibility metadata lists 1 target framework; confirm the exact target used by your application.

Related Guides & Workflows

Learn how to evaluate, integrate, or audit this package in your .NET project.