org.eclipse.jdt.launching.sourcelookup
Class ArchiveSourceLocation
java.lang.Object
org.eclipse.core.runtime.PlatformObject
org.eclipse.jdt.launching.sourcelookup.ArchiveSourceLocation
-
All Implemented Interfaces:
-
IAdaptable,
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
and org.eclipse.debug.core.sourcelookup.containers
. This class
has been replaced by the following classes:
org.eclipse.debug.core.sourcelookup.containers.ArchiveSourceContainer
and org.eclipse.debug.core.sourcelookup.containers.ExternalArchiveSourceContainer
.
-
public class ArchiveSourceLocation
- extends
PlatformObject
- implements
IJavaSourceLocation
Locates source elements in an archive (zip) in the local file system. Returns
instances of ZipEntryStorage
.
This class may be instantiated.
-
Since:
- 2.0
-
See Also:
-
IJavaSourceLocation
-
Restriction:
- This class is not intended to be subclassed by clients.
Constructor Summary
|
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
|
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, or null
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 location |
IPath
|
getRootPath
()
Deprecated. Returns the location of the root source folder within
the archive, or null if the root source
folder is the root of the archive |
int
|
hashCode
()
Deprecated. |
void
|
initializeFrom
(
String memento)
Deprecated. Initializes this source location from the given memento. |
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 file -
sourceRoot
- a path to the root source folder in the
specified archive, or null
if the root source folder
is the root of the archive
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, or
null
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 interface
IJavaSourceLocation
-
-
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, or
null
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
equals
public boolean equals(
Object object)
-
Deprecated.
-
-
Overrides:
-
equals
in class
Object
-
hashCode
public int hashCode()
-
Deprecated.
-
-
Overrides:
-
hashCode
in class
Object
-
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 interface
IJavaSourceLocation
-
-
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 interface
IJavaSourceLocation
-
-
Parameters:
-
memento
- a memento generated by this source location
-
Throws:
-
CoreException
- if unable to initialize this source
location
Copyright (c) IBM Corp. and others 2000, 2008. All Rights Reserved.