Briseann Django 1.0 comhoiriúnacht le 0.96 i roinnt réimsí.
\nCuideoidh an treoir seo leat tionscadal agus feidhmchláir 0.96 a phort go 1.0. Cuimsíonn an chéad chuid den doiciméad seo na hathruithe coitianta a theastaíonn chun reáchtáil le 1.0. Má bhriseann do chód fós tar éis dul tríd an gcéad chuid, seiceáil an chuid `Athruithe Lú Coitianta `_ le haghaidh liosta de dornán saincheisteanna comhoiriúnachta nach bhfuil chomh coitianta.
\n\nDéanann an chuid seo cur síos ar na hathruithe idir 0.96 agus 1.0 a chaithfidh mórchuid na n-úsáideoirí a dhéanamh.
\nAthraigh litríochtaí teaghrán ('foo') go litríochtaí Unicode (u'foo'). Úsáideann Django teaghráin Unicode anois ar fud. I bhformhór na n-áiteanna, leanfaidh teaghráin amh ag obair, ach cuirfidh nuashonrú chun litríochtaí Unicode a úsáid cosc ar roinnt fadhbanna doiléire.
Féach: doc: /ref/unicode le haghaidh sonraí iomlána.
\nAthruithe coitianta ar do chomhad samhlacha:
\nmaxlength ``go ``max_longLink to this heading#Athainmnigh d'argóint maxlength ``go `max_length (athraíodh é seo chun a bheith comhsheasmhach le réimsí foirme):
__unicode__ in ionad __str__Link to this heading#Cuir modh __unicode__ feidhm __str__ do mhúnla, agus déan cinnte go n-úsáideann tú Unicode`_ (u'foo') sa mhodh sin.
prepopulated_fromLink to this heading#Bain an argóint prepopulated_from ar réimsí samhail. Níl sé bailí a thuilleadh agus aistríodh é go dtí an rang ModelAdmin i admin.py`. Féach `an riarachán `_, thíos, le haghaidh tuilleadh sonraí faoi athruithe ar an riarachán.
Bain an argóint core ``ó do réimsí samhail. Níl sé riachtanach a thuilleadh, ós rud é go láimhseálann an comhéadan riaracháin an fheidhmiúlacht chomhionann (cuid de: ref: `eagarthóireacht inlíne <admin-inlines>`) go difriúil anois. Ní gá duit a bheith buartha faoi eagarthóireacht inlíne go dtí go sroicheann tú chuig an rannán `an riaracháin `_, thíos. Go dtí seo, bain na tagairtí go léir do `core.
class Admin: le admin.py`Link to this heading#Bain do dhearbhuithe inmheánacha ``aicme Riaracháin ``ó do mhúnlaí. Ní bhriseoidh siad aon rud má fhágann tú iad, ach ní dhéanfaidh siad aon rud freisin. Chun aipeanna a chlárú leis an riarachán aistrfidh tú na dearbhuithe sin chuig comhad admin.py; féach `an riarachán `_ thíos le haghaidh tuilleadh sonraí.
\n\nSeo thíos sampla comhad models.py leis na hathruithe go léir a chaithfidh tú a dhéanamh:
Sean (0.96) models.py:
class Author(models.Model):\n first_name = models.CharField(maxlength=30)\n last_name = models.CharField(maxlength=30)\n slug = models.CharField(maxlength=60, prepopulate_from=("first_name", "last_name"))\n\n class Admin:\n list_display = ["first_name", "last_name"]\n\n def __str__(self):\n return "%s %s" % (self.first_name, self.last_name)\nNua (1.0) models.py:
class Author(models.Model):\n first_name = models.CharField(max_length=30)\n last_name = models.CharField(max_length=30)\n slug = models.CharField(max_length=60)\n\n def __unicode__(self):\n return "%s %s" % (self.first_name, self.last_name)\nNua (1.0) admin.py:
from django.contrib import admin\nfrom models import Author\n\n\nclass AuthorAdmin(admin.ModelAdmin):\n list_display = ["first_name", "last_name"]\n prepopulated_fields = {"slug": ("first_name", "last_name")}\n\n\nadmin.site.register(Author, AuthorAdmin)\nCeann de na hathruithe is mó i 1.0 is é an riarachán nua. Tá comhéadan riaracháin Django (django.contrib.admin `) athchóirithe go hiomlán; tá sainmhínithe riaracháin dícheangailte go hiomlán anois ó shainmhínithe samhail, athscríobhadh an creat chun leabharlann láimhseála foirm nua Django a úsáid agus athdhearadh le leathaitheacht agus saincheaptha san áireamh.
\nGo praiticiúil, ciallaíonn sé seo go mbeidh ort gach ceann de do dhearbhuithe `Riarachán aicme ``a athscríobh. Chonaic tú cheana féin i `samhlacha `_ thuas conas glao ``admin.site.register () ``a chur in ionad do ``admin aicme admin `. Seo thíos roinnt sonraí níos mó maidir le conas an dearbhú ``Riarach sin a athscríobh isteach sa chomhréir nua.
Tá na roghanna nua edit_inline aistrithe go léir chuig admin.py`. Seo sampla:
Sean (0.96):
\nclass Parent(models.Model): ...\n\n\nclass Child(models.Model):\n parent = models.ForeignKey(Parent, edit_inline=models.STACKED, num_in_admin=3)\nNua (1.0):
\nclass ChildInline(admin.StackedInline):\n model = Child\n extra = 3\n\n\nclass ParentAdmin(admin.ModelAdmin):\n model = Parent\n inlines = [ChildInline]\n\n\nadmin.site.register(Parent, ParentAdmin)\nFéach: ref: admin-inlines le haghaidh tuilleadh sonraí.
\nréimsí ``a shimpliú, nó bain úsáid as ``fieldsetsLink to this heading#Bhí an sean-chomhpháirtíocht réimsí `mearbhall go leor, agus tá sé simplithe. Oibríonn an sean-chomhréir fós, ach beidh ort ``fieldsets a úsáid ina ionad.
Sean (0.96):
\nclass ModelOne(models.Model):\n ...\n\n class Admin:\n fields = ((None, {"fields": ("foo", "bar")}),)\n\n\nclass ModelTwo(models.Model):\n ...\n\n class Admin:\n fields = (\n ("group1", {"fields": ("foo", "bar"), "classes": "collapse"}),\n ("group2", {"fields": ("spam", "eggs"), "classes": "collapse wide"}),\n )\nNua (1.0):
\nclass ModelOneAdmin(admin.ModelAdmin):\n fields = ("foo", "bar")\n\n\nclass ModelTwoAdmin(admin.ModelAdmin):\n fieldsets = (\n ("group1", {"fields": ("foo", "bar"), "classes": "collapse"}),\n ("group2", {"fields": ("spam", "eggs"), "classes": "collapse wide"}),\n )\nurls.pyLink to this heading#Má tá an suíomh riaracháin á úsáid agat, ní mór duit do fhréamh ``urls.py` a nuashonrú.
\nSean (0.96) urls.py:
from django.conf.urls.defaults import *\n\nurlpatterns = patterns(\n "",\n (r"^admin/", include("django.contrib.admin.urls")),\n # ... the rest of your URLs here ...\n)\nNua (1.0) urls.py:
from django.conf.urls.defaults import *\n\n# The next two lines enable the admin and load each admin.py file:\nfrom django.contrib import admin\n\nadmin.autodiscover()\n\nurlpatterns = patterns(\n "",\n (r"^admin/(.*)", admin.site.root),\n # ... the rest of your URLs here ...\n)\ndjango.forms in ionad newformsLink to this heading#Cuir django.newforms` in ionad django.forms` - Athainmníodh Django 1.0 an modúl newforms (tugadh isteach i 0.96) go sean-foirme` simplí. Baineadh an modúl oldforms freisin.
Má tá leabharlann ``newforms` á úsáid agat cheana féin, agus má d'úsáid tú ár gcomhréiteach ráiteas ``allmhairiúch` a mholtar, níl le déanamh agat ach do ráitis iompórtála a athrú.
\nSean:
\nfrom django import newforms as forms\nNua:
\nfrom django import forms\nMá tá an seanchóras foirmeacha á n-úsáid agat (ar a django.forms`` agus django.oldforms` roimhe seo), beidh ort d'fhoirmeacha a athscríobh. Áit mhaith le tosú ná: doc: `foirmeacha doiciméadúcháin `</topics/forms/index>
\nCuir úsáid comhaid uaslódáilte - is é sin, iontrálacha i Request.Files -- mar fhoclóirí simplí leis an nua:class: ~django.core.files.uploadedfile.uploadedfile. Ní oibríonn comhréir an sean-fhoclóra a thuilleadh.
Dá bhrí sin, i radharc mar:
\ndef my_view(request):\n f = request.FILES["file_field_name"]\n ...\n... bheadh ort na hathruithe seo a leanas a dhéanamh:
\n\nTá athrú tagtha ar chur i bhfeidhm inmheán:class: Django.db.Models.FileField. Toradh infheicthe air seo ná go bhfuil athrú tagtha ar an mbealach a rochtain agat ar thréithe speisialta (URL, ainm comhaid, méid íomhá, srl.) na réimsí samhail seo. Beidh ort na hathruithe seo a leanas a dhéanamh, ag glacadh leis ar do mhúnla 's:class: ~django.db.models.filefield tugtar myfile:
Sean (0.96) | \nNua (1.0) | \n
|---|---|
``myfile.get_content_filename () `` | \n
| \n
``myfile.get_content_url () `` | \n``myfile.content.url `` | \n
``myfile.get_content_size () `` | \n
| \n
``myfile.save_content_file () `` | \n``myfile.content.save () `` | \n
``myfile.get_content_width () `` | \n
| \n
``myfile.get_content_height () `` | \n
| \n
Tabhair faoi deara nach bhfuil ciall ar na tréithe leithead agus airde ach do réimsí: class: `~django.db.models.imagefield. Is féidir tuilleadh sonraí a fháil sna cáipéiséisíocht: doc: model API </ref/models/fields>.
Paginator in ionad ObjectPaginatorLink to this heading#Baineadh an ObjectPaginator` i 0.96 agus cuireadh leagan feabhsaithe ina ionad, :class: django.core.paginator.paginator.
\nDe réir réamhshocraithe, éalaíonn an córas teimpléid HTML-go huathoibríoch anois aschur gach athróg. Chun tuilleadh a fhoghlaim, féach:ref: automatic-html-escaping.
\nChun éalú uathoibríoch a dhíchumasú le haghaidh athróg aonair, bain úsáid as an scagair:tfilter: safe:
\nThis will be escaped: {{ data }}\nThis will not be escaped: {{ data|safe }}\nChun éalú uathoibríoch a dhíchumasú le haghaidh teimpléad iomlán, fillte an teimpléad (nó díreach cuid áirithe den teimpléad) sa chlibe:ttag: autoescape:
\n{% autoescape off %}\n ... unescaped template content here ...\n{% endautoescape %}\nIs athruithe níos lú, níos logánaithe iad na hathruithe seo a leanas. Níor cheart dóibh dul i bhfeidhm ach ar úsáideoirí níos airde, ach is dócha gur fiú léamh tríd an liosta agus do chód a sheiceáil le haghaidh na rudaí seo.
\nCuir `**kwargs ``le haon láimhseálaithe comhartha cláraithe.
Ceangail, dícheangail agus seol comharthaí trí mhodhanna ar an réad: class: ~django.dispch.signal in ionad trí mhodhanna modúl i django.expedich.expedicher`.
Bain aon úsáid de na roghanna seoltóra Anainm agus `Aon ``` ` `` `` `` `` `` `` `` `` `` ` Is féidir leat comharthaí a sheolann aon seoltóir a fháil fós trí úsáid a bhaint as ``seoltóir = none
Déan aon chomharthaí saincheaptha a dhearbhaigh tú i gcásanna de:class: Django.Dispatch.Signal in ionad rudaí gan ainm.
Seo achoimre tapa ar na hathruithe cód a chaithfidh tú a dhéanamh:
\nSean (0.96) | \nNua (1.0) | \n
|---|---|
``def glaonna aisghairm (seoltóir) `` | \n\n |
``sig = réad () `` | \n``sig = django.expedich.signal () `` | \n
``expedicher.connect (glaoch ar ais, sig) `` | \n``sig.connect (glaoch ar ais) `` | \n
``expedicher.send (sig, seoltóir) `` | \n``sig.send (seoltóir) `` | \n
``expedicher.connect (glaoch ar ais, sig, seoltóir = aon) `` | \n``sig.connect (glaoch ar ais, Seoltóir = níl aon duine) `` | \n
Má bhí tú ag úsáid aip ``django.contrib.comments` Django 0.96, beidh ort uasghrádú a dhéanamh chuig an aip tráchtanna nua a tugadh isteach i 1.0. Féach an treoir uasghrádaithe le haghaidh sonraí.
\nAthainmníodh django.contrib.localflavor.usa ``go `django.contrib.localflavor.us. Rinneadh an t-athrú seo chun scéim ainmniúcháin blasanna áitiúla eile a mheaitseáil. Chun do chód a aistriú, níl le déanamh agat ach na hallmhairí a athrú.
Athainmníodh SessionBase.get_new_session_key () ``go ``_get_new_session_key (). ``get_new_session_object () ``níl ann a thuilleadh.
Roimhe seo, rith an tsraith a luchtú go huathoibríoch modh ``save () ``an tsamhail. Níl sé seo amhlaidh a thuilleadh, mar sin teastaíonn luachanna follasacha in aon daingneán anois ó aon réimsí (mar shampla: stampaí ama) a rinneadh go huathoibríoch ag `save () `.
\nTá an sean:exc: EnvironmentError roinnte ina an:exc: ImportError nuair a theipeann ar Django an modúl socruithe a aimsiú agus a:exc: RuntimeError nuair a dhéanann tú iarracht socruithe a athchumrú tar éis iad a úsáid cheana féin.
\nLOGIN_URL has movedLink to this heading#Bhog an: setting: LOGIN_URL tairiseach ó django.contrib.auth isteach sa modúl socruithe ``. <LOGIN_URL>In ionad ``from django.contrib.auth allmhairiú LOGIN_URL a úsáid féach to:setting: `Settings.login_url `.
APPEND_SLASH behavior has been updatedLink to this heading#I 0.96, mura raibh deireadh le URL i slash nó mura raibh tréimhse aige sa chomhpháirt dheiridh dá chonair, agus:setting: 'APPEND_SLASH` Fíor, atreoródh Django chuig an URL céanna, ach le slash curtha leis an deireadh. Anois, seiceálann Django chun a fheiceáil an mbeadh rud éigin i do phatrúin URL comhoiriúnach leis an bpatrún gan an slash rianaithe. Más ea, ní dhéantar aon athatreorú, toisc go nglactar leis go raibh tú ag iarraidh an patrún sin a ghabháil d'aon ghnó.
\nMaidir le formhór na ndaoine, ní bheidh aon athruithe ag teastáil ó seo. Mar sin féin, tá patrúin URL ag daoine áirithe a bhfuil cuma seo orthu:
\nr"/some_prefix/(.*)$"\nRoimhe seo, bheadh na patrúin sin a atreorú chun slasc rianaithe a bheith acu. Más mian leat slash i gcónaí ar URLanna den sórt sin, athscríobh an patrún mar:
\nr"/some_prefix/(.*/)$"\nTugann bainisteoirí ar ais anois eisceacht a:exc: ~Django.Core.Exceptions.MultipleObjectsReturned in ionad:exc: AssertionError:
\nSean (0.96):
\ntry:\n Model.objects.get(...)\nexcept AssertionError:\n handle_the_error()\nNua (1.0):
\ntry:\n Model.objects.get(...)\nexcept Model.MultipleObjectsReturned:\n handle_the_error()\nLazyDateLink to this heading#Níl an rang cúntóra LazyDate ann a thuilleadh.
Is féidir luachanna réamhshocraithe réimse agus argóintí fiosrúcháin a bheith ina rudaí inghlaonta, mar sin is féidir tagairt do datetime.datetime.now` a chur in ionad cásanna LazyDate:
Sean (0.96):
\nclass Article(models.Model):\n title = models.CharField(maxlength=100)\n published = models.DateField(default=LazyDate())\nNua (1.0):
\nimport datetime\n\n\nclass Article(models.Model):\n title = models.CharField(max_length=100)\n published = models.DateField(default=datetime.datetime.now)\nDecimalfield nua, agus is snámhphointe ceart anois é FloatfieldLink to this heading#Sean (0.96):
\nclass MyModel(models.Model):\n field_name = models.FloatField(max_digits=10, decimal_places=3)\n ...\nNua (1.0):
\nclass MyModel(models.Model):\n field_name = models.DecimalField(max_digits=10, decimal_places=3)\n ...\nMá dhéanann tú dearmad an t-athrú seo a dhéanamh, feicfidh tú earráidí faoi Floatfield gan tréith max_digits a ghlacadh i __init__, toisc nach nglacann an Floatfield nua aon argóintí a bhaineann le cruinneas.
Má tá MySQL nó PostgreSQL á úsáid agat, níl aon athruithe breise ag teastáil. Tá na cineálacha colún bunachar sonraí le haghaidh Decimalfield mar an gcéanna leis an sean-Floatfield.
Má tá SQLite á úsáid agat, ní mór duit an bunachar sonraí a chur i bhfeidhm ar na colúin chuí mar chineálacha deachúil, seachas snámha. Chun seo a dhéanamh, beidh ort do chuid sonraí a athluchtú. Déan é seo tar éis duit an t-athrú a dhéanamh ar Decimalfield a úsáid i do chód agus an cód Django a nuashonrú.
\n\nChun gach feidhmchlár a uasghrádú chun ``Decimalfield` a úsáid, is féidir leat an méid seo a leanas a dhéanamh, agus ainm gach aip in ionad ```sa chód th <app>íos:
\n$ ./manage.py dumpdata --format=xml <app> > data-dump.xml\n$ ./manage.py reset <app>\n$ ./manage.py loaddata data-dump.xml\nNótaí:
\nTá sé tábhachtach go gcuimhneoidh tú formáid XML a úsáid sa chéad chéim den phróiseas seo. Táimid ag baint leas as gné de na dumpaí sonraí XML a fhágann gur féidir snámha a iompar go deachmhálacha le SQLite.
Sa dara céim iarrfar ort a dhearbhú go bhfuil tú ullmhaithe chun na sonraí a chailleadh don iarratas (í) atá i gceist. Abair tá; cuirfimid na sonraí seo ar ais sa tríú céim.
Ní úsáidtear Decimalfield in aon cheann de na feidhmchláir a sheoltar le Django sula ndéantar an t-athrú seo, mar sin ní gá duit a bheith buartha faoin nós imeachta seo a dhéanamh d'aon cheann de na samhlacha caighdeánacha Django.
Má théann rud éigin mícheart sa phróiseas thuas, níl le déanamh ach cóipeáil do bhunachar sonraí cúltaca thar an mbunchomhad agus tosú arís.
\ndjango.views.i18n.set_language() now requires a POST requestLink to this heading#Roimhe seo, úsáideadh iarratas GET. Chiallaigh an sean-iompar go bhféadfaí stát (an áitiúil a úsáidtear chun an suíomh a thaispeáint) a athrú trí iarratas GET, atá i gcoinne moltaí na sonraíochta HTTP. Caithfidh an cód a ghlaonn an dearcadh seo a chinntiú go ndéantar iarratas POST anois, in ionad GET. Ciallaíonn sé seo nach féidir leat nasc a úsáid a thuilleadh chun rochtain a fháil ar an radharc, ach caithfidh tú aighneacht foirme de chineál éigin a úsáid (m.sh. cnaipe).
\nNí dhéantar `_ () ``(an réad inghlaonta a bhfuil a ainm béim amháin aige) a thuilleadh isteach i dtógáin - is é sin, níl sé ar fáil go draíochta i ngach modúl a thuilleadh.
\nMá bhí tú ag brath roimhe seo ar _ () ``a bheith i láthair i gcónaí, ba cheart duit ``ugettext` nó ugettext_lazy a iompórtáil go sainráite anois, más cuí, agus é a ainmhairiú chuig _` duit féin:
from django.utils.translation import ugettext as _\nNí thacaíonn rudaí HttpRequest` le rochtain ar stíl fhoclóra a thuilleadh; roimhe seo, bhí sonraí GET agus POST ``ar fáil go díreach ar an réad `HttpRequest` (m.sh., d'fhéadfá píosa sonraí foirme a sheiceáil trí if 'some_form_key' a úsáid in iarrat` nó trí request ['some_form_key']. Ní thacaítear leis seo a thuilleadh; má theastaíonn rochtain uait ar na sonraí comhcheangailte ``GET` agus POST `, bain úsáid as Request.request ina ionad.
Moltar go láidir, áfach, go bhféachann tú go sainráite sa fhoclóir cuí i gcónaí don chineál iarratais a bhfuil súil agat a fháil (Request.Get nó Request.Post); ag brath ar an bhfoclóir comhcheangailte request.request is féidir bunús na sonraí atá ag teacht isteach a masc.
Athainmníodh Django.http.httpResponse.Headers go _headers agus:class: ~django.http.http.httpResponse tacaíonn anois le seiceáil srianta go díreach. Mar sin bain úsáid as if ceannteideal mar fhreagra: ``in ionad ``if ceannteideal i freagra.heads:`.
Tá na ranganna caidrimh chineálach -- GenericForeignKey` agus GenericRelation -- tar éis bogadh isteach sa mhodúl:mod: django.contrib.contenttypes.
\ndjango.test.Client.login() has changedLink to this heading#Sean (0.96):
\nfrom django.test import Client\n\nc = Client()\nc.login("/path/to/login", "myuser", "mypassword")\nNua (1.0):
\n# ... same as above, but then:\nc.login(username="myuser", password="mypassword")\ndjango.core.management has been greatly refactored.
Caithfidh glaonna chuig seirbhísí bainistíochta i do chód ``call_command ``a úsáid anois. Mar shampla, má tá cód tástála éigin agat a ghlaonn flush agus load_data:
\nfrom django.core import management\n\nmanagement.flush(verbosity=0, interactive=False)\nmanagement.load_data(["test_data"], verbosity=0)\n... beidh ort an cód seo a athrú chun léamh:
\nfrom django.core import management\n\nmanagement.call_command("flush", verbosity=0, interactive=False)\nmanagement.call_command("loaddata", "test_data", verbosity=0)\nÉilíonn django-admin.py agus manage.py` fo-orduithe anois chun roimh roghanna. Mar sin:
$ django-admin.py --settings=foo.bar runserver\n... ní oibríonn sé a thuilleadh agus ba chóir é a athrú go:
\n$ django-admin.py runserver --settings=foo.bar\nSorteddictfromlist imitheLink to this heading#Baineadh django.newforms.forms.sorteddictfromlist. Is féidir Django.Utils.DataStructures.SortedDict a ionchasadh anois le seicheamh tuples.
Chun do chód a nuashonrú:
\nÚsáid Django.Utils.DataStructures.SortedDict cibé áit a raibh tú ag úsáid Django.NewForms.Forms.SortedDictFromList.
Toisc nach dtugann Django.utils.DataStructures.SortedDict.copy` doimhchóip ar ais mar a rinne SortedDictFromList.copy () `, beidh ort do chód a nuashonrú má bhí tú ag brath ar dhoimhchóip. Déan é seo trí `copy.deepcopy a úsáid go díreach.
Athainmníodh agus/nó athlonnaíodh beagn* uil* de fheidhmeanna cúltaca an bhunachar sonraí. Níor doiciméadaíodh aon cheann díobh seo, ach beidh ort do chód a athrú má tá aon cheann de na feidhmeanna seo á úsáid agat, a bhfuil gach ceann acu in:mod: django.db:
\nSean (0.96) | \nNua (1.0) | \n
|---|---|
| \n
| \n
| \n
| \n
| \n
| \n
| \n
| \n
| \n
| \n
| \n
| \n
| \n
| \n
``backend.get_last_insert_id `` | \n``connection.ops.last_insert_id `` | \n
| \n
| \n
``backend.get_max_name_length `` | \n``connection.ops.max_name_length `` | \n
| \n
| \n
| \n
| \n
``backend.get_sql_flush `` | \n``connection.ops.sql_flush `` | \n
``backend.get_sql_sequence_reset `` | \n
| \n
| \n
| \n
| \n
| \n
| \n
| \n
| \n
| \n
| \n
| \n
| \n
| \n
| \n``nascach.oibreoirí `` | \n
| \n
| \n
| \n
| \n
| \n
| \n
| \n
| \n
``backend.needs_upper_for_iops `` | \n
| \n
| \n
| \n
| \n
| \n
| \n
| \n
| \n
| \n