- 一旦使用本开源项目以及引用了本项目或包含本项目代码的公司因为违反劳动法(包括但不限定非法裁员,超时用工,雇佣童工等)在任何法律诉讼中败诉的,项目作者有权利追讨本项目的使用费,或者直接不允许使用任何包含本项目的源代码!任何性质的
外包公司或996公司需要使用本类库,请联系作者进行商业授权!其他企业或个人可随意使用不受限.
- 一个 MongoDB 驱动的服务包,方便使用 MongoDB 数据库.
- 数据库中字段名驼峰命名,ID,Id 自动转化成 ObjectId.
- 可配置部分类的 Id 字段不存为 ObjectId,而存为 string 类型.
- 自动本地化 MOngoDB 时间类型
- 添加.Net6 Date/Time Only类型支持(TimeOnly理论上应该是兼容原TimeSpan数据类型).
- Date/Time Only类型可结合Miracle.WebCore使用,前端可直接传字符串类型的Date/Time Only的值.
- 在系统环境变量或者 Docker 容器中设置环境变量名称为: CONNECTIONSTRINGS_MONGO = mongodb 链接字符串 或者在 appsetting.json 中添加,
- 现在你也可以参考example.api项目查看直接传入相关数据.
{
"ConnectionStrings": {
"Mongo": "mongodb链接字符串"
},
// 或者使用
"CONNECTIONSTRINGS_MONGO": "mongodb链接字符串",
// 添加文件缓存
"MiracleStaticFile": {
"VirtualPath": "/miraclefs",
"PhysicalPath": "/home/username/test"
}
}######### 包依赖关系
- Miracle.MongoDB.GridFS依赖Miracle.MongoDB,Miracle.MongoDB.GridFS.Extension依赖Miracle.MongoDB.GridFS,
- 所以若是引用Miracle.MongoDB.GridFS会自动引入Miracle.MongoDB
- 引用Miracle.MongoDB.GridFS.Extension会自动引入Miracle.MongoDB.GridFS.
- 所以在使用扩展或者GridFS的时候可以不必显示引入Miracle.MongoDB
- 使用 Nuget 安装 Miracle.MongoDB
- .Net 6 +
using example.api;
using Miracle.MongoDB;
using Miracle.WebApi.Middlewares;
var builder = WebApplication.CreateBuilder(args);
// Add services to the container.
// 添加Mongodb数据库服务
var dboptions = new MiracleMongoOptions();
dboptions.AppendConventionRegistry("IdentityServer Mongo Conventions", new()
{
Conventions = new()
{
new IgnoreExtraElementsConvention(true)
},
Filter = _ => true
});
var db = await builder.Services.AddMongoDbContext<DbContext>(clientSettings: new()
{
ServerAddresses = new()
{
new("192.168.2.10", 27017),
},
AuthDatabase = "admin",
DatabaseName = "miracle",
UserName = "oneblogs",
Password = "&oneblogs.cn",
}, dboptions: dboptions);
builder.Services.AddControllers();
builder.Services.AddSwaggerGen(c => c.SwaggerDoc("v1", new() { Title = "example.api", Version = "v1" }));
var app = builder.Build();
// Configure the HTTP request pipeline.
if (app.Environment.IsDevelopment()) app.UseDeveloperExceptionPage();
app.UseGlobalException();
app.UseResponseTime();
app.UseAuthorization();
app.MapControllers();
app.UseSwagger().UseSwaggerUI();
app.Run();- 使用 Nuget 安装 Miracle.MongoDB.GridFS
- .Net 6 +
using example.api;
using Miracle.MongoDB;
using Miracle.WebApi.Middlewares;
var builder = WebApplication.CreateBuilder(args);
// Add services to the container.
// 添加Mongodb数据库服务
var dboptions = new MiracleMongoOptions();
dboptions.AppendConventionRegistry("IdentityServer Mongo Conventions", new()
{
Conventions = new()
{
new IgnoreExtraElementsConvention(true)
},
Filter = _ => true
});
var db = await builder.Services.AddMongoDbContext<DbContext>(clientSettings: new()
{
ServerAddresses = new()
{
new("192.168.2.10", 27017),
},
AuthDatabase = "admin",
DatabaseName = "miracle",
UserName = "oneblogs",
Password = "&oneblogs.cn",
}, dboptions: dboptions);
// 添加GridFS服务
builder.Services.AddMiracleGridFS(db._database!, new()
{
BusinessApp = "MiracleFS",
Options = new()
{
BucketName = "",
ChunkSizeBytes = 1024,
DisableMD5 = true,
ReadConcern = new() { },
ReadPreference = ReadPreference.Primary,
WriteConcern = WriteConcern.Unacknowledged
},
DefalutDB = true,
ItemInfo = "item.info"
});
builder.Services.AddControllers();
builder.Services.AddSwaggerGen(c => c.SwaggerDoc("v1", new() { Title = "example.api", Version = "v1" }));
var app = builder.Build();
// Configure the HTTP request pipeline.
if (app.Environment.IsDevelopment()) app.UseDeveloperExceptionPage();
app.UseGlobalException();
app.UseResponseTime();
app.UseAuthorization();
app.MapControllers();
app.UseSwagger().UseSwaggerUI();
app.Run();- 新增文件缓存到物理路径,便于文件在线使用.
- 添加物理路径清理接口.(可通过调用该接口定时清理所有缓存的文件)
- 使用 Nuget 安装 Miracle.MongoDB.GridFS.Extension
- .Net 6 +
var app = builder.Build();
// Configure the HTTP request pipeline.
if (app.Environment.IsDevelopment()) app.UseDeveloperExceptionPage();
app.UseGlobalException();
app.UseResponseTime();
app.UseAuthorization();
// 添加虚拟目录用于缓存文件,便于在线播放等功能.
app.UseMiracleGridFSVirtualPath(builder.Configuration);
app.MapControllers();
app.UseSwagger().UseSwaggerUI();
app.Run();- 详细内容参见 example.api 项目
