Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
SOAP::Transport::TCP(3User Contributed Perl DocumentatiSOAP::Transport::TCP(3)

NAME
       SOAP::Transport::TCP - TCP Transport Support for	SOAP::Lite

   SOAP::Transport::TCP
       The classes provided by this module implement direct TCP/IP
       communications methods for both clients and servers.

       The connections don't use HTTP or any other higher-level	protocol.
       These classes are selected when the client or server object being
       created uses an endpoint	URI that starts	with tcp://. Both client and
       server classes support using Secure Socket Layer	if it is available. If
       any of the parameters to	a new method from either of the	classes	begins
       with SSL_ (such as SSL_server in	place of Server), the class attempts
       to load the IO::Socket::SSL package and use it to create	socket
       objects.

       Both of the following classes catch methods that	are intended for the
       socket objects and pass them along, allowing calls such as
       $client->accept(	) without including the	socket class in	the
       inheritance tree.

       SOAP::Transport::TCP::Client

       Inherits	from: SOAP::Client.

       The TCP client class defines only two relevant methods beyond new and
       send_receive. These methods are:

       SSL(optional new	boolean	value)
	       if ($client->SSL) # Execute only	if in SSL mode

	   Reflects the	attribute that denotes whether the client object is
	   using SSL sockets for communications.

       io_socket_class
	       ($client->io_socket_class)->new(%options);

	   Returns the name of the class to use	when creating socket objects
	   for internal	use in communications. As implemented, it returns one
	   of IO::Socket::INET or IO::Socket::SSL, depending on	the return
	   value of the	previous SSL method.

       If an application creates a subclass that inherits from this client
       class, either method is a likely	target for overloading.

       The new method behaves identically to most other	classes, except	that
       it detects the presence of SSL-targeted values in the parameter list
       and sets	the SSL	method appropriately if	they are present.

       The send_receive	method creates a socket	of the appropriate class and
       connects	to the configured endpoint. It then sets the socket to
       nonblocking I/O,	sends the message, shuts down the client end of	the
       connection (preventing further writing),	and reads the response back
       from the	server.	The socket object is discarded after the response and
       appropriate status codes	are set	on the client object.

       SOAP::Transport::TCP::Server

       Inherits	from: SOAP::Server.

       The server class	also defines the same two additional methods as	in the
       client class:

       SSL(optional new	boolean	value)
	       if ($client->SSL) # Execute only	if in SSL mode

	   Reflects the	attribute that denotes whether the client object is
	   using SSL sockets for communications.

       io_socket_class
	       ($client->io_socket_class)->new(%options);

	   Returns the name of the class to use	when creating socket objects
	   for internal	use in communications. As implemented, it returns one
	   of IO::Socket::INET or IO::Socket::SSL, depending on	the return
	   value of the	previous SSL method. The new method also manages the
	   automatic selection of SSL in the same fashion as the client	class
	   does.

	   The handle method in	this server implementation isn't designed to
	   be called once with each new	request. Rather, it is called with no
	   arguments, at which time it enters into an infinite loop of waiting
	   for a connection, reading the request, routing the request and
	   sending back	the serialized response. This continues	until the
	   process itself is interrupted by an untrapped signal	or similar
	   means.

COPYRIGHT
       Copyright (C) 2000-2004 Paul Kulchenko. All rights reserved.

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

AUTHORS
       Written by Paul Kulchenko.

       Split from SOAP::Lite and SOAP-Transport-TCP packaging by Martin	Kutter

perl v5.32.1			  2018-05-14	       SOAP::Transport::TCP(3)

NAME | COPYRIGHT | AUTHORS

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=SOAP::Transport::TCP&sektion=3&manpath=FreeBSD+13.0-RELEASE+and+Ports>

home | help