17c478bd9Sstevel@tonic-gate /* 27c478bd9Sstevel@tonic-gate * CDDL HEADER START 37c478bd9Sstevel@tonic-gate * 47c478bd9Sstevel@tonic-gate * The contents of this file are subject to the terms of the 59a70fc3bSMark J. Nelson * Common Development and Distribution License (the "License"). 69a70fc3bSMark J. Nelson * You may not use this file except in compliance with the License. 77c478bd9Sstevel@tonic-gate * 87c478bd9Sstevel@tonic-gate * You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE 97c478bd9Sstevel@tonic-gate * or http://www.opensolaris.org/os/licensing. 107c478bd9Sstevel@tonic-gate * See the License for the specific language governing permissions 117c478bd9Sstevel@tonic-gate * and limitations under the License. 127c478bd9Sstevel@tonic-gate * 137c478bd9Sstevel@tonic-gate * When distributing Covered Code, include this CDDL HEADER in each 147c478bd9Sstevel@tonic-gate * file and include the License file at usr/src/OPENSOLARIS.LICENSE. 157c478bd9Sstevel@tonic-gate * If applicable, add the following below this CDDL HEADER, with the 167c478bd9Sstevel@tonic-gate * fields enclosed by brackets "[]" replaced with your own identifying 177c478bd9Sstevel@tonic-gate * information: Portions Copyright [yyyy] [name of copyright owner] 187c478bd9Sstevel@tonic-gate * 197c478bd9Sstevel@tonic-gate * CDDL HEADER END 207c478bd9Sstevel@tonic-gate */ 217c478bd9Sstevel@tonic-gate /* 227c478bd9Sstevel@tonic-gate * Copyright (c) 1999 by Sun Microsystems, Inc. 237c478bd9Sstevel@tonic-gate * All rights reserved. 247c478bd9Sstevel@tonic-gate * 257c478bd9Sstevel@tonic-gate */ 267c478bd9Sstevel@tonic-gate 277c478bd9Sstevel@tonic-gate // ServiceAgent.java: Interface for the SLP Service Agent operations 287c478bd9Sstevel@tonic-gate // Author: James Kempf 297c478bd9Sstevel@tonic-gate // Created On: Mon Jul 7 09:05:40 1997 307c478bd9Sstevel@tonic-gate // Last Modified By: James Kempf 317c478bd9Sstevel@tonic-gate // Last Modified On: Thu Jan 7 14:17:12 1999 327c478bd9Sstevel@tonic-gate // Update Count: 16 337c478bd9Sstevel@tonic-gate // 347c478bd9Sstevel@tonic-gate 357c478bd9Sstevel@tonic-gate package com.sun.slp; 367c478bd9Sstevel@tonic-gate 377c478bd9Sstevel@tonic-gate import java.util.*; 387c478bd9Sstevel@tonic-gate 397c478bd9Sstevel@tonic-gate /** 407c478bd9Sstevel@tonic-gate * The Advertiser interface allows clients to register new service 417c478bd9Sstevel@tonic-gate * instances with SLP and to change the attributes of existing services. 427c478bd9Sstevel@tonic-gate * 437c478bd9Sstevel@tonic-gate * @see ServiceLocationManager 447c478bd9Sstevel@tonic-gate * 457c478bd9Sstevel@tonic-gate * @author James Kempf, Erik Guttman 467c478bd9Sstevel@tonic-gate */ 477c478bd9Sstevel@tonic-gate 487c478bd9Sstevel@tonic-gate public interface Advertiser { 497c478bd9Sstevel@tonic-gate 507c478bd9Sstevel@tonic-gate /** 51*55fea89dSDan Cross * Return the Advertiser's locale object. 527c478bd9Sstevel@tonic-gate * 537c478bd9Sstevel@tonic-gate * @return The Locale object. 547c478bd9Sstevel@tonic-gate */ 557c478bd9Sstevel@tonic-gate getLocale()567c478bd9Sstevel@tonic-gate Locale getLocale(); 577c478bd9Sstevel@tonic-gate 587c478bd9Sstevel@tonic-gate /** 597c478bd9Sstevel@tonic-gate * Register a new service with the service location protocol in 607c478bd9Sstevel@tonic-gate * the Advertiser's locale. 617c478bd9Sstevel@tonic-gate * 627c478bd9Sstevel@tonic-gate * @param URL The service URL for the service. 637c478bd9Sstevel@tonic-gate * @param serviceLocationAttributes A vector of ServiceLocationAttribute 647c478bd9Sstevel@tonic-gate * objects describing the service. 657c478bd9Sstevel@tonic-gate * @exception ServiceLocationException An exception is thrown if the 66*55fea89dSDan Cross * registration fails. 677c478bd9Sstevel@tonic-gate * @exception IllegalArgumentException A parameter is null or 687c478bd9Sstevel@tonic-gate * otherwise invalid. 697c478bd9Sstevel@tonic-gate * 707c478bd9Sstevel@tonic-gate */ 717c478bd9Sstevel@tonic-gate register(ServiceURL URL, Vector serviceLocationAttributes)727c478bd9Sstevel@tonic-gate public void register(ServiceURL URL, 737c478bd9Sstevel@tonic-gate Vector serviceLocationAttributes) 747c478bd9Sstevel@tonic-gate throws ServiceLocationException; 757c478bd9Sstevel@tonic-gate 767c478bd9Sstevel@tonic-gate /** 777c478bd9Sstevel@tonic-gate * Deregister a service with the service location protocol. 787c478bd9Sstevel@tonic-gate * This has the effect of deregistering the service from <b>every</b> 797c478bd9Sstevel@tonic-gate * Locale and scope under which it was registered. 807c478bd9Sstevel@tonic-gate * 817c478bd9Sstevel@tonic-gate * @param URL The service URL for the service. 827c478bd9Sstevel@tonic-gate * @exception ServiceLocationException An exception is thrown if the 837c478bd9Sstevel@tonic-gate * deregistration fails. 847c478bd9Sstevel@tonic-gate */ 857c478bd9Sstevel@tonic-gate deregister(ServiceURL URL)867c478bd9Sstevel@tonic-gate public void deregister(ServiceURL URL) 877c478bd9Sstevel@tonic-gate throws ServiceLocationException; 887c478bd9Sstevel@tonic-gate 897c478bd9Sstevel@tonic-gate /** 907c478bd9Sstevel@tonic-gate * Add attributes to a service URL in the locale of the Advertiser. 917c478bd9Sstevel@tonic-gate * 927c478bd9Sstevel@tonic-gate * Note that due to SLP v1 update semantics, the URL will be registered 937c478bd9Sstevel@tonic-gate * if it is not already. 947c478bd9Sstevel@tonic-gate * 957c478bd9Sstevel@tonic-gate * 967c478bd9Sstevel@tonic-gate * @param URL The service URL for the service. 977c478bd9Sstevel@tonic-gate * @param serviceLocationAttributes A vector of ServiceLocationAttribute 987c478bd9Sstevel@tonic-gate * objects to add. 997c478bd9Sstevel@tonic-gate * @exception ServiceLocationException An exception is thrown if the 1007c478bd9Sstevel@tonic-gate * operation fails. 1017c478bd9Sstevel@tonic-gate */ 1027c478bd9Sstevel@tonic-gate addAttributes(ServiceURL URL, Vector serviceLocationAttributes)1037c478bd9Sstevel@tonic-gate public void addAttributes(ServiceURL URL, 1047c478bd9Sstevel@tonic-gate Vector serviceLocationAttributes) 1057c478bd9Sstevel@tonic-gate throws ServiceLocationException; 1067c478bd9Sstevel@tonic-gate 1077c478bd9Sstevel@tonic-gate /** 1087c478bd9Sstevel@tonic-gate * Delete the attributes from a service URL in the locale of 1097c478bd9Sstevel@tonic-gate * the Advertiser. The deletions are made for all scopes in 1107c478bd9Sstevel@tonic-gate * which the URL is registered. 1117c478bd9Sstevel@tonic-gate * 1127c478bd9Sstevel@tonic-gate * 1137c478bd9Sstevel@tonic-gate * @param URL The service URL for the service. 1147c478bd9Sstevel@tonic-gate * @param attributeIds A vector of Strings indicating 1157c478bd9Sstevel@tonic-gate * the attributes to remove. 1167c478bd9Sstevel@tonic-gate * @exception ServiceLocationException An exception is thrown if the 1177c478bd9Sstevel@tonic-gate * operation fails. 1187c478bd9Sstevel@tonic-gate */ 1197c478bd9Sstevel@tonic-gate deleteAttributes(ServiceURL URL, Vector attributeIds)1207c478bd9Sstevel@tonic-gate public void deleteAttributes(ServiceURL URL, 1217c478bd9Sstevel@tonic-gate Vector attributeIds) 1227c478bd9Sstevel@tonic-gate throws ServiceLocationException; 1237c478bd9Sstevel@tonic-gate } 124