File Exchange

image thumbnail

urlreadpost - url POST method with binary file uploading

version 1.1 (3.5 KB) by

A replacement for urlread(url,'post',...) that allows POST to upload binary (file) data.



View License

The HTTP 'POST' method is provided as a mechanism for uploading data as part of a URL request. There are two methods for encoding this data: application/x-www-form-urlencoded, in which each parameter is inserted as part of one long string, and multipart/form-data, in which each parameter gets its own MIME form-data block in the stream. This latter method allows the inclusion of large amounts of binary data (for instance, a POST which uploads a file) which is not possible with x-www-form-urlencoded.

Matlab's stock urlread does support the 'POST' method, but only with the x-www-form-urlencoded encoding. I wrote this replacement to be able to access web services that involve uploading binary files directly from Matlab. Here's an example, of uploading MP3 audio data to the Echo Nest Analyze API:

  f = fopen('music.mp3');
  d = fread(f,Inf,'*uint8'); % Read in byte stream of MP3 file
  str = urlreadpost('', ...

urlpost checks the type of the value part of each key/value pair, and encodes it as an octet-stream (binary) if it is not
char data. In practice, you should only pass byte data (e.g. the uint8 vector in the example above).

This function is a modified version of the urlread.m function that is part of Matlab R2010a. Also included is the stock urlreadwrite.m helper function since this is used by urlreadpost.m, but won't be found in its private location by default.

Comments and Ratings (2)


Kelvin (view profile)

Hi, thanks for writing this code - it looks very useful! Unfortunately I haven't been able to make it work. Could you provide an example with a few more form inputs?


R (view profile)

Very cool code, partly written in java.
Does what it promises: enables file uploads to a web service.
I found this code even before I discovered that the regular urlread cannot do this. Love it! Used with R2010b and php/apache server.



I fixed a typo in the example usage fragment (d was referred to as dd).

MATLAB Release
MATLAB 7.10 (R2010a)

Inspired: Steno3D

Download apps, toolboxes, and other File Exchange content using Add-On Explorer in MATLAB.

» Watch video