mDNSShared/Java/DNSSDService.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 /**     A tracking object for a service created by {@link DNSSD}. */
  22
  23 public interface        DNSSDService
  24 {
  25         /**
  26         Halt the active operation and free resources associated with the DNSSDService.<P>
  27
  28         Any services or records registered with this DNSSDService will be deregistered. Any
  29         Browse, Resolve, or Query operations associated with this reference will be terminated.<P>
  30
  31         Note: if the service was initialized with DNSSD.register(), and an extra resource record was
  32         added to the service via {@link DNSSDRegistration#addRecord}, the DNSRecord so created
  33         is invalidated when this method is called - the DNSRecord may not be used afterward.
  34         */
  35         void            stop();
  36 }
  37