mDNSShared/Java/DNSRecord.java

   1 /* -*- Mode: Java; tab-width: 4 -*-
   2  *
   3  * Copyright (c) 2004 Apple Computer, Inc. All rights reserved.
   4  *
   5  * Licensed under the Apache License, Version 2.0 (the "License");
   6  * you may not use this file except in compliance with the License.
   7  * You may obtain a copy of the License at
   8  *
   9  *     http://www.apache.org/licenses/LICENSE-2.0
  10  *
  11  * Unless required by applicable law or agreed to in writing, software
  12  * distributed under the License is distributed on an "AS IS" BASIS,
  13  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  14  * See the License for the specific language governing permissions and
  15  * limitations under the License.
  16
  17     Change History (most recent first):
  18
  19 $Log: DNSRecord.java,v $
  20 Revision 1.3  2006/08/14 23:25:08  cheshire
  21 Re-licensed mDNSResponder daemon source code under Apache License, Version 2.0
  22
  23 Revision 1.2  2004/12/11 03:00:59  rpantos
  24 <rdar://problem/3907498> Java DNSRecord API should be cleaned up
  25
  26 Revision 1.1  2004/04/30 16:32:34  rpantos
  27 First checked in.
  28
  29
  30  */
  31
  32
  33 package com.apple.dnssd;
  34
  35
  36 /**
  37         Reference to a record returned by {@link DNSSDRegistration#addRecord}.<P>
  38
  39         Note: client is responsible for serializing access to these objects if
  40         they are shared between concurrent threads.
  41 */
  42
  43 public interface        DNSRecord
  44 {
  45         /** Update a registered resource record.<P>
  46                 The record must either be the primary txt record of a service registered via DNSSD.register(),
  47                 or a record added to a registered service via addRecord().<P>
  48
  49                 @param  flags
  50                                         Currently unused, reserved for future use.
  51                 <P>
  52                 @param  rData
  53                                         The new rdata to be contained in the updated resource record.
  54                 <P>
  55                 @param  ttl
  56                                         The time to live of the updated resource record, in seconds.
  57         */
  58         void                    update( int flags, byte[] rData, int ttl)
  59         throws DNSSDException;
  60
  61         /** Remove a registered resource record.<P>
  62         */
  63         void                    remove()
  64         throws DNSSDException;
  65 }
  66