CompositeRequest.h

Go to the documentation of this file.

/*****************************************************************************
 *                                                                           *
 *  Copyright 2018 Rice University                                           *
 *                                                                           *
 *  Licensed under the Apache License, Version 2.0 (the "License");          *
 *  you may not use this file except in compliance with the License.         *
 *  You may obtain a copy of the License at                                  *
 *                                                                           *
 *      http://www.apache.org/licenses/LICENSE-2.0                           *
 *                                                                           *
 *  Unless required by applicable law or agreed to in writing, software      *
 *  distributed under the License is distributed on an "AS IS" BASIS,        *
 *  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. *
 *  See the License for the specific language governing permissions and      *
 *  limitations under the License.                                           *
 *                                                                           *
 *****************************************************************************/

#ifndef COMPOSITE_REQUEST_H
#define COMPOSITE_REQUEST_H

#include "PDBLogger.h"
#include "PDBCommunicator.h"

// This templated function makes it easy to write a simple network client that asks a request,
// then gets a result.  See, for example, CatalogClient.cc for an example of how to use.
//
// The type args are:
//  RequestType: the type of object to create to send over the wire
//  ResponseType: the type of object we expect to receive over the wire
//  ReturnType: the type we will return to the caller
//  RequestTypeParams: type of the params to use for the contructor to the object we send over the
//wre
//
// The params are:
//  myLogger: The logger we write error messages to
//  port: the port to send the request to
//  address: the address to send the request to
//  onErr: the value to return if there is an error sending/receiving data
//  bytesForRequest: the number of bytes to give to the allocator used to build the request
//  processResponse: the function used to process the response to the request
//  args: the arguments to give to the constructor of the request
//

namespace pdb {

template <class RequestType, class ResponseType, class ReturnType, class... RequestTypeParams>
ReturnType compositeRequest(
    PDBLoggerPtr myLogger,
    int port,
    std::string address,
    ReturnType onErr,
    size_t bytesForRequest,
    function<ReturnType(Handle<ResponseType>, PDBCommunicator)> processResponse,
    RequestTypeParams&&... args);
}

#endif

#include "CompositeRequest.cc"