http_rest_api_handler.h

/* Copyright 2018 Google Inc. All Rights Reserved.
 
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 TENSORFLOW_SERVING_MODEL_SERVERS_HTTP_REST_API_HANDLER_H_
#define TENSORFLOW_SERVING_MODEL_SERVERS_HTTP_REST_API_HANDLER_H_
 
#include <memory>
#include <string>
#include <utility>
#include <vector>
 
#include "absl/strings/string_view.h"
#include "absl/types/optional.h"
#include "re2/re2.h"
#include "tensorflow/core/lib/core/status.h"
#include "tensorflow/core/protobuf/config.pb.h"
#include "tensorflow/core/protobuf/meta_graph.pb.h"
#include "tensorflow_serving/model_servers/http_rest_api_handler_base.h"
 
namespace tensorflow {
 
class SignatureDef;
 
namespace serving {
 
class ServerCore;
class TensorflowPredictor;
class ModelSpec;
 
// HttpRestApiHandler handles HTTP/REST APIs of TF serving.
//
// Currently supported APIs are as follows:
//
// o Inference - Classify/Regress/Predict
//
//   POST /v1/models/<model_name>:(classify|regress|predict)
//   POST /v1/models/<model_name>/versions/<ver>:(classify|regress|predict)
//
// o Model status
//
//   GET /v1/models/<model_name> (status of all versions)
//   GET /v1/models/<model_name>/versions/<ver> (status of specific version)
//
// The API is documented here:
// tensorflow_serving/g3doc/api_rest.md
//
// Users of this class should typically create one instance of it at process
// startup, register paths defined by kPathRegex with the in-process HTTP
// server, and when a request arrives, forward the request to ProcessRequest()
// method.
//
// This class is thread safe.
class HttpRestApiHandler : public HttpRestApiHandlerBase {
 public:
  // Returns a regex that captures all API paths handled by this handler.
  // Typical use of this method is to register request paths with underlying
  // HTTP server, so incoming requests can be forwarded to this handler.
  static const char* const kPathRegex;
 
  // API calls are configured to timeout after `timeout_in_ms`.
  // `core` is not owned and is expected to outlive HttpRestApiHandler
  // instance.
  HttpRestApiHandler(int timeout_in_ms, ServerCore* core);
 
  ~HttpRestApiHandler() override;
 
  // Process a HTTP request.
  //
  // In case of errors, the `headers` and `output` are still relevant as they
  // contain detailed error messages, that can be relayed back to the client.
  Status ProcessRequest(const absl::string_view http_method,
                        const absl::string_view request_path,
                        const absl::string_view request_body,
                        std::vector<std::pair<string, string>>* headers,
                        string* model_name, string* method,
                        string* output) override;
 
 private:
  Status ProcessClassifyRequest(
      const absl::string_view model_name,
      const absl::optional<int64_t>& model_version,
      const absl::optional<absl::string_view>& model_version_label,
      const absl::string_view request_body, string* output);
  Status ProcessRegressRequest(
      const absl::string_view model_name,
      const absl::optional<int64_t>& model_version,
      const absl::optional<absl::string_view>& model_version_label,
      const absl::string_view request_body, string* output);
  Status ProcessPredictRequest(
      const absl::string_view model_name,
      const absl::optional<int64_t>& model_version,
      const absl::optional<absl::string_view>& model_version_label,
      const absl::string_view request_body, string* output);
  Status ProcessModelStatusRequest(
      const absl::string_view model_name,
      const absl::optional<int64_t>& model_version,
      const absl::optional<absl::string_view>& model_version_label,
      string* output);
  Status ProcessModelMetadataRequest(
      const absl::string_view model_name,
      const absl::optional<int64_t>& model_version,
      const absl::optional<absl::string_view>& model_version_label,
      string* output);
  Status GetInfoMap(const ModelSpec& model_spec, const string& signature_name,
                    ::google::protobuf::Map<string, tensorflow::TensorInfo>* infomap);
 
  RunOptions run_options_;
  ServerCore* core_;
  std::unique_ptr<TensorflowPredictor> predictor_;
};
 
}  // namespace serving
}  // namespace tensorflow
 
#endif  // TENSORFLOW_SERVING_MODEL_SERVERS_HTTP_REST_API_HANDLER_H_