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
  18
  19 package com.apple.dnssd;
  20
  21
  22 /**     A listener that receives results from {@link DNSSD#queryRecord}. */
  23
  24 public interface QueryListener extends BaseListener
  25 {
  26         /** Called when a record query has been completed. Inspect flags
  27             parameter to determine nature of query event.<P>
  28
  29                 @param  query
  30                                         The active query object.
  31                 <P>
  32                 @param  flags
  33                                         If kDNSServiceFlagsAdd bit is set, this is a newly discovered answer;
  34                                         otherwise this is a previously discovered answer which has expired.
  35                                         Other possible values are DNSSD.MORE_COMING.
  36                 <P>
  37                 @param  ifIndex
  38                                         The interface on which the query was resolved. (The index for a given
  39                                         interface is determined via the if_nametoindex() family of calls.)
  40                 <P>
  41                 @param  fullName
  42                                         The resource record's full domain name.
  43                 <P>
  44                 @param  rrtype
  45                                         The resource record's type (e.g. PTR, SRV, etc) as defined by RFC 1035 and its updates.
  46                 <P>
  47                 @param  rrclass
  48                                         The class of the resource record, as defined by RFC 1035 and its updates.
  49                 <P>
  50                 @param  rdata
  51                                         The raw rdata of the resource record.
  52                 <P>
  53                 @param  ttl
  54                                         The resource record's time to live, in seconds.
  55         */
  56         void    queryAnswered( DNSSDService query, int flags, int ifIndex, String fullName,
  57                                                                 int rrtype, int rrclass, byte[] rdata, int ttl);
  58 }
  59