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#resolve}. */ 23 24 public 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 <servicename>.<protocol>.<domain>. 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