ResolveListener.java revision 4904:cd464a980538 
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: ResolveListener.java,v $
20Revision 1.3  2006/08/14 23:25:08  cheshire
21Re-licensed mDNSResponder daemon source code under Apache License, Version 2.0
22
23Revision 1.2  2004/04/30 21:48:27  rpantos
24Change line endings for CVS.
25
26Revision 1.1  2004/04/30 16:29:35  rpantos
27First checked in.
28
29ident	"%Z%%M%	%I%	%E% SMI"
30
31*/
32
33
34package	com.apple.dnssd;
35
36
37/**	A listener that receives results from {@link DNSSD#resolve}. */
38
39public interface ResolveListener extends BaseListener
40{
41	/** Called when a service has been resolved.<P>
42
43		@param	resolver
44					The active resolver object.
45		<P>
46		@param	flags
47					Currently unused, reserved for future use.
48		<P>
49		@param	fullName
50					The full service domain name, in the form &lt;servicename&gt;.&lt;protocol&gt;.&lt;domain&gt;.
51					(Any literal dots (".") are escaped with a backslash ("\."), and literal
52					backslashes are escaped with a second backslash ("\\"), e.g. a web server
53					named "Dr. Pepper" would have the fullname  "Dr\.\032Pepper._http._tcp.local.").
54					This is the appropriate format to pass to standard system DNS APIs such as
55					res_query(), or to the special-purpose functions included in this API that
56					take fullname parameters.
57		<P>
58		@param	hostName
59					The target hostname of the machine providing the service.  This name can
60					be passed to functions like queryRecord() to look up the host's IP address.
61		<P>
62		@param	port
63					The port number on which connections are accepted for this service.
64		<P>
65		@param	txtRecord
66					The service's primary txt record.
67	*/
68	void	serviceResolved( DNSSDService resolver, int flags, int ifIndex, String fullName,
69								String hostName, int port, TXTRecord txtRecord);
70}
71
72