=encoding utf8

=head1 NAME

=begin original

HTTP::WebTest::Cookies - Cookie storage and management

=end original

HTTP::WebTest::Cookies - Cookie の格納及び管理

=head1 SYNOPSIS

    use HTTP::WebTest::Cookies;

    $cookie_jar = HTTP::WebTest::Cookies->new;

    $cookie_jar->accept_cookies($bool);
    $cookie_jar->send_cookies($bool);

    $cookie_jar->add_cookie_header($request);
    $cookie_jar->extract_cookies($response);

=head1 DESCRIPTION

=begin original

Subclass of L<HTTP::Cookies|HTTP::Cookies> which enables optional
transmission and receipt of cookies.

=end original

クッキーの転送や受信を追加可能にした L<HTTP::Cookies|HTTP::Cookies> の
サブクラス.

=head1 METHODS

(メソッド)

=head2 accept_cookies($optional_accept_cookies)

=begin original

Returns the current setting of accept_cookies.
If optional boolean parameter C<$optional_accept_cookies> is passed,
enables or disables receipt of cookies.

=end original

現在の accept_cookies の設定を返します. 
任意の真偽値パラメータ C<$optional_accept_cookies> が渡されると
クッキーの受信を許可もしくは不許可にします.

=head3 Returns

(復帰値)

=begin original

True if receipt of cookies is enabled; false otherwise.

=end original

クッキーの受信が許可されていれば真, そうでなければ偽.

=head2 send_cookies($optional_send_cookies)

=begin original

Returns the current setting of send_cookies.
If optional boolean parameter C<$optional_send_cookies> is passed,
enables or disables transmission of cookies.

=end original

現在の send_cookies の設定を返します. 
任意の真偽値パラメータ C<$optional_send_cookies> が渡されると
クッキーの転送を許可もしくは不許可にします.

=head3 Returns

(復帰値)

=begin original

True if transmission of cookies is enabled; false otherwise.

=end original

クッキーの転送が許可されていれば真, そうでなければ偽.

=head2 extract_cookies (...)

=begin original

Overloaded method.  If receipt of cookies is enabled, passes all arguments 
to C<SUPER::extract_cookies>.  Otherwise, does nothing.

=end original

オーバーロードしているメソッド. 
クッキーの受信が許可されていれば引数を C<SUPER::extract_cookies> に
渡します. そうでなければ何もしません.

=head2 add_cookie_header (...)

=begin original

Overloaded method.  If transmission of cookies is enabled,
passes all arguments to C<SUPER::add_cookie_header>.  Otherwise, does nothing.

=end original

オーバーロードしているメソッド. 
クッキーの転送が許可されていれば引数を C<SUPER::add_cookie_header> に
渡します. そうでなければ何もしません.

=head1 COPYRIGHT

Copyright (c) 2000-2001 Richard Anderson.  All rights reserved.


Copyright (c) 2001-2003 Ilya Martynov.  All rights reserved.


=begin original

This program is free software; you can redistribute it and/or modify
it under the same terms as Perl itself.

=end original

このプログラムはフリーソフトウェアです. 
このプログラムは Perl 自身と同じ条件下で再配布・改変可能です.

=head1 SEE ALSO

L<HTTP::WebTest|HTTP::WebTest>


L<HTTP::WebTest::API|HTTP::WebTest::API>


L<HTTP::Cookies|HTTP::Cookies>