rails笔记 actionmailer

actionmailer

rails 内置提供了发送邮件的方法即actionmailer , 在内部使用TMail的api,同时提供了对测试友好的功能,默认在test状态下面,rails不会真正发送mail,只会把mail附加到ActionMailer::Base.deliveries中,这样可以通过测试方法访问了

配置actionmailer

ActionMailer::Base.delivery_method = :smtp | :sendmail | :test

• :smtp 是直接使用smtp发送,具体配置如下

  ActionMailer::Base.server_settings = { :address => "domain.of.smtp.host.net", :port => 25, :domain => "domain.of.sender.net", :authentication => :login, :user_name => "dave", :password => "secret", }

  其中:authentication可以为:login,:plain,:cram_md5(目前不可用SSL),如果不需要登陆就省略这个参数 :domain为HELO使用的域名

• :sendmail 使用/usr/sbin下的sendmail程序(linux/unix)

• :test 就是附加到deliveries中

此外还有

ActionMailer::Base.perform_deliveries = true | false 配置是否真正发送mail ActionMailer::Base.raise_delivery_errors = true | false 发送失败是否抛出exception ActionMailer::Base.default_charset = "utf-8" 发送mail的默认编码

注意 现在的rails似乎都用config开头了, config.action_mailer.xxxx

使用mailer的流程如下

使用generator

ruby script/generate mailer XXXXMailer methoda methodb....

Mailer类会创建在app/models中,不同的method和controller类似,代表不同的邮件,也有不同的模板(和controller类比下来就是),还有不同的fixture和不同的test_方法

Mailer实例变量如下

• @bcc @cc @from @recipients 数组和string都可以 支持"Cap He hyz@jetic.org"这样的语法
• @charset header中的content-type表明的编码, 默认为default_charset的设置
• @send_on = time 设置header中的发送时间, 默认为当前时间
• @subject 邮件标题

@body 是一个hash, @body["xxx"]=...可以创建 rhtml中的 @xxx变量

rhtml模板

mailer的模板在app/views/xxx_mailer/下, 是rhtml文件(没有说不能用builder,但是email不需要builder xml) 用法和普通rhtml一样,不过在render(::partial=>"./line_item")这样类似的操作中需要用到"./"因为rails无法通过controller来推测模板位置

发送方法

两个静态方法deliver_..和create_..

使用XXXMailer.deliver_methoda(...) 直接发送 XXXMailer.create_methodb(..) 创建Tmail::Mail对象 通过它的encoded()得到email对象的内容,还可以再用XXXMailer.deliver(email)发送

默认是发送纯文本的邮件, 发送html的mail很简单 email.set_content_type("text/html") 即可

中文测试没有问题, 就是发送smtp要多调试, smtp不需要验证的时候千万不要使用:authentication :user_name :password 否则会出错

接收email

rails内置没有接受email的功能, 目前只能通过使用linux系统的shell来调用runner来完成

比如编写.procmailrc文件

测试mail

系统会默认生成好测试的类框架,

修改测试方法, 然后测试得到的mail对象即可

unit测试例子

class OrderMailerTest < Test::Unit::TestCase
    def setup
        @order = Order.new(:name =>"Dave Thomas", :email => "dave@pragprog.com")
    end
    def test_confirm
        response = OrderMailer.create_confirm(@order)
        assert_equal("Pragmatic Store Order Confirmation", response.subject)
        assert_equal("dave@pragprog.com", response.to[0])
        assert_match(/Dear Dave Thomas/, response.body)
    end
end

置于测试邮件是否发送到指定位子, 可以在controller的functional test中测试,因为mail类本身是仿造model的, 所以也有自己的fixture

转载于:https://www.cnblogs.com/baoz/archive/2006/01/24/2269863.html