001: /*
002: * (C) Copyright IBM Corp. 2000 All rights reserved.
003: *
004: * The program is provided "AS IS" without any warranty express or
005: * implied, including the warranty of non-infringement and the implied
006: * warranties of merchantibility and fitness for a particular purpose.
007: * IBM will not be liable for any damages suffered by you as a result
008: * of using the Program. In no event will IBM be liable for any
009: * special, indirect or consequential damages or lost profits even if
010: * IBM has been advised of the possibility of their occurrence. IBM
011: * will not be liable for any third party claims against you.
012: */
013:
014: package com.ibm.webdav;
015:
016: import java.util.*;
017:
018: /**
019: * A workspace is a resource that provides a means to map
020: * versioned resources to particular versions. The members
021: * of a workspace are version selectors and unversioned
022: * resources. The targets of the version selectors identifies
023: * the version contained in the workspace. A workspace
024: * may contain a set of activitys that encapsulate changes
025: * made to resources in that workspace.
026: */
027: public class Workspace extends Collection {
028: /**
029: * Baseline this Workspace to save the selected revisions.
030: *
031: * @return a Baseline containing all the revisions selectable through
032: * this workspace
033: * @exception com.ibm.webdav.WebDAVException
034: */
035: public void baseline() throws WebDAVException {
036: }
037:
038: /**
039: * Create a Workspace at the given location. Servers may require workspaces
040: * to be created in a designated portion of the URL namespace.
041: *
042: * @return the newly created Workspace
043: * @exception com.ibm.webdav.WebDAVException
044: */
045: public static Workspace create(java.net.URL url)
046: throws WebDAVException {
047: return null;
048: }
049:
050: /**
051: * Return a list of differences in activities between this
052: * workspace and the given workspace. The differences
053: * in activities between a workspace and a baseline gives a high level
054: * view of their differences.
055: *
056: * @param target the baseline to compare with
057: * this workspace
058: * @return an Enumeration of the Activities that are different
059: * between the given baseline and this workspace
060: * @exception com.ibm.webdav.WebDAVException
061: */
062: public Enumeration differencesWith(Baseline target)
063: throws WebDAVException {
064: return null;
065: }
066:
067: /**
068: * Get the activities for revisions that were changed in this workspace.
069: * These activities are candidates for merging into some integration
070: * Workspace.
071: *
072: * @return an Enumeration ofthe Activities for revisions modified in this workspace
073: * @exception com.ibm.webdav.WebDAVException
074: */
075: public Enumeration getActivities() throws WebDAVException {
076: return null;
077: }
078:
079: /**
080: * Get the current activity for this workspace. Checkouts are
081: * done in the context of the current activity if any. A workspace
082: * can only have one current activity at a time. If this activity
083: * is in the revision selection rule of the workspace used to
084: * create the revision, the updates to the revision will remain
085: * visible after the working resource is checked in. The current
086: * label may also be used to perform this function if activities
087: * are not supported or used.
088: *
089: * @return the current Activity associated with changes made in
090: * this workspace
091: * @exception com.ibm.webdav.WebDAVException
092: */
093: public Activity getCurrentActivity() throws WebDAVException {
094: return null;
095: }
096:
097: /**
098: * Return an XML document containing the merge conflicts that would
099: * result if the mergeSource was merged into this Workspace.
100: * Merge conflicts arrise when a revision selected by one revision
101: * selector is on a different line of descent than that selected
102: * by some other revision selector in the workspace. Merge conflicts
103: * can be resolved by merging the mergeSource into the workspace and
104: * updating any working resources that result from merge conflicts.
105: *
106: * @return an Enumeration of the Resources that would be in conflict
107: * resulting from merging the mergeSource into this Workspace
108: * @exception com.ibm.webdav.WebDAVException
109: */
110: public Enumeration getMergeConflicts(Activity mergeSource)
111: throws WebDAVException {
112: return null;
113: }
114:
115: /**
116: * Return an XML document containing the merge conflicts that would
117: * result if the mergeSource was merged into this Workspace.
118: * Merge conflicts arrise when a revision selected by one revision
119: * selector is on a different line of descent than that selected
120: * by some other revision selector in the workspace. Merge conflicts
121: * can be resolved by merging the mergeSource into the workspace and
122: * updating any working resources that result from merge conflicts.
123: *
124: * @return an Enumeration of the Resources that would be in conflict
125: * resulting from merging the mergeSource into this Workspace
126: * @exception com.ibm.webdav.WebDAVException
127: */
128: public Enumeration getMergeConflicts(Baseline mergeSource)
129: throws WebDAVException {
130: return null;
131: }
132:
133: /**
134: * Return an XML document containing the merge conflicts that would
135: * result if the mergeSource was merged into this Workspace.
136: * Merge conflicts arrise when a revision selected by one revision
137: * selector is on a different line of descent than that selected
138: * by some other revision selector in the workspace. Merge conflicts
139: * can be resolved by merging the mergeSource into the workspace and
140: * updating any working resources that result from merge conflicts.
141: *
142: * @return an Enumeration of the Resources that would be in conflict
143: * resulting from merging the mergeSource into this Workspace
144: * @exception com.ibm.webdav.WebDAVException
145: */
146: public Enumeration getMergeConflicts(Workspace mergeSource)
147: throws WebDAVException {
148: return null;
149: }
150:
151: /**
152: * Merge the mergeSource with this workspace.
153: * This results in potentially selecting different revisions,
154: * and the creation of working resources resulting from merge conflicts.
155: *
156: * If the mergeSource includes mutable revisions, the merge conflicts are not reliable.
157: *
158: * @param mergeSource the Workspace to merge into this workspace
159: * @return an Enumeration of the Resources that were in conflict as a result of the merge.
160: * @exception com.ibm.webdav.WebDAVException
161: * @see com.ibm.webdav.Resource#mergeWith
162: */
163: public Enumeration mergeWith(Activity mergeSource)
164: throws WebDAVException {
165: return null;
166: }
167:
168: /**
169: * Merge the mergeSource with this workspace.
170: * This results in potentially selecting different revisions,
171: * and the creation of working resources resulting from merge conflicts.
172: *
173: * If the mergeSource includes mutable revisions, the merge conflicts are not reliable.
174: *
175: * @param mergeSource the Workspace to merge into this workspace
176: * @return an Enumeration of the Resources that were in conflict as a result of the merge.
177: * @exception com.ibm.webdav.WebDAVException
178: * @see com.ibm.webdav.Resource#mergeWith
179: */
180: public Enumeration mergeWith(Baseline mergeSource)
181: throws WebDAVException {
182: return null;
183: }
184:
185: /**
186: * Merge the mergeSource with this workspace.
187: * This results in potentially selecting different revisions,
188: * and the creation of working resources resulting from merge conflicts.
189: *
190: * If the mergeSource includes mutable revisions, the merge conflicts are not reliable.
191: *
192: * @param mergeSource the Workspace to merge into this workspace
193: * @return an Enumeration of the Resources that were in conflict as a result of the merge.
194: * @exception com.ibm.webdav.WebDAVException
195: * @see com.ibm.webdav.Resource#mergeWith
196: */
197: public Enumeration mergeWith(Resource mergeSource)
198: throws WebDAVException {
199: return null;
200: }
201:
202: /**
203: * Merge the mergeSource with this workspace.
204: * This results in potentially selecting different revisions,
205: * and the creation of working resources resulting from merge conflicts.
206: *
207: * If the mergeSource includes mutable revisions, the merge conflicts are not reliable.
208: *
209: * @param mergeSource the Workspace to merge into this workspace
210: * @return an Enumeration of the Resources that were in conflict as a result of the merge.
211: * @exception com.ibm.webdav.WebDAVException
212: * @see com.ibm.webdav.Resource#mergeWith
213: */
214: public Enumeration mergeWith(Workspace mergeSource)
215: throws WebDAVException {
216: return null;
217: }
218:
219: /**
220: * Set the current activity for this workspace. Checkouts are
221: * done in the context of the current activity if any. A workspace
222: * can only have one current activity at a time. If this activity
223: * is in the revision selection rule of the workspace used to
224: * create the revision, the updates to the revision will remain
225: * visible after the working resource is checked in. The current
226: * label may also be used to perform this function if activities
227: * are not supported or used.
228: *
229: * @param value the current Activity associated with changes made in
230: * this workspace
231: * @exception com.ibm.webdav.WebDAVException
232: */
233: public void setCurrentActivity(Activity currentActivity)
234: throws WebDAVException {
235: }
236: }
|