DNSRecord.java revision 4904:cd464a980538
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: DNSRecord.java,v $
20Revision 1.3  2006/08/14 23:25:08  cheshire
21Re-licensed mDNSResponder daemon source code under Apache License, Version 2.0
22
23Revision 1.2  2004/12/11 03:00:59  rpantos
24<rdar://problem/3907498> Java DNSRecord API should be cleaned up
25
26Revision 1.1  2004/04/30 16:32:34  rpantos
27First checked in.
28
29
30ident	"%Z%%M%	%I%	%E% SMI"
31
32 */
33
34
35package	com.apple.dnssd;
36
37
38/**
39	Reference to a record returned by {@link DNSSDRegistration#addRecord}.<P>
40
41	Note: client is responsible for serializing access to these objects if
42	they are shared between concurrent threads.
43*/
44
45public interface	DNSRecord
46{
47	/** Update a registered resource record.<P>
48		The record must either be the primary txt record of a service registered via DNSSD.register(),
49		or a record added to a registered service via addRecord().<P>
50
51		@param	flags
52					Currently unused, reserved for future use.
53		<P>
54		@param	rData
55					The new rdata to be contained in the updated resource record.
56		<P>
57		@param	ttl
58					The time to live of the updated resource record, in seconds.
59	*/
60	void			update( int flags, byte[] rData, int ttl)
61	throws DNSSDException;
62
63	/** Remove a registered resource record.<P>
64	*/
65	void			remove()
66	throws DNSSDException;
67}
68
69