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 60