X-Git-Url: https://git.saurik.com/apple/mdnsresponder.git/blobdiff_plain/8e92c31c9a45a66732f5bc7afbc9f5596c17e91d..8ec81f6c99056f5c63e0045ca48a7c405058254b:/mDNSShared/Java/DNSSDRegistration.java

diff --git a/mDNSShared/Java/DNSSDRegistration.java b/mDNSShared/Java/DNSSDRegistration.java
index 7be186d..720df0b 100644
--- a/mDNSShared/Java/DNSSDRegistration.java
+++ b/mDNSShared/Java/DNSSDRegistration.java
@@ -1,36 +1,18 @@
-/*
+/* -*- Mode: Java; tab-width: 4 -*-
+ *
  * Copyright (c) 2004 Apple Computer, Inc. All rights reserved.
  *
- * @APPLE_LICENSE_HEADER_START@
- * 
- * Copyright (c) 1999-2003 Apple Computer, Inc.  All Rights Reserved.
+ * 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
  * 
- * This file contains Original Code and/or Modifications of Original Code
- * as defined in and that are subject to the Apple Public Source License
- * Version 2.0 (the 'License'). You may not use this file except in
- * compliance with the License. Please obtain a copy of the License at
- * http://www.opensource.apple.com/apsl/ and read it before using this
- * file.
+ *     http://www.apache.org/licenses/LICENSE-2.0
  * 
- * The Original Code and all software distributed under the License are
- * distributed on an 'AS IS' basis, WITHOUT WARRANTY OF ANY KIND, EITHER
- * EXPRESS OR IMPLIED, AND APPLE HEREBY DISCLAIMS ALL SUCH WARRANTIES,
- * INCLUDING WITHOUT LIMITATION, ANY WARRANTIES OF MERCHANTABILITY,
- * FITNESS FOR A PARTICULAR PURPOSE, QUIET ENJOYMENT OR NON-INFRINGEMENT.
- * Please see the License for the specific language governing rights and
+ * 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.
- * 
- * @APPLE_LICENSE_HEADER_END@
-
-    Change History (most recent first):
-
-$Log: DNSSDRegistration.java,v $
-Revision 1.1  2004/04/30 16:32:34  rpantos
-First checked in.
-
-
-	This file declares the public interface to DNSSDRegistration, a DNSSDService
-	subclass that allows a client to control a service registration.
  */
 
 
@@ -41,10 +23,20 @@ package	com.apple.dnssd;
 
 public interface	DNSSDRegistration extends DNSSDService
 {
+	/** Get a reference to the primary TXT record of a registered service.<P> 
+		The record can be updated by sending it an update() message.<P>
+
+		<P>
+		@return		A {@link DNSRecord}. 
+					If {@link DNSSDRegistration#stop} is called, the DNSRecord is also 
+					invalidated and may not be used further.
+	*/
+	DNSRecord		getTXTRecord()
+	throws DNSSDException;
+
 	/** Add a record to a registered service.<P> 
 		The name of the record will be the same as the registered service's name.<P>
-		The record can later be updated or deregistered by passing the DNSRecord returned 
-		by this function to updateRecord() or removeRecord().<P>
+		The record can be updated or deregistered by sending it an update() or remove() message.<P>
 
 		@param	flags
 					Currently unused, reserved for future use.
@@ -64,37 +56,5 @@ public interface	DNSSDRegistration extends DNSSDService
 	*/
 	DNSRecord		addRecord( int flags, int rrType, byte[] rData, int ttl)
 	throws DNSSDException;
-
-	/** Update a registered resource record.<P> 
-		The record must either be the primary txt record of a service registered via DNSSD.register(), 
-		or a record added to a registered service via addRecord().<P>
-
-		@param	record
-					A DNSRecord initialized by addRecord(), or null to update the
-					service's primary txt record.
-		<P>
-		@param	flags
-					Currently unused, reserved for future use.
-		<P>
-		@param	rData
-					The new rdata to be contained in the updated resource record.
-		<P>
-		@param	ttl
-					The time to live of the updated resource record, in seconds.
-	*/
-	void			updateRecord( DNSRecord record, int flags, byte[] rData, int ttl)
-	throws DNSSDException;
-
-	/** Remove a registered resource record.<P> 
-		The record must have been previously added to a service record set via via addRecord().<P>
-
-		@param	record
-					A DNSRecord initialized by addRecord().
-		<P>
-		@param	flags
-					Currently unused, reserved for future use.
-	*/
-	void			removeRecord( DNSRecord record, int flags)
-	throws DNSSDException;
 }