5.12. 文件上传

要上传文件，应该先获得一个 access token，在后续请求中要使用这个 token。

假设我们有下面这个文件上传的表单：

<form id="fileForm">
    <h2>Select a file:</h2>
    <input type="file" name="file" id="fileUpload"/>
    <br/>
    <button type="submit">Upload</button>
</form>

<h2>Result:</h2>
<img id="uploadedFile" src="" style="display: none"/>

我们将使用 jQuery 进行上传，并使用 data 获取返回的 JSON，其内容是为上传的文件新建的 FileDescriptor 实例。之后我们可以将 access token 作为参数通过其 FileDescriptor 的 id 访问上传的文件：

$('#fileForm').submit(function (e) {
    e.preventDefault();

    var file = $('#fileUpload')[0].files[0];
    var url = 'http://localhost:8080/app/rest/v2/files?name=' + file.name; // 文件名作为一个参数

    $.ajax({
        type: 'POST',
        url: url,
        headers: {
            'Authorization': 'Bearer ' + oauthToken // 添加 access token 头
        },
        processData: false,
        contentType: false,
        dataType: 'json',
        data: file,
        success: function (data) {
            alert('Upload successful');

            $('#uploadedFile').attr('src',
                'http://localhost:8080/app/rest/v2/files/' + data.id + '?access_token=' + oauthToken); // 更新 image url
            $('#uploadedFile').show();
        }
    });
});