01: /*
02: * $Header: /export/home/cvsroot/MyPersonalizerRepository/MyPersonalizer/Subsystems/Kernel/Sources/es/udc/mypersonalizer/kernel/model/repository/interfaces/ServicePropertyAccessor.java,v 1.1.1.1 2004/03/25 12:08:36 fbellas Exp $
03: * $Revision: 1.1.1.1 $
04: * $Date: 2004/03/25 12:08:36 $
05: *
06: * =============================================================================
07: *
08: * Copyright (c) 2003, The MyPersonalizer Development Group
09: * (http://www.tic.udc.es/~fbellas/mypersonalizer/index.html) at
10: * University Of A Coruna
11: * All rights reserved.
12: *
13: * Redistribution and use in source and binary forms, with or without
14: * modification, are permitted provided that the following conditions are met:
15: *
16: * - Redistributions of source code must retain the above copyright notice,
17: * this list of conditions and the following disclaimer.
18: *
19: * - Redistributions in binary form must reproduce the above copyright notice,
20: * this list of conditions and the following disclaimer in the documentation
21: * and/or other materials provided with the distribution.
22: *
23: * - Neither the name of the University Of A Coruna nor the names of its
24: * contributors may be used to endorse or promote products derived from
25: * this software without specific prior written permission.
26: *
27: * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
28: * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
29: * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
30: * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE
31: * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
32: * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
33: * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
34: * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
35: * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
36: * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
37: * POSSIBILITY OF SUCH DAMAGE.
38: *
39: */
40:
41: package es.udc.mypersonalizer.kernel.model.repository.interfaces;
42:
43: import es.udc.mypersonalizer.kernel.model.properties.Property;
44: import es.udc.mypersonalizer.kernel.util.exceptions.InstanceNotFoundException;
45: import es.udc.mypersonalizer.kernel.util.exceptions.InternalErrorException;
46:
47: /**
48: * This interface specifies the methods required to store and retrieve
49: * instances of the <code>ServiceProperty</code> class.
50: *
51: * @author Fernando Bellas
52: * @since 1.0
53: */
54: public interface ServicePropertyAccessor {
55:
56: /**
57: * Finds a service property.
58: *
59: * @param key the service property key
60: * @return the service property
61: * @throws InternalErrorException if a severe failure occured
62: * @throws InstanceNotFoundException if it was unable to find the service property
63: */
64: ServiceProperty findServiceProperty(ServicePropertyKey key)
65: throws InternalErrorException, InstanceNotFoundException;
66:
67: /**
68: * Removes a service property.
69: *
70: * @param key the service property key
71: * @throws InternalErrorException if a severe failure occured
72: * @throws InstanceNotFoundException if it was unable to find the service property
73: */
74: void removeServiceProperty(ServicePropertyKey key)
75: throws InternalErrorException, InstanceNotFoundException;
76:
77: /**
78: * Updates a service property.
79: *
80: * @param serviceProperty the new service property
81: * @throws InternalErrorException if a severe failure occured
82: * @throws InstanceNotFoundException if it was unable to find the service property
83: */
84: void updateServiceProperty(ServiceProperty serviceProperty)
85: throws InternalErrorException, InstanceNotFoundException;
86:
87: /**
88: * Adds a new service property. This method must return a
89: * <code>ServiceProperty</code> with a valid property identifier.
90: *
91: * @param serviceIdentifier the service identifier
92: * @param property the property that contains the new service properties
93: * @return the added service property with a valid property identifier
94: * @throws InternalErrorException if a severe failure occured
95: */
96: ServiceProperty addServiceProperty(String serviceIdentifier,
97: Property property) throws InternalErrorException;
98: }
|