(Mac)Rails项目使用七牛上传及下载文件

集成七牛用到的JS-SDK及RUBY-SDK

首先要注册一个七牛的账号,这是我的推荐链接,希望大家能用到

七牛账号注册传送门

一、创建测试项目

没有安装 rails及ruby的自己找一下教程安装就可以了,这里不多说

rails new blog
cd blog

二、使用bower-rails来管理JS及CSS

1、rails创建项目后,在项目目录找到Gemfile文件添加,bower-rails链接
gem 'bower-rails', '~> 0.10.0'

因为bower可以统一管理js及css,所以很喜欢用它来找各种所需要的js及css框架

bundle install  #安装添加的Gem

bundle完成后,没有安装bower的先安装

npm install -g bower

已经安装的跳过上面操作

rails g bower_rails:initialize #初始化,生成两个文件:Bowerfile,config/initializers/bower_rails.rb

也可以手动创建Bowerfile文件

2、在Bowerfile里面我们需要的文件

通过七牛的js-sdk我们看到,里面需要Plupload及qiniu.js,在Bowerfile里面添加下面两行

asset 'plupload'
asset 'qiniu'

为什么引用这两个,大家可以使用
bower search qiniu 查看一下七牛

qiniu git://github.com/qiniu/js-sdk.git

bower search plupload

plupload git://github.com/moxiecode/plupload.git

上面的两条就是我们用到的

rake bower:install #进行我们使用的文件的安装

完成后就会看到vendor/assets/目录下多了个bower_components,里面就是我们用到的qiniu,plupload两个目录
#bower安装的文件都会放到``bower_components``这个目录下

查看一下Asset Path,确认正常安装

rails c
pp Rails.application.config.assets.paths ;nil
#最后一条应该是:
#你的项目目录/blog/vendor/assets/bower_components
3、集成JS-SDK

打开app/assets/javascripts/application.js,在//= require_tree .上面添加下面三行程序

//= require plupload/js/moxie
//= require plupload/js/plupload.dev
//= require qiniu/src/qiniu

引用哪个文件参考js-sdk

(引入plupload.full.min.js(产品环境)或 引入plupload.dev.js和moxie.js(开发调试))
以上我们就把plupload及七牛js-sdk集成完了,下面开始使用

使用JS-SDK及RUBY-SDK上传文件到七牛

1、创建welcome_controller及index方法
rails g controller welcome index

修改config/routes.rb,去掉root 'welcome#index'前面的注释重启一下服务,刷新页面,查看源码就会看到我们引入的js应该在里面了

<script src="/assets/plupload/js/moxie.self-b8e07f1d750316a52394ba94437a76c366321fc07168056886d71194d9708765.js?body=1" data-turbolinks-track="true"></script>
<script src="/assets/plupload/js/plupload.dev.self-ed93d8d8697e05029f55c943427a588f2f51428bf2a24da9e3669fe39d58b923.js?body=1" data-turbolinks-track="true"></script>
<script src="/assets/qiniu/src/qiniu.self-3090703c4bdd583539b3af30b9cc0c9d704400edce934202d69bb38d962294ac.js?body=1" data-turbolinks-track="true"></script>

查看JS-SDK下面的说明,修改views/welcome/index.html.erb,参考JS-SDK

<h1>Welcome#index</h1>
<p>Find me in app/views/welcome/index.html.erb</p>
<div class="container" id="container">

</div>
<a href="javascript:;" id="pickfiles">上传文件</a>

