ap
Dependencies: DnsQuery
Dependents: WizFi310_TCP_Echo_Server_Example
Fork of NetworkSocketAPI by
TCPServer.h@90:0a988e4abb72, 2016-04-19 (annotated)
- Committer:
- Christopher Haster
- Date:
- Tue Apr 19 18:22:15 2016 -0500
- Revision:
- 90:0a988e4abb72
- Parent:
- 89:b1d417383c0d
- Child:
- 92:dd5f19874adf
Add open call as alternative to passing NetworkInterface at construction
Pros
- Allows memory to be statically allocated
- Avoids issues with Thread creation before entering main
- Matches existing APIs such as FunctionPointer and Ticker
Cons
- Does not enforce passing a NetworkInterface
Who changed what in which revision?
User | Revision | Line number | New contents of line |
---|---|---|---|
Christopher Haster |
89:b1d417383c0d | 1 | /* Socket |
Christopher Haster |
89:b1d417383c0d | 2 | * Copyright (c) 2015 ARM Limited |
Christopher Haster |
89:b1d417383c0d | 3 | * |
Christopher Haster |
89:b1d417383c0d | 4 | * Licensed under the Apache License, Version 2.0 (the "License"); |
Christopher Haster |
89:b1d417383c0d | 5 | * you may not use this file except in compliance with the License. |
Christopher Haster |
89:b1d417383c0d | 6 | * You may obtain a copy of the License at |
Christopher Haster |
89:b1d417383c0d | 7 | * |
Christopher Haster |
89:b1d417383c0d | 8 | * http://www.apache.org/licenses/LICENSE-2.0 |
Christopher Haster |
89:b1d417383c0d | 9 | * |
Christopher Haster |
89:b1d417383c0d | 10 | * Unless required by applicable law or agreed to in writing, software |
Christopher Haster |
89:b1d417383c0d | 11 | * distributed under the License is distributed on an "AS IS" BASIS, |
Christopher Haster |
89:b1d417383c0d | 12 | * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. |
Christopher Haster |
89:b1d417383c0d | 13 | * See the License for the specific language governing permissions and |
Christopher Haster |
89:b1d417383c0d | 14 | * limitations under the License. |
Christopher Haster |
89:b1d417383c0d | 15 | */ |
Christopher Haster |
89:b1d417383c0d | 16 | |
Christopher Haster |
89:b1d417383c0d | 17 | #ifndef TCPSERVER_H |
Christopher Haster |
89:b1d417383c0d | 18 | #define TCPSERVER_H |
Christopher Haster |
89:b1d417383c0d | 19 | |
Christopher Haster |
89:b1d417383c0d | 20 | #include "Socket.h" |
Christopher Haster |
89:b1d417383c0d | 21 | #include "TCPSocket.h" |
Christopher Haster |
89:b1d417383c0d | 22 | #include "NetworkInterface.h" |
Christopher Haster |
89:b1d417383c0d | 23 | |
Christopher Haster |
89:b1d417383c0d | 24 | /** TCP Server. |
Christopher Haster |
89:b1d417383c0d | 25 | */ |
Christopher Haster |
89:b1d417383c0d | 26 | class TCPServer : public Socket { |
Christopher Haster |
89:b1d417383c0d | 27 | public: |
Christopher Haster |
89:b1d417383c0d | 28 | /** TCP Server lifetime |
Christopher Haster |
89:b1d417383c0d | 29 | */ |
Christopher Haster |
90:0a988e4abb72 | 30 | TCPServer(); |
Christopher Haster |
89:b1d417383c0d | 31 | TCPServer(NetworkInterface *iface); |
Christopher Haster |
89:b1d417383c0d | 32 | virtual ~TCPServer(); |
Christopher Haster |
90:0a988e4abb72 | 33 | |
Christopher Haster |
90:0a988e4abb72 | 34 | /** Open the socket |
Christopher Haster |
90:0a988e4abb72 | 35 | * @param iface Interface to open socket on |
Christopher Haster |
90:0a988e4abb72 | 36 | */ |
Christopher Haster |
90:0a988e4abb72 | 37 | virtual int open(NetworkInterface *iface); |
Christopher Haster |
89:b1d417383c0d | 38 | |
Christopher Haster |
89:b1d417383c0d | 39 | /** Bind a socket to a specific port |
Christopher Haster |
89:b1d417383c0d | 40 | * @param port The port to listen for incoming connections on |
Christopher Haster |
89:b1d417383c0d | 41 | * @return 0 on success, negative on failure |
Christopher Haster |
89:b1d417383c0d | 42 | */ |
Christopher Haster |
89:b1d417383c0d | 43 | int bind(uint16_t port); |
Christopher Haster |
89:b1d417383c0d | 44 | |
Christopher Haster |
89:b1d417383c0d | 45 | /** Start listening for incoming connections |
Christopher Haster |
89:b1d417383c0d | 46 | * @param backlog Number of pending connections that can be queued up at any |
Christopher Haster |
89:b1d417383c0d | 47 | * one time [Default: 1] |
Christopher Haster |
89:b1d417383c0d | 48 | * @return 0 on success, negative on failure |
Christopher Haster |
89:b1d417383c0d | 49 | */ |
Christopher Haster |
89:b1d417383c0d | 50 | int listen(int backlog=1); |
Christopher Haster |
89:b1d417383c0d | 51 | |
Christopher Haster |
89:b1d417383c0d | 52 | /** Accept a new connection. |
Christopher Haster |
89:b1d417383c0d | 53 | * @param socket A TCPSocket instance that will handle the incoming connection. |
Christopher Haster |
89:b1d417383c0d | 54 | * @return 0 on success, negative on failure. |
Christopher Haster |
89:b1d417383c0d | 55 | */ |
Christopher Haster |
89:b1d417383c0d | 56 | int accept(TCPSocket *connection); |
Christopher Haster |
89:b1d417383c0d | 57 | |
Christopher Haster |
89:b1d417383c0d | 58 | /** Register a callback on when a new connection is ready |
Christopher Haster |
89:b1d417383c0d | 59 | * @param callback Function to call when accept will succeed, may be called in |
Christopher Haster |
89:b1d417383c0d | 60 | * interrupt context. |
Christopher Haster |
89:b1d417383c0d | 61 | */ |
Christopher Haster |
89:b1d417383c0d | 62 | void attach_accept(FunctionPointer callback); |
Christopher Haster |
89:b1d417383c0d | 63 | |
Christopher Haster |
89:b1d417383c0d | 64 | template <typename T, typename M> |
Christopher Haster |
89:b1d417383c0d | 65 | void attach_accept(T *tptr, M mptr) { |
Christopher Haster |
89:b1d417383c0d | 66 | attach_accept(FunctionPointer(tptr, mptr)); |
Christopher Haster |
89:b1d417383c0d | 67 | } |
Christopher Haster |
89:b1d417383c0d | 68 | |
Christopher Haster |
89:b1d417383c0d | 69 | private: |
Christopher Haster |
89:b1d417383c0d | 70 | FunctionPointer _accept_cb; |
Christopher Haster |
89:b1d417383c0d | 71 | }; |
Christopher Haster |
89:b1d417383c0d | 72 | |
Christopher Haster |
89:b1d417383c0d | 73 | #endif |