diff options
author | aamine <aamine@b2dd03c8-39d4-4d8f-98ff-823fe69b080e> | 2002-03-26 11:17:13 +0000 |
---|---|---|
committer | aamine <aamine@b2dd03c8-39d4-4d8f-98ff-823fe69b080e> | 2002-03-26 11:17:13 +0000 |
commit | 04168e7e3e4bc412c16c68f565b84dca5cdf93a7 (patch) | |
tree | 41be9a448a7a003ce68f27460bfd2d0b3ff0a3e4 | |
parent | ce0de3f67b573957d15e8945784a0d4413c32734 (diff) |
* doc/net/protocol.rd.ja, smtp.rd.ja, pop.rd.ja: removed.
* MANIFEST: remove doc/net/* entries.
git-svn-id: svn+ssh://ci.ruby-lang.org/ruby/trunk@2289 b2dd03c8-39d4-4d8f-98ff-823fe69b080e
-rw-r--r-- | ChangeLog | 6 | ||||
-rw-r--r-- | doc/net/http.rd.ja | 433 | ||||
-rw-r--r-- | doc/net/pop.rd.ja | 326 | ||||
-rw-r--r-- | doc/net/smtp.rd.ja | 194 |
4 files changed, 6 insertions, 953 deletions
@@ -1,3 +1,9 @@ +Tue Mar 26 20:25:28 2002 Minero Aoki <[email protected]> + + * doc/net/protocol.rd.ja, smtp.rd.ja, pop.rd.ja: removed. + + * MANIFEST: remove doc/net/* entries. + Tue Mar 26 18:45:15 2002 WATANABE Hirofumi <[email protected]> * configure.in (FILE_READPTR): check bufread instead of bufend diff --git a/doc/net/http.rd.ja b/doc/net/http.rd.ja deleted file mode 100644 index 1bdb898b80..0000000000 --- a/doc/net/http.rd.ja +++ /dev/null @@ -1,433 +0,0 @@ -=begin - -= net/http.rb - -== ���Υ饤�֥��ˤĤ��� - -���ѥǡ���ž���ץ��ȥ��� HTTP ���饤�֥��Ǥ��� -������ [RFC2616] ((<URL:http://www.ietf.org/rfc/rfc2616.txt>)) �� -�𤤤Ƥ��ޤ��� - -== ������ - -=== �����֥����Ф���ɥ�����Ȥ����� (GET) - - require 'net/http' - Net::HTTP.start( 'some.www.server', 80 ) {|http| - response , = http.get('/index.html') - puts response.body - } - -�ޤ��ʲ���Ʊ����̣��û������ΤǤ��� - - require 'net/http' - Net::HTTP.get_print 'some.www.server', '/index.html' - -=== �ե�����ξ������������ (POST) - - require 'net/http' - Net::HTTP.start( 'some.www.server', 80 ) {|http| - response , = http.post( '/cgi-bin/any.rhtml', - 'querytype=subject&target=ruby' ) - } - -=== �ץ�������ͳ�Υ������� - -Net::HTTP �Υ��饹��å� Net::HTTP.Proxy �ϡ���˥ץ�������ͳ�� -��³����褦��ư��롢���������饹����������֤��ޤ������Υ��饹�� -Net::HTTP ��Ѿ����Ƥ���Τ� Net::HTTP ������Ʊ���褦�˻Ȥ��ޤ��� - - require 'net/http' - - $proxy_addr = 'your.proxy.addr' - $proxy_port = 8080 - : - Net::HTTP::Proxy($proxy_addr, $proxy_port).start( 'some.www.server' ) {|http| - # always connect to your.proxy.addr:8080 - : - } - -�ޤ� Net::HTTP.Proxy ���������� nil ���� Net::HTTP ���Ȥ��֤��Τ� -��Υ����ɤΤ褦�˽Ƥ����Хץ������ʤ��ξ��ˤ��б��Ǥ��ޤ��� - -=== ������쥯�Ȥ��б����� - - require 'net/http' - Net::HTTP.version_1_1 - - host = 'www.ruby-lang.org' - path = '/' - begin - Net::HTTP.start( host, 80 ) {|http| - response , = http.get(path) - print response.body - } - rescue Net::ProtoRetriableError => err - if m = %r<http://([^/]+)>.match( err.response['location'] ) then - host = m[1].strip - path = m.post_match - retry - end - end - -������Ǥ� URL ����ۥ���̾������Τˤ������������ˡ��ȤäƤ��ޤ����� -���� URI ���饹��ɸ��ź�դˤʤ�Ф�äȴ�ñ�ˤʤ�Ϥ��Ǥ��� - -=== Basic ǧ�� - - require 'net/http' - - Net::HTTP.start( 'auth.some.domain' ) {|http| - response , = http.get( '/need-auth.cgi', - 'Authorization' => 'Basic ' + ["#{account}:#{password}"].pack('m').strip ) - print response.body - } - -�С������ 1.2 (Ruby 1.7 �ʹߤ�ź��) �Ǥϼ��Τ褦�˽ޤ��� - - require 'net/http' - - req = Net::HTTP::Get.new('/need-auth.cgi') - req.basic_auth 'account', 'password' - Net::HTTP.start( 'auth.some.domain' ) {|http| - response = http.request(req) - print response.body - } - -== ���������ͤؤ��ѹ��Ȱܹ����֤ˤĤ��� - -Ruby 1.6 �����äƤ���Τ� http.rb 1.1 �� 1.7 �ʹߤ� 1.2 �Ǥ����� -���δ֤ǤϤ��ʤ��礭�����ͤ��Ѥ��ޤ��������������˻��ͤ��ѹ� -����ΤǤʤ���ξ���μ�������¸������������ߤ��뤳�Ȥˤ��ޤ����� - -��å� HTTP.version_1_2��HTTP.version_1_1 ��Ƥ֤� -���Τ��Ȥ���������� Net::HTTP ���֥������ȤϤ��줾��� -�С������λ��ͤ�ư���褦�ˤʤ�ޤ����ʲ��ϻ�����Ǥ��� - - # example - Net::HTTP.start {|http1| ...(http1 has 1.2 features)... } - - Net::HTTP.version_1_1 - Net::HTTP.start {|http2| ...(http2 has 1.1 features)... } - - Net::HTTP.version_1_2 - Net::HTTP.start {|http3| ...(http3 has 1.2 features)... } - -���ε�ǽ�ϥ���åɥ����դǤϤ���ޤ��� - -== class Net::HTTP - -=== ���饹��å� - -: new( address, port = 80, proxy_addr = nil, proxy_port = nil ) - ������ HTTP ���֥������Ȥ��������ޤ���address �� HTTP �����С��� FQDN �ǡ� - port ����³����ݡ����ֹ�Ǥ������Υ�åɤǤϤޤ���³�Ϥ��ޤ��� - - proxy_addr ��Ϳ����ȥץ�������𤷤���³���륪�֥������Ȥ��������ޤ��� - -: start( address, port = 80, proxy_addr = nil, proxy_port = nil ) -: start( address, port = 80, proxy_addr = nil, proxy_port = nil ) {|http| .... } - �ʲ���Ʊ���Ǥ��� - - Net::HTTP.new(address, port, proxy_addr, proxy_port).start(&block) - -: get( address, path, port = 80 ) - �ۥ��� address �� port �֥ݡ��Ȥ���³���� path ��ɽ������ - ����ƥ��ƥ��������ʸ������֤��ޤ��� - -: get_print( address, path, port = 80 ) - �ۥ��� address �� port �֥ݡ��Ȥ���³���� path ��ɽ������ - ����ƥ��ƥ����������������$stdout �� << �ǽ��Ϥ��ޤ��� - -: Proxy( address, port = 80 ) - ��˻��ꤵ�줿�ץ���������³���륯�饹��������֤��ޤ��� - ���Υ��饹�� Net::HTTP ��Ѿ����Ƥ���Τ� Net::HTTP ������ - Ʊ���褦�˻Ȥ��ޤ��� - - address �� nil �ΤȤ��� Net::HTTP ���饹�Τޤ��֤��ޤ��� - - # example - proxy_class = Net::HTTP::Proxy( 'proxy.foo.org', 8080 ) - : - proxy_class.start( 'www.ruby-lang.org' ) {|http| - # connecting proxy.foo.org:8080 - : - } - -: proxy_class? - ���Ȥ� (Proxy ��åɤˤ�äƺ������줿) �ץ������ѤΥ��饹�ʤ�п��� - -: port - HTTP �Υǥե���ȥݡ��� (80)�� - -=== ��å� - -: start -: start {|http| .... } - TCP ���ͥ�������ĥ�ꡢHTTP ���å����Ϥ��ޤ��� - ���Ǥ˥��å�����Ϥ��Ƥ������㳰 IOError ��ȯ�����ޤ��� - - ���ƥ졼���Ȥ��ƸƤФ줿���ϥ֥��å��δ֤������å�������³���� - �֥��å���λ�ȤȤ�˼�ưŪ�˥��å������Ĥ��ޤ��� - -: active? - HTTP ���å�����Ϥ���Ƥ����鿿�� - -: address - ��³���륢�ɥ쥹 - -: port - ��³����ݡ����ֹ� - -: open_timeout -: open_timeout=(n) - ��³�����Ԥĺ����ÿ��������ÿ����äƤ⥳�ͥ������ - �����ʤ�����㳰 TimeoutError ��ȯ�����ޤ��� - -: read_timeout -: read_timeout=(n) - �ɤߤ��� (read(1) ���) �ǥ֥��å����Ƥ褤�����ÿ��� - �����ÿ����äƤ��ɤߤ���ʤ�����㳰 TimeoutError ��ȯ�����ޤ��� - -: finish - HTTP ���å�����λ���ޤ������å�������ˤ��Υ�åɤ� - �ƤФ줿�����㳰 IOError ��ȯ�����ޤ��� - -: proxy? - �ץ�������𤷤���³����ʤ鿿�� - -: proxy_address - �ץ�������ͳ����³���� HTTP ���֥������Ȥʤ�ץ������Υ��ɥ쥹�� - �����Ǥʤ��ʤ� nil�� - -: proxy_port - �ץ�������ͳ����³���� HTTP ���֥������Ȥʤ�ץ������Υݡ��ȡ� - �����Ǥʤ��ʤ� nil�� - -: get( path, header = nil ) -: get( path, header = nil ) {|str| .... } - �����о�� path �ˤ��륨��ƥ��ƥ���������ޤ����ޤ� header �� nil - �Ǥʤ���С��ꥯ�����Ȥ�����Ȥ��ˤ������Ƥ� HTTP �إå��Ȥ��ƽ� - ���ߤޤ���header �ϥϥå���ǡ��֥إå�̾ => ���ơפΤ褦�ʷ����� - �ʤ���Ф����ޤ��� - - �֤��ͤϡ��С������ 1.1 �Ǥ� HTTPResponse �ȥ���ƥ��ƥ��ܥǥ�ʸ����� - �����Ǥ�����Ǥ���1.2 �Ǥ� HTTPResponse �����ҤȤĤΤߤǤ������ξ�硢 - ����ƥ��ƥ��ܥǥ��� response.body �������ޤ��� - - �֥��å��ȤȤ�˸ƤФ줿���ϥ���ƥ��ƥ��ܥǥ����Ťĥ֥��å��� - Ϳ���ޤ��� - - 1.1 �Ǥ� 3xx (�ƻ�Բ�ǽ�ʥ��顼)���Ф��Ƥ��㳰��ȯ�����ޤ������ξ�� - HTTPResponse ���㳰���֥������Ȥ��� err.response �����뤳�Ȥ��Ǥ��ޤ��� - ���� 1.2 �Ǥ������㳰��ȯ�����ޤ��� - - # version 1.1 (bundled with Ruby 1.6) - response, body = http.get( '/index.html' ) - - # version 1.2 (bundled with Ruby 1.7 or later) - response = http.get( '/index.html' ) - - # compatible in both version - response , = http.get( '/index.html' ) - response.body - - # using block - File.open( 'save.txt', 'w' ) {|f| - http.get( '/~foo/', nil ) do |str| - f.write str - end - } - -: head( path, header = nil ) - �����о�� path �ˤ��륨��ƥ��ƥ��Υإå��Τߤ�������ޤ��� - �ޤ� header �� nil �Ǥʤ���Хꥯ�����Ȥ�����Ȥ��ˤ������Ƥ� - HTTP �إå��Ȥ��ƽ��ߤޤ���header �ϥϥå���ǡ� - �֥إå�̾ => ���ơפΤ褦�ʷ����Ǥʤ���Ф����ޤ��� - - HTTPResponse ���֥������Ȥ��֤��ޤ��� - - 1.1 �Ǥ� 3xx (�ƻ�Բ�ǽ�ʥ��顼)���Ф��Ƥ��㳰��ȯ�����ޤ������ξ�� - HTTPResponse ���㳰���֥������Ȥ��� err.response �����뤳�Ȥ��Ǥ��ޤ��� - ���� 1.2 �Ǥ������㳰��ȯ�����ޤ��� - - response = nil - Net::HTTP.start( 'some.www.server', 80 ) {|http| - response = http.head( '/index.html' ) - } - p response['content-type'] - -: post( path, data, header = nil ) -: post( path, data, header = nil ) {|str| .... } - �����о�� path �ˤ��륨��ƥ��ƥ����Ф�ʸ���� data �� - ����ޤ����쥹�ݥ� << ��åɤ�Ȥä� dest �˽� - ���ޤ�ޤ���header �� get ��åɤ�Ʊ���Ǥ��� - HTTPResponse ���֥������Ȥ� dest ��������֤��ޤ��� - - ���ƥ졼���Ȥ��ƸƤӤ����줿�Ȥ��ϥ���ƥ��ƥ��ܥǥ����Ť� - �֥��å���Ϳ���ޤ��� - - 1.1 �Ǥ� 3xx (�ƻ�Բ�ǽ�ʥ��顼)���Ф��Ƥ��㳰��ȯ�����ޤ������ξ�� - HTTPResponse ���㳰���֥������Ȥ��� err.response �����뤳�Ȥ��Ǥ��ޤ��� - ���� 1.2 �Ǥ������㳰��ȯ�����ޤ��� - - # version 1.1 - response, body = http.post( '/cgi-bin/search.rb', 'query=subject&target=ruby' ) - - # version 1.2 - response = http.post( '/cgi-bin/search.rb', 'query=subject&target=ruby' ) - - # compatible in both version - response , = http.post( '/cgi-bin/search.rb', 'query=subject&target=ruby' ) - - # using block - File.open( 'save.html', 'w' ) {|f| - http.post( '/cgi-bin/search.rb', - 'query=subject&target=ruby' ) do |str| - f.write str - end - } - -: request_get( path, header = nil ) -: request_get( path, header = nil ) {|response| .... } - path �ˤ��륨��ƥ��ƥ���������ޤ���HTTPResponse - ���֥������Ȥ��֤��ޤ��� - - �֥��å��ȤȤ�˸ƤӽФ��줿�Ȥ��ϡ��֥��å��¹������³�� - �ݻ������ޤ� HTTPResponse ���֥������Ȥ�֥��å����Ϥ��ޤ��� - - ���Υ�åɤ� HTTP �ץ��ȥ���˴�Ϣ�����㳰��ȯ�������ޤ��� - - # example - response = http.request_get( '/index.html' ) - p response['content-type'] - puts response.body # body is already read - - # using block - http.request_get( '/index.html' ) {|response| - p response['content-type'] - response.read_body do |str| # read body now - print str - end - } - -: request_post( path, data, header = nil ) -: request_post( path, data, header = nil ) {|response| .... } - path �ˤ��륨��ƥ��ƥ���������ޤ���HTTPResponse - ���֥������Ȥ��֤��ޤ��� - - �֥��å��ȤȤ�˸ƤӽФ��줿�Ȥ��ϡ��ܥǥ����ɤߤ������� - HTTPResponse ���֥������Ȥ�֥��å����Ϥ��ޤ��� - - ���Υ�åɤ� HTTP �ץ��ȥ���˴�Ϣ�����㳰��ȯ�������ޤ��� - - # example - response = http.post2( '/cgi-bin/nice.rb', 'datadatadata...' ) - p response.status - puts response.body # body is already read - - # using block - http.post2( '/cgi-bin/nice.rb', 'datadatadata...' ) {|response| - p response.status - p response['content-type'] - response.read_body do |str| # read body now - print str - end - } - -: request( request [, data] ) -: request( request [, data] ) {|response| .... } - HTTPResquest ���֥������� request ���������ޤ���POST/PUT �λ��� data �� - Ϳ�����ޤ� (POST/PUT �ʳ��� data ��Ϳ����� ArgumentError ��ȯ�����ޤ�)�� - - �֥��å��ȤȤ�˸ƤӤ����줿�Ȥ��ϥܥǥ����ɤߤ��ޤ��� HTTPResponse - ���֥������Ȥ�֥��å���Ϳ���ޤ��� - - ���Υ�åɤ� HTTP �ץ��ȥ���˴�Ϣ�����㳰��ȯ�������ޤ��� - -== class Net::HTTP::Get, Head, Post - -HTTP �ꥯ�����Ȥ���ݲ����륯�饹��key �Ϥ��٤���ʸ����ʸ���� -���̤��ޤ��� - -=== ���饹��å� - -: new - HTTP �ꥯ�����ȥ��֥������Ȥ��������ޤ��� - -=== ��å� - -: self[ key ] - key �إå��ե�����ɤ�ʸ���� - key ����ʸ����ʸ������̤��ޤ��� - -: self[ key ] = val - key �إå��ե�����ɤ� val �åȤ��ޤ��� - key ����ʸ����ʸ������̤��ޤ��� - -: each {|name, val| .... } - �إå�̾�Ȥ����ͤ��Ф��뤯�꤫�������إå�̾�Ͼ�ʸ�������줵��ޤ��� - -: basic_auth( account, password ) - Authrization: �إå��� basic auth �Ѥ˥��åȤ��ޤ��� - -: range - Range: �إå��μ����ϰϤ� Range ���֥������Ȥ��֤��ޤ��� - -: range = r -: set_range( i, len ) - �ϰϤ���ꤷ�ƥ���ƥ��ƥ���������뤿��Υإå� Range: �åȤ��ޤ��� - r �� Range ���֥������ȡ�i, len �ϻ�����Ĺ���Ǥ��� - -: content_length - Content-Length: �إå����� (����)�� - -: content_range - Content-Range: �إå����� (Range)�� - -== class Net::HTTPResponse - -HTTP �쥹�ݥΥ��饹�Ǥ��� -�������إå��ե������̾�Ǥ����硢��ʸ����ʸ������̤��ޤ��� - -=== ��å� - -: self[ key ] - key �إå��ե������(ʸ����)�Ǥ������Ȥ��Х��� 'content-length' - ���Ф��Ƥ� '2048' �Τ褦��ʸ���������ޤ��� - key ����ʸ����ʸ������̤��ޤ��� - -: self[ key ] = val - key �إå��ե�����ɤ� value �����ꤷ�ޤ��� - key ����ʸ����ʸ������̤��ޤ��� - -: key?( key ) - key �Ȥ����إå��ե�����ɤ�����п��� - key ����ʸ����ʸ������̤��ޤ��� - -: each {|name,value| .... } - ���٤ƤΥإå��ե������̾�Ȥ����ͤΥڥ����Ф��뤯�꤫������ - -: canonical_each {|name,value| .... } - �إå��ե�����ɤ�����̾�Ȥ����ͤΥڥ����Ф��Ʒ����֤��ޤ��� - -: code - HTTP �Υꥶ��ȥ����ɤǤ����㤨�� '302' �ʤɤǤ��� - -: message - HTTP �����Ф��ꥶ��ȥ����ɤ��ղä����֤���å������Ǥ��� - �㤨�� 'Not Found' �ʤɤǤ��� - -: read_body( dest = '' ) - ����ƥ��ƥ��ܥǥ�������� dest �� << ��åɤ�Ȥäƽ��ߤޤ��� - Ʊ�� HTTPResponse ���֥������Ȥ��Ф������ʾ�ƤФ줿��硢 - ����ܤ���Ϥʤˤ⤻���˰���ܤ��֤��ͤΤޤ��֤��ޤ��� - -: read_body {|str| .... } - ����ƥ��ƥ��ܥǥ����Ťļ������ƽ缡�֥��å���Ϳ���ޤ��� - -: body - ����ƥ��ƥ��ܥǥ��Ǥ���read_body ��Ƥ�Ǥ���Ф��ΰ��� dest�� - �Ƥ�Ǥ��ʤ���Х���ƥ��ƥ��ܥǥ���ʸ����Ȥ����ɤߤ�����֤��ޤ��� - -=end diff --git a/doc/net/pop.rd.ja b/doc/net/pop.rd.ja deleted file mode 100644 index 2c7e22f29f..0000000000 --- a/doc/net/pop.rd.ja +++ /dev/null @@ -1,326 +0,0 @@ -=begin - -= net/pop.rb - -== ���Υ饤�֥��ˤĤ��� - -����������뤿��Υץ��ȥ��� POP3 (Post Office Protocol version 3) �� -���饤�֥��Ǥ���POP3 �μ����� [RFC1939] -((<URL:http://www.ietf.org/rfc/rfc1939.txt>)) �˴𤤤Ƥ��ޤ��� - -== ������ - -=== ���μ��� - -�ʲ��Υ����ɤϡ�����������ƥե����� 'inbox/1' 'inbox/2'... �� -���ߡ������о夫�����ä��ޤ���pop3.server.address ��Ŭ�� -�ɤߤ����Ƥ��������� - - require 'net/pop' - - pop = Net::POP3.new( 'pop3.server.address', 110 ) - pop.start( 'YourAccount', 'YourPassword' ) ### - if pop.mails.empty? then - puts 'no mail.' - else - i = 0 - pop.each_mail do |m| # or "pop.mails.each ..." - File.open( 'inbox/' + i.to_s, 'w' ) {|f| - f.write m.pop - } - m.delete - i += 1 - end - puts "#{pop.mails.size} mails popped." - end - pop.finish ### - -POP �����Фϥͥåȥ���Τळ����¸�ߤ���Τǡ��ʤˤ��Ż����� -�ˤϤ������˳��ϼ�³������ä��齪λ��³���Ԥ�ʤ���Ф��� -�ޤ������Ԥ��Τ� Net::POP3#start �� #finish �ǡ�POP3 ���֥������� -�Ϥ�����ĤΥ�åɤδ֤Ǥ���ͭ���ˤʤ�ޤ��� - -�����о�Υ��� POPMail ���֥������ȤȤ���ɽ������Ƥ��ꡢ���� -���֥������ȤΥ�åɤ�Ƥ֤��Ȥǥ����äƤ�����ä����ꤹ�� -���Ȥ��Ǥ��ޤ���POP3#mails �Ϥ��� POPMail ���֥������Ȥ�����Ǥ��ꡢ -POP3#each_mail �Ϥ���� mails.each �Υ��硼�ȥ��åȤǤ��� - -=== û������ - -�����Ϥ����ƾ�ά��û���ѥ�åɤ�������ˤ��ʤ��Ĺ�Ǥ��� -�ޤ����֥��å��դ��� Net::POP3.start ��Ȥ����Ȥ� POP3.new #start -#finish ��ʻ��Ǥ��ޤ��� - - require 'net/pop' - - Net::POP3.start( 'pop3.server.address', 110 ) - 'YourAccount', 'YourPassword' ) - if pop.mails.empty? then - puts 'no mail.' - else - i = 0 - pop.each_mail do |m| # or "pop.mails.each ..." - File.open( 'inbox/' + i.to_s, 'w' ) {|f| - f.write m.pop - } - m.delete - i += 1 - end - puts "#{pop.mails.size} mails popped." - end - } - -POP3#delete_all ��Ȥ��Ȥ���� #each_mail �� m.delete �� -ʻ��Ǥ��ޤ��� - - require 'net/pop' - - Net::POP3.start( 'pop3.server.address', 110, - 'YourAccount', 'YourPassword' ) {|pop| - if pop.mails.empty? then - puts 'no mail.' - else - i = 0 - pop.delete_all do |m| - File.open( 'inbox/' + i.to_s, 'w' ) {|f| - f.write m.pop - } - i += 1 - end - end - } - -���饹��åɤ� POP3.delete_all ��Ȥ��Ȥ����û���ʤ�ޤ��� - - require 'net/pop' - - i = 0 - Net::POP3.delete_all( 'pop3.server.address', 110, - 'YourAccount', 'YourPassword' ) do |m| - File.open( 'inbox/' + i.to_s, 'w' ) {|f| - f.write m.pop - } - i += 1 - end - -=== �ե������ľ�ܽ� - -����ޤǤ���Ǥ� m.pop ����ʬ�ǥ���ҤȤĤ�ʸ����Ȥ��� -�����ȤäƤ��ޤ����������Ȥ��� 3MB ���餤�������ʥ��ξ��� -����ǤϤޤ�����礬����ޤ������Τ褦�ʾ��ϰʲ��Τ褦�� m.pop -�� File ���֥������Ȥ�Ϳ����꤬�Ȥ��ޤ��� - - require 'net/pop' - Net::POP3.delete_all( 'pop3.server.address', 110, - 'YourAccount', 'YourPassword' ) do |m| - File.open( 'inbox', 'w' ) {|f| - m.pop f #### - } - end - -=== APOP - -Net::POP3 ���饹�Τ����� Net::APOP ���饹��Ȥ��ȡ�ǧ�ڻ��� APOP �� -�Ȥ��褦�ˤʤ�ޤ����ޤ�ưŪ�˥Ρ��ޥ� POP �� APOP ������ˤϡ� -�ʲ��Τ褦�� Net::POP3.APOP() ��åɤ�Ȥ��Τ������Ǥ��� - - require 'net/pop' - - # use APOP authentication if $isapop == true - pop = Net::POP3.APOP($isapop).new( 'apop.server.address', 110 ) - pop.start( YourAccount', 'YourPassword' ) {|pop| - # Rest code is same. - } - -������ˡ�ϥ��饹���Τ��Ѥ���Τǡ����饹��åɤ� start �� foreach�� -delete_all��auth_only �ʤɤ� APOP �ȤȤ�˻Ȥ��ޤ��� - -== Net::POP3 class - -=== ���饹��å� - -: new( address, port = 110, apop = false ) - Net::POP3 ���֥������Ȥ��������ޤ����ޤ���³�Ϥ��ޤ��� - apop �����ΤȤ��� APOP ǧ�ڤ�Ԥ����֥������Ȥ��������ޤ��� - -: start( address, port = 110, account, password ) -: start( address, port = 110, account, password ) {|pop| .... } - address �� port �֥ݡ��Ȥ���³������������� account �ѥ���� - password �� POP �������ޤ���������� port �� nil ���Ϥ��� - POP3 �Υǥե���ȥݡ���(110)��Ȥ��ޤ��� - - Net::POP3.start( addr, port, account, password ) {|pop| - pop.each_mail do |m| - file.write m.pop - m.delete - end - } - -: APOP( is_apop ) - bool �����ʤ� Net::APOP ���饹�����ʤ� Net::POP3 ���饹���֤��ޤ��� - �ʲ�����Τ褦�˻ȤäƤ��������� - - # example 1 - pop = Net::POP3::APOP($isapop).new( addr, port ) - - # example 2 - Net::POP3::APOP($isapop).start( addr, port ) {|pop| - .... - } - -: foreach( address, port = 110, account, password ) {|mail| .... } - POP ���å������������о�Τ��٤ƤΥ����Ф��Ʒ����֤��ޤ��� - �ʲ���Ʊ���Ǥ��� - - Net::POP3.start( address, port, account, password ) {|pop| - pop.each_mail do |m| - yield m - end - } - - # example - Net::POP3.foreach( 'your.pop.server', 110, - 'YourAccount', 'YourPassword' ) do |m| - file.write m.pop - m.delete if $DELETE - end - -: delete_all( address, port = 110, account, password ) -: delete_all( address, port = 110, account, password ) {|mail| .... } - POP ���å������������о�Υ��٤ƺ�����ޤ��� - �֥��å���Ϳ����줿���Ϻ���������˥֥��å��ˤ��Υ��� - �Ϥ��ޤ����ʲ���Ʊ���Ǥ��� - - # example - Net::POP3.delete_all( addr, nil, 'YourAccount', 'YourPassword' ) do |m| - m.pop file - end - -: auth_only( address, port = 110, account, password ) - POP ���å�����ǧ�ڤ�����Ԥä���³���ڤ�ޤ��� - POP before SMTP ���ѤǤ��� - - # example - Net::POP3.auth_only( 'your.pop3.server', - nil, # using default (110) - 'YourAccount', - 'YourPassword' ) - -=== ��å� - -: start( account, password ) -: start( account, password ) {|pop| .... } - ��⡼�ȥۥ��ȤȤ���³�Ϥ�����������Ȥ� account�� - �ѥ���ɤ� password ��Ȥä� POP �������ޤ��� - -: active? - POP3 ���å�����Ϥ���Ƥ����鿿�� - -: address - ��³���륢�ɥ쥹 - -: port - ��³����ݡ����ֹ� - -: open_timeout -: open_timeout=(n) - ��³�����Ԥĺ����ÿ��������ÿ����äƤ⥳�ͥ������ - �����ʤ�����㳰 TimeoutError ��ȯ�����ޤ��� - -: read_timeout -: read_timeout=(n) - �ɤߤ��� (read(1) ���) �ǥ֥��å����Ƥ褤�����ÿ��� - �����ÿ����äƤ��ɤߤ���ʤ�����㳰 TimeoutError ��ȯ�����ޤ��� - -: finish - POP3 ���å�����λ���ޤ������å�������ˤ��Υ�åɤ� - �ƤФ줿�����㳰 IOError ��ȯ�����ޤ��� - -: mails - Net::POPMail ���֥������Ȥ���������ޤ��� - ��������ϥ��å����Ϥ����Ȥ��˼�ưŪ�˹�������ޤ��� - -: each_mail {|popmail| .... } -: each {|popmail| .... } - pop3.mails.each ��Ʊ���Ǥ��� - -: delete_all -: delete_all {|popmail| .... } - �����о�Υ������ƾõ�ޤ��� - �֥��å���Ϳ����줿�Ȥ��Ͼõ�����ˤ��� POPMail ���֥������Ȥ� - �֥��å����Ϥ��ޤ��� - - # example - n = 1 - pop.delete_all do |m| - File.open("inbox/#{n}") {|f| f.write m.pop } - n += 1 - end - -: auth_only( account, password ) - POP ���å�����ǧ�ڤ�����Ԥä���³���ڤ�ޤ��� - POP before SMTP ���ѤǤ��� - # example - pop = Net::POP3.new( 'your.pop3.server' ) - pop.auth_only 'YourAccount', 'YourPassword' - -: reset - ���å�����ꥻ�åȤ��ޤ��� - ����Ū�ˤ� POPMail#delete �Ǿä�����뤬�������褷�ޤ��� - (POP3 �Ǥϥ���Ĥ��������褹����ˡ�Ϥ���ޤ���) - -== Net::APOP - -���Υ��饹�ǤϿ�������åɤ�Ƴ�����Ƥ��ޤ��� -ǧ�������� APOP ���Ѥ������Ǥ��� - -=== �����ѡ����饹 -Net::POP3 - -== Net::POPMail - -POP �����С���Υ����̤����Ū��ɽ�����륯�饹�� -���μ�����õ�Ȥ��ä����ץ��벽���ޤ��� - -=== ��å� - -: pop( dest = '' ) - ����������� dest �� << ��åɤ�Ȥäƽ��ߤޤ��� - dest ���֤��ޤ��� - - # example - allmails = nil - POP3.start( 'your.pop3.server', 110, - 'YourAccount, 'YourPassword' ) {|pop| - allmails = pop.mails.collect {|popmail| popmail.pop } - } - -: pop {|str| .... } - ����ʸ������Ť��ɤߤ��ߡ��缡�֥��å���Ϳ���ޤ��� - - # example - POP3.start( 'localhost', 110 ) {|pop3| - pop3.each_mail do |m| - m.pop do |str| - # do anything - end - end - } - -: header - �إå��������������ʸ������֤��ޤ��� - -: top( lines ) - ���إå��� lines �Ԥ֤����ʸ�������ʸ������֤��ޤ��� - -: delete - �����о夫����������ޤ��� - -: size - ���Υ����� (ñ�̤ϥХ���) �����ޤ��� - -: deleted? - ��뤬�����о�Ǿõ��Ƥ���Ȥ������õ�Ƥ��ޤä��� - POP3#reset ��Ȥ��ʳ������褹����ˡ�Ϥ���ޤ��� - -=end diff --git a/doc/net/smtp.rd.ja b/doc/net/smtp.rd.ja deleted file mode 100644 index cc87865dc7..0000000000 --- a/doc/net/smtp.rd.ja +++ /dev/null @@ -1,194 +0,0 @@ -=begin - -= net/smtp.rb - -== ���Υ饤�֥��ˤĤ��� - -�����������뤿��Υץ��ȥ��� SMTP (Simple Mail Transfer Protocol) -���饤�֥��Ǥ����إå��ʤɥ��Υǡ��������ȤϤǤ��ޤ��� -SMTP �μ����� [RFC2821] ((<URL:http://www.ietf.org/rfc/rfc2821.txt>)) -�˴𤤤Ƥ��ޤ��� - -== ������ - -=== �Ȥˤ����������� - -SMTP ��Ȥäƥ�������ˤϤޤ� SMTP.start �ǥ��å������ޤ��� -�������������ФΥ��ɥ쥹������������ݡ����ֹ�Ǥ��� -�֥��å���Ȥ��� File.open ��Ʊ���褦�˽�ü������ưŪ�ˤ�äƤ���� -�ΤǤ�������Ǥ��� - - require 'net/smtp' - Net::SMTP.start( 'your.smtp.server', 25 ) {|smtp| - # use smtp object only in this block - } - -your.smtp.server ��Ŭ�ڤ� SMTP �����ФΥ��ɥ쥹���ɤߤ����Ƥ��������� -�̾�� LAN �δ����Ԥ�ץ��Х����� SMTP �����Ф��Ѱդ��Ƥ���Ƥ���Ϥ��Ǥ��� - -���å���������餢�Ȥ� send_mail �ǥ���ή����������Ǥ��� - - require 'net/smtp' - - Net::SMTP.start( 'your.smtp.server', 25 ) {|smtp| - smtp.send_mail <<EndOfMail, '[email protected]', '[email protected]' - From: Your Name <[email protected]> - To: Dest Address <[email protected]> - Subject: test mail - Date: Sat, 23 Jun 2001 16:26:43 +0900 - Message-Id: <[email protected]> - - This is test mail. - EndOfMail - } - -=== ���å�����λ���� - -�������ä��� SMTP#finish ��Ƥ�ǥ��å�����λ���ʤ���Ф��� -�ޤ���File �Τ褦�� GC ���˾���� close ����뤳�Ȥ⤢��ޤ��� -���������ʤȤ����� finish ���ʤ������������ɤ���ݤ��ޤ����� -���٤Ƹ���Ǥ���finish ��ɬ���Ƥ�Ǥ��������� - -�ޤ��֥��å��դ��� SMTP.start/SMTP#start ��Ȥ��Ⱦ���� finish �� -�Ƥ�Ǥ����Τ������Ǥ�����ǽ�ʸ¤�֥��å��դ��� start ��Ȥ��Τ� -�褤�Ǥ��礦�� - - # using SMTP#finish - smtp = Net::SMTP.start( 'your.smtp.server', 25 ) - smtp.send_mail mail_string, 'from@address', 'to@address' - smtp.finish - - # using block form of SMTP.start - Net::SMTP.start( 'your.smtp.server', 25 ) {|smtp| - smtp.send_mail mail_string, 'from@address', 'to@address' - } - -=== ʸ����ʳ���������� - -�ҤȤľ����Ǥ�ʸ�����ƥ��(�ҥ��ɥ������)��Ȥä��������ޤ������� -each ��åɤ���ä����֥������Ȥ���ʤ�ʤ�Ǥ����뤳�Ȥ��Ǥ��ޤ��� -�ʲ��� File ���֥������Ȥ���ľ������������Ǥ��� - - require 'net/smtp' - Net::SMTP.start( 'your.smtp.server', 25 ) {|smtp| - File.open( 'Mail/draft/1' ) {|f| - smtp.send_mail f, '[email protected]', '[email protected]' - } - } - -=== HELO �ɥᥤ�� - -SMTP �Ǥϥ�������¦�Υۥ��Ȥ�̾�� (HELO �ɥᥤ��ȸƤ�) ���� -�����ΤǤ�����Net::SMTP �ǤϤȤꤢ���� localhost.localdomain �� -����̾�����������Ƥ��ޤ��������Ƥ��� SMTP �����ФϤ��� HELO �ɥᥤ�� -�ˤ��ǧ�ڤϤ��ޤ꿿���ܤ˹Ԥ�ʤ��Τ� (��ñ�˵�¤�Ǥ��뤫��Ǥ�) -����ˤʤ�ʤ����Ȥ�¿���ΤǤ������ޤ�˥�륻�å������ڤ��� -���Ȥ⤢��ޤ������������Ȥ��ϤȤꤢ���� HELO �ɥᥤ���Ϳ���Ƥߤ� -�����������������ʳ��λ��� HELO �ɥᥤ��Ϥ������Ϥ��Τ� -�٥��ȤǤ��� - -HELO �ɥᥤ��� SMTP.start/SMTP#start ���軰���� helo_domain �˻��� -���ޤ��� - - Net::SMTP.start( 'your.smtp.server', 25, - 'mail.from.domain' ) {|smtp| - -�褯���������륢�åץۥ��Ȥξ�硢HELO �ɥᥤ��ˤ� ISP �Υ�� -�����ФΥɥᥤ���ȤäƤ����Ф����Ƥ��̤�ޤ��� - -== class Net::SMTP - -=== ���饹��å� - -: new( address, port = 25 ) - ������ SMTP ���֥������Ȥ��������ޤ���address ��SMTP�����С���FQDN�ǡ� - port ����³����ݡ����ֹ�Ǥ��������������Υ�åɤǤϤޤ���³�Ϥ��ޤ��� - -: start( address, port = 25, helo_domain = 'localhost.localdomain', account = nil, password = nil, authtype = nil ) -: start( address, port = 25, helo_domain = 'localhost.localdomain', account = nil, password = nil, authtype = nil ) {|smtp| .... } - �ʲ���Ʊ���Ǥ��� - Net::SMTP.new(address,port).start(helo_domain,account,password,authtype) - - # example - Net::SMTP.start( 'your.smtp.server' ) { - smtp.send_mail mail_string, '[email protected]', '[email protected]' - } - -=== ��å� - -: start( helo_domain = <local host name>, account = nil, password = nil, authtype = nil ) -: start( helo_domain = <local host name>, account = nil, password = nil, authtype = nil ) {|smtp| .... } - TCP ���ͥ�������ĥ�ꡢƱ���� SMTP ���å����Ϥ��ޤ������ΤȤ��� - ������Υۥ��Ȥ� FQDN �� helo_domain �˻��ꤷ�ޤ��� - �⤷���Ǥ˥��å�����Ϥ��Ƥ����� IOError ��ȯ�����ޤ��� - - account �� password ��ξ����Ϳ����줿��硢AUTH ���ޥ�ɤˤ�ä� - ǧ�ڤ�Ԥ��ޤ���authtype �ϻ��Ѥ���ǧ�ڤΥ����פǡ�����ܥ� - �� :plain �� :cram_md5 ����ꤷ�ޤ��� - -: active? - SMTP ���å�����Ϥ���Ƥ����鿿�� - -: address - ��³���륢�ɥ쥹 - -: port - ��³����ݡ����ֹ� - -: open_timeout -: open_timeout=(n) - ��³�����Ԥĺ����ÿ��������ÿ����äƤ⥳�ͥ������ - �����ʤ�����㳰 TimeoutError ��ȯ�����ޤ��� - -: read_timeout -: read_timeout=(n) - �ɤߤ��� (read(1) ���) �ǥ֥��å����Ƥ褤�����ÿ��� - �����ÿ����äƤ��ɤߤ���ʤ�����㳰 TimeoutError ��ȯ�����ޤ��� - -: finish - SMTP ���å�����λ���ޤ������å�������ˤ��Υ�åɤ� - �ƤФ줿�����㳰 IOError ��ȯ�����ޤ��� - -: send_mail( mailsrc, from_addr, *to_addrs ) - mailsrc ����Ȥ����������ޤ���mailsrc �� each ���ƥ졼������� - ���֥������Ȥʤ�ʤ�Ǥ���ޤ��� (���Ȥ��� String �� File)�� - from_domain �������Υ�륢�ɥ쥹 ('...@...'�Τ������Τ��) �ǡ� - to_addrs �ˤ��������륢�ɥ쥹���¤٤ޤ��� - - # example - Net::SMTP.start( 'your.smtp.server' ) {|smtp| - smtp.send_mail mail_string, - '[email protected]', - } - -: ready( from_addr, *to_addrs ) {|adapter| .... } - �����ߤν����������ǡ�write ��åɤ���ĥ��֥������Ȥ� - �֥��å��ˤ������ޤ���from_addr ����������륢�ɥ쥹�� to_addrs �� - ����Υ��ܥå����Ǥ��� - - # example - Net::SMTP.start( 'your.smtp.server', 25 ) {|smtp| - smtp.ready( '[email protected]', '[email protected]' ) {|f| - f.puts 'From: [email protected]' - f.puts 'To: [email protected]' - f.puts 'Subject: test mail' - f.puts - f.puts 'This is test mail.' - } - } - -== ȯ�������㳰 - -���å������� (SMTP ��٥��) ���顼�������ä���硢 -�ʲ����㳰��ȯ�����ޤ��� -: Net::ProtoSyntaxError - SMTP ���ޥ�ɤι�ʸ�ߥ�(500����) -: Net::ProtoFatalError - ����Ū�ʥ��顼(550����) -: Net::ProtoUnknownError - ͽ�����ʤ����顼�������餯�Х� -: Net::ProtoServerBusy - ���Ū�ʥ��顼(420/450����) - -=end |