folly/io/async/ScopedEventBaseThread.h

   1 /*
   2  * Copyright 2015 Facebook, Inc.
   3  *
   4  * Licensed under the Apache License, Version 2.0 (the "License");
   5  * you may not use this file except in compliance with the License.
   6  * You may obtain a copy of the License at
   7  *
   8  *   http://www.apache.org/licenses/LICENSE-2.0
   9  *
  10  * Unless required by applicable law or agreed to in writing, software
  11  * distributed under the License is distributed on an "AS IS" BASIS,
  12  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  13  * See the License for the specific language governing permissions and
  14  * limitations under the License.
  15  */
  16
  17 #pragma once
  18
  19 #include <memory>
  20 #include <folly/io/async/EventBase.h>
  21
  22 namespace std {
  23 class thread;
  24 }
  25
  26 namespace folly {
  27
  28 /**
  29  * A helper class to start a new thread running a TEventBase loop.
  30  *
  31  * The new thread will be started by the ScopedEventBaseThread constructor.
  32  * When the ScopedEventBaseThread object is destroyed, the thread will be
  33  * stopped.
  34  */
  35 class ScopedEventBaseThread {
  36  public:
  37   explicit ScopedEventBaseThread(bool autostart = true);
  38   ~ScopedEventBaseThread();
  39
  40   ScopedEventBaseThread(ScopedEventBaseThread&& other) noexcept;
  41   ScopedEventBaseThread &operator=(ScopedEventBaseThread&& other) noexcept;
  42
  43   /**
  44    * Get a pointer to the TEventBase driving this thread.
  45    */
  46   EventBase* getEventBase() const {
  47     return eventBase_.get();
  48   }
  49
  50   void start();
  51   void stop();
  52   bool running();
  53
  54  private:
  55   ScopedEventBaseThread(const ScopedEventBaseThread& other) = delete;
  56   ScopedEventBaseThread& operator=(const ScopedEventBaseThread& other) = delete;
  57
  58   std::unique_ptr<EventBase> eventBase_;
  59   std::unique_ptr<std::thread> thread_;
  60 };
  61
  62 }