fc::rpc::http_api_connection Class Reference

#include <http_api.hpp>

Inheritance diagram for fc::rpc::http_api_connection:

Collaboration diagram for fc::rpc::http_api_connection:

Public Member Functions
	http_api_connection ()
	~http_api_connection ()
virtual variant	send_call (api_id_type api_id, string method_name, variants args=variants()) override
virtual variant	send_callback (uint64_t callback_id, variants args=variants()) override
virtual void	send_notice (uint64_t callback_id, variants args=variants()) override
void	on_request (const fc::http::request &req, const fc::http::server::response &resp)
Public Member Functions inherited from fc::api_connection
	api_connection ()
virtual	~api_connection ()
template<typename T >
api< T >	get_remote_api (api_id_type api_id=0)
variant	receive_call (api_id_type api_id, const string &method_name, const variants &args=variants()) const
variant	receive_callback (uint64_t callback_id, const variants &args=variants()) const
void	receive_notice (uint64_t callback_id, const variants &args=variants()) const
template<typename Interface >
api_id_type	register_api (const Interface &a)
template<typename Signature >
uint64_t	register_callback (const std::function< Signature > &cb)
std::vector< std::string >	get_method_names (api_id_type local_api_id=0) const

Public Attributes
fc::rpc::state	_rpc_state
Public Attributes inherited from fc::api_connection
fc::signal< void()>	closed

Detailed Description

Definition at line 11 of file http_api.hpp.

Constructor & Destructor Documentation

http_api_connection()

fc::rpc::http_api_connection::http_api_connection

(

)

Definition at line 10 of file http_api.cpp.

{
   _rpc_state.add_method( "call", [this]( const variants& args ) -> variant
   {
      // TODO: This logic is duplicated between http_api_connection and websocket_api_connection
      // it should be consolidated into one place instead of copy-pasted
      FC_ASSERT( args.size() == 3 && args[2].is_array() );
      api_id_type api_id;
      if( args[0].is_string() )
      {
         variants subargs;
         subargs.push_back( args[0] );
         variant subresult = this->receive_call( 1, "get_api_by_name", subargs );
         api_id = subresult.as_uint64();
      }
      else
         api_id = args[0].as_uint64();
 
      return this->receive_call(
         api_id,
         args[1].as_string(),
         args[2].get_array() );
   } );
 
   _rpc_state.add_method( "notice", [this]( const variants& args ) -> variant
   {
      FC_ASSERT( args.size() == 2 && args[1].is_array() );
      this->receive_notice(
         args[0].as_uint64(),
         args[1].get_array() );
      return variant();
   } );
 
   _rpc_state.add_method( "callback", [this]( const variants& args ) -> variant
   {
      FC_ASSERT( args.size() == 2 && args[1].is_array() );
      this->receive_callback(
         args[0].as_uint64(),
         args[1].get_array() );
      return variant();
   } );
 
   _rpc_state.on_unhandled( [&]( const std::string& method_name, const variants& args )
   {
      return this->receive_call( 0, method_name, args );
   } );
}

Here is the call graph for this function:

~http_api_connection()

fc::rpc::http_api_connection::~http_api_connection

(

)

Definition at line 6 of file http_api.cpp.

{
}

Member Function Documentation

on_request()

void fc::rpc::http_api_connection::on_request	(	const fc::http::request &	req,
		const fc::http::server::response &	resp )

Definition at line 83 of file http_api.cpp.

{
   // this must be called by outside HTTP server's on_request method
   std::string resp_body;
   http::reply::status_code resp_status;
 
   auto handle_error = [&](const auto& e)
   {
      resp_status = http::reply::InternalServerError;
      resp_body = "";
      wdump((e.to_detail_string()));
   };
 
   try
   {
      resp.add_header( "Content-Type", "application/json" );
      std::string req_body( req.body.begin(), req.body.end() );
      auto var = fc::json::from_string( req_body );
      const auto& var_obj = var.get_object();
 
      if( var_obj.contains( "method" ) )
      {
         auto call = var.as<fc::rpc::request>();
         auto handle_error_inner = [&](const auto& e)
         {
            resp_body = fc::json::to_string( fc::rpc::response( *call.id, error_object{ 1, e.to_detail_string(), fc::variant(e)} ) );
            resp_status = http::reply::InternalServerError;}
         };
 
         try
         {
            auto result = _rpc_state.local_call( call.method, call.params );
            resp_body = fc::json::to_string( fc::rpc::response( *call.id, result ) );
            resp_status = http::reply::OK;
         }
         catch ( const std::bad_alloc& ) 
         {
            throw;
         } 
         catch ( const boost::interprocess::bad_alloc& ) 
         {
            throw;
         } 
         catch ( const fc::exception& e )
         {
            handle_error_inner(e);
         }
         catch ( const std::exception& e )
         {
            handle_error_inner(fc::std_exception_wrapper::from_current_exception(e));
         }
      }
      else
      {
         resp_status = http::reply::BadRequest;
         resp_body = "";
      }
   }

Here is the call graph for this function:

send_call()

variant fc::rpc::http_api_connection::send_call ( api_id_type api_id, string method_name, variants args = variants() )

overridevirtual

makes calls to the remote server

Implements fc::api_connection.

Definition at line 58 of file http_api.cpp.

{
   // HTTP has no way to do this, so do nothing
   return variant();
}

send_callback()

variant fc::rpc::http_api_connection::send_callback ( uint64_t callback_id, variants args = variants() )

overridevirtual

Implements fc::api_connection.

Definition at line 67 of file http_api.cpp.

{
   // HTTP has no way to do this, so do nothing
   return variant();
}

send_notice()

void fc::rpc::http_api_connection::send_notice ( uint64_t callback_id, variants args = variants() )

overridevirtual

Implements fc::api_connection.

Definition at line 75 of file http_api.cpp.

{
   // HTTP has no way to do this, so do nothing
   return;
}

Member Data Documentation

_rpc_state

fc::rpc::state fc::rpc::http_api_connection::_rpc_state

Definition at line 32 of file http_api.hpp.

---

The documentation for this class was generated from the following files:

• libraries/fc/include/fc/rpc/http_api.hpp
• libraries/fc/src/rpc/http_api.cpp