devise 小项目(一)

Devise源于Warden，而warden是一个基于Rack的验证权限gem，不过，使用devise实际并不需要任何关于warden的知识。

如果你之前有一些其他类似的维护验证权限功能的gem的使用经验的话，你会发现Devise的和他们的不同之处在于，提供了从页面到model的实现。相比而言，例如Authlogic就只实现了与model层的实现，这时你就要自己去处理view层实现。而Devise是基于Rails 引擎开发的所以就可以同时提供controllers和view的实现。从功能角度来看，Devise提供了11个方面的在维护和验证权限过程的功能模 块，这些模块都是可配置的。

Devise is a flexible authentication solution for Rails based on Warden. It:

• Is Rack based;
• Is a complete MVC solution based on Rails engines;
• Allows you to have multiple models signed in at the same time;
• Is based on a modularity concept: use only what you really need.

It's composed of 10 modules:

• Database Authenticatable: encrypts and stores a password in the database to validate the authenticity of a user while signing in. The authentication can be done both through POST requests or HTTP Basic Authentication.
• Omniauthable: adds OmniAuth (https://github.com/intridea/omniauth) support.
• Confirmable: sends emails with confirmation instructions and verifies whether an account is already confirmed during sign in.
• Recoverable: resets the user password and sends reset instructions.
• Registerable: handles signing up users through a registration process, also allowing them to edit and destroy their account.
• Rememberable: manages generating and clearing a token for remembering the user from a saved cookie.
• Trackable: tracks sign in count, timestamps and IP address.
• Timeoutable: expires sessions that have not been active in a specified period of time.
• Validatable: provides validations of email and password. It's optional and can be customized, so you're able to define your own validations.
• Lockable: locks an account after a specified number of failed sign-in attempts. Can unlock via email or after a specified time period.

Devise is guaranteed to be thread-safe on YARV. Thread-safety support on JRuby is in progress.

1.基于Rack

　　2.是一个基于Rails引擎的完整MVC解决方案

　　3.允许多个模块同时登陆

　　4.基于模块化的概念：只使用你需要的

它由10个模块组成：

　　1.数据库验证：注册信息的同时将密码加密并且储存在数据库中以便于身份验证，无论提交POST请求还是HTTP基本身份验证的情况下都支持。

　　2.Omniauthable验证：添加了OmniAuth(https://github.com/intridea/omniauth)身份验证。

　　3.邮件确认：在登陆时发送验证邮件确认邮件已被确认。

　　4.重获密码：重新设置密码并且发送重设密码邮件

　　5.注册：控制已注册用户的功能，已注册用户可以编辑和删除他们的账户。

　　6.记忆cookie功能：管理创建和清楚用户已保存的cookie的记忆令牌。

　　7.可追踪的：追踪登陆次数，时间以及IP地址。

　　8.会话超时管理：在特定的时间内会话到期。

　　9.验证信息：提供验证邮件和密码。此功能是可选择和定制的，所以你可以定义你自己需要的验证。

　　10.可锁定的：在指定数量的失败登陆后锁定账户，可以通过限定时间或者邮件验证解锁账户。

Devise在YARV虚拟机上是第三方安全的，在Jruby上第三方安全正在进行中。

1.先创建应用

cd workspace
rails _4.2.0_ new sample_device --skip-bundle(由于会自动检查更新，所以取消更好)
cd sample_device
bundle install --local

2.如果你之前安装了某个 gem(例如
Rails 本身)的其他版本,和 Gemfile 中指定的版本号不同,最好再执行 bundle update 命令,更新 gem,确
保安装的版本和指定的一致，运行

bundle update #应该是bundle update会去检查Gemfile里gem的更新，然后对比lock文件，如果Gemfile里没有指定版本或是指定是>=的版本，那有新版本就会去安装新的版本的gem，然后更新lock文件。
　　　　　　　　#而bundle install以Lock文件为优先，为本地系统安装Lock文件中指定的版本，而去检查Gemfile中有而Lock中没有的，安装之。Install好像不去管网络中Gem版本的更新。

3.登陆bitbucket创建仓库，然后初始化git仓库

git init
git add -A
git commit -m "Init repository"

将README.rdoc改为README.md(markdown格式)

git mv README.rodc README.md

提交改动

git commit -am "Improve README"

把代码推送到bitbucket

git remote add origin git@bitbucket:yz00/sample_devise.git
git push -u origin --all

使用 Git 时最好在单独的主题分支中完成工作,so建立新的分支

git co master
git co -b devise-init

4.在Gemfile里面添加,所有gem如下

source 'https://rubygems.org'

# Bundle edge Rails instead: gem 'rails', github: 'rails/rails'
gem 'rails', '4.2.0'

# Use SCSS for stylesheets
gem 'sass-rails', '~> 5.0'
# Use Uglifier as compressor for JavaScript assets
gem 'uglifier', '>= 1.3.0'
# Use CoffeeScript for .coffee assets and views
gem 'coffee-rails', '~> 4.1.0'
# See https://github.com/sstephenson/execjs#readme for more supported runtimes
# gem 'therubyracer', platforms: :ruby

# Use jquery as the JavaScript library
gem 'jquery-rails'
# Turbolinks makes following links in your web application faster. Read more: https://github.com/rails/turbolinks
gem 'turbolinks'
# Build JSON APIs with ease. Read more: https://github.com/rails/jbuilder
gem 'jbuilder', '~> 2.0'
# bundle exec rake doc:rails generates the API under doc/api.
gem 'sdoc', '~> 0.4.0', group: :doc

# Use ActiveModel has_secure_password
gem 'bcrypt', '~> 3.1.7'
#
gem 'devise'
gem 'omniauth', '1.2.2'
gem 'bootstrap-sass'
# Use Unicorn as the app server
# gem 'unicorn'

# Use Capistrano for deployment
# gem 'capistrano-rails', group: :development

group :development, :test do
  # Call 'byebug' anywhere in the code to stop execution and get a debugger console
  gem 'byebug'

  # Use sqlite3 as the database for Active Record
  gem 'sqlite3'

  # Access an IRB console on exception pages or by using <%= console %> in views
  gem 'web-console', '~> 2.0'

  # Spring speeds up development by keeping your application running in the background. Read more: https://github.com/rails/spring
  gem 'spring'
end
group :production do 
  #use postgresql as the database for Active Record
  gem 'pg'
  #Makes running your Rails app easier
  gem 'rails_12factor'
end

然后安装

bundle install

初始化devise

rails generate devise:install

由于devise用的rails引擎，支持generate

$ rails generate devise User　　　　#注意大写
      invoke  active_record
      create    app/models/user.rb　　　　#生成user模型
      invoke    test_unit　　　　　　　　#测试部分
      create      test/unit/user_test.rb
      create      test/fixtures/users.yml
      inject  app/models/user.rb　　　　
      create  db/migrate/20150605114421_devise_create_users.rb 　　　　　　#生成migration
       route  devise_for :users

然后我们来看看文件里都有什么

user.rb

class User < ActiveRecord::Base
  # Include default devise modules. Others available are:
   #:lockable
  devise :database_authenticatable, :registerable,   #数据库验证，注册拥有的功能
         :confirmable, :timeoutable,:omniauthable,　　#注册邮件验证，登陆超时，OmniAuth第三方验证
         :recoverable, :rememberable, :trackable, :validatable　　#修改密码发送验证邮件，记忆cookies,追踪功能，登陆验证
end

20150605114421_devise_create_users

class DeviseCreateUsers < ActiveRecord::Migration
  def change
    create_table(:users) do |t|　　　　#建立user表
      ## Database authenticatable
      t.string :email,              null: false, default: ""　　　　#邮件不能为空，默认为“”
      t.string :encrypted_password, null: false, default: ""　　　　#加密的密码不能为空，默认为“”

      ## Recoverable
      t.string   :reset_password_token　　　　　　　　　　　　　　　　#重置密码的令牌
      t.datetime :reset_password_sent_at　　　　　　　　　　　　　　 #重置的时间

      ## Rememberable
      t.datetime :remember_created_at　　　　　　　　　　　　　　　　　　#记忆令牌建立时间

      ## Trackable
      t.integer  :sign_in_count, default: 0, null: false　　　　　　　#登陆次数不能为空，默认为0
      t.datetime :current_sign_in_at　　　　　　　　　　　　　　　　　　#本次登陆时间
      t.datetime :last_sign_in_at　　　　　　　　　　　　　　　　　　　　#上次登陆时间
      t.string   :current_sign_in_ip　　　　　　　　　　　　　　　　　　#本次登陆IP
      t.string   :last_sign_in_ip　　　　　　　　　　　　　　　　　　　　#上次登陆IP

      ## Confirmable
       t.string   :confirmation_token　　　　　　　　　　　　#注册邮件令牌
       t.datetime :confirmed_at　　　　　　　　　　　　　　　　#注册时间
       t.datetime :confirmation_sent_at　　　　　　　　　　　　#收到邮件验证时间
       t.string   :unconfirmed_email # Only if using reconfirmable　　　　#未验证的邮件，只在再次确认时使用

      ## Lockable
      # t.integer  :failed_attempts, default: 0, null: false # Only if lock strategy is :failed_attempts
      # t.string   :unlock_token # Only if unlock strategy is :email or :both
      # t.datetime :locked_at

      t.timestamps null: false　　　　　　#时间戳
    end

    add_index :users, :email,                unique: true　　　　#邮件的索引
    add_index :users, :reset_password_token, unique: true　　　　#重置密码的索引
    add_index :users, :confirmation_token,   unique: true　　　　#邮件确认的令牌索引
    # add_index :users, :unlock_token,         unique: true
  end
end

建立数据库

bundel exec rake db:migrate
# bundle exec rake db:rollback　　撤销上面的命令
# bundle exec rake db:migrate VERSION=0  回到最初的版本

看看数据库里有什么，users表都建立好了，之后自动添加了id属性

再来看看路由里面有啥：

rake routes
                  Prefix Verb     URI Pattern                            Controller#Action
        new_user_session GET      /users/sign_in(.:format)               devise/sessions#new　　　　　　#获取登陆页面
            user_session POST     /users/sign_in(.:format)               devise/sessions#create　　　　#提交登陆页面
    destroy_user_session DELETE   /users/sign_out(.:format)              devise/sessions#destroy　　　　#退出登陆
 user_omniauth_authorize GET|POST /users/auth/:provider(.:format)        devise/omniauth_callbacks#passthru {:provider=>/(?!)/}　　　　#第三方验证验证
  user_omniauth_callback GET|POST /users/auth/:action/callback(.:format) devise/omniauth_callbacks#:action　　　　　　#第三方验证回调　　
           user_password POST     /users/password(.:format)              devise/passwords#create　　　　　　　　　　#提交密码
       new_user_password GET      /users/password/new(.:format)          devise/passwords#new　　　　　　　　　　　　#返回页面
      edit_user_password GET      /users/password/edit(.:format)         devise/passwords#edit　　　　　　　　　　　#获取修改密码
                         PATCH    /users/password(.:format)              devise/passwords#update　　　　　　　　　　#更新密码
                         PUT      /users/password(.:format)              devise/passwords#update　　　　　　　　　　#替换密码（区别请看http://www.web-tinker.com/article/20707.html）
cancel_user_registration GET      /users/cancel(.:format)                devise/registrations#cancel　　　　　　　　#取消注册
       user_registration POST     /users(.:format)                       devise/registrations#create　　　　　　　　#提交注册
   new_user_registration GET      /users/sign_up(.:format)               devise/registrations#new　　　　　　　　　　#获取注册
  edit_user_registration GET      /users/edit(.:format)                  devise/registrations#edit　　　　　　　　　　#获取编辑注册信息
                         PATCH    /users(.:format)                       devise/registrations#update　　　　　　　　#更新注册此信息
                         PUT      /users(.:format)                       devise/registrations#update　　　　　　　　#替换注册信息
                         DELETE   /users(.:format)                       devise/registrations#destroy　　　　　　　　#删除账户
       user_confirmation POST     /users/confirmation(.:format)          devise/confirmations#create　　　　　　　　#提交邮件验证
   new_user_confirmation GET      /users/confirmation/new(.:format)      devise/confirmations#new　　　　　　　　　　#创建邮件验证
                         GET      /users/confirmation(.:format)          devise/confirmations#show　　　　　　　　　#跳转页面
                    root GET      /                                      home#index　　　　　　　　　　　　　　　　　　#首页

创建home,help页面

rails  g controller index help #可以撤销此命令（rails destroy controller Home index help）

现在启动 rails application

rails s

添加首页内的代码

home/index.html.erb

<% provide(:title, "Home") %>
<h1>Age Home</h1>
<p>Age Time</p>

修改layouts/application.html.erb

<!DOCTYPE html>
<html>
<head>
<title><%= yield(:title) %> | Ruby on Rails Tutorial Sample App</title>
<%= stylesheet_link_tag  'application', media: 'all',
                                       'data-turbolinks-track' => true %>　　　　
<%= javascript_include_tag 'application', 'data-turbolinks-track' => true %>　　　　#引入应用的样式表和 JavaScript 文件，Asset Pipeline 的一部分
<%= csrf_meta_tags %>　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　#Rails 中的 csrf_meta_tags 方法,作用是避免“跨站请求伪造”
</head>
<body>
    <%= yield %>
</body>
</html>

添加helpers/application_helper.eb,rails会帮助我们把辅助方法的模块引入其他类中。

module ApplicationHelper
    def full_title(page_title = '')
        base_title = "Age"
        if page_title.empty?
            base_title
        else
            page_title + " | "+ base_title
        end
    end
end

添加测试技术

test/test_helper.rb
ENV['RAILS_ENV'] ||= 'test'
require File.expand_path('../../config/environment', __FILE__)
require 'rails/test_help'
require "minitest/reporters"           #利用minitest-reporters技术
Minitest::Reporters.use!　　　　　　　　#添加颜色显示
class ActiveSupport::TestCase
# Setup all fixtures in test/fixtures/*.yml for all tests in alphabetical
# order.
fixtures :all
# Add more helper methods to be used by all tests here...
end

调用跟踪静默程序

config/initializers/backtrace_silencers.rb
# Be sure to restart your server when you modify this file.
# You can add backtrace silencers for libraries that you're using but don't
# wish to see in your backtraces.
Rails.backtrace_cleaner.add_silencer { |line| line =~ /rvm/ }
# You can also remove all the silencers if you're trying to debug a problem
# that might stem from framework code.
# Rails.backtrace_cleaner.remove_silencers!

使用 rspec BDD测试

引用解释：

RSpec是一套Ruby的測試DSL(Domain-specific language)框架，它的程式比Test::Unit更好讀，寫的人更容易描述測試目的，可以說是一種可執行的規格文件。也 非常多的Ruby on Rails專案採用RSpec作為測試框架。它又稱為一種BDD(Behavior-driven development)測試框架，相較於TDD用test思維，測試程式的結果。BDD強調的是用spec思維，描述程式應該有什麼行為。

安装rspec

/Gemfile

group :test, :development do
  gem "rspec"
  gem "rspec-rails"
end

gem install rspec 
Fetching: rspec-support-3.2.2.gem (100%)
Successfully installed rspec-support-3.2.2
Fetching: rspec-core-3.2.3.gem (100%)
Successfully installed rspec-core-3.2.3
Fetching: rspec-expectations-3.2.1.gem (100%)
Successfully installed rspec-expectations-3.2.1
Fetching: rspec-mocks-3.2.1.gem (100%)
Successfully installed rspec-mocks-3.2.1
Fetching: rspec-3.2.0.gem (100%)
Successfully installed rspec-3.2.0
5 gems installed

$bundle install --binstubs #这会建立一个bin目录包含所有Gemfile里面用的执行档。

安装：

$rails generate rspec:install  #bin/rspec --init

现在测试装好了

添加背景图片

Rails 会使用 Asset Pipeline自动在 app/assets/images/文件夹中寻找图片。

随意打开一个网站选择图片，然后点击邮件，view page source

cd images
wget https://cdn.apstudynotes.org/images/hero/amjed.jpg

修改图片权限

cd ..
chmod -R  777  images

添加jquery-anystretch

mkdir js
cd js
wget https://raw.githubusercontent.com/danmillar/jquery-anystretch/master/jquery.anystretch.min.js

再去jquery.com/download 添加要用的方法

在head标签中添加
    <script src="http://code.jquery.com/jquery-1.11.3.min.js"></script>
    <script src="http://code.jquery.com/jquery-migrate-1.2.1.min.js"></script>
    <script src="js/jquery.anystretch.min.js"></script>

只有重定向使用 _url 形式,其余都使用 _path 形式。(因为 HTTP 标准严格要求重定向
的 URL 必须完整。不过在大多数浏览器中,两种形式都可以正常使用。