| 1 | Index: docs/ref/models/instances.txt
|
|---|
| 2 | ===================================================================
|
|---|
| 3 | --- docs/ref/models/instances.txt (revision 12833)
|
|---|
| 4 | +++ docs/ref/models/instances.txt (working copy)
|
|---|
| 5 | @@ -34,12 +34,18 @@
|
|---|
| 6 |
|
|---|
| 7 | .. versionadded:: 1.2
|
|---|
| 8 |
|
|---|
| 9 | -There are three steps in validating a model, and all three are called by a
|
|---|
| 10 | -model's ``full_clean()`` method. Most of the time, this method will be called
|
|---|
| 11 | -automatically by a ``ModelForm``. (See the :ref:`ModelForm documentation
|
|---|
| 12 | -<topics-forms-modelforms>` for more information.) You should only need to call
|
|---|
| 13 | -``full_clean()`` if you plan to handle validation errors yourself.
|
|---|
| 14 | +There are three steps in validating a model:
|
|---|
| 15 |
|
|---|
| 16 | + * Validate the model fields
|
|---|
| 17 | + * Validate the model as a whole
|
|---|
| 18 | + * Validate the field uniqueness
|
|---|
| 19 | +
|
|---|
| 20 | +All three steps are performed by a model's ``full_clean()`` method.
|
|---|
| 21 | +Most of the time, each step is performed automatically via the is_valid method of ``ModelForm``. (See the :ref:`ModelForm documentation <topics-forms-modelforms>`
|
|---|
| 22 | +for more information.)
|
|---|
| 23 | +You should only need to call a model's ``full_clean()`` method if you plan to
|
|---|
| 24 | +handle validation errors yourself.
|
|---|
| 25 | +
|
|---|
| 26 | .. method:: Model.full_clean(exclude=None)
|
|---|
| 27 |
|
|---|
| 28 | This method calls ``Model.clean_fields()``, ``Model.clean()``, and
|
|---|
| 29 | @@ -52,9 +58,8 @@
|
|---|
| 30 | validated since any errors raised could not be corrected by the user.
|
|---|
| 31 |
|
|---|
| 32 | Note that ``full_clean()`` will NOT be called automatically when you call
|
|---|
| 33 | -your model's ``save()`` method. You'll need to call it manually if you want
|
|---|
| 34 | -to run model validation outside of a ``ModelForm``. (This is for backwards
|
|---|
| 35 | -compatibility.)
|
|---|
| 36 | +your model's ``save()`` method, nor through ``ModelForm`` validation.
|
|---|
| 37 | +You'll need to call it manually when you want to run model validation outside of a ``ModelForm``. (This is for backwards compatibility.)
|
|---|
| 38 |
|
|---|
| 39 | Example::
|
|---|
| 40 |
|
|---|