<script type="text/javascript">
var uploader = Qiniu.uploader({
    runtimes: 'html5,flash,html4',    //上传模式,依次退化
    browse_button: 'pickfiles',       //上传选择的点选按钮,**必需**
    uptoken_url: '/uptoken',            //Ajax请求upToken的Url,**强烈建议设置**(服务端提供)
    // downtoken_url: '/downtoken',
    // Ajax请求downToken的Url,私有空间时使用,JS-SDK将向该地址POST文件的key和domain,服务端返回的JSON必须包含`url`字段,`url`值为该文件的下载地址
    // uptoken : '<Your upload token>', //若未指定uptoken_url,则必须指定 uptoken ,uptoken由其他程序生成
    // unique_names: true, // 默认 false,key为文件名。若开启该选项,SDK会为每个文件自动生成key(文件名)
    // save_key: true,   // 默认 false。若在服务端生成uptoken的上传策略中指定了 `sava_key`,则开启,SDK在前端将不对key进行任何处理
    domain: 'http://qiniu-plupload.qiniudn.com/',   //bucket 域名,下载资源时用到,**必需**
    get_new_uptoken: false,  //设置上传文件的时候是否每次都重新获取新的token
    container: 'container',           //上传区域DOM ID,默认是browser_button的父元素,
    max_file_size: '100mb',           //最大文件体积限制
    flash_swf_url: 'js/plupload/Moxie.swf',  //引入flash,相对路径
    max_retries: 3,                   //上传失败最大重试次数
    dragdrop: true,                   //开启可拖曳上传
    drop_element: 'container',        //拖曳上传区域元素的ID,拖曳文件或文件夹后可触发上传
    chunk_size: '4mb',                //分块上传时,每片的体积
    auto_start: true,                 //选择文件后自动上传,若关闭需要自己绑定事件触发上传,
    //x_vars : {
    //    自定义变量,参考http://developer.qiniu.com/docs/v6/api/overview/up/response/vars.html
    //    'time' : function(up,file) {
    //        var time = (new Date()).getTime();
              // do something with 'time'
    //        return time;
    //    },
    //    'size' : function(up,file) {
    //        var size = file.size;
              // do something with 'size'
    //        return size;
    //    }
    //},
    init: {
        'FilesAdded': function(up, files) {
            plupload.each(files, function(file) {
                // 文件添加进队列后,处理相关的事情
            });
        },
        'BeforeUpload': function(up, file) {
               // 每个文件上传前,处理相关的事情
        },
        'UploadProgress': function(up, file) {
               // 每个文件上传时,处理相关的事情
        },
        'FileUploaded': function(up, file, info) {
               // 每个文件上传成功后,处理相关的事情
               // 其中 info 是文件上传成功后,服务端返回的json,形式如
               // {
               //    "hash": "Fh8xVqod2MQ1mocfI4S4KpRL6D98",
               //    "key": "gogopher.jpg"
               //  }
               // 参考http://developer.qiniu.com/docs/v6/api/overview/up/response/simple-response.html

               // var domain = up.getOption('domain');
               // var res = parseJSON(info);
               // var sourceLink = domain + res.key; 获取上传成功后的文件的Url
        },
        'Error': function(up, err, errTip) {
               //上传出错时,处理相关的事情
        },
        'UploadComplete': function() {
               //队列文件处理完毕后,处理相关的事情
        },
        'Key': function(up, file) {
            // 若想在前端对每个文件的key进行个性化处理,可以配置该函数
            // 该配置必须要在 unique_names: false , save_key: false 时才生效

            var key = "";
            // do something with key here
            return key
        }
    }
});
</script>

这里面注意:container: 'container'这个参数必须要有个`<div id="container"></div>否则会报错,当然id与参数对应就行,不是必须container

刷新页面,打开firebug或chrome的开发者工具,发现console里面有个错误

GET http://localhost:3000/uptoken 404 (Not Found)

因为七牛上传要一个上传凭证,js里面默认是uptoken,但我们没有这个方法所有下一步,就是生成七牛上传用的uploadToken

2、集成RUBY-SDK

打开Gemfile 添加七牛的SDK,参考RUBY-SDK

gem 'qiniu', '~> 6.4.1'

保存后
bundle install

2、生成七牛的上传凭证

创建qiniu_controller及生成上传凭证的方法token

rails g controller qiniu token 

参考Ruby SDK 使用指南

`config/initiallzers目录下创建qiniu.rb,添加下面内容

require 'qiniu'
Qiniu.establish_connection! :access_key => '<YOUR_APP_ACCESS_KEY>',
                            :secret_key => '<YOUR_APP_SECRET_KEY>'

