Class ArchiveSourceLocation
- java.lang.Object
-
- org.eclipse.core.runtime.PlatformObject
-
- org.eclipse.jdt.launching.sourcelookup.ArchiveSourceLocation
-
- All Implemented Interfaces:
IAdaptable
,IJavaSourceLocation
@Deprecated public class ArchiveSourceLocation extends PlatformObject implements IJavaSourceLocation
Deprecated.In 3.0, the debug platform provides source lookup facilities that should be used in place of the Java source lookup support provided in 2.0. The new facilities provide a source lookup director that coordinates source lookup among a set of participants, searching a set of source containers. See the following packages:org.eclipse.debug.core.sourcelookup
andorg.eclipse.debug.core.sourcelookup.containers
. This class has been replaced by the following classes:org.eclipse.debug.core.sourcelookup.containers.ArchiveSourceContainer
andorg.eclipse.debug.core.sourcelookup.containers.ExternalArchiveSourceContainer
.Locates source elements in an archive (zip) in the local file system. Returns instances ofZipEntryStorage
.This class may be instantiated.
- Since:
- 2.0
- See Also:
IJavaSourceLocation
- Restriction:
- This class is not intended to be sub-classed by clients.
-
-
Constructor Summary
Constructors Constructor Description ArchiveSourceLocation()
Deprecated.Constructs a new empty source location to be initialized with a memento.ArchiveSourceLocation(String archiveName, String sourceRoot)
Deprecated.Constructs a new source location that will retrieve source elements from the zip file with the given name.
-
Method Summary
All Methods Static Methods Instance Methods Concrete Methods Deprecated Methods Modifier and Type Method Description static void
closeArchives()
Deprecated.Closes all zip files that have been opened, and removes them from the zip file cache.boolean
equals(Object object)
Deprecated.Object
findSourceElement(String name)
Deprecated.Returns an object representing the source code for a type with the specified name, ornull
if none could be found.protected ZipFile
getArchive()
Deprecated.Returns the archive associated with this source location.String
getMemento()
Deprecated.Returns a memento for this source location from which this source location can be reconstructed.String
getName()
Deprecated.Returns the name of the archive associated with this source locationIPath
getRootPath()
Deprecated.Returns the location of the root source folder within the archive, ornull
if the root source folder is the root of the archiveint
hashCode()
Deprecated.void
initializeFrom(String memento)
Deprecated.Initializes this source location from the given memento.-
Methods inherited from class org.eclipse.core.runtime.PlatformObject
getAdapter
-
Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, toString, wait, wait, wait
-
Methods inherited from interface org.eclipse.core.runtime.IAdaptable
getAdapter
-
-
-
-
Constructor Detail
-
ArchiveSourceLocation
public ArchiveSourceLocation()
Deprecated.Constructs a new empty source location to be initialized with a memento.
-
ArchiveSourceLocation
public ArchiveSourceLocation(String archiveName, String sourceRoot)
Deprecated.Constructs a new source location that will retrieve source elements from the zip file with the given name.- Parameters:
archiveName
- zip filesourceRoot
- a path to the root source folder in the specified archive, ornull
if the root source folder is the root of the archive
-
-
Method Detail
-
closeArchives
public static void closeArchives()
Deprecated.Closes all zip files that have been opened, and removes them from the zip file cache. This method is only to be called by the launching plug-in.
-
findSourceElement
public Object findSourceElement(String name) throws CoreException
Deprecated.Description copied from interface:IJavaSourceLocation
Returns an object representing the source code for a type with the specified name, ornull
if none could be found. The name is a fully qualified type name, and may contain the '$' character when referring to inner types. For example,java.lang.String
. The source element returned is implementation specific - for example, a resource, a local file, a zip file entry, etc.- Specified by:
findSourceElement
in interfaceIJavaSourceLocation
- Parameters:
name
- fully qualified name of the type for which source is being searched for- Returns:
- source element
- Throws:
CoreException
- if an exception occurs while searching for the specified source element
-
getArchive
protected ZipFile getArchive() throws IOException
Deprecated.Returns the archive associated with this source location.- Returns:
- zip file
- Throws:
IOException
- if unable to create the zip file associated with this location
-
getRootPath
public IPath getRootPath()
Deprecated.Returns the location of the root source folder within the archive, ornull
if the root source folder is the root of the archive- Returns:
- the location of the root source folder within
the archive, or
null
if the root source folder is the root of the archive
-
getName
public String getName()
Deprecated.Returns the name of the archive associated with this source location- Returns:
- the name of the archive associated with this source location
-
getMemento
public String getMemento() throws CoreException
Deprecated.Description copied from interface:IJavaSourceLocation
Returns a memento for this source location from which this source location can be reconstructed.- Specified by:
getMemento
in interfaceIJavaSourceLocation
- Returns:
- a memento for this source location
- Throws:
CoreException
- if unable to create a memento
-
initializeFrom
public void initializeFrom(String memento) throws CoreException
Deprecated.Description copied from interface:IJavaSourceLocation
Initializes this source location from the given memento.- Specified by:
initializeFrom
in interfaceIJavaSourceLocation
- Parameters:
memento
- a memento generated by this source location- Throws:
CoreException
- if unable to initialize this source location
-
-