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 $ 20 Revision 1.3 2006/08/14 23:25:08 cheshire 21 Re-licensed mDNSResponder daemon source code under Apache License, Version 2.0 22 23 Revision 1.2 2004/04/30 21:48:27 rpantos 24 Change line endings for CVS. 25 26 Revision 1.1 2004/04/30 16:29:35 rpantos 27 First checked in. 28 29 ident "%Z%%M% %I% %E% SMI" 30 31 */ 32 33 34 package com.apple.dnssd; 35 36 37 /** A listener that receives results from {@link DNSSD#resolve}. */ 38 39 public 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 <servicename>.<protocol>.<domain>. 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 */ serviceResolved( DNSSDService resolver, int flags, int ifIndex, String fullName, String hostName, int port, TXTRecord txtRecord)68 void serviceResolved( DNSSDService resolver, int flags, int ifIndex, String fullName, 69 String hostName, int port, TXTRecord txtRecord); 70 } 71 72