nhibernate.postgresql.json 1.1.2

.NET Core 2.0 .NET Standard 2.0
dotnet add package nhibernate.postgresql.json --version 1.1.2
NuGet\Install-Package nhibernate.postgresql.json -Version 1.1.2
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="nhibernate.postgresql.json" Version="1.1.2" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add nhibernate.postgresql.json --version 1.1.2
#r "nuget: nhibernate.postgresql.json, 1.1.2"
#r directive can be used in F# Interactive, C# scripting and .NET Interactive. Copy this into the interactive tool or source code of the script to reference the package.
// Install nhibernate.postgresql.json as a Cake Addin
#addin nuget:?package=nhibernate.postgresql.json&version=1.1.2

// Install nhibernate.postgresql.json as a Cake Tool
#tool nuget:?package=nhibernate.postgresql.json&version=1.1.2

Build status

nhibernate.postgresql.json

NHibernate custom type to handle PostgreSQL JSON and JSONB column types.

As of June/2019 this repository is being actively maintained.

Installation

This library depends on the following NuGet packages:

These will be installed as dependencies along with this page.

To install this download package nhibernate.postgresql.json or run:

Install-Package nhibernate.postgresql.json

Compatibility

This library has been tested with .NET Core 2.1 and NHibernate 5.x.

Configuration

All this package does is offer an NHibernate custom type that you can use to handle json/jsonb PostgreSql data types. It relies on the configuration provided by NpgSql.Json.Net.

The way it works is by telling the extension which .NET types you want it to handle for you. This is done in the Startup class:

NpgsqlConnection.GlobalTypeMapper.UseJsonNet(new[] { typeof(AnotherType) });

It is important to note that you must specify each of the types that you want the library to handle for you and not their parents.

Usage

After the configuration is complete, you can just use it in your mapping as a custom type:

Map(x => x.PropertyWithMyType).CustomSqlType("jsonb").CustomType<JsonType<AnotherType>>().Column("db_column");

It also works with native CLR types such as Dictionary<string,string> which is perfect to store unstructured data. In my particular case, I use it to store raw data from web requests along with parsed data.

Map(x => x.Raw).CustomSqlType("jsonb").CustomType<JsonType<Dictionary<string,string>>>().Column("raw");

Sample

A more complete sample can be found below:

Startup.cs

public class Startup
    {
        public Startup(IConfiguration configuration)
        {
            Configuration = configuration;
        }

        public IConfiguration Configuration { get; }

        // This method gets called by the runtime. Use this method to add services to the container.
        public void ConfigureServices(IServiceCollection services)
        {
            services.AddMvc()
                .SetCompatibilityVersion(CompatibilityVersion.Version_2_1);

            NpgsqlConnection.GlobalTypeMapper.UseJsonNet(new[] { typeof(MyType) });
        }

        // This method gets called by the runtime. Use this method to configure the HTTP request pipeline.
        public void Configure(IApplicationBuilder app, IHostingEnvironment env)
        {
            if (env.IsDevelopment())
            {
                app.UseDeveloperExceptionPage();
            }
            else
            {
                app.UseHsts();
            }

            //app.UseHttpsRedirection();
            app.UseMvc();
        }

MyEntity.cs

public class AnotherType
{
	public AnotherType() {}
	
	public virtual string AnotherProperty {get;set;}
}

public class MyType
{
	public MyType() {}

	public virtual string Name { get; set; }
	public virtual int Age { get; set; }
	public virtual AnotherType Other { get; set; }	
}

public class MyTypeMap : ClassMap<AnotherType>
{

	public MyType()
	{
		Table("my_table");

		Map(x => x.Name).Column("name");
		Map(x => x.Age).Column("age");
		Map(x => x.Other).CustomSqlType("jsonb").CustomType<JsonType<Transaction>>().Column("other").Not.Nullable();
	}
}

How to contribute / I want to help

If you are interested in helping out there are a few things we could use:

  • Add tests to the project to make sure that this behaves as it should (so far I have been using it in a production app, but my use case is very simple and not comprehensive)
  • Add more examples

If you feel like helping, just send a PR 😃

Product Versions
.NET net5.0 net5.0-windows net6.0 net6.0-android net6.0-ios net6.0-maccatalyst net6.0-macos net6.0-tvos net6.0-windows net7.0 net7.0-android net7.0-ios net7.0-maccatalyst net7.0-macos net7.0-tvos net7.0-windows
.NET Core netcoreapp2.0 netcoreapp2.1 netcoreapp2.2 netcoreapp3.0 netcoreapp3.1
.NET Standard netstandard2.0 netstandard2.1
.NET Framework net461 net462 net463 net47 net471 net472 net48 net481
MonoAndroid monoandroid
MonoMac monomac
MonoTouch monotouch
Tizen tizen40 tizen60
Xamarin.iOS xamarinios
Xamarin.Mac xamarinmac
Xamarin.TVOS xamarintvos
Xamarin.WatchOS xamarinwatchos
Compatible target framework(s)
Additional computed target framework(s)
Learn more about Target Frameworks and .NET Standard.

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.1.2 8,572 7/26/2019
1.1.1 530 5/27/2019
1.1.0 541 5/17/2019
1.0.21 542 5/27/2019
1.0.1 803 12/26/2018
1.0.0 934 12/26/2018