The Java model is the set of classes that model the objects associated with creating, editing, and building a Java program. The Java model classes are defined in the org.eclipse.jdt.core.* packages. These classes implement Java specific behavior for resources and further decompose Java resources into model elements.
The package org.eclipse.jdt.core defines the classes that model the elements that compose a Java program. The JDT uses an in-memory object model to represent the structure of a Java program. This model is hierarchical. Elements of a program can be decomposed into child elements.
Java elements are a similar resource objects. When you work with a Java element, you are actually working with a handle to some underlying model object. You must use the exists() protocol to determine whether the element is actually present in the workspace.
The following table summarizes the different kinds of Java elements.
|
Element |
Description |
|---|---|
|
Represents the root Java element, corresponding to the workspace. The parent of all Java projects. |
|
|
Represents a Java project in the workspace. (Child of IJavaModel ) |
|
|
Represents a set of package fragments, and maps the fragments to an underlying resource which is either a folder, JAR, or ZIP file. (Child of IJavaProject ) |
|
|
Represents the portion of the workspace that corresponds to an entire package, or a portion of the package. (Child of IPackageFragmentRoot ) |
|
|
Represents a Java source (.java) file. (Child of IPackageFragment ) |
|
|
Represents a package declaration in a compilation unit. (Child of ICompilationUnit ) |
|
|
Represents the collection of package import declarations in a compilation unit. (Child of ICompilationUnit ) |
|
|
Represents a single package import declaration. (Child of IImportContainer ) |
|
|
Represents either a source type inside a compilation unit, or a binary type inside a class file. |
|
|
Represents a field inside a type. (Child of IType ) |
|
|
Represents a method or constructor inside a type. (Child of IType ) |
|
|
Represents a static or instance initializer inside a type. (Child of IType ) |
|
|
Represents a compiled (binary) type. (Child of IPackageFragment ) |
All Java elements support the IJavaElement interface.
Some of the elements are shown in the Packages view. These elements implement the IOpenable interface, since they must be opened before they can be navigated. The figure below shows how these elements are represented in the Packages view.
The Java elements that implement IOpenable are mainly created from information found in the underlying resource files. The same elements are represented generically in the resource navigator view.
Other elements correspond to the items that make up a Java compilation unit. The figure below shows a Java compilation unit and a content outliner that displays the source elements in the compilation unit.
These elements implement the ISourceReference interface, since they contain corresponding source code. (As these elements are selected in the content outliner, their corresponding source code is shown in the Java editor).
Many of the Java elements correspond to generic resources in the workspace. When you want to create Java elements from a generic resource the class JavaCore is the best starting point. The following code snippet shows how to get Java elements from their corresponding resources.
private void createJavaElementsFrom(IProject myProject,
IFolder myFolder, IFile myFile) {
IJavaProject myJavaProject = JavaCore.create(myProject);
if (myJavaProject == null)
// the project is not configured for Java (has no Java nature)
return;
// get a package fragment or package fragment root
IJavaElement myPackageFragment = JavaCore.create(myFolder);
// get a .java (compilation unit), .class (class file), or
// .jar (package fragment root)
IJavaElement myJavaFile = JavaCore.create(myFile);
}
JavaCore is also used to maintain the Java class path, including locations for finding source code and libraries, and locations for generating output binary (.class) files.
When you create a Java project from a simple project, JavaCore will check to see if the project is configured with the Java nature. The JDT plug-in uses a project nature to designate a project as having Java behavior. This nature (org.eclipse.jdt.core.JavaCore#NATURE_ID ) is assigned to a project when the "New Java project" wizard creates a project. If the Java nature is not configured on a project, JavaCore will return null when asked to create the project.
What are the unique characteristics of Java projects? They record their classpath in a ".classpath" file and add the Java incremental project builder to the project's build spec. Otherwise, they are just regular projects and can be configured with other natures (and other incremental builders) by plug-ins. Plug-ins that want to configure projects with Java behavior in addition to their own behavior typically use the NewJavaProjectWizardPage to assign the Java nature to the project in addition to their own custom natures or behavior.
IJavaModel can be considered the parent of all projects in the workspace that have the Java project nature (and therefore can be treated as an IJavaProject).