打开`qiniu_controller.rb文件,在token方法里面添加下面代码

#上传到七牛的操作
def token
  require 'qiniu'
  # 已在某处调用Qiniu#establish_connection!方法
  put_policy = Qiniu::Auth::PutPolicy.new(
        QINIU_BUCKET,     # 七年存储空间
  )
  uptoken = Qiniu::Auth.generate_uptoken(put_policy)
  render json:{'uptoken':uptoken}
end

上面代码解释一下几个地方

# 已在某处调用Qiniu#establish_connection!方法``提示的方法就是我们在在config/initiallzers目录下创建qiniu.rb“添加的方法

QINIU_BUCKET因为七牛的空间是个全局变量,我把它放到config/environment.rb,内容如下:

# Load the Rails application.
require File.expand_path('../application', __FILE__)

# Initialize the Rails application.
Rails.application.initialize!

QINIU_BUCKET="你的七牛空间" #注意变量名要全部大写

render json:{'uptoken':uptoken}要返回给前台js-sdk的json数据格式

修改config\routers.rb里面添加 get 'qiniu/token'的路由

重启一下服务

rails s

我不知道是不是我这有问题,遇到一个问题,如下:

➜  blog  rails s
Could not find gem 'qiniu (~> 6.4.1)' in any of the gem sources listed in your Gemfile or available on this machine.
Run `bundle install` to install missing gems.
➜  blog  bundle install
Fetching gem metadata from https://ruby.taobao.org/.........
Fetching version metadata from https://ruby.taobao.org/..
Resolving dependencies...
Bundler could not find compatible versions for gem "mime-types":
  In snapshot (Gemfile.lock):
    mime-types (= 2.99)

  In Gemfile:
    rails (= 4.2.5) was resolved to 4.2.5, which depends on
      actionmailer (= 4.2.5) was resolved to 4.2.5, which depends on
mail (>= 2.5.4, ~> 2.5) was resolved to 2.6.3, which depends
on
          mime-types (< 3, >= 1.16)

    qiniu (~> 6.4.1) was resolved to 6.4.1, which depends on
      mime-types (~> 2.4.3)

Running `bundle update` will rebuild your snapshot from scratch,
using only
the gems in your Gemfile, which may resolve the conflict.
➜  blog  bundle update

这样就可以了,启用服务

rails s

访问http://localhost:3000/qiniu/token就可以看到生成了uptoken的json数据

这样上传凭证就完成了,修改一下index.html.erb里面的uptoken_url: '/qiniu/token'后,访问http://localhost:3000/看到firebug或开发者工具里面没有错误了

现在就可以上传文件到七牛了,index.html.erb里面的几个方法自己按着自己的业务修改就行,这里就不多说了

    'FilesAdded': function(up, files) {
            console.log('fileadded');
            console.log(files);
            plupload.each(files, function(file) {
                // 文件添加进队列后,处理相关的事情
            });
        },
        'BeforeUpload': function(up, file) {
            console.log('beforeUpload');
            // 每个文件上传前,处理相关的事情
        },
        'UploadProgress': function(up, file) {
            console.log('UploadProcess');
            // 每个文件上传时,处理相关的事情
        },
        'FileUploaded': function(up, file, info) {
          console.log(file);
           // 每个文件上传成功后,处理相关的事情
           // 其中 info 是文件上传成功后,服务端返回的json,形式如
           // {
           //    "hash": "Fh8xVqod2MQ1mocfI4S4KpRL6D98",
           //    "key": "gogopher.jpg"
           //  }
           // 参考http://developer.qiniu.com/docs/v6/api/overview/up/response/simple-response.html

           // var domain = up.getOption('domain');
           // var res = parseJSON(info);
           // var sourceLink = domain + res.key; 获取上传成功后的文件的Url
        },
        'Error': function(up, err, errTip) {
           //上传出错时,处理相关的事情
        },
        'UploadComplete': function() {
               //队列文件处理完毕后,处理相关的事情
        },
        'Key': function(up, file) {
            // 若想在前端对每个文件的key进行个性化处理,可以配置该函数
            // 该配置必须要在 unique_names: false , save_key: false 时才生效

            var key = "";
            // do something with key here
            return key
        }
3、下载素材私有空间,自己可以参考一下Ruby SDK 使用指南

相比上传,下载比较简单,同样在qiniu_controller里面添加downtoken的方法,因为这块程序在rails下没有测试过,所以仅供参考完成的qiniu_controller.rb源码如下:

class QiniuController < ApplicationController

  #post请求,设置downtoken忽略csrf验证
  skip_before_filter :verify_authenticity_token, :only => [:downtoken]  
  #上传到七牛的操作
  def token
    require 'qiniu'
    # logger.info(QINIU_BUCKET);
    # 已在某处调用Qiniu#establish_connection!方法
    put_policy = Qiniu::Auth::PutPolicy.new(
        QINIU_BUCKET,     # 存储空间
    )
    uptoken = Qiniu::Auth.generate_uptoken(put_policy)
    # result['uptoken'] =  uptoken;
    render json:{'uptoken':uptoken}
  end

  def downtoken
    require 'qiniu'
    # 已在某处调用Qiniu#establish_connection!方法
    primitive_url = params[:domain]+params[:key]
    download_url = Qiniu::Auth.authorize_download_url(primitive_url)
    render json:{'url':download_url}
  end

end

config/routers.rb里面添加post 'public/downtoken'

index.html.erb里面修改为downtoken_url: '/qiniu/downtoken'

第一次用csdn的markdown写东西,太累了,如有不合适的地方望大家多多包涵啊

  • 3
    点赞
  • 1
    收藏
    觉得还不错? 一键收藏
  • 0
    评论

“相关推荐”对你有帮助么?

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值