1 // ANNA - Anna is Not Nothingness Anymore
3 // (c) Copyright 2005-2014 Eduardo Ramos Testillano & Francisco Ruiz Rayo
5 // http://redmine.teslayout.com/projects/anna-suite
7 // Redistribution and use in source and binary forms, with or without
8 // modification, are permitted provided that the following conditions
11 // * Redistributions of source code must retain the above copyright
12 // notice, this list of conditions and the following disclaimer.
13 // * Redistributions in binary form must reproduce the above
14 // copyright notice, this list of conditions and the following disclaimer
15 // in the documentation and/or other materials provided with the
17 // * Neither the name of the copyright holder nor the names of its
18 // contributors may be used to endorse or promote products derived from
19 // this software without specific prior written permission.
21 // THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
22 // "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
23 // LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
24 // A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
25 // OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
26 // SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
27 // LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
28 // DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
29 // THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
30 // (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
31 // OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
33 // Authors: eduardo.ramos.testillano@gmail.com
34 // cisco.tierra@gmail.com
37 #ifndef anna_comm_DatagramSocket_hpp
38 #define anna_comm_DatagramSocket_hpp
40 #include <anna/comm/ClientSocket.hpp>
47 Esta clase implementa un Socket no orientado a conexion.
49 class DatagramSocket : public ClientSocket {
52 * Indica el uso que tendrá este DatagramSocket, si para recibir o para enviar.
54 enum Mode { ReadOnly, WriteOnly };
57 Crear un Socket no orientado a conexion de un sólo sentido.
59 Los datagram socket definidos como \em Mode \em ReadOnly tienen que ser asociados al
60 comunicador mediante la invocación al método anna::comm::Communicator::attach.
62 Los datagram socket definidos como \em Mode \em WriteOnly tienen que invocar a al
63 método #connect antes de poder ser usados.
65 \param mode Uso que se dará a este DatagramSocket.
66 \param address Dirección en la que enviar o recibir mensajes.
67 \param transportFactory Factoria de protocolos de transporte a usar por este sockets.
68 \warning La factoria de protocolos debe estar disponible mientras el Socket esta activo.
70 DatagramSocket(const Mode mode, const INetAddress& address, TransportFactory* transportFactory = NULL);
73 Devuelve el modo en que fue instanciado este Socket.
74 \return el modo en que fue instanciado este Socket.
76 Mode getMode() const throw() { return a_mode; }
79 Devuelve \em true si el socket fue instancia como sólo-lectura.
80 \return \em true si el socket fue instancia como sólo-lectura.
82 const bool isReadOnly() const throw() { return a_mode == ReadOnly; }
85 Devuelve \em true si el socket fue instancia como sólo-lectura.
86 \return \em true si el socket fue instancia como sólo-lectura.
88 const bool isWriteOnly() const throw() { return a_mode == WriteOnly; }
91 Prepara el socket para enviar a la direccion indicada en el constructor.
93 void connect() throw(RuntimeException);
98 void do_write(const DataBlock&) throw(RuntimeException);
99 int do_read(const char* data, const int maxSize) throw(RuntimeException);