Follow Techotopia on Twitter

On-line Guides
All Guides
eBook Store
iOS / Android
Linux for Beginners
Office Productivity
Linux Installation
Linux Security
Linux Utilities
Linux Virtualization
Linux Kernel
System/Network Admin
Programming
Scripting Languages
Development Tools
Web Development
GUI Toolkits/Desktop
Databases
Mail Systems
openSolaris
Eclipse Documentation
Techotopia.com
Virtuatopia.com

How To Guides
Virtualization
General System Admin
Linux Security
Linux Filesystems
Web Servers
Graphics & Desktop
PC Hardware
Windows
Problem Solutions
Privacy Policy

  




 

 


Eclipse Platform
Release 3.5

org.eclipse.update.core
Class JarContentReference

java.lang.Object
  extended by 

org.eclipse.update.core.ContentReference
      extended by 
org.eclipse.update.core.JarContentReference

Deprecated. The org.eclipse.update component has been replaced by Equinox p2. This provisional API was never promoted to stable API, and may be removed from a future release of the platform.

public class JarContentReference
extends ContentReference

Local .jar file content reference.

This class may be instantiated or subclassed by clients.

Note: This class/interface is part of an interim API that is still under development and expected to change significantly before reaching stability. It is being made 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.

Since:
2.0
See Also:
ContentReference, JarEntryContentReference

Nested Class Summary
static class JarContentReference.ContentSelector
          Deprecated. Content selector used in .jar operations.
 
Field Summary
 
Fields inherited from class org.eclipse.update.core. ContentReference
DEFAULT_EXECUTABLE_PERMISSION, UNKNOWN_SIZE
 
Constructor Summary
JarContentReference ( String id, File file)
          Deprecated. Create jar content reference from file.
JarContentReference ( String id, File file, boolean b)
          Deprecated. Constructor JarContentReference.
JarContentReference ( String id, URL url)
          Deprecated. Create jar content reference from URL.
 
Method Summary
protected   JarFile asJarFile ()
          Deprecated. Returns the content reference as a jar file.
 void closeArchive ()
          Deprecated. Closes the jar archive corresponding to this reference.
  ContentReference createContentReference ( String id, File file)
          Deprecated. A factory method to create a jar content reference.
  ContentReference[] peek ( JarContentReference.ContentSelector selector, InstallMonitor monitor)
          Deprecated. Peeks into the referenced jar archive.
  ContentReference peek ( String entryName, JarContentReference.ContentSelector selector, InstallMonitor monitor)
          Deprecated. Peeks into the referenced jar archive looking for the named entry.
static void shutdown ()
          Deprecated. Perform shutdown processing for jar archive handling.
  ContentReference[] unpack ( File dir, JarContentReference.ContentSelector selector, InstallMonitor monitor)
          Deprecated. Unpacks the referenced jar archive into the specified location.
  ContentReference unpack ( File dir, String entryName, JarContentReference.ContentSelector selector, InstallMonitor monitor)
          Deprecated. Unpacks the named jar entry into the specified location.
 
Methods inherited from class org.eclipse.update.core. ContentReference
asFile, asURL, getIdentifier, getInputSize, getInputStream, getLastModified, getPermission, isLocalReference, setLastModified, setPermission, setTempLocal, toString
 
Methods inherited from class java.lang. Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

Constructor Detail

JarContentReference

public JarContentReference(
String id,
                           
URL url)
Deprecated. 
Create jar content reference from URL.

Parameters:
id - "symbolic" path identifier
url - actual referenced URL
Since:
2.0

JarContentReference

public JarContentReference(
String id,
                           
File file)
Deprecated. 
Create jar content reference from file.

Parameters:
id - "symbolic" path identifier
file - actual referenced file
Since:
2.0

JarContentReference

public JarContentReference(
String id,
                           
File file,
                           boolean b)
Deprecated. 
Constructor JarContentReference.

Parameters:
id -
file -
b -
Method Detail

createContentReference

public 
ContentReference createContentReference(
String id,
                                               
File file)
Deprecated. 
A factory method to create a jar content reference.

Overrides:
createContentReference in class ContentReference
Parameters:
id - "symbolic" path identifier
file - actual referenced file
Returns:
jar content reference
Since:
2.0

asJarFile

protected 
JarFile asJarFile()
                     throws 
IOException
Deprecated. 
Returns the content reference as a jar file. Note, that this method does not cause the file to be downloaded if it is not already local.

Returns:
reference as jar file
Throws:
IOException - reference cannot be returned as jar file
Since:
2.0

unpack

public 
ContentReference[] unpack(
File dir,
                                 
JarContentReference.ContentSelector selector,
                                 
InstallMonitor monitor)
                          throws 
IOException,
                                 
InstallAbortedException
Deprecated. 
Unpacks the referenced jar archive into the specified location. Returns content references to the unpacked files.

Parameters:
dir - location to unpack the jar into
selector - selector, used to select entries to unpack, and to define "symbolic" path identifiers for the entries.
monitor - progress monitor
Throws:
IOException
InstallAbortedException
Since:
2.0

unpack

public 
ContentReference unpack(
File dir,
                               
String entryName,
                               
JarContentReference.ContentSelector selector,
                               
InstallMonitor monitor)
                        throws 
IOException,
                               
InstallAbortedException
Deprecated. 
Unpacks the named jar entry into the specified location. Returns content reference to the unpacked file.

Parameters:
dir - location to unpack the jar into
entryName - name of the jar entry
selector - selector, used to define "symbolic" path identifier for the entry
monitor - progress monitor
Throws:
IOException
InstallAbortedException
Since:
2.0

peek

public 
ContentReference[] peek(
JarContentReference.ContentSelector selector,
                               
InstallMonitor monitor)
                        throws 
IOException
Deprecated. 
Peeks into the referenced jar archive. Returns content references to the jar entries within the jar file.

Parameters:
selector - selector, used to select entries to return, and to define "symbolic" path identifiers for the entries.
monitor - progress monitor
Throws:
IOException
Since:
2.0

peek

public 
ContentReference peek(
String entryName,
                             
JarContentReference.ContentSelector selector,
                             
InstallMonitor monitor)
                      throws 
IOException
Deprecated. 
Peeks into the referenced jar archive looking for the named entry. Returns content reference to the jar entry within the jar file.

Parameters:
entryName - name of the jar entry
selector - selector, used to define "symbolic" path identifier for the entry
monitor - progress monitor
Returns:
the content reference ofr null if the entry doesn't exist
Throws:
IOException
Since:
2.0

closeArchive

public void closeArchive()
                  throws 
IOException
Deprecated. 
Closes the jar archive corresponding to this reference.

Throws:
IOException
Since:
2.0

shutdown

public static void shutdown()
Deprecated. 
Perform shutdown processing for jar archive handling. This method is called when platform is shutting down. It is not intended to be called at any other time under normal circumstances. A side-effect of calling this method is that all jars referenced by JarContentReferences are closed.

Since:
2.0

Eclipse Platform
Release 3.5

Guidelines for using Eclipse APIs.

Copyright (c) Eclipse contributors and others 2000, 2008. All rights reserved.


 
 
  Published under the terms of the Eclipse Public License Version 1.0 ("EPL") Design by Interspire