xref: /aosp_15_r20/external/openscreen/discovery/dnssd/impl/conversion_layer.h (revision 3f982cf4871df8771c9d4abe6e9a6f8d829b2736)
1*3f982cf4SFabien Sanglard // Copyright 2019 The Chromium Authors. All rights reserved.
2*3f982cf4SFabien Sanglard // Use of this source code is governed by a BSD-style license that can be
3*3f982cf4SFabien Sanglard // found in the LICENSE file.
4*3f982cf4SFabien Sanglard 
5*3f982cf4SFabien Sanglard #ifndef DISCOVERY_DNSSD_IMPL_CONVERSION_LAYER_H_
6*3f982cf4SFabien Sanglard #define DISCOVERY_DNSSD_IMPL_CONVERSION_LAYER_H_
7*3f982cf4SFabien Sanglard 
8*3f982cf4SFabien Sanglard #include <string>
9*3f982cf4SFabien Sanglard #include <vector>
10*3f982cf4SFabien Sanglard 
11*3f982cf4SFabien Sanglard #include "absl/strings/string_view.h"
12*3f982cf4SFabien Sanglard #include "discovery/dnssd/impl/constants.h"
13*3f982cf4SFabien Sanglard #include "discovery/dnssd/public/dns_sd_instance_endpoint.h"
14*3f982cf4SFabien Sanglard #include "discovery/dnssd/public/dns_sd_txt_record.h"
15*3f982cf4SFabien Sanglard #include "discovery/mdns/mdns_records.h"
16*3f982cf4SFabien Sanglard #include "platform/base/error.h"
17*3f982cf4SFabien Sanglard 
18*3f982cf4SFabien Sanglard namespace openscreen {
19*3f982cf4SFabien Sanglard namespace discovery {
20*3f982cf4SFabien Sanglard 
21*3f982cf4SFabien Sanglard class InstanceKey;
22*3f982cf4SFabien Sanglard class ServiceKey;
23*3f982cf4SFabien Sanglard 
24*3f982cf4SFabien Sanglard // *** Conversions from DNS entities to DNS-SD Entities ***
25*3f982cf4SFabien Sanglard 
26*3f982cf4SFabien Sanglard // Attempts to create a new TXT record from the provided set of strings,
27*3f982cf4SFabien Sanglard // returning a TxtRecord on success or an error if the provided strings are
28*3f982cf4SFabien Sanglard // not valid.
29*3f982cf4SFabien Sanglard ErrorOr<DnsSdTxtRecord> CreateFromDnsTxt(const TxtRecordRdata& txt);
30*3f982cf4SFabien Sanglard 
31*3f982cf4SFabien Sanglard bool IsPtrRecord(const MdnsRecord& record);
32*3f982cf4SFabien Sanglard 
33*3f982cf4SFabien Sanglard // Checks that the instance, service, and domain ids in this instance are valid.
34*3f982cf4SFabien Sanglard bool HasValidDnsRecordAddress(const MdnsRecord& record);
35*3f982cf4SFabien Sanglard bool HasValidDnsRecordAddress(const DomainName& domain);
36*3f982cf4SFabien Sanglard 
37*3f982cf4SFabien Sanglard //*** Conversions to DNS entities from DNS-SD Entities ***
38*3f982cf4SFabien Sanglard 
39*3f982cf4SFabien Sanglard // Returns the Domain Name associated with this InstanceKey.
40*3f982cf4SFabien Sanglard DomainName GetDomainName(const InstanceKey& key);
41*3f982cf4SFabien Sanglard 
42*3f982cf4SFabien Sanglard // Returns the domain name associated with this MdnsRecord. In the case of a PTR
43*3f982cf4SFabien Sanglard // record, this is the target domain, and it is the named domain in all other
44*3f982cf4SFabien Sanglard // cases.
45*3f982cf4SFabien Sanglard DomainName GetDomainName(const MdnsRecord& record);
46*3f982cf4SFabien Sanglard 
47*3f982cf4SFabien Sanglard // Returns the query required to get all instance information about the service
48*3f982cf4SFabien Sanglard // instances described by the provided InstanceKey.
49*3f982cf4SFabien Sanglard DnsQueryInfo GetInstanceQueryInfo(const InstanceKey& key);
50*3f982cf4SFabien Sanglard 
51*3f982cf4SFabien Sanglard // Returns the query required to get all service information that matches the
52*3f982cf4SFabien Sanglard // provided key.
53*3f982cf4SFabien Sanglard DnsQueryInfo GetPtrQueryInfo(const ServiceKey& key);
54*3f982cf4SFabien Sanglard 
55*3f982cf4SFabien Sanglard // Returns all MdnsRecord entities generated from this object.
56*3f982cf4SFabien Sanglard std::vector<MdnsRecord> GetDnsRecords(const DnsSdInstanceEndpoint& endpoint);
57*3f982cf4SFabien Sanglard std::vector<MdnsRecord> GetDnsRecords(const DnsSdInstance& instance);
58*3f982cf4SFabien Sanglard 
59*3f982cf4SFabien Sanglard }  // namespace discovery
60*3f982cf4SFabien Sanglard }  // namespace openscreen
61*3f982cf4SFabien Sanglard 
62*3f982cf4SFabien Sanglard #endif  // DISCOVERY_DNSSD_IMPL_CONVERSION_LAYER_H_
63