X-Git-Url: https://git.saurik.com/apple/mdnsresponder.git/blobdiff_plain/8e92c31c9a45a66732f5bc7afbc9f5596c17e91d..f5e6e86cb0d7e0c7608c30d93ecb200173f29055:/mDNSShared/Java/DNSSDRegistration.java diff --git a/mDNSShared/Java/DNSSDRegistration.java b/mDNSShared/Java/DNSSDRegistration.java index 7be186d..4a4942f 100644 --- a/mDNSShared/Java/DNSSDRegistration.java +++ b/mDNSShared/Java/DNSSDRegistration.java @@ -3,8 +3,6 @@ * * @APPLE_LICENSE_HEADER_START@ * - * Copyright (c) 1999-2003 Apple Computer, Inc. All Rights Reserved. - * * 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 @@ -25,6 +23,9 @@ Change History (most recent first): $Log: DNSSDRegistration.java,v $ +Revision 1.2 2004/12/11 03:01:00 rpantos + Java DNSRecord API should be cleaned up + Revision 1.1 2004/04/30 16:32:34 rpantos First checked in. @@ -41,10 +42,20 @@ package com.apple.dnssd; public interface DNSSDRegistration extends DNSSDService { + /** Get a reference to the primary TXT record of a registered service.

+ The record can be updated by sending it an update() message.

+ +

+ @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.

The name of the record will be the same as the registered service's name.

- The record can later be updated or deregistered by passing the DNSRecord returned - by this function to updateRecord() or removeRecord().

+ The record can be updated or deregistered by sending it an update() or remove() message.

@param flags Currently unused, reserved for future use. @@ -64,37 +75,5 @@ public interface DNSSDRegistration extends DNSSDService */ DNSRecord addRecord( int flags, int rrType, byte[] rData, int ttl) throws DNSSDException; - - /** Update a registered resource record.

- 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().

- - @param record - A DNSRecord initialized by addRecord(), or null to update the - service's primary txt record. -

- @param flags - Currently unused, reserved for future use. -

- @param rData - The new rdata to be contained in the updated resource record. -

- @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.

- The record must have been previously added to a service record set via via addRecord().

- - @param record - A DNSRecord initialized by addRecord(). -

- @param flags - Currently unused, reserved for future use. - */ - void removeRecord( DNSRecord record, int flags) - throws DNSSDException; }