KickJava   Java API By Example, From Geeks To Geeks.

Java > Open Source Codes > org > apache > slide > store > RevisionDescriptorStore


1 /*
2  * $Header: /home/cvs/jakarta-slide/src/share/org/apache/slide/store/RevisionDescriptorStore.java,v 1.7 2004/07/28 09:34:41 ib Exp $
3  * $Revision: 1.7 $
4  * $Date: 2004/07/28 09:34:41 $
5  *
6  * ====================================================================
7  *
8  * Copyright 1999-2002 The Apache Software Foundation
9  *
10  * Licensed under the Apache License, Version 2.0 (the "License");
11  * you may not use this file except in compliance with the License.
12  * You may obtain a copy of the License at
13  *
14  * http://www.apache.org/licenses/LICENSE-2.0
15  *
16  * Unless required by applicable law or agreed to in writing, software
17  * distributed under the License is distributed on an "AS IS" BASIS,
18  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
19  * See the License for the specific language governing permissions and
20  * limitations under the License.
21  *
22  */
23
24 package org.apache.slide.store;
25
26 import org.apache.slide.common.Service;
27 import org.apache.slide.common.ServiceAccessException;
28 import org.apache.slide.common.Uri;
29 import org.apache.slide.content.NodeRevisionDescriptor;
30 import org.apache.slide.content.NodeRevisionNumber;
31 import org.apache.slide.content.RevisionDescriptorNotFoundException;
32
33 /**
34  * Store for RevisionDescriptor objects.
35  *
36  * @version $Revision: 1.7 $
37  */
38 public interface RevisionDescriptorStore extends Service {
39     
40     
41     // ------------------------------------------------------ Interface Methods
42
43     
44     /**
45      * Retrieve an individual object's revision descriptor.
46      *
47      * @param uri uri
48      * @param revisionNumber Node revision number
49      */
50     NodeRevisionDescriptor retrieveRevisionDescriptor
51         (Uri uri, NodeRevisionNumber revisionNumber)
52         throws ServiceAccessException, RevisionDescriptorNotFoundException;
53     
54     
55     /**
56      * Create a new revision descriptor.
57      *
58      * @param uri Uri
59      * @param revisionDescriptor Node revision descriptor
60      * @exception ServiceAccessException Service access error
61      */
62     void createRevisionDescriptor(Uri uri,
63                                   NodeRevisionDescriptor revisionDescriptor)
64         throws ServiceAccessException;
65     
66     
67     /**
68      * Update a revision descriptor.
69      *
70      * @param uri Uri
71      * @param revisionDescriptor Node revision descriptor
72      * @exception ServiceAccessException Service access error
73      * @exception RevisionDescriptorNotFoundException Revision descriptor
74      * was not found
75      */
76     void storeRevisionDescriptor(Uri uri,
77                                  NodeRevisionDescriptor revisionDescriptor)
78         throws ServiceAccessException, RevisionDescriptorNotFoundException;
79     
80     
81     /**
82      * Remove a revision descriptor.
83      *
84      * @param uri Uri
85      * @param revisionNumber Revision number
86      * @exception ServiceAccessException Service access error
87      */
88     void removeRevisionDescriptor(Uri uri, NodeRevisionNumber revisionNumber)
89         throws ServiceAccessException;
90     
91 }
92
Popular Tags