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#resolve}. */
23
24public interface ResolveListener extends BaseListener
25{
26	/** Called when a service has been resolved.<P>
27
28		@param	resolver
29					The active resolver object.
30		<P>
31		@param	flags
32					Currently unused, reserved for future use.
33		<P>
34		@param	fullName
35					The full service domain name, in the form &lt;servicename&gt;.&lt;protocol&gt;.&lt;domain&gt;.
36					(Any literal dots (".") are escaped with a backslash ("\."), and literal
37					backslashes are escaped with a second backslash ("\\"), e.g. a web server
38					named "Dr. Pepper" would have the fullname  "Dr\.\032Pepper._http._tcp.local.").
39					This is the appropriate format to pass to standard system DNS APIs such as
40					res_query(), or to the special-purpose functions included in this API that
41					take fullname parameters.
42		<P>
43		@param	hostName
44					The target hostname of the machine providing the service.  This name can
45					be passed to functions like queryRecord() to look up the host's IP address.
46		<P>
47		@param	port
48					The port number on which connections are accepted for this service.
49		<P>
50		@param	txtRecord
51					The service's primary txt record.
52	*/
53	void	serviceResolved( DNSSDService resolver, int flags, int ifIndex, String fullName,
54								String hostName, int port, TXTRecord txtRecord);
55}
56
57