| /* |
| * Copyright 2014, The Android Open Source Project |
| * |
| * Licensed under the Apache License, Version 2.0 (the "License"); |
| * you may not use this file except in compliance with the License. |
| * You may obtain a copy of the License at |
| * |
| * http://www.apache.org/licenses/LICENSE-2.0 |
| * |
| * Unless required by applicable law or agreed to in writing, software |
| * distributed under the License is distributed on an "AS IS" BASIS, |
| * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. |
| * See the License for the specific language governing permissions and |
| * limitations under the License. |
| */ |
| |
| #ifndef ANDROID_CAZE_CONNECTION_H |
| #define ANDROID_CAZE_CONNECTION_H |
| |
| #include <cstddef> |
| #include <memory> |
| #include <string> |
| |
| namespace android { |
| namespace caze { |
| |
| // Abstract base class for representing a connection to the server with simple helper methods for |
| // sending specific data types |
| class Connection { |
| public: |
| virtual ~Connection() {} |
| |
| // Try to send size bytes of data from the specified buffer using the underlying connection. |
| // Will block if the connection is not ready. Returns the number of bytes successfully sent |
| // (possibly less then size if an error occurred). |
| virtual size_t send(const void* data, size_t size) = 0; |
| |
| // Tries to read size bytes to the buffer specified by data on the underlying connection and |
| // blocks until the data is available. Returns the number of bytes successfully retrieved |
| // (possibly less then size if an error occurred). |
| virtual size_t recv(void* data, size_t size) = 0; |
| |
| // Returns the last error message raised by the connection. |
| virtual const char* error() = 0; |
| |
| // Accept an incoming connection request on the underlying connection and returns the new |
| // connection corresponding to it. The returned connection is ready to use. |
| virtual std::unique_ptr<Connection> accept() = 0; |
| |
| // Helper methods for sending and receiving strings |
| bool sendString(const std::string& s); |
| bool readString(std::string* s); |
| }; |
| |
| } // end of namespace caze |
| } // end of namespace android |
| |
| #endif |