[3.1.x] Refs #12990 -- Added example to JSONField release notes.

Backport of 5d4b9c1cab from master
This commit is contained in:
Tom Forbes 2020-06-30 23:23:51 +01:00 committed by Mariusz Felisiak
parent 05206ca4ff
commit 7598ba01aa
1 changed files with 19 additions and 2 deletions

View File

@ -70,8 +70,25 @@ JSONField for all supported database backends
Django now includes :class:`.models.JSONField` and
:class:`forms.JSONField <django.forms.JSONField>` that can be used on all
supported database backends. Both fields support the use of custom JSON
encoders and decoders. The model field supports the introspection, lookups, and
transforms that were previously PostgreSQL-only.
encoders and decoders. The model field supports the introspection,
:ref:`lookups, and transforms <querying-jsonfield>` that were previously
PostgreSQL-only::
from django.db import models
class ContactInfo(models.Model):
data = models.JSONField()
ContactInfo.objects.create(data={
'name': 'John',
'cities': ['London', 'Cambridge'],
'pets': {'dogs': ['Rufus', 'Meg']},
})
ContactInfo.objects.filter(
data__name='John',
data__pets__has_key='dogs',
data__cities__contains='London',
).delete()
If your project uses ``django.contrib.postgres.fields.JSONField``, plus the
related form field and transforms, you should adjust to use the new fields,