Changes between Version 1 and Version 2 of DocPtModelAPI

Timestamp:

Oct 31, 2006, 6:27:23 AM (18 years ago)

Author:

anonymous

Comment:

--

DocPtModelAPI

@@ -41 +41 @@
 .. _0.91: http://www.djangoproject.com/documentation/0_91/ 
 
+===================
+Referência do Model
+===================
+
+O model é a fonte única e definitiva dos seus dados, nele estão contidos os
+campos essenciais e relacionamentos dos dados que você está arquivando.
+Genericamente, cada model referencia a uma tabela no banco de dados.
+
+O básico:
+
+    * Cada model é uma classe Python que é uma subclasse de
+      ``django.db.models.Model``.
+    * Cada atributo do model representa um campo na base de dados.
+    * Metadados do model (informações descritivas dos dados) vão para uma
+      classe interior nomeada ``Meta``.
+    * Metadados usados para o site de administração do Django vão para a
+      classe interior nomeada ``Admin``.
+    * A partir disso o Django oferece uma API de acesso ao banco de dados
+      gerada automaticamente, que é melhor explicada na
+      `Referência da API de Banco de Dados`_.
+
+Associado a esse documento existe o `repositório oficial de exemplos de
+models`_.(No código fonte do Django, estes exemplos se encontram no
+diretório ``tests/modeltests``.)
+
+.. _Referência da API de Banco de Dados:
+    http://www.djangoproject.com/documentation/db_api/
+.. _repositório oficial de exemplos de model:
+    http://www.djangoproject.com/documentation/models/
+
+Exemplo rápido
+==============
+
+Este model exemplo define uma ``Person``, que possui um ``first_name`` e
+``last_name``::
+
+    from django.db import models
+
+    class Person(models.Model):
+        first_name = models.CharField(maxlength=30)
+        last_name = models.CharField(maxlength=30)
+
+``first_name`` e ``last_name`` são *campos* do model. Cada campo é
+especificado como um atributo da classe, e cada atributo referencia a uma
+coluna do banco de dados.
+
+O model ``Person`` acima criaria uma tabela no banco de dados como essa::
+
+    CREATE TABLE myapp_person (
+        "id" serial NOT NULL PRIMARY KEY,
+        "first_name" varchar(30) NOT NULL,
+        "last_name" varchar(30) NOT NULL
+    );
+
+Algumas notas técnicas:
+
+    * O nome da tabela, ``myapp_person``, é automaticamente atribuído de
+      algum metadado do model podendo ser sobrescrito. Olhe _`Nome de
+      Tabelas` abaixo.
+    * Um campo ``id`` é adicionado automaticamente
+
+
 }}}