Interface IProject
- All Superinterfaces:
IAdaptable,IContainer,IResource,ISchedulingRule
Features of projects include:
- A project collects together a set of files and folders.
- A project's location controls where the project's resources are stored in the local file system.
- A project's build spec controls how building is done on the project.
- A project can carry session and persistent properties.
- A project can be open or closed; a closed project is passive and has a minimal in-memory footprint.
- A project can have one or more project build configurations.
- A project can carry references to other project build configurations.
- A project can have one or more project natures.
Projects implement the IAdaptable interface;
extensions are managed by the platform's adapter manager.
- See Also:
- Restriction:
- This interface is not intended to be implemented by clients.
- Restriction:
- This interface is not intended to be extended by clients.
-
Field Summary
FieldsModifier and TypeFieldDescriptionstatic final intOption constant (value 1) indicating that a snapshot to be loaded or saved contains a resource tree (refresh information).Fields inherited from interface org.eclipse.core.resources.IContainer
DO_NOT_CHECK_EXISTENCE, EXCLUDE_DERIVED, INCLUDE_HIDDEN, INCLUDE_PHANTOMS, INCLUDE_TEAM_PRIVATE_MEMBERSFields inherited from interface org.eclipse.core.resources.IResource
ALLOW_MISSING_LOCAL, ALWAYS_DELETE_PROJECT_CONTENT, AVOID_NATURE_CONFIG, BACKGROUND_REFRESH, CHECK_ANCESTORS, DEPTH_INFINITE, DEPTH_ONE, DEPTH_ZERO, DERIVED, FILE, FOLDER, FORCE, HIDDEN, KEEP_HISTORY, NEVER_DELETE_PROJECT_CONTENT, NONE, NULL_STAMP, PROJECT, REPLACE, ROOT, SHALLOW, TEAM_PRIVATE, VIRTUAL -
Method Summary
Modifier and TypeMethodDescriptionvoidInvokes thebuildmethod of the specified builder for this project.voidbuild(int kind, IProgressMonitor monitor) Builds this project.voidbuild(IBuildConfiguration config, int kind, IProgressMonitor monitor) Builds a specific build configuration of this project.voidClears the cache of dynamic project references for this project.voidclose(IProgressMonitor monitor) Closes this project.voidcreate(IProjectDescription description, int updateFlags, IProgressMonitor monitor) Creates a new project resource in the workspace using the given project description.voidcreate(IProjectDescription description, IProgressMonitor monitor) Creates a new project resource in the workspace using the given project description.voidcreate(IProgressMonitor monitor) Creates a new project resource in the workspace with files in the default location in the local file system.voiddelete(boolean deleteContent, boolean force, IProgressMonitor monitor) Deletes this project from the workspace.Returns the active build configuration for the project.getBuildConfig(String configName) Returns the projectIBuildConfigurationwith the given name for this project.Returns the build configurations for this project.Returns this project's content type matcher.Returns line separator appropriate for new files in the given project.Returns the description for this project.Returns a handle to the file with the given name in this project.Returns a handle to the folder with the given name in this project.Returns the specified project nature for this project ornullif the project nature has not been added to this project.getReferencedBuildConfigs(String configName, boolean includeMissing) Returns the build configurations referenced by the passed in build configuration on this project.IProject[]Returns the projects referenced by this project.IProject[]Returns the list of all open projects which reference this project.Returns the location in the local file system of the project-specific working data area for use by the bundle/plug-in with the given identifier, ornullif the project does not exist.booleanhasBuildConfig(String configName) Checks whether the project has the specified build configuration.booleanReturns whether the project nature specified by the given nature extension id has been added to this project.booleanisNatureEnabled(String natureId) Returns true if the project nature specified by the given nature extension id is enabled for this project, and false otherwise.booleanisOpen()Returns whether this project is open.voidloadSnapshot(int options, URI snapshotLocation, IProgressMonitor monitor) Loads a snapshot of project meta-data from the given location URI.voidmove(IProjectDescription description, boolean force, IProgressMonitor monitor) Renames this project so that it is located at the name in the given description.voidopen(int updateFlags, IProgressMonitor monitor) Opens this project.voidopen(IProgressMonitor monitor) Opens this project.voidsaveSnapshot(int options, URI snapshotLocation, IProgressMonitor monitor) Writes a snapshot of project meta-data into the given location URI.voidsetDescription(IProjectDescription description, int updateFlags, IProgressMonitor monitor) Changes this project resource to match the given project description.voidsetDescription(IProjectDescription description, IProgressMonitor monitor) Changes this project resource to match the given project description.Methods inherited from interface org.eclipse.core.runtime.IAdaptable
getAdapterMethods inherited from interface org.eclipse.core.resources.IContainer
createFilter, exists, findDeletedMembersWithHistory, findMember, findMember, findMember, findMember, getDefaultCharset, getDefaultCharset, getFile, getFilters, getFolder, members, members, members, setDefaultCharset, setDefaultCharsetMethods inherited from interface org.eclipse.core.resources.IResource
accept, accept, accept, accept, accept, clearHistory, copy, copy, copy, copy, createMarker, createMarker, createProxy, delete, delete, deleteMarkers, equals, exists, findMarker, findMarkers, findMaxProblemSeverity, getFileExtension, getFullPath, getLocalTimeStamp, getLocation, getLocationURI, getMarker, getModificationStamp, getName, getParent, getPathVariableManager, getPersistentProperties, getPersistentProperty, getProject, getProjectRelativePath, getRawLocation, getRawLocationURI, getResourceAttributes, getSessionProperties, getSessionProperty, getType, getWorkspace, isAccessible, isDerived, isDerived, isHidden, isHidden, isLinked, isLinked, isLocal, isPhantom, isReadOnly, isSynchronized, isTeamPrivateMember, isTeamPrivateMember, isVirtual, move, move, move, move, refreshLocal, revertModificationStamp, setDerived, setDerived, setHidden, setLocal, setLocalTimeStamp, setPersistentProperty, setReadOnly, setResourceAttributes, setSessionProperty, setTeamPrivateMember, touchMethods inherited from interface org.eclipse.core.runtime.jobs.ISchedulingRule
contains, isConflicting
-
Field Details
-
SNAPSHOT_TREE
static final int SNAPSHOT_TREEOption constant (value 1) indicating that a snapshot to be loaded or saved contains a resource tree (refresh information).- Since:
- 3.6
- See Also:
-
-
Method Details
-
build
void build(int kind, String builderName, Map<String, String> args, IProgressMonitor monitor) throws CoreExceptionInvokes thebuildmethod of the specified builder for this project. Does nothing if this project is closed. If this project has multiple builders on its build spec matching the given name, only the first matching builder will be run. The build is run for the project's active build configuration.The builder name is declared in the extension that plugs in to the standard
org.eclipse.core.resources.buildersextension point. The arguments are builder specific.This method may change resources; these changes will be reported in a subsequent resource change event.
This method is long-running; progress and cancellation are provided by the given progress monitor.
- Parameters:
kind- the kind of build being requested. Valid values are:IncrementalProjectBuilder.FULL_BUILD- indicates a full build.IncrementalProjectBuilder.INCREMENTAL_BUILD- indicates a incremental build.IncrementalProjectBuilder.CLEAN_BUILD- indicates a clean request. Clean does not actually build anything, but rather discards all problems and build states.
builderName- the name of the builderargs- a table of builder-specific arguments keyed by argument name (key type:String, value type:String);nullis equivalent to an empty mapmonitor- a progress monitor, ornullif progress reporting is not desired- Throws:
CoreException- if the build fails. The status contained in the exception may be a genericIResourceStatus.BUILD_FAILEDcode, but it could also be any other status code; it might also be aMultiStatus.OperationCanceledException- if the operation is canceled. Cancelation can occur even if no progress monitor is provided.- See Also:
-
build
Builds this project. Does nothing if the project is closed.Building a project involves executing the commands found in this project's build spec. The build is run for the project's active build configuration.
This method may change resources; these changes will be reported in a subsequent resource change event.
This method is long-running; progress and cancellation are provided by the given progress monitor.
- Parameters:
kind- the kind of build being requested. Valid values are:-
IncrementalProjectBuilder.FULL_BUILD- indicates a full build. -
IncrementalProjectBuilder.INCREMENTAL_BUILD- indicates an incremental build. CLEAN_BUILD- indicates a clean request. Clean does not actually build anything, but rather discards all problems and build states.
-
monitor- a progress monitor, ornullif progress reporting is not desired- Throws:
CoreException- if the build fails. The status contained in the exception may be a genericBUILD_FAILEDcode, but it could also be any other status code; it might also be a multi-status.OperationCanceledException- if the operation is canceled. Cancelation can occur even if no progress monitor is provided.- See Also:
-
build
Builds a specific build configuration of this project. Does nothing if the project is closed or the build configuration does not exist.Building a project involves executing the commands found in this project's build spec. The build is run for the specific project build configuration.
This method may change resources; these changes will be reported in a subsequent resource change event.
This method is long-running; progress and cancellation are provided by the given progress monitor.
- Parameters:
config- build configuration to buildkind- the kind of build being requested. Valid values are:-
IncrementalProjectBuilder.FULL_BUILD- indicates a full build. -
IncrementalProjectBuilder.INCREMENTAL_BUILD- indicates an incremental build. CLEAN_BUILD- indicates a clean request. Clean does not actually build anything, but rather discards all problems and build states.
-
monitor- a progress monitor, ornullif progress reporting is not desired- Throws:
CoreException- if the build fails. The status contained in the exception may be a genericBUILD_FAILEDcode, but it could also be any other status code; it might also be a multi-status.OperationCanceledException- if the operation is canceled. Cancelation can occur even if no progress monitor is provided.- Since:
- 3.7
- See Also:
-
close
Closes this project. The project need not be open. Closing a closed project does nothing.Closing a project involves ensuring that all important project-related state is safely stored on disk, and then discarding the in-memory representation of its resources and other volatile state, including session properties. After this method, the project continues to exist in the workspace but its member resources (and their members, etc.) do not. A closed project can later be re-opened.
This method changes resources; these changes will be reported in a subsequent resource change event that includes an indication that this project has been closed and its members have been removed.
This method is long-running; progress and cancellation are provided by the given progress monitor.
- Parameters:
monitor- a progress monitor, ornullif progress reporting is not desired- Throws:
CoreException- if this method fails. Reasons include:- This resource does not exist.
- Resource changes are disallowed during certain types of resource change
event notification. See
IResourceChangeEventfor more details.
OperationCanceledException- if the operation is canceled. Cancelation can occur even if no progress monitor is provided.- See Also:
-
create
Creates a new project resource in the workspace using the given project description. Upon successful completion, the project will exist but be closed.Newly created projects have no session or persistent properties.
If the project content area given in the project description does not contain a project description file, a project description file is written in the project content area with the natures, build spec, comment, and referenced projects as specified in the given project description. If there is an existing project description file, it is not overwritten. In either case, this method does not cause natures to be configured.
This method changes resources; these changes will be reported in a subsequent resource change event, including an indication that the project has been added to the workspace.
This method is long-running; progress and cancellation are provided by the given progress monitor.
- Parameters:
description- the project descriptionmonitor- a progress monitor, ornullif progress reporting is not desired- Throws:
CoreException- if this method fails. Reasons include:- This project already exists in the workspace.
- The name of this resource is not valid (according to
IWorkspace.validateName). - The project location is not valid (according to
IWorkspace.validateProjectLocation). - The project description file could not be created in the project content area.
- Resource changes are disallowed during certain types of resource change
event notification. See
IResourceChangeEventfor more details.
OperationCanceledException- if the operation is canceled. Cancelation can occur even if no progress monitor is provided.- See Also:
-
create
Creates a new project resource in the workspace with files in the default location in the local file system. Upon successful completion, the project will exist but be closed.Newly created projects have no session or persistent properties.
If the project content area does not contain a project description file, an initial project description file is written in the project content area with the following information:
- no references to other projects
- no natures
- an empty build spec
- an empty comment
If there is an existing project description file, it is not overwritten.
This method changes resources; these changes will be reported in a subsequent resource change event, including an indication that this project has been added to the workspace.
This method is long-running; progress and cancellation are provided by the given progress monitor.
- Parameters:
monitor- a progress monitor, ornullif progress reporting is not desired- Throws:
CoreException- if this method fails. Reasons include:- This project already exists in the workspace.
- The name of this resource is not valid (according to
IWorkspace.validateName). - The project location is not valid (according to
IWorkspace.validateProjectLocation). - The project description file could not be created in the project content area.
- Resource changes are disallowed during certain types of resource change
event notification. See
IResourceChangeEventfor more details.
OperationCanceledException- if the operation is canceled. Cancelation can occur even if no progress monitor is provided.- See Also:
-
create
void create(IProjectDescription description, int updateFlags, IProgressMonitor monitor) throws CoreException Creates a new project resource in the workspace using the given project description. Upon successful completion, the project will exist but be closed.Newly created projects have no session or persistent properties.
If the project content area given in the project description does not contain a project description file, a project description file is written in the project content area with the natures, build spec, comment, and referenced projects as specified in the given project description. If there is an existing project description file, it is not overwritten. In either case, this method does not cause natures to be configured.
This method changes resources; these changes will be reported in a subsequent resource change event, including an indication that the project has been added to the workspace.
This method is long-running; progress and cancellation are provided by the given progress monitor.
The
IResource.HIDDENupdate flag indicates that this resource should immediately be set as a hidden resource. Specifying this flag is equivalent to atomically callingIResource.setHidden(boolean)with a value oftrueimmediately after creating the resource.Update flags other than those listed above are ignored.
- Parameters:
description- the project descriptionmonitor- a progress monitor, ornullif progress reporting is not desired- Throws:
CoreException- if this method fails. Reasons include:- This project already exists in the workspace.
- The name of this resource is not valid (according to
IWorkspace.validateName). - The project location is not valid (according to
IWorkspace.validateProjectLocation). - The project description file could not be created in the project content area.
- Resource changes are disallowed during certain types of resource change
event notification. See
IResourceChangeEventfor more details.
OperationCanceledException- if the operation is canceled. Cancelation can occur even if no progress monitor is provided.- Since:
- 3.4
- See Also:
-
delete
Deletes this project from the workspace. No action is taken if this project does not exist.This is a convenience method, fully equivalent to:
delete( (deleteContent ? IResource.ALWAYS_DELETE_PROJECT_CONTENT : IResource.NEVER_DELETE_PROJECT_CONTENT ) | (force ? FORCE : IResource.NONE), monitor);This method is long-running; progress and cancellation are provided by the given progress monitor.
- Parameters:
deleteContent- a flag controlling how whether content is aggressively deletedforce- a flag controlling whether resources that are not in sync with the local file system will be toleratedmonitor- a progress monitor, ornullif progress reporting is not desired- Throws:
CoreException- if this method fails. Reasons include:- This project could not be deleted.
- This project's contents could not be deleted.
- Resource changes are disallowed during certain types of resource change
event notification. See
IResourceChangeEventfor more details.
OperationCanceledException- if the operation is canceled. Cancelation can occur even if no progress monitor is provided.- See Also:
-
getActiveBuildConfig
Returns the active build configuration for the project.If at any point the active configuration is removed from the project, for example when updating the list of build configurations, the active build configuration will be set to the first build configuration specified by
IProjectDescription.setBuildConfigs(String[]).If all of the build configurations are removed, the active build configuration will be set to the default configuration.
- Returns:
- the active build configuration
- Throws:
CoreException- if this method fails. Reasons include:- This project does not exist.
- This project is not open.
- Since:
- 3.7
-
getBuildConfig
Returns the projectIBuildConfigurationwith the given name for this project.- Parameters:
configName- the name of the configuration to get- Returns:
- a project configuration
- Throws:
CoreException- if this method fails. Reasons include:- This project does not exist.
- This project is not open.
- The configuration does not exist in this project.
- Since:
- 3.7
- See Also:
-
getBuildConfigs
Returns the build configurations for this project. A project always has at least one build configuration, so this will never return an empty list or null. The result will not contain duplicates.- Returns:
- a list of project build configurations
- Throws:
CoreException- if this method fails. Reasons include:- This project does not exist.
- This project is not open.
- Since:
- 3.7
-
getContentTypeMatcher
Returns this project's content type matcher. This content type matcher takes project specific preferences and nature-content type associations into account.- Returns:
- the content type matcher for this project
- Throws:
CoreException- if this method fails. Reasons include:- This project does not exist.
- This project is not open.
- Since:
- 3.1
- See Also:
-
getDescription
Returns the description for this project. The returned value is a copy and cannot be used to modify this project. The returned value is suitable for use in creating, copying and moving other projects.- Returns:
- the description for this project
- Throws:
CoreException- if this method fails. Reasons include:- This project does not exist.
- This project is not open.
- See Also:
-
getFile
Returns a handle to the file with the given name in this project.This is a resource handle operation; neither the resource nor the result need exist in the workspace. The validation check on the resource name/path is not done when the resource handle is constructed; rather, it is done automatically as the resource is created.
- Parameters:
name- the string name of the member file- Returns:
- the (handle of the) member file
- See Also:
-
getFolder
Returns a handle to the folder with the given name in this project.This is a resource handle operation; neither the container nor the result need exist in the workspace. The validation check on the resource name/path is not done when the resource handle is constructed; rather, it is done automatically as the resource is created.
- Parameters:
name- the string name of the member folder- Returns:
- the (handle of the) member folder
- See Also:
-
getNature
Returns the specified project nature for this project ornullif the project nature has not been added to this project. Clients may downcast to a more concrete type for more nature-specific methods. The documentation for a project nature specifies any such additional protocol.This may cause the plug-in that provides the given nature to be activated.
- Parameters:
natureId- the fully qualified nature extension identifier, formed by combining the nature extension id with the id of the declaring plug-in. (e.g."com.example.acmeplugin.coolnature")- Returns:
- the project nature object
- Throws:
CoreException- if this method fails. Reasons include:- This project does not exist.
- This project is not open.
- The project nature extension could not be found.
-
getWorkingLocation
Returns the location in the local file system of the project-specific working data area for use by the bundle/plug-in with the given identifier, ornullif the project does not exist.The content, structure, and management of this area is the responsibility of the bundle/plug-in. This area is deleted when the project is deleted.
This project needs to exist but does not need to be open.
- Parameters:
id- the bundle or plug-in's identifier- Returns:
- a local file system path
- Since:
- 3.0
-
getReferencedProjects
Returns the projects referenced by this project. This includes both the static and dynamic references of this project. The returned projects need not exist in the workspace. The result will not contain duplicates. Returns an empty array if there are no referenced projects.- Returns:
- a list of projects
- Throws:
CoreException- if this method fails. Reasons include:- This project does not exist.
- This project is not open.
- See Also:
-
clearCachedDynamicReferences
void clearCachedDynamicReferences()Clears the cache of dynamic project references for this project. Invoking this method will cause the dynamic project references to be recomputed the next time they are accessed (for example, in a call togetReferencedProjects(). It is not necessary to hold the workspace lock when invoking this method. Plugins that provide anIDynamicReferenceProvidershould invoke this method to inform the rest of the application when one or more dynamic project references may have changed. This will also clear any other cached data that is derived from the dynamic references.- Since:
- 3.12
-
getReferencingProjects
IProject[] getReferencingProjects()Returns the list of all open projects which reference this project. This project may or may not exist. Returns an empty array if there are no referencing projects.- Returns:
- a list of open projects referencing this project
-
getReferencedBuildConfigs
IBuildConfiguration[] getReferencedBuildConfigs(String configName, boolean includeMissing) throws CoreException Returns the build configurations referenced by the passed in build configuration on this project.This includes both the static and dynamic project level references. These are converted to build configurations pointing at the currently active referenced project configuration. The result will not contain duplicates.
References to active configurations will be translated to references to actual build configurations, if the project is accessible. Note that if includeMissing is true BuildConfigurations which can't be resolved (i.e. exist on missing projects, or aren't listed on the referenced project) are still included in the returned IBuildConfiguration array.
Returns an empty array if there are no references.
- Parameters:
configName- the configuration to get the references forincludeMissing- boolean controls whether unresolved buildConfiguration should be included in the result- Returns:
- an array of project build configurations
- Throws:
CoreException- if this method fails. Reasons include:- This project does not exist.
- This project is not open.
- The build configuration does not exist in this project.
- Since:
- 3.7
- See Also:
-
hasBuildConfig
Checks whether the project has the specified build configuration.- Parameters:
configName- the configuration- Returns:
trueif the project has the specified configuration, false otherwise- Throws:
CoreException- if this method fails. Reasons include:- This project does not exist.
- This project is not open.
- Since:
- 3.7
-
hasNature
Returns whether the project nature specified by the given nature extension id has been added to this project.- Parameters:
natureId- the nature extension identifier- Returns:
trueif the project has the given nature- Throws:
CoreException- if this method fails. Reasons include:- This project does not exist.
- This project is not open.
-
isNatureEnabled
Returns true if the project nature specified by the given nature extension id is enabled for this project, and false otherwise.Reasons for a nature not to be enabled include:
- The nature is not available in the install.
- The nature has not been added to this project.
- The nature has a prerequisite that is not enabled for this project.
- The nature specifies "one-of-nature" membership in a set, and there is another nature on this project belonging to that set.
- The prerequisites for the nature form a cycle.
- Parameters:
natureId- the nature extension identifier- Returns:
trueif the given nature is enabled for this project- Throws:
CoreException- if this method fails. Reasons include:- This project does not exist.
- This project is not open.
- Since:
- 2.0
- See Also:
-
isOpen
boolean isOpen()Returns whether this project is open.A project must be opened before it can be manipulated. A closed project is passive and has a minimal memory footprint; a closed project has no members.
- Returns:
trueif this project is open,falseif this project is closed or does not exist- See Also:
-
loadSnapshot
Loads a snapshot of project meta-data from the given location URI. Must be called after the project has been created, but before it is opened. The options constant controls what kind of snapshot information to load. Valid option values include:SNAPSHOT_TREE- load resource tree (refresh info)
- Parameters:
options- kind of snapshot information to loadsnapshotLocation- URI to load frommonitor- a progress monitor, ornullif progress reporting is not desired- Throws:
CoreException- if this method fails. Reasons include:- The snapshot was not found at the specified URI.
OperationCanceledException- if the operation is canceled.- Since:
- 3.6
- See Also:
-
move
void move(IProjectDescription description, boolean force, IProgressMonitor monitor) throws CoreException Renames this project so that it is located at the name in the given description.This is a convenience method, fully equivalent to:
move(description, (force ? FORCE : IResource.NONE), monitor);
This method changes resources; these changes will be reported in a subsequent resource change event that will include an indication that the resource has been removed from its parent and that a corresponding resource has been added to its new parent. Additional information provided with resource delta shows that these additions and removals are related.
This method is long-running; progress and cancellation are provided by the given progress monitor.
- Parameters:
description- the description for the destination projectforce- a flag controlling whether resources that are not in sync with the local file system will be toleratedmonitor- a progress monitor, ornullif progress reporting is not desired- Throws:
CoreException- if this resource could not be moved. Reasons include:- This resource is not accessible.
- This resource or one of its descendents is not local.
- This resource or one of its descendents is out of sync with the local file system
and
forceisfalse. - The workspace and the local file system are out of sync at the destination resource or one of its descendents.
- Resource changes are disallowed during certain types of resource change
event notification. See
IResourceChangeEventfor more details.
OperationCanceledException- if the operation is canceled. Cancelation can occur even if no progress monitor is provided.- See Also:
-
open
Opens this project. No action is taken if the project is already open.Opening a project constructs an in-memory representation of its resources from information stored on disk.
When a project is opened for the first time, initial information about the project's existing resources can be obtained in the following ways:
- If a
loadSnapshot(int, URI, IProgressMonitor)call has been made before the open, resources are restored from that file (a file written bysaveSnapshot(int, URI, IProgressMonitor)). When the snapshot includes resource tree information and can be loaded without error, no refresh is initiated, so the project's resource tree will match what the snapshot provides. - Otherwise, when the
IResource.BACKGROUND_REFRESHflag is specified, resources on disk will be added to the project in the background after this method returns. Child resources of the project may not be available until this background refresh completes. - Otherwise, resource information is obtained with a refresh operation in the foreground, before this method returns.
This method changes resources; these changes will be reported in a subsequent resource change event that includes an indication that the project has been opened and its resources have been added to the tree. If the
BACKGROUND_REFRESHupdate flag is specified, multiple resource change events may occur as resources on disk are discovered and added to the tree.This method is long-running; progress and cancellation are provided by the given progress monitor.
- Parameters:
updateFlags- ifIResource.BACKGROUND_REFRESHis passed, and the project is not new in the workspace (i.e. is not being opened for the first time) a background refresh is scheduled with the workspace refresh manager. See description above for cases in which the project is new in the workspace.monitor- a progress monitor, ornullif progress reporting is not desired- Throws:
CoreException- if this method fails. Reasons include:- Resource changes are disallowed during certain types of resource change
event notification. See
IResourceChangeEventfor more details.
- Resource changes are disallowed during certain types of resource change
event notification. See
OperationCanceledException- if the operation is canceled. Cancelation can occur even if no progress monitor is provided.- Since:
- 3.1
- See Also:
- If a
-
open
Opens this project. No action is taken if the project is already open.This is a convenience method, fully equivalent to
open(IResource.NONE, monitor).This method changes resources; these changes will be reported in a subsequent resource change event that includes an indication that the project has been opened and its resources have been added to the tree.
This method is long-running; progress and cancellation are provided by the given progress monitor.
- Parameters:
monitor- a progress monitor, ornullif progress reporting is not desired- Throws:
CoreException- if this method fails. Reasons include:- Resource changes are disallowed during certain types of resource change
event notification. See
IResourceChangeEventfor more details.
- Resource changes are disallowed during certain types of resource change
event notification. See
OperationCanceledException- if the operation is canceled. Cancelation can occur even if no progress monitor is provided.- See Also:
-
saveSnapshot
Writes a snapshot of project meta-data into the given location URI. The options constant controls what kind of snapshot information to write. Valid option values include:SNAPSHOT_TREE- save resource tree (refresh info)
- Parameters:
options- kind of snapshot information to savesnapshotLocation- URI for saving the snapshot tomonitor- a progress monitor, ornullif progress reporting is not desired- Throws:
CoreException- if this method fails. Reasons include:- The URI is not writable or an error occurs writing the data.
OperationCanceledException- if the operation is canceled.- Since:
- 3.6
- See Also:
-
setDescription
Changes this project resource to match the given project description. This project should exist and be open.This is a convenience method, fully equivalent to:
setDescription(description, KEEP_HISTORY, monitor);
This method requires the
IWorkspaceRootscheduling rule.This method changes resources; these changes will be reported in a subsequent resource change event, including an indication that the project's content has changed.
This method is long-running; progress and cancellation are provided by the given progress monitor.
- Parameters:
description- the project descriptionmonitor- a progress monitor, ornullif progress reporting is not desired- Throws:
CoreException- if this method fails. Reasons include:- This project does not exist in the workspace.
- This project is not open.
- The location in the local file system corresponding to the project description file is occupied by a directory.
- The workspace is out of sync with the project description file in the local file system .
- Resource changes are disallowed during certain types of resource change
event notification. See
IResourceChangeEventfor more details. - The file modification validator disallowed the change.
OperationCanceledException- if the operation is canceled. Cancelation can occur even if no progress monitor is provided.- See Also:
-
setDescription
void setDescription(IProjectDescription description, int updateFlags, IProgressMonitor monitor) throws CoreException Changes this project resource to match the given project description. This project should exist and be open.The given project description is used to change the project's natures, build spec, comment, and referenced projects. The name and location of a project cannot be changed using this method; these settings in the project description are ignored. To change a project's name or location, use
IResource.move(IProjectDescription, int, IProgressMonitor). The project's session and persistent properties are not affected.If the new description includes nature ids of natures that the project did not have before, these natures will be configured in automatically, which involves instantiating the project nature and calling
IProjectNature.configure()on it. An internal reference to the nature object is retained, and will be returned on subsequent calls togetNaturefor the specified nature id. Similarly, any natures the project had which are no longer required will be automatically de-configured by callingIProjectNature.deconfigure()on the nature object and letting go of the internal reference to it.The
FORCEupdate flag controls how this method deals with cases where the workspace is not completely in sync with the local file system. IfFORCEis not specified, the method will only attempt to overwrite the project's description file in the local file system provided it is in sync with the workspace. This option ensures there is no unintended data loss; it is the recommended setting. However, ifFORCEis specified, an attempt will be made to write the project description file in the local file system, overwriting any existing one if need be.The
KEEP_HISTORYupdate flag controls whether or not a copy of current contents of the project description file should be captured in the workspace's local history. The local history mechanism serves as a safety net to help the user recover from mistakes that might otherwise result in data loss. SpecifyingKEEP_HISTORYis recommended. Note that local history is maintained with each individual project, and gets discarded when a project is deleted from the workspace.The
AVOID_NATURE_CONFIGupdate flag controls whether or not added and removed natures should be configured or de-configured. If this flag is not specified, then added natures will be configured and removed natures will be de-configured. If this flag is specified, natures can still be added or removed, but they will not be configured or de-configured.The scheduling rule required for this operation depends on the
AVOID_NATURE_CONFIGflag. If the flag is specified theIResourceRuleFactory.modifyRule(org.eclipse.core.resources.IResource)is required; If the flag is not specified, theIWorkspaceRootscheduling rule is required.Update flags other than
FORCE,KEEP_HISTORY, andAVOID_NATURE_CONFIGare ignored.Prior to modifying the project description file, the file modification validator (if provided by the Team plug-in), will be given a chance to perform any last minute preparations. Validation is performed by calling
IFileModificationValidator.validateSaveon the project description file. If the validation fails, then this operation will fail.This method changes resources; these changes will be reported in a subsequent resource change event, including an indication that the project's content has changed.
This method is long-running; progress and cancellation are provided by the given progress monitor.
- Parameters:
description- the project descriptionupdateFlags- bit-wise or of update flag constants (FORCE,KEEP_HISTORYandAVOID_NATURE_CONFIG)monitor- a progress monitor, ornullif progress reporting is not desired- Throws:
CoreException- if this method fails. Reasons include:- This project does not exist in the workspace.
- This project is not open.
- The location in the local file system corresponding to the project description file is occupied by a directory.
- The workspace is not in sync with the project
description file in the local file system and
FORCEis not specified. - Resource changes are disallowed during certain types of resource change
event notification. See
IResourceChangeEventfor more details. - The file modification validator disallowed the change.
OperationCanceledException- if the operation is canceled. Cancelation can occur even if no progress monitor is provided.- Since:
- 2.0
- See Also:
-
getDefaultLineSeparator
Returns line separator appropriate for new files in the given project.This method uses the following algorithm to determine the line separator to be returned:
- the line separator defined in project preferences, or
- the line separator defined in workspace preferences, or
- the line separator defined in default preferences, or
- Operating system default line separator
- Returns:
- line separator for the current file
- Throws:
CoreException- if this method fails.- Since:
- 3.18
-