mDNSResponder-320.5.1.tar.gz

[apple/mdnsresponder.git] / mDNSShared / Java / DNSSDRegistration.java

diff --git a/mDNSShared/Java/DNSSDRegistration.java b/mDNSShared/Java/DNSSDRegistration.java
index 7be186d061f964fa20a5d8cb0dc92e7031e56a40..720df0b8471c22ed130bea593b3593f462a5dfc1 100644 (file)
--- 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;
 }