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