You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
122 lines
3.3 KiB
122 lines
3.3 KiB
15 years ago
|
/* This file is part of the KDE project
|
||
|
|
*
|
||
|
|
* Copyright (C) 2004 Jakub Stachowski <qbast@go2.pl>
|
||
|
|
*
|
||
|
|
* This library is free software; you can redistribute it and/or
|
||
|
|
* modify it under the terms of the GNU Library General Public
|
||
|
|
* License as published by the Free Software Foundation; either
|
||
|
|
* version 2 of the License, or (at your option) any later version.
|
||
|
|
*
|
||
|
|
* This library is distributed in the hope that it will be useful,
|
||
|
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
||
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
|
||
|
|
* Library General Public License for more details.
|
||
|
|
*
|
||
|
|
* You should have received a copy of the GNU Library General Public License
|
||
|
|
* along with this library; see the file COPYING.LIB. If not, write to
|
||
|
|
* the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
|
||
|
|
* Boston, MA 02110-1301, USA.
|
||
|
|
*/
|
||
|
|
|
||
|
|
#ifndef DNSSDSERVICEBASE_H
|
||
|
|
#define DNSSDSERVICEBASE_H
|
||
|
|
|
||
|
|
#include <qmap.h>
|
||
|
|
#include <ksharedptr.h>
|
||
|
|
|
||
|
|
class QString;
|
||
|
|
class QDataStream;
|
||
|
|
namespace DNSSD
|
||
|
|
{
|
||
|
|
class ServiceBasePrivate;
|
||
|
|
|
||
|
|
/**
|
||
|
|
This class is used to carry information about service. It can be remote, local,
|
||
|
|
metaservice or domain. Metaservice has only type and domain - it means that
|
||
|
|
services of given type are present in given domain.
|
||
|
|
@short Describes any type of service.
|
||
|
|
@author Jakub Stachowski
|
||
|
|
*/
|
||
|
|
class KDNSSD_EXPORT ServiceBase : public KShared
|
||
|
|
{
|
||
|
|
public:
|
||
|
|
typedef KSharedPtr<ServiceBase> Ptr;
|
||
|
|
|
||
|
|
/**
|
||
|
|
@param name Service name - empty for metaservices
|
||
|
|
@param type Service type - empty for domains
|
||
|
|
@param domain Domain name
|
||
|
|
@param host Host name
|
||
|
|
@param port Port number
|
||
|
|
*/
|
||
|
|
ServiceBase(const QString& name=QString::null,const QString& type=QString::null,
|
||
|
|
const QString& domain=QString::null, const QString& host=QString::null,
|
||
|
|
unsigned short port=0);
|
||
|
|
|
||
|
|
virtual ~ServiceBase();
|
||
|
|
|
||
|
|
/**
|
||
|
|
Returns name of service. This is empty for metaservices
|
||
|
|
*/
|
||
|
|
const QString& serviceName() const;
|
||
|
|
|
||
|
|
/**
|
||
|
|
Returns type of service. It always in format _sometype._udp or _sometype._tcp and
|
||
|
|
it is empty for domains.
|
||
|
|
*/
|
||
|
|
const QString& type() const;
|
||
|
|
|
||
|
|
/**
|
||
|
|
Returns domain that given service belongs to. It is "local." for link-local services.
|
||
|
|
*/
|
||
|
|
const QString& domain() const;
|
||
|
|
|
||
|
|
/**
|
||
|
|
Returns hostname. It is only valid for local and resolved remote services.
|
||
|
|
*/
|
||
|
|
const QString& hostName() const;
|
||
|
|
|
||
|
|
/**
|
||
|
|
Returns port number. It is only valid for local and resolved remote services.
|
||
|
|
*/
|
||
|
|
unsigned short port() const;
|
||
|
|
|
||
|
|
/**
|
||
|
|
Returns read only map of text properties. It is only valid for local and resolved remote services.
|
||
|
|
*/
|
||
|
|
const QMap<QString,QString>& textData() const;
|
||
|
|
|
||
|
|
protected:
|
||
|
|
QString m_serviceName;
|
||
|
|
QString m_type;
|
||
|
|
QString m_domain;
|
||
|
|
QString m_hostName;
|
||
|
|
unsigned short m_port;
|
||
|
|
|
||
|
|
/**
|
||
|
|
Map of TXT properties
|
||
|
|
*/
|
||
|
|
QMap<QString,QString> m_textData;
|
||
|
|
/**
|
||
|
|
Encode service name, type and domain into string that can be used as DNS-SD PTR label
|
||
|
|
*/
|
||
|
|
QString encode();
|
||
|
|
/**
|
||
|
|
Decode PTR label returned by DNS resolver into service name, type and domain. It also
|
||
|
|
handles special cases - metaservices and domains.
|
||
|
|
*/
|
||
|
|
void decode(const QString& name);
|
||
|
|
|
||
|
|
friend KDNSSD_EXPORT QDataStream & operator<< (QDataStream & s, const ServiceBase & a);
|
||
|
|
friend KDNSSD_EXPORT QDataStream & operator>> (QDataStream & s, ServiceBase & a);
|
||
|
|
|
||
|
|
virtual void virtual_hook(int, void*);
|
||
|
|
private:
|
||
|
|
ServiceBasePrivate* d;
|
||
|
|
|
||
|
|
};
|
||
|
|
|
||
|
|
}
|
||
|
|
|
||
|
|
#endif
|