Copy the KDE 3.5 branch to branches/trinity for new KDE 3.5 features.

BUG:215923


git-svn-id: svn://anonsvn.kde.org/home/kde/branches/trinity/kdelibs@1054174 283d02a7-25f6-0310-bc7c-ecb5cbfe19da

1 files changed, 111 insertions, 0 deletions

diff --git a/dnssd/remoteservice.h b/dnssd/remoteservice.h
new file mode 100644
index 000000000..220331b5f
--- /dev/null
+++ b/dnssd/remoteservice.h
@@ -0,0 +1,111 @@
+/* This file is part of the KDE project
+ *
+ * Copyright (C) 2004, 2005 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 DNSSDREMOTESERVICE_H
+#define DNSSDREMOTESERVICE_H
+
+#include <qobject.h>
+#include <dnssd/servicebase.h>
+
+class QDataStream;
+class KURL;
+namespace DNSSD
+{
+class RemoteServicePrivate;
+
+/**
+RemoteService class allows to resolve service announced on remote machine. In most cases objects
+of this class are created by ServiceBrowser, but it is not required. Only fields valid before 
+service is resolved are name, type.and domain. 
+ 
+ 
+@short class representing service announced on remote machine.
+@author Jakub Stachowski
+ */
+class KDNSSD_EXPORT RemoteService : public QObject, public ServiceBase
+{
+	Q_OBJECT
+public:
+	typedef KSharedPtr<RemoteService> Ptr;
+	
+	/**
+	Creates unresolved service from given DNS label
+	@param label Data returned by PTR query - it is decoded into name, type and 
+	domain
+	 */
+	RemoteService(const QString& label);
+	
+	/**
+	Creates unresolved remote service with given name, type and domain.
+	 */
+	RemoteService(const QString& name,const QString& type,const QString& domain);
+	
+	/**
+	Creates resolved remote service from invitation URL constructed by PublicService::toInvitation.
+	If URL was invalid, service is set to unresolved and other fields should not be used.
+	 */
+	RemoteService(const KURL& url);
+	
+	virtual ~RemoteService();
+	
+	/**
+	Resolves host name and port of service. Host name is not resolved into numeric
+	address - use KResolver for that. Signal resolved(bool) will be emitted 
+	when finished or even before return of this function - in case of immediate failure.
+	 */
+	void resolveAsync();
+	
+	/**
+	Synchronous version of resolveAsync(). Note that resolved(bool) is emitted 
+	before this function returns, 
+	@return TRUE is successful
+	 */
+	bool resolve();
+	
+	/**
+	Returns true if service has been successfully resolved
+	 */
+	bool isResolved() const;
+	
+signals:
+	/**
+	Emitted when resolving is complete. Parameter is set to TRUE if it was successful.
+	If operating in asynchronous mode this signal can be emitted several times (when 
+	service change)
+	 */
+	void resolved(bool);
+
+protected:
+	virtual void virtual_hook(int id, void *data);
+	virtual void customEvent(QCustomEvent* event);
+private:
+	void resolveError();
+	void resolved(const char *host, unsigned short port, unsigned short txtlen,
+		const char* txtRecord);
+	RemoteServicePrivate *d;
+
+	friend KDNSSD_EXPORT QDataStream & operator<< (QDataStream & s, const RemoteService & a);
+	friend KDNSSD_EXPORT QDataStream & operator>> (QDataStream & s, RemoteService & a);
+
+};
+
+}
+
+#endif