那些年，我们在Django web开发中踩过的坑（一）——神奇的‘/’与ajax+iframe上传

一、上传图片并在前端展示

为了避免前端整体刷新，我们采用ajax+iframe（兼容所有浏览器）上传，这样用户上传之后就可以立即看到图片：

上传前：

上传后：

前端部分html：

<form style="display: inline-block" id="upload_img_form" name="form" action="/upload/" method="POST"
          enctype="multipart/form-data">
        {% csrf_token %}
        　　<a id="fakeFile" class="fake-file">
        　　　　<input type="file" name="img" onchange="UploadImage(this);"/>
        　　　　<input type="text" name="url" class="hide"/>
        </a>
        <iframe id='upload_img_iframe' name='upload_img_iframe' src="" class="hide"></iframe>
    </form>

　　别看这么短短的html，坑却不少：

• 坑one：action="/upload/"，当年笔者傻傻的就只写了action="/upload"，因为url是这么配的：url(r'^upload', v.upload),结果

  django居然报错了，笔者查了很多资料，最后才知道，原来，虽然url的最后没有加'/'，但是django在运行时会自动给url的后面加'/',因此，我们在post提交时，必须在url的最后加'/'。

• 坑two：enctype="multipart/form-data"，文件上传相对于其他表单类型出现的概率比较小，而文件上传确是这些表单类型中的异类，它需要在form写上enctype="multipart/form-data"。
• 坑three：{% csrf_token %}，django运行程序时，请求首先会通过中间件，然后才会通过url，django配置文件中有关于跨站请求伪造的中间件：

  MIDDLEWARE_CLASSES = [
      'django.middleware.security.SecurityMiddleware',
      'django.contrib.sessions.middleware.SessionMiddleware',
      'django.middleware.common.CommonMiddleware',
      'django.middleware.csrf.CsrfViewMiddleware',
      'django.contrib.auth.middleware.AuthenticationMiddleware',
      'django.contrib.auth.middleware.SessionAuthenticationMiddleware',
      'django.contrib.messages.middleware.MessageMiddleware',
      'django.middleware.clickjacking.XFrameOptionsMiddleware',
  ]
  

  　　django为用户实现防止跨站请求伪造的功能，通过中间件 django.middleware.csrf.CsrfViewMiddleware 来完成。而对于django中设置防跨站请求伪造功能有分为全局和局部。

  全局：

  　　中间件 django.middleware.csrf.CsrfViewMiddleware

  局部：

  • @csrf_protect，为当前函数强制设置防跨站请求伪造功能，即便settings中没有设置全局中间件。
  • @csrf_exempt，取消当前函数防跨站请求伪造功能，即便settings中设置了全局中间件。

  中间件'django.middleware.csrf.CsrfViewMiddleware',会查看post请求是否携带token ，如果没有则直接在process_request中return 并报出如下错误：

  此时，我们有几种处理方式：1.直接简单粗暴的注释掉settings中的csrf中间件；2.给接收post请求的views函数加@csrf_exempt（注：from django.views.decorators.csrf import csrf_exempt,csrf_protect），该装饰器的意思是取消当前函数防跨站请求伪造功能；

JavaScript代码：　

function UploadImage(ths) {
        document.getElementById('upload_img_iframe').onload = UploadImageComplete;  //页面加载完成后执行UploadImageComplete函数
        document.getElementById('upload_img_form').target = 'upload_img_iframe';  //设置form提交到iframe
        document.getElementById('upload_img_form').submit(); //#提交到iframe
    }
    function UploadImageComplete() {
        var origin = $("#upload_img_iframe").contents().find("body").text();//#获取图片数据
        var obj = JSON.parse(origin); //#转换成JavaScript对象
            var img = document.createElement('img'); //#创建img标签
            img.src = obj.path; //图片地址
            img.style.width = "200px";
            img.style.height = "180px";
            $("#upload_img_form").append(img);//添加图片
            $('#fakeFile').addClass('hide');
            $('#reUploadImage').removeClass('hide');
            $('#fakeFile').find('input[type="text"]').val(obj.data);//#保存图片地址到隐藏的input标签中
    }

　　后台views函数代码：

def upload(request):
    if request.method == 'POST':
        obj = request.FILES.get('img')#获取图片对象
        pat = os.path.join('static','img','vote',obj.name)#文件打开目录，需要和当前文件路径一致
        f = open(pat,'wb')
        for ch in obj.chunks():
            f.write(ch)
        f.close()
        ret = {'path': '/'+os.path.join('static','img','vote',obj.name)}#django前端文件路径：'/' + 静态文件前缀static + 静态文件下的目录
        import json
        return HttpResponse(json.dumps(ret))#反馈给前端
    return render(request,'upload.html',)

后台和前端js关于文件路径再现一坑：

　　注：这里我们将图片保存在静态文件目录static下的img中（静态文件路径的前缀也是static）

　　django前端我们希望的引入图片的路径是这样的:/static/img/xx.png，这里需要注意的是static前必须加'/',没错，就是这个神奇的'/'，代表当前程序主目录，即配置文件中的BASE_DIR。

　　后台我们打开文件写入图片到服务器的路径，这里open路径需要遵循的是python的规则而不是django前端的规则，即python会默认从当前路径开始找，因此直接static/img/xx.png就行，前面不需要加'/'。

二、数据库查询结果给前端反馈序列化的问题

　　

　　json不能序列化django中的datatime、Decimal等数据结构，解决方案：

1.单独转为python数据结构

str（ Decimal('12.36')）

　　然后通过json进行序列化。

2.直接将数据库查询结果QuerySet对象转化为列表，QuerySet看起来像列表

ret=list（QuerySet对象）
result=json.dumps（ret）

　　由于json.dumps时无法处理datetime日期，所以可以通过自定义处理器来做扩展，如：

import json
from datetime import date
from datetime import datetime 

class JsonCustomEncoder(json.JSONEncoder): 

    def default(self, field): 

        if isinstance(field, datetime):
            return o.strftime('%Y-%m-%d %H:%M:%S')
        elif isinstance(field, date):
            return o.strftime('%Y-%m-%d')
        else:
            return json.JSONEncoder.default(self, field) 

# ds = json.dumps(d, cls=JsonCustomEncoder) 

　　这是通过制定json.dumps序列化的类来实现的。

3.使用django的序列化工具serializers

from django.core import serializers

ret = models.BookType.objects.all()

data = serializers.serialize("json", ret)

　　总结：常见的form表单传文件可能大家都会，因此本博文主要讲述了ajax+iframe上传文件中需要注意的一些问题，如需form上传文件案例，可联系本人，谢谢！