Skip to main content
summaryrefslogtreecommitdiffstats
blob: 6192f062a66735ea417270ceb7616a7c4fe11c30 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
package org.eclipse.jdt.internal.core.builder;

public interface IImageBuilder 
{


	/**
	 * If the new state is being built incrementally, returns an object 
	 * describing the differences between the old state and the new state,
	 * otherwise returns null.  The delta is restricted to the given
	 * ImageContext.  
	 * This image delta will include entries for all program elements that are
	 * present in:
	 * <pre>
	 * (oldState UNION newState) INTERSECT imageContext
	 *</pre>
	 * That is, it will include each program element that is present in one or the other
	 * state and also in the given image context.
	 * Any delta objects navigated to from the result are restricted 
	 * to the same ImageContext.
	 * Note that there is no necessary relationship between the image context
	 * supplied and the build contexts of the old and new states.
	 */
	IDelta getImageDelta(IImageContext imageContext);
	/**
	 * Returns the state being built.
	 */
	IState getNewState();
	/**
	 * If the new state is being built incrementally, returns the old state, 
	 * otherwise returns null.
	 */
	IState getOldState();
/**
 * Return a string of the form:
 * 		batch image builder for:
 * 			new state: this.data.newstate
 * OR
 * 		incremental image builder for:
 *			new state: this.data.newstate
 * 			old state: this.data.oldstate
 * Obviously, which string gets returned depends
 * on the type of image builder.
 * The string returned is only for debugging purposes,
 * and the contents of the string may change in the future.
 * @return java.lang.String
 */
public String toString();
}

Back to the top