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 */ serviceResolved( DNSSDService resolver, int flags, int ifIndex, String fullName, String hostName, int port, TXTRecord txtRecord)53 void serviceResolved( DNSSDService resolver, int flags, int ifIndex, String fullName, 54 String hostName, int port, TXTRecord txtRecord); 55 } 56 57