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
  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 &lt;servicename&gt;.&lt;protocol&gt;.&lt;domain&gt;.
  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