mDNSShared/Java/ResolveListener.java

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