17c9978567a202d6aa98beac5da5e1b3b34792862Jerome Poichet// Copyright 2012 Google Inc. All Rights Reserved. 27c9978567a202d6aa98beac5da5e1b3b34792862Jerome Poichet// 37c9978567a202d6aa98beac5da5e1b3b34792862Jerome Poichet// Licensed under the Apache License, Version 2.0 (the "License"); 47c9978567a202d6aa98beac5da5e1b3b34792862Jerome Poichet// you may not use this file except in compliance with the License. 57c9978567a202d6aa98beac5da5e1b3b34792862Jerome Poichet// You may obtain a copy of the License at 67c9978567a202d6aa98beac5da5e1b3b34792862Jerome Poichet// 77c9978567a202d6aa98beac5da5e1b3b34792862Jerome Poichet// http://www.apache.org/licenses/LICENSE-2.0 87c9978567a202d6aa98beac5da5e1b3b34792862Jerome Poichet// 97c9978567a202d6aa98beac5da5e1b3b34792862Jerome Poichet// Unless required by applicable law or agreed to in writing, software 107c9978567a202d6aa98beac5da5e1b3b34792862Jerome Poichet// distributed under the License is distributed on an "AS IS" BASIS, 117c9978567a202d6aa98beac5da5e1b3b34792862Jerome Poichet// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 127c9978567a202d6aa98beac5da5e1b3b34792862Jerome Poichet// See the License for the specific language governing permissions and 137c9978567a202d6aa98beac5da5e1b3b34792862Jerome Poichet// limitations under the License. 147c9978567a202d6aa98beac5da5e1b3b34792862Jerome Poichet 157c9978567a202d6aa98beac5da5e1b3b34792862Jerome Poichet#ifndef POLO_WIRE_POLOWIREINTERFACE_H_ 167c9978567a202d6aa98beac5da5e1b3b34792862Jerome Poichet#define POLO_WIRE_POLOWIREINTERFACE_H_ 177c9978567a202d6aa98beac5da5e1b3b34792862Jerome Poichet 187c9978567a202d6aa98beac5da5e1b3b34792862Jerome Poichet#include <stddef.h> 197c9978567a202d6aa98beac5da5e1b3b34792862Jerome Poichet#include <vector> 207c9978567a202d6aa98beac5da5e1b3b34792862Jerome Poichet 217c9978567a202d6aa98beac5da5e1b3b34792862Jerome Poichet#include "polo/wire/polowirelistener.h" 227c9978567a202d6aa98beac5da5e1b3b34792862Jerome Poichet#include "polo/util/macros.h" 237c9978567a202d6aa98beac5da5e1b3b34792862Jerome Poichet 247c9978567a202d6aa98beac5da5e1b3b34792862Jerome Poichetnamespace polo { 257c9978567a202d6aa98beac5da5e1b3b34792862Jerome Poichetnamespace wire { 267c9978567a202d6aa98beac5da5e1b3b34792862Jerome Poichet 277c9978567a202d6aa98beac5da5e1b3b34792862Jerome Poichet// An interface for sending and receiving raw data for a Polo pairing session. 287c9978567a202d6aa98beac5da5e1b3b34792862Jerome Poichetclass PoloWireInterface { 297c9978567a202d6aa98beac5da5e1b3b34792862Jerome Poichet public: 307c9978567a202d6aa98beac5da5e1b3b34792862Jerome Poichet PoloWireInterface() {} 317c9978567a202d6aa98beac5da5e1b3b34792862Jerome Poichet virtual ~PoloWireInterface() {} 327c9978567a202d6aa98beac5da5e1b3b34792862Jerome Poichet 337c9978567a202d6aa98beac5da5e1b3b34792862Jerome Poichet // Sets the listener that will receive incoming data and error notifications. 347c9978567a202d6aa98beac5da5e1b3b34792862Jerome Poichet // @param listener the listener to set for this interface 357c9978567a202d6aa98beac5da5e1b3b34792862Jerome Poichet void set_listener(PoloWireListener* listener) { listener_ = listener; } 367c9978567a202d6aa98beac5da5e1b3b34792862Jerome Poichet 377c9978567a202d6aa98beac5da5e1b3b34792862Jerome Poichet // Sends data over the interface. 387c9978567a202d6aa98beac5da5e1b3b34792862Jerome Poichet // @param data the bytes to send 397c9978567a202d6aa98beac5da5e1b3b34792862Jerome Poichet virtual void Send(const std::vector<uint8_t>& data) = 0; 407c9978567a202d6aa98beac5da5e1b3b34792862Jerome Poichet 417c9978567a202d6aa98beac5da5e1b3b34792862Jerome Poichet // Receives the given number of bytes from the interface asynchronously. The 427c9978567a202d6aa98beac5da5e1b3b34792862Jerome Poichet // listener will be notified when the data is received. 437c9978567a202d6aa98beac5da5e1b3b34792862Jerome Poichet // @param num_bytes the number of bytes to receive 447c9978567a202d6aa98beac5da5e1b3b34792862Jerome Poichet virtual void Receive(size_t num_bytes) = 0; 457c9978567a202d6aa98beac5da5e1b3b34792862Jerome Poichet 467c9978567a202d6aa98beac5da5e1b3b34792862Jerome Poichet protected: 477c9978567a202d6aa98beac5da5e1b3b34792862Jerome Poichet // Gets the listener that will receive incoming data and error notifications. 487c9978567a202d6aa98beac5da5e1b3b34792862Jerome Poichet PoloWireListener* listener() const { return listener_; } 497c9978567a202d6aa98beac5da5e1b3b34792862Jerome Poichet 507c9978567a202d6aa98beac5da5e1b3b34792862Jerome Poichet private: 517c9978567a202d6aa98beac5da5e1b3b34792862Jerome Poichet PoloWireListener* listener_; 527c9978567a202d6aa98beac5da5e1b3b34792862Jerome Poichet 537c9978567a202d6aa98beac5da5e1b3b34792862Jerome Poichet DISALLOW_COPY_AND_ASSIGN(PoloWireInterface); 547c9978567a202d6aa98beac5da5e1b3b34792862Jerome Poichet}; 557c9978567a202d6aa98beac5da5e1b3b34792862Jerome Poichet 567c9978567a202d6aa98beac5da5e1b3b34792862Jerome Poichet} // namespace wire 577c9978567a202d6aa98beac5da5e1b3b34792862Jerome Poichet} // namespace polo 587c9978567a202d6aa98beac5da5e1b3b34792862Jerome Poichet 597c9978567a202d6aa98beac5da5e1b3b34792862Jerome Poichet#endif // POLO_WIRE_POLOWIREINTERFACE_H_ 60