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
19package	com.apple.dnssd;
20
21
22/**	A listener that receives results from {@link DNSSD#queryRecord}. */
23
24public 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