blob: e5c8ffe65b1c223e04d6ae2c5aea4c97a72bc59b (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
|
/*
* CDDL HEADER START
*
* The contents of this file are subject to the terms of the
* Common Development and Distribution License (the "License").
* You may not use this file except in compliance with the License.
*
* You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
* or http://www.opensolaris.org/os/licensing.
* See the License for the specific language governing permissions
* and limitations under the License.
*
* When distributing Covered Code, include this CDDL HEADER in each
* file and include the License file at usr/src/OPENSOLARIS.LICENSE.
* If applicable, add the following below this CDDL HEADER, with the
* fields enclosed by brackets "[]" replaced with your own identifying
* information: Portions Copyright [yyyy] [name of copyright owner]
*
* CDDL HEADER END
*/
/*
* Copyright (c) 1999 by Sun Microsystems, Inc.
* All rights reserved.
*
*/
// ServiceAgent.java: Interface for the SLP Service Agent operations
// Author: James Kempf
// Created On: Mon Jul 7 09:05:40 1997
// Last Modified By: James Kempf
// Last Modified On: Thu Jan 7 14:17:12 1999
// Update Count: 16
//
package com.sun.slp;
import java.util.*;
/**
* The Advertiser interface allows clients to register new service
* instances with SLP and to change the attributes of existing services.
*
* @see ServiceLocationManager
*
* @author James Kempf, Erik Guttman
*/
public interface Advertiser {
/**
* Return the Advertiser's locale object.
*
* @return The Locale object.
*/
Locale getLocale();
/**
* Register a new service with the service location protocol in
* the Advertiser's locale.
*
* @param URL The service URL for the service.
* @param serviceLocationAttributes A vector of ServiceLocationAttribute
* objects describing the service.
* @exception ServiceLocationException An exception is thrown if the
* registration fails.
* @exception IllegalArgumentException A parameter is null or
* otherwise invalid.
*
*/
public void register(ServiceURL URL,
Vector serviceLocationAttributes)
throws ServiceLocationException;
/**
* Deregister a service with the service location protocol.
* This has the effect of deregistering the service from <b>every</b>
* Locale and scope under which it was registered.
*
* @param URL The service URL for the service.
* @exception ServiceLocationException An exception is thrown if the
* deregistration fails.
*/
public void deregister(ServiceURL URL)
throws ServiceLocationException;
/**
* Add attributes to a service URL in the locale of the Advertiser.
*
* Note that due to SLP v1 update semantics, the URL will be registered
* if it is not already.
*
*
* @param URL The service URL for the service.
* @param serviceLocationAttributes A vector of ServiceLocationAttribute
* objects to add.
* @exception ServiceLocationException An exception is thrown if the
* operation fails.
*/
public void addAttributes(ServiceURL URL,
Vector serviceLocationAttributes)
throws ServiceLocationException;
/**
* Delete the attributes from a service URL in the locale of
* the Advertiser. The deletions are made for all scopes in
* which the URL is registered.
*
*
* @param URL The service URL for the service.
* @param attributeIds A vector of Strings indicating
* the attributes to remove.
* @exception ServiceLocationException An exception is thrown if the
* operation fails.
*/
public void deleteAttributes(ServiceURL URL,
Vector attributeIds)
throws ServiceLocationException;
}
|