mDNSShared/Java/QueryListener.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: QueryListener.java,v $
  20 Revision 1.4  2007/03/12 23:43:08  vazquez
  21 <rdar://problem/4169128> Documentation: Error in Java queryAnswered doc
  22
  23 Revision 1.3  2006/08/14 23:25:08  cheshire
  24 Re-licensed mDNSResponder daemon source code under Apache License, Version 2.0
  25
  26 Revision 1.2  2004/04/30 21:48:27  rpantos
  27 Change line endings for CVS.
  28
  29 Revision 1.1  2004/04/30 16:29:35  rpantos
  30 First checked in.
  31
  32  */
  33
  34
  35 package com.apple.dnssd;
  36
  37
  38 /**     A listener that receives results from {@link DNSSD#queryRecord}. */
  39
  40 public interface QueryListener extends BaseListener
  41 {
  42         /** Called when a record query has been completed. Inspect flags
  43             parameter to determine nature of query event.<P>
  44
  45                 @param  query
  46                                         The active query object.
  47                 <P>
  48                 @param  flags
  49                                         If kDNSServiceFlagsAdd bit is set, this is a newly discovered answer;
  50                                         otherwise this is a previously discovered answer which has expired.
  51                                         Other possible values are DNSSD.MORE_COMING.
  52                 <P>
  53                 @param  ifIndex
  54                                         The interface on which the query was resolved. (The index for a given
  55                                         interface is determined via the if_nametoindex() family of calls.)
  56                 <P>
  57                 @param  fullName
  58                                         The resource record's full domain name.
  59                 <P>
  60                 @param  rrtype
  61                                         The resource record's type (e.g. PTR, SRV, etc) as defined by RFC 1035 and its updates.
  62                 <P>
  63                 @param  rrclass
  64                                         The class of the resource record, as defined by RFC 1035 and its updates.
  65                 <P>
  66                 @param  rdata
  67                                         The raw rdata of the resource record.
  68                 <P>
  69                 @param  ttl
  70                                         The resource record's time to live, in seconds.
  71         */
  72         void    queryAnswered( DNSSDService query, int flags, int ifIndex, String fullName,
  73                                                                 int rrtype, int rrclass, byte[] rdata, int ttl);
  74 }
  75