📄 _pion_engine_8hpp-source.html
字号:
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"><html><head><meta http-equiv="Content-Type" content="text/html;charset=UTF-8"><title>libpion: /Users/mdickey/code/libpion-export/include/libpion/PionEngine.hpp Source File</title><link href="doxygen.css" rel="stylesheet" type="text/css"><link href="tabs.css" rel="stylesheet" type="text/css"></head><body><!-- Generated by Doxygen 1.5.2 --><div class="tabs"> <ul> <li><a href="index.html"><span>Main Page</span></a></li> <li><a href="namespaces.html"><span>Namespaces</span></a></li> <li><a href="annotated.html"><span>Classes</span></a></li> <li class="current"><a href="files.html"><span>Files</span></a></li> </ul></div><h1>/Users/mdickey/code/libpion-export/include/libpion/PionEngine.hpp</h1><div class="fragment"><pre class="fragment"><a name="l00001"></a>00001 <span class="comment">// -----------------------------------------------------------------</span><a name="l00002"></a>00002 <span class="comment">// libpion: a C++ framework for building lightweight HTTP interfaces</span><a name="l00003"></a>00003 <span class="comment">// -----------------------------------------------------------------</span><a name="l00004"></a>00004 <span class="comment">// Copyright (C) 2007 Atomic Labs, Inc. (http://www.atomiclabs.com)</span><a name="l00005"></a>00005 <span class="comment">//</span><a name="l00006"></a>00006 <span class="comment">// Distributed under the Boost Software License, Version 1.0.</span><a name="l00007"></a>00007 <span class="comment">// See accompanying file COPYING or copy at http://www.boost.org/LICENSE_1_0.txt</span><a name="l00008"></a>00008 <span class="comment">//</span><a name="l00009"></a>00009 <a name="l00010"></a>00010 <span class="preprocessor">#ifndef __PION_PIONENGINE_HEADER__</span><a name="l00011"></a>00011 <span class="preprocessor"></span><span class="preprocessor">#define __PION_PIONENGINE_HEADER__</span><a name="l00012"></a>00012 <span class="preprocessor"></span><a name="l00013"></a>00013 <span class="preprocessor">#include <libpion/PionConfig.hpp></span><a name="l00014"></a>00014 <span class="preprocessor">#include <libpion/PionLogger.hpp></span><a name="l00015"></a>00015 <span class="preprocessor">#include <libpion/TCPServer.hpp></span><a name="l00016"></a>00016 <span class="preprocessor">#include <libpion/HTTPServer.hpp></span><a name="l00017"></a>00017 <span class="preprocessor">#include <boost/asio.hpp></span><a name="l00018"></a>00018 <span class="preprocessor">#include <boost/noncopyable.hpp></span><a name="l00019"></a>00019 <span class="preprocessor">#include <boost/thread/once.hpp></span><a name="l00020"></a>00020 <span class="preprocessor">#include <boost/thread/thread.hpp></span><a name="l00021"></a>00021 <span class="preprocessor">#include <boost/thread/mutex.hpp></span><a name="l00022"></a>00022 <span class="preprocessor">#include <boost/thread/condition.hpp></span><a name="l00023"></a>00023 <span class="preprocessor">#include <exception></span><a name="l00024"></a>00024 <span class="preprocessor">#include <list></span><a name="l00025"></a>00025 <span class="preprocessor">#include <map></span><a name="l00026"></a>00026 <a name="l00027"></a>00027 <a name="l00028"></a>00028 <span class="keyword">namespace </span>pion { <span class="comment">// begin namespace pion</span><a name="l00029"></a>00029 <a name="l00033"></a><a class="code" href="classpion_1_1_pion_engine.html">00033</a> <span class="keyword">class </span><a class="code" href="classpion_1_1_pion_engine.html">PionEngine</a> :<a name="l00034"></a>00034 <span class="keyword">private</span> boost::noncopyable<a name="l00035"></a>00035 {<a name="l00036"></a>00036 <span class="keyword">public</span>:<a name="l00037"></a>00037 <a name="l00039"></a><a class="code" href="classpion_1_1_pion_engine_1_1_already_started_exception.html">00039</a> <span class="keyword">class </span><a class="code" href="classpion_1_1_pion_engine_1_1_already_started_exception.html" title="exception thrown if start() is called after Pion is running">AlreadyStartedException</a> : <span class="keyword">public</span> std::exception {<a name="l00040"></a>00040 <span class="keyword">virtual</span> <span class="keyword">const</span> <span class="keywordtype">char</span>* what() <span class="keyword">const</span> <span class="keywordflow">throw</span>() {<a name="l00041"></a>00041 <span class="keywordflow">return</span> <span class="stringliteral">"Pion has already started"</span>;<a name="l00042"></a>00042 }<a name="l00043"></a>00043 };<a name="l00044"></a>00044 <a name="l00046"></a><a class="code" href="classpion_1_1_pion_engine_1_1_no_servers_exception.html">00046</a> <span class="keyword">class </span><a class="code" href="classpion_1_1_pion_engine_1_1_no_servers_exception.html" title="exception thrown if start() is called before any servers are defined">NoServersException</a> : <span class="keyword">public</span> std::exception {<a name="l00047"></a>00047 <span class="keyword">virtual</span> <span class="keyword">const</span> <span class="keywordtype">char</span>* what() <span class="keyword">const</span> <span class="keywordflow">throw</span>() {<a name="l00048"></a>00048 <span class="keywordflow">return</span> <span class="stringliteral">"Pion cannot start until servers are defined"</span>;<a name="l00049"></a>00049 }<a name="l00050"></a>00050 };<a name="l00051"></a>00051 <a name="l00052"></a>00052 <a name="l00054"></a><a class="code" href="classpion_1_1_pion_engine.html#00286dc19fc8f743b6a9d1ab2898d6ae">00054</a> <a class="code" href="classpion_1_1_pion_engine.html#00286dc19fc8f743b6a9d1ab2898d6ae" title="public destructor: not virtual, should not be extended">~PionEngine</a>() { <a class="code" href="classpion_1_1_pion_engine.html#2c6d002ad46191a4c4c4046537db329e">stop</a>(<span class="keyword">true</span>); }<a name="l00055"></a>00055 <a name="l00061"></a><a class="code" href="classpion_1_1_pion_engine.html#041692dfc331532fd97a79b43a7aeb74">00061</a> <span class="keyword">inline</span> <span class="keyword">static</span> <a class="code" href="classpion_1_1_pion_engine.html">PionEngine</a>& <a class="code" href="classpion_1_1_pion_engine.html#041692dfc331532fd97a79b43a7aeb74">getInstance</a>(<span class="keywordtype">void</span>) {<a name="l00062"></a>00062 boost::call_once(PionEngine::createInstance, m_instance_flag);<a name="l00063"></a>00063 <span class="keywordflow">return</span> *m_instance_ptr;<a name="l00064"></a>00064 }<a name="l00065"></a>00065 <a name="l00073"></a>00073 <span class="keywordtype">bool</span> <a class="code" href="classpion_1_1_pion_engine.html#39c7e8b0eeca284001cf7a9455cbb5ae">addServer</a>(<a class="code" href="namespacepion.html#a54ac170d28fb8b88d560775581a9b8f" title="data type for a TCPServer pointer">TCPServerPtr</a> tcp_server);<a name="l00074"></a>00074 <a name="l00082"></a>00082 <a class="code" href="namespacepion.html#7ed8c1f0fbb318801a8a19dda04f7001" title="data type for a HTTP protocol handler pointer">HTTPServerPtr</a> <a class="code" href="classpion_1_1_pion_engine.html#caa79f07e5eb562eb4b3ba99230ee941">addHTTPServer</a>(<span class="keyword">const</span> <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> tcp_port);<a name="l00083"></a>00083 <a name="l00091"></a>00091 <a class="code" href="namespacepion.html#a54ac170d28fb8b88d560775581a9b8f" title="data type for a TCPServer pointer">TCPServerPtr</a> <a class="code" href="classpion_1_1_pion_engine.html#d2a1e4fc8c01020702b067508c027d6d">getServer</a>(<span class="keyword">const</span> <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> tcp_port);<a name="l00092"></a>00092 <a name="l00098"></a>00098 <span class="keywordtype">void</span> <a class="code" href="classpion_1_1_pion_engine.html#2c6d002ad46191a4c4c4046537db329e">stop</a>(<span class="keyword">const</span> <span class="keywordtype">bool</span> reset_servers = <span class="keyword">false</span>);<a name="l00099"></a>00099 <a name="l00101"></a>00101 <span class="keywordtype">void</span> <a class="code" href="classpion_1_1_pion_engine.html#82d766568a1629f92f36ff6930ba0751" title="starts pion">start</a>(<span class="keywordtype">void</span>);<a name="l00102"></a>00102 <a name="l00104"></a>00104 <span class="keywordtype">void</span> <a class="code" href="classpion_1_1_pion_engine.html#e9ae5bdbf1ef328a83e9a1a12037d08e" title="the calling thread will sleep until the engine has stopped">join</a>(<span class="keywordtype">void</span>);<a name="l00105"></a>00105 <a name="l00107"></a><a class="code" href="classpion_1_1_pion_engine.html#5d04f83ff12550d8a645cd92dbd3a753">00107</a> <span class="keyword">inline</span> <span class="keywordtype">void</span> <a class="code" href="classpion_1_1_pion_engine.html#5d04f83ff12550d8a645cd92dbd3a753" title="sets the number of threads to be used (these are shared by all servers)">setNumThreads</a>(<span class="keyword">const</span> <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> n) { m_num_threads = n; }<a name="l00108"></a>00108 <a name="l00110"></a><a class="code" href="classpion_1_1_pion_engine.html#18533750090c18bedee61564d9769140">00110</a> <span class="keyword">inline</span> <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> <a class="code" href="classpion_1_1_pion_engine.html#18533750090c18bedee61564d9769140" title="returns the number of threads currently in use">getNumThreads</a>(<span class="keywordtype">void</span>)<span class="keyword"> const </span>{ <span class="keywordflow">return</span> m_num_threads; }<a name="l00111"></a>00111 <a name="l00113"></a><a class="code" href="classpion_1_1_pion_engine.html#74aa1df1308e3a02e2eb0b3bee141706">00113</a> <span class="keyword">inline</span> <span class="keywordtype">void</span> <a class="code" href="classpion_1_1_pion_engine.html#74aa1df1308e3a02e2eb0b3bee141706" title="sets the logger to be used">setLogger</a>(<a class="code" href="namespacepion.html#917bc483e4f692504156efb93c11b322">PionLogger</a> log_ptr) { m_logger = log_ptr; }<a name="l00114"></a>00114 <a name="l00116"></a><a class="code" href="classpion_1_1_pion_engine.html#1d656ab4125167ce1e17e684d7c80b93">00116</a> <span class="keyword">inline</span> <a class="code" href="namespacepion.html#917bc483e4f692504156efb93c11b322">PionLogger</a> <a class="code" href="classpion_1_1_pion_engine.html#1d656ab4125167ce1e17e684d7c80b93" title="returns the logger currently in use">getLogger</a>(<span class="keywordtype">void</span>) { <span class="keywordflow">return</span> m_logger; }<a name="l00117"></a>00117 <a name="l00119"></a><a class="code" href="classpion_1_1_pion_engine.html#d8ad96703f8a19cf2aac3c774003f163">00119</a> <span class="keyword">inline</span> boost::asio::io_service& <a class="code" href="classpion_1_1_pion_engine.html#d8ad96703f8a19cf2aac3c774003f163" title="returns the async I/O service used by the engine">getIOService</a>(<span class="keywordtype">void</span>) { <span class="keywordflow">return</span> m_asio_service; }<a name="l00120"></a>00120 <a name="l00121"></a>00121 <a name="l00122"></a>00122 <span class="keyword">private</span>:<a name="l00123"></a>00123 <a name="l00125"></a>00125 <a class="code" href="classpion_1_1_pion_engine.html">PionEngine</a>(<span class="keywordtype">void</span>)<a name="l00126"></a>00126 : m_logger(PION_GET_LOGGER(<span class="stringliteral">"Pion"</span>)),<a name="l00127"></a>00127 m_is_running(false), m_num_threads(DEFAULT_NUM_THREADS) {}<a name="l00128"></a>00128 <a name="l00130"></a>00130 <span class="keyword">static</span> <span class="keywordtype">void</span> createInstance(<span class="keywordtype">void</span>);<a name="l00131"></a>00131 <a name="l00133"></a>00133 <span class="keywordtype">void</span> run(<span class="keywordtype">void</span>);<a name="l00134"></a>00134 <a name="l00135"></a>00135 <a name="l00137"></a>00137 <span class="keyword">typedef</span> std::map<unsigned int, TCPServerPtr> TCPServerMap;<a name="l00138"></a>00138 <a name="l00140"></a>00140 <span class="keyword">typedef</span> std::list<boost::shared_ptr<boost::thread> > PionThreadPool;<a name="l00141"></a>00141 <a name="l00143"></a>00143 <span class="keyword">static</span> <span class="keyword">const</span> <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> DEFAULT_NUM_THREADS;<a name="l00144"></a>00144 <a name="l00146"></a>00146 <span class="keyword">static</span> PionEngine * m_instance_ptr;<a name="l00147"></a>00147 <a name="l00149"></a>00149 <span class="keyword">static</span> boost::once_flag m_instance_flag;<a name="l00150"></a>00150 <a name="l00152"></a>00152 <a class="code" href="namespacepion.html#917bc483e4f692504156efb93c11b322">PionLogger</a> m_logger;<a name="l00153"></a>00153 <a name="l00155"></a>00155 TCPServerMap m_servers;<a name="l00156"></a>00156 <a name="l00158"></a>00158 PionThreadPool m_thread_pool;<a name="l00159"></a>00159 <a name="l00161"></a>00161 boost::asio::io_service m_asio_service;<a name="l00162"></a>00162 <a name="l00164"></a>00164 boost::mutex m_mutex;<a name="l00165"></a>00165 <a name="l00167"></a>00167 boost::condition m_engine_has_stopped;<a name="l00168"></a>00168 <a name="l00170"></a>00170 <span class="keywordtype">bool</span> m_is_running;<a name="l00171"></a>00171 <a name="l00173"></a>00173 <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> m_num_threads;<a name="l00174"></a>00174 };<a name="l00175"></a>00175 <a name="l00176"></a>00176 } <span class="comment">// end namespace pion</span><a name="l00177"></a>00177 <a name="l00178"></a>00178 <span class="preprocessor">#endif</span></pre></div><hr size="1"><address style="text-align: right;"><small>Generated on Tue Jun 19 13:29:22 2007 for libpion by <a href="http://www.doxygen.org/index.html"><img src="doxygen.png" alt="doxygen" align="middle" border="0"></a> 1.5.2 </small></address></body></html>⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -