mDNSShared/Java/BrowseListener.java

   1 /*
   2  * Copyright (c) 2004 Apple Computer, Inc. All rights reserved.
   3  *
   4  * @APPLE_LICENSE_HEADER_START@
   5  *
   6  * Copyright (c) 1999-2003 Apple Computer, Inc.  All Rights Reserved.
   7  *
   8  * This file contains Original Code and/or Modifications of Original Code
   9  * as defined in and that are subject to the Apple Public Source License
  10  * Version 2.0 (the 'License'). You may not use this file except in
  11  * compliance with the License. Please obtain a copy of the License at
  12  * http://www.opensource.apple.com/apsl/ and read it before using this
  13  * file.
  14  *
  15  * The Original Code and all software distributed under the License are
  16  * distributed on an 'AS IS' basis, WITHOUT WARRANTY OF ANY KIND, EITHER
  17  * EXPRESS OR IMPLIED, AND APPLE HEREBY DISCLAIMS ALL SUCH WARRANTIES,
  18  * INCLUDING WITHOUT LIMITATION, ANY WARRANTIES OF MERCHANTABILITY,
  19  * FITNESS FOR A PARTICULAR PURPOSE, QUIET ENJOYMENT OR NON-INFRINGEMENT.
  20  * Please see the License for the specific language governing rights and
  21  * limitations under the License.
  22  *
  23  * @APPLE_LICENSE_HEADER_END@
  24
  25     Change History (most recent first):
  26
  27 $Log: BrowseListener.java,v $
  28 Revision 1.2  2004/04/30 21:48:27  rpantos
  29 Change line endings for CVS.
  30
  31 Revision 1.1  2004/04/30 16:29:35  rpantos
  32 First checked in.
  33
  34  */
  35
  36
  37 package com.apple.dnssd;
  38
  39
  40 /**     A listener that receives results from {@link DNSSD#browse}. */
  41
  42 public interface BrowseListener extends BaseListener
  43 {
  44         /** Called to report discovered services.<P>
  45
  46                 @param  browser
  47                                         The active browse service.
  48                 <P>
  49                 @param  flags
  50                                         Possible values are DNSSD.MORE_COMING.
  51                 <P>
  52                 @param  ifIndex
  53                                         The interface on which the service is advertised. This index should be passed
  54                                         to {@link DNSSD#resolve} when resolving the service.
  55                 <P>
  56                 @param  serviceName
  57                                         The service name discovered.
  58                 <P>
  59                 @param  regType
  60                                         The registration type, as passed in to DNSSD.browse().
  61                 <P>
  62                 @param  domain
  63                                         The domain in which the service was discovered.
  64         */
  65         void    serviceFound( DNSSDService browser, int flags, int ifIndex,
  66                                                         String serviceName, String regType, String domain);
  67
  68         /** Called to report services which have been deregistered.<P>
  69
  70                 @param  browser
  71                                         The active browse service.
  72                 <P>
  73                 @param  flags
  74                                         Possible values are DNSSD.MORE_COMING.
  75                 <P>
  76                 @param  ifIndex
  77                                         The interface on which the service is advertised.
  78                 <P>
  79                 @param  serviceName
  80                                         The service name which has deregistered.
  81                 <P>
  82                 @param  regType
  83                                         The registration type, as passed in to DNSSD.browse().
  84                 <P>
  85                 @param  domain
  86                                         The domain in which the service was discovered.
  87         */
  88         void    serviceLost( DNSSDService browser, int flags, int ifIndex,
  89                                                         String serviceName, String regType, String domain);
  90 }
  91