Program Listing for File communication_info.hpp

Return to documentation for file (include/email/communication_info.hpp)

// Copyright 2021 Christophe Bedard
//
// 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 EMAIL__COMMUNICATION_INFO_HPP_
#define EMAIL__COMMUNICATION_INFO_HPP_

#include <optional>  // NOLINT cpplint mistakes <optional> for a C system header
#include <string>

#include "email/email/info.hpp"
#include "email/gid.hpp"
#include "email/timestamp.hpp"
#include "email/visibility_control.hpp"

namespace email
{


class CommunicationInfo
{
public:
  EMAIL_PUBLIC
  CommunicationInfo(
    const Timestamp & source_timestamp,
    const Timestamp & received_timestamp,
    const Gid & source_gid);

  EMAIL_PUBLIC
  CommunicationInfo(const CommunicationInfo &) = default;

  EMAIL_PUBLIC
  ~CommunicationInfo();

  EMAIL_PUBLIC
  const Timestamp &
  source_timestamp() const;

  EMAIL_PUBLIC
  const Timestamp &
  received_timestamp() const;

  EMAIL_PUBLIC
  const Gid &
  source_gid() const;


  static
  std::optional<CommunicationInfo>
  from_headers(const EmailHeaders & headers, const std::string & source_gid_header);

  static constexpr auto HEADER_SOURCE_TIMESTAMP = "Source-Timestamp";

private:
  const Timestamp source_timestamp_;
  const Timestamp received_timestamp_;
  const Gid source_gid_;
};

}  // namespace email

#endif  // EMAIL__COMMUNICATION_INFO_HPP_