有时,在网络编程过程中需要向服务器上传文件。Multipart/form-data是上传文件的一种方式。
Multipart/form-data其实就是浏览器用表单上传文件的方式。最常见的情境是:在写邮件时,向邮件后添加附件,附件通常使用表单添加,也就是用multipart/form-data格式上传到服务器。
表单形式上传附件
具体的步骤是怎样的呢?
首先,客户端和服务器建立连接(TCP协议)。
第二,客户端可以向服务器端发送数据。因为上传文件实质上也是向服务器端发送请求。
第三,客户端按照符合“multipart/form-data”的格式向服务器端发送数据。
Multipart/form-data的格式是怎样的呢?
既然Multipart/form-data格式就是浏览器用表单提交数据的格式,我们就来看看文件经过浏览器编码后是什么样子。
HTML表单
浏览器打开的表单
点击“Browse…”分别选择“unknow.gif”和“unknow1.gif”文件,点击“submit”按纽后,文件将被上传到服务器。
下面是服务器收到的数据:
服务器收到的数据
这是一个POST请求。所以数据是放在请求体内,而不是请求头内。
这行指出这个请求是“multipart/form-data”格式的,且“boundary”是 “---------------------------7db15a14291cce”这个字符串。
不难想象,“boundary”是用来隔开表单中不同部分数据的。例子中的表单就有 2 部分数据,用“boundary”隔开。“boundary”一般由系统随机产生,但也可以简单的用“-------------”来代替。
实际上,每部分数据的开头都是由"--" + boundary开始,而不是由 boundary 开始。仔细看才能发现下面的开头这段字符串实际上要比 boundary 多了个 “--”
紧接着 boundary 的是该部分数据的描述。
接下来才是数据。
“GIF”gif格式图片的文件头,可见,unknow1.gif确实是gif格式图片。
在请求的最后,则是 "--" + boundary + "--" 表明表单的结束。
需要注意的是,在html协议中,用 “/r/n” 换行,而不是 “/n”。
下面的代码片断演示如何构造multipart/form-data格式数据,并上传图片到服务器。
[c-sharp] view plain copy
- //---------------------------------------
- // this is the demo code of using multipart/form-data to upload text and photos.
- // -use WinInet APIs.
- //
- //
- // connection handlers.
- //
- HRESULT hr;
- HINTERNET m_hOpen;
- HINTERNET m_hConnect;
- HINTERNET m_hRequest;
- //
- // make connection.
- //
- ...
- //
- // form the content.
- //
- std::wstring strBoundary = std::wstring(L"------------------");
- std::wstring wstrHeader(L"Content-Type: multipart/form-data, boundary=");
- wstrHeader += strBoundary;
- HttpAddRequestHeaders(m_hRequest, wstrHeader.c_str(), DWORD(wstrHeader.size()), HTTP_ADDREQ_FLAG_ADD);
- //
- // "std::wstring strPhotoPath" is the name of photo to upload.
- //
- //
- // uploaded photo form-part begin.
- //
- std::wstring strMultipartFirst(L"--");
- strMultipartFirst += strBoundary;
- strMultipartFirst += L"/r/nContent-Disposition: form-data; name=/"pic/"; filename=";
- strMultipartFirst += L"/"" + strPhotoPath + L"/"";
- strMultipartFirst += L"/r/nContent-Type: image/jpeg/r/n/r/n";
- //
- // "std::wstring strTextContent" is the text to uploaded.
- //
- //
- // uploaded text form-part begin.
- //
- std::wstring strMultipartInter(L"/r/n--");
- strMultipartInter += strBoundary;
- strMultipartInter += L"/r/nContent-Disposition: form-data; name=/"status/"/r/n/r/n";
- std::wstring wstrPostDataUrlEncode(CEncodeTool::Encode_Url(strTextContent));
- // add text content to send.
- strMultipartInter += wstrPostDataUrlEncode;
- std::wstring strMultipartEnd(L"/r/n--");
- strMultipartEnd += strBoundary;
- strMultipartEnd += L"--/r/n";
- //
- // open photo file.
- //
- // ws2s(std::wstring)
- // -transform "strPhotopath" from unicode to ansi.
- std::ifstream *pstdofsPicInput = new std::ifstream;
- pstdofsPicInput->open((ws2s(strPhotoPath)).c_str(), std::iOS::binary|std::ios::in);
- pstdofsPicInput->seekg(0, std::ios::end);
- int nFileSize = pstdofsPicInput->tellg();
- if(nPicFileLen == 0)
- {
- return E_ACCESSDENIED;
- }
- char *pchPicFileBuf = NULL;
- try
- {
- pchPicFileBuf = new char[nPicFileLen];
- }
- catch(std::bad_alloc)
- {
- hr = E_FAIL;
- }
- if(FAILED(hr))
- {
- return hr;
- }
- pstdofsPicInput->seekg(0, std::ios::beg);
- pstdofsPicInput->read(pchPicFileBuf, nPicFileLen);
- if(pstdofsPicInput->bad())
- {
- pstdofsPicInput->close();
- hr = E_FAIL;
- }
- delete pstdofsPicInput;
- if(FAILED(hr))
- {
- return hr;
- }
- // Calculate the length of data to send.
- std::string straMultipartFirst = CEncodeTool::ws2s(strMultipartFirst);
- std::string straMultipartInter = CEncodeTool::ws2s(strMultipartInter);
- std::string straMultipartEnd = CEncodeTool::ws2s(strMultipartEnd);
- int cSendBufLen = straMultipartFirst.size() + nPicFileLen + straMultipartInter.size() + straMultipartEnd.size();
- // Allocate the buffer to temporary store the data to send.
- PCHAR pchSendBuf = new CHAR[cSendBufLen];
- memcpy(pchSendBuf, straMultipartFirst.c_str(), straMultipartFirst.size());
- memcpy(pchSendBuf + straMultipartFirst.size(), (const char *)pchPicFileBuf, nPicFileLen);
- memcpy(pchSendBuf + straMultipartFirst.size() + nPicFileLen, straMultipartInter.c_str(), straMultipartInter.size());
- memcpy(pchSendBuf + straMultipartFirst.size() + nPicFileLen + straMultipartInter.size(), straMultipartEnd.c_str(), straMultipartEnd.size());
- //
- // send the request data.
- //
- HttpSendRequest(m_hRequest, NULL, 0, (LPVOID)pchSendBuf, cSendBufLen)
- ...