2 * Copyright (c) 2013 Cisco Systems, Inc. and others. All rights reserved.
4 * This program and the accompanying materials are made available under the
5 * terms of the Eclipse Public License v1.0 which accompanies this distribution,
6 * and is available at http://www.eclipse.org/legal/epl-v10.html
8 package org.opendaylight.controller.config.api;
10 import javax.management.InstanceNotFoundException;
11 import javax.management.ObjectName;
13 public interface ServiceReferenceWritableRegistry extends ServiceReferenceReadableRegistry {
15 * Create or update reference name to objectName. Reference name is unique per service interface name.
16 * @return created or updated object name containing service name and reference name
17 * @throws IllegalArgumentException if there is a mismatch between serviceInterfaceName and objectName
18 * @throws InstanceNotFoundException if search did not find exactly one instance
20 ObjectName saveServiceReference(String serviceInterfaceName, String refName, ObjectName moduleON) throws InstanceNotFoundException;
23 * Remove service reference.
24 * @return true iif removed
25 * @throws IllegalArgumentException if service interface name is not advertised by any module
27 void removeServiceReference(String serviceInterfaceName, String refName) throws InstanceNotFoundException;
30 * Remove all service references.
32 void removeAllServiceReferences();
35 * Remove all service references attached to given module.
36 * @return true iif at least one reference was removed
38 boolean removeServiceReferences(ObjectName objectName) throws InstanceNotFoundException;