class URI::MailTo
RFC6068, das mailto-URL-Schema.
Constants
- COMPONENT
-
Ein
Arrayder verfügbaren Komponenten fürURI::MailTo. - DEFAULT_PORT
-
Ein Standardport von nil für
URI::MailTo.
Attribute
E-Mail-Header, die von der URL gesetzt werden, als Array von Arrays.
Öffentliche Klassenmethoden
Source
# File lib/uri/mailto.rb, line 85 def self.build(args) tmp = Util.make_components_hash(self, args) case tmp[:to] when Array tmp[:opaque] = tmp[:to].join(',') when String tmp[:opaque] = tmp[:to].dup else tmp[:opaque] = '' end if tmp[:headers] query = case tmp[:headers] when Array tmp[:headers].collect { |x| if x.kind_of?(Array) x[0] + '=' + x[1..-1].join else x.to_s end }.join('&') when Hash tmp[:headers].collect { |h,v| h + '=' + v }.join('&') else tmp[:headers].to_s end unless query.empty? tmp[:opaque] << '?' << query end end super(tmp) end
Beschreibung
Erstellt ein neues URI::MailTo-Objekt aus Komponenten mit Syntaxprüfung.
Komponenten können als Array oder Hash bereitgestellt werden. Wird ein Array verwendet, müssen die Komponenten als [to, headers] angegeben werden.
Wird ein Hash verwendet, sind die Schlüssel die Komponentennamen, denen ein Doppelpunkt vorangestellt ist.
Die Header können als vor-codierter String, z. B. "subject=subscribe&cc=address", oder als Array von Arrays wie [['subject', 'subscribe'], ['cc', 'address']] bereitgestellt werden.
Beispiele
require 'uri' m1 = URI::MailTo.build(['joe@example.com', 'subject=Ruby']) m1.to_s # => "mailto:joe@example.com?subject=Ruby" m2 = URI::MailTo.build(['john@example.com', [['Subject', 'Ruby'], ['Cc', 'jack@example.com']]]) m2.to_s # => "mailto:john@example.com?Subject=Ruby&Cc=jack@example.com" m3 = URI::MailTo.build({:to => 'listman@example.com', :headers => [['subject', 'subscribe']]}) m3.to_s # => "mailto:listman@example.com?subject=subscribe"
URI::Generic::build auf.Source
# File lib/uri/mailto.rb, line 132 def initialize(*arg) super(*arg) @to = nil @headers = [] # The RFC3986 parser does not normally populate opaque @opaque = "?#{@query}" if @query && !@opaque unless @opaque raise InvalidComponentError, "missing opaque part for mailto URL" end to, header = @opaque.split('?', 2) # allow semicolon as a addr-spec separator # http://support.microsoft.com/kb/820868 unless /\A(?:[^@,;]+@[^@,;]+(?:\z|[,;]))*\z/ =~ to raise InvalidComponentError, "unrecognised opaque part for mailtoURL: #{@opaque}" end if arg[10] # arg_check self.to = to self.headers = header else set_to(to) set_headers(header) end end
Beschreibung
Erstellt ein neues URI::MailTo-Objekt aus generischen URL-Komponenten ohne Syntaxprüfung.
Diese Methode wird normalerweise von URI::parse aufgerufen, das die Gültigkeit jeder Komponente prüft.
URI::Generic::new auf.Öffentliche Instanzmethoden
Source
# File lib/uri/mailto.rb, line 232 def headers=(v) check_headers(v) set_headers(v) v end
Setter für Header v.
Source
# File lib/uri/mailto.rb, line 200 def to=(v) check_to(v) set_to(v) v end
Setter für to v.
Source
# File lib/uri/mailto.rb, line 268 def to_mailtext to = URI.decode_www_form_component(@to) head = '' body = '' @headers.each do |x| case x[0] when 'body' body = URI.decode_www_form_component(x[1]) when 'to' to << ', ' + URI.decode_www_form_component(x[1]) else head << URI.decode_www_form_component(x[0]).capitalize + ': ' + URI.decode_www_form_component(x[1]) + "\n" end end "To: #{to} #{head} #{body} " end
Gibt den RFC822-E-Mail-Textäquivalent der URL als String zurück.
Beispiel
require 'uri' uri = URI.parse("mailto:ruby-list@ruby-lang.org?Subject=subscribe&cc=myaddr") uri.to_mailtext # => "To: ruby-list@ruby-lang.org\nSubject: subscribe\nCc: myaddr\n\n\n"
Geschützte Instanzmethoden
Source
# File lib/uri/mailto.rb, line 221 def set_headers(v) @headers = [] if v v.split('&').each do |x| @headers << x.split(/=/, 2) end end end
Privater Setter für Header v.
Source
# File lib/uri/mailto.rb, line 194 def set_to(v) @to = v end
Privater Setter für to v.
Private Instanzmethoden
Source
# File lib/uri/mailto.rb, line 208 def check_headers(v) return true unless v return true if v.size == 0 if HEADER_REGEXP !~ v raise InvalidComponentError, "bad component(expected opaque component): #{v}" end true end
Prüft die Header-Komponente v gegen entweder
-
HEADER_REGEXP
Source
# File lib/uri/mailto.rb, line 169 def check_to(v) return true unless v return true if v.size == 0 v.split(/[,;]/).each do |addr| # check url safety as path-rootless if /\A(?:%\h\h|[!$&-.0-;=@-Z_a-z~])*\z/ !~ addr raise InvalidComponentError, "an address in 'to' is invalid as URI #{addr.dump}" end # check addr-spec # don't s/\+/ /g addr.gsub!(/%\h\h/, URI::TBLDECWWWCOMP_) if EMAIL_REGEXP !~ addr raise InvalidComponentError, "an address in 'to' is invalid as uri-escaped addr-spec #{addr.dump}" end end true end
Prüft die to-Komponente v.