naiveproxy/net/dns/address_sorter.h
2018-08-14 22:19:20 +00:00

47 lines
1.3 KiB
C++

// Copyright (c) 2012 The Chromium Authors. All rights reserved.
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.
#ifndef NET_DNS_ADDRESS_SORTER_H_
#define NET_DNS_ADDRESS_SORTER_H_
#include <memory>
#include "base/callback.h"
#include "base/macros.h"
#include "net/base/net_export.h"
namespace net {
class AddressList;
// Sorts AddressList according to RFC3484, by likelihood of successful
// connection. Depending on the platform, the sort could be performed
// asynchronously by the OS, or synchronously by local implementation.
// AddressSorter does not necessarily preserve port numbers on the sorted list.
class NET_EXPORT AddressSorter {
public:
using CallbackType =
base::OnceCallback<void(bool success, const AddressList& list)>;
virtual ~AddressSorter() {}
// Sorts |list|, which must include at least one IPv6 address.
// Calls |callback| upon completion. Could complete synchronously. Could
// complete after this AddressSorter is destroyed.
virtual void Sort(const AddressList& list, CallbackType callback) const = 0;
// Creates platform-dependent AddressSorter.
static std::unique_ptr<AddressSorter> CreateAddressSorter();
protected:
AddressSorter() {}
private:
DISALLOW_COPY_AND_ASSIGN(AddressSorter);
};
} // namespace net
#endif // NET_DNS_ADDRESS_SORTER_H_