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
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
|
/*******************************************************************************
* Copyright (c) 2007, 2010 Oracle. All rights reserved.
* This program and the accompanying materials are made available under the
* terms of the Eclipse Public License v1.0, which accompanies this distribution
* and is available at http://www.eclipse.org/legal/epl-v10.html.
*
* Contributors:
* Oracle - initial API and implementation
******************************************************************************/
package org.eclipse.jpt.core.resource.java;
import java.util.Iterator;
import org.eclipse.jdt.core.dom.CompilationUnit;
import org.eclipse.jpt.core.utility.TextRange;
/**
* Java source code or binary persistent member.
* <p>
* Provisional API: This interface is part of an interim API that is still
* under development and expected to change significantly before reaching
* stability. It is available at this early stage to solicit feedback from
* pioneering adopters on the understanding that any code that uses this API
* will almost certainly be broken (repeatedly) as the API evolves.
*
* @version 2.3
* @since 2.0
*/
public interface JavaResourcePersistentMember
extends JavaResourceNode
{
// ********** annotations **********
/**
* String associated with changes to the "annotations" collection
*/
String ANNOTATIONS_COLLECTION = "annotations"; //$NON-NLS-1$
/**
* Return the member's annotations in the order that they appear.
* Do not return duplicate annotations as this error is handled by the Java
* compiler.
*/
Iterator<Annotation> annotations();
/**
* Return the number of annotations.
*/
int annotationsSize();
/**
* Return the annotation with the specified name.
* Return the first if there are duplicates in the source code.
*/
Annotation getAnnotation(String annotationName);
/**
* Return the specified annotation.
* Return the first if there are duplicates in the source code.
* Do not return null, but a Null Object instead if no annotation
* with the specified name exists in the source code.
*/
Annotation getNonNullAnnotation(String annotationName);
/**
* Return the nestable annotations with the specified name in the order that
* they appear.
* If nestable and container annotations are both specified on the
* member directly, return only the nestable annotations specified within
* the container annotation.
*/
// TODO tie the singular and plural annotations together so we can generate
// a validation error when both are specified
Iterator<NestableAnnotation> annotations(String nestableAnnotationName, String containerAnnotationName);
/**
* Add an annotation with the specified name.
* Return the newly-created annotation.
*/
Annotation addAnnotation(String annotationName);
/**
* Add a new nestable annotation with the specified name.
* Create a new container annotation if necessary and add the nestable
* annotation to it.
* If both the nestable annotation and the container annotation already
* exist, then add to the container annotation, leaving the existing
* nestable annotation alone.
* If only the nestable annotation exists, then create the new container
* annotation and move the existing nestable annotation to it along with
* the new one. If neither annotation exists, then create a new nestable
* annotation.
*/
NestableAnnotation addAnnotation(int index, String nestableAnnotationName, String containerAnnotationName);
/**
* Move the nestable annotation found in the specified container
* annotation at the specified source index to the specified target index.
*/
void moveAnnotation(int targetIndex, int sourceIndex, String containerAnnotationName);
/**
* Remove the specified annotation.
*/
void removeAnnotation(String annotationName);
/**
* Remove the specified nestable annotation from the container annotation at the specified
* index.
* If there is no container, assume the index is zero and this does the same as
* {@link #removeAnnotation(String)}
*/
void removeAnnotation(int index, String nestableAnnotationName, String containerAnnotationName);
/**
* Sets the specified primary annotation as the first annotation, and removes all known
* annotations (i.e. does not remove non-persistence annotations) which are not included
* in the supporting annotations.
*/
Annotation setPrimaryAnnotation(String primaryAnnotationName, Iterable<String> supportingAnnotationNames);
// ********** queries **********
/**
* Return whether the underlying JDT member is persistable according to
* the JPA spec.
*/
boolean isPersistable();
String PERSISTABLE_PROPERTY = "persistable"; //$NON-NLS-1$
/**
* Return whether the underlying JDT member is currently annotated with any recognized
* annotations.
*/
boolean isAnnotated();
/**
* Return whether the Java resource persistent member is for the specified
* member.
*/
boolean isFor(String memberName, int occurrence);
/**
* Return the text range for the member's name.
*/
TextRange getNameTextRange(CompilationUnit astRoot);
// ********** behavior **********
/**
* Resolve type information that could be dependent on changes elsewhere
* in the workspace.
*/
void resolveTypes(CompilationUnit astRoot);
}
|
