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.core.runtime
Interface ILibrary


Deprecated. In Eclipse 3.0 the plug-in classpath representation was changed. Clients of ILibrary are directed to the headers associated with the relevant bundle. In particular, the Bundle-Classpath header contains all available information about the classpath of a plug-in. Having retrieved the header, the ManifestElement helper class can be used to parse the value and discover the individual class path entries. The various header attributes are defined in Constants .

For example,

     String header = bundle.getHeaders().get(Constants.BUNDLE_CLASSPATH);
     ManifestElement[] elements = ManifestElement.parseHeader(
         Constants.BUNDLE_CLASSPATH, header);
     if (elements == null) 
         return;
     elements[0].getValue();   // the jar/dir containing the code
     ...
 

Note that this new structure does not include information on which packages are exported or present in the listed classpath entries. This information is no longer relevant.

See IPluginDescriptor for information on the relationship between plug-in descriptors and bundles.

This interface must only be used by plug-ins which explicitly require the org.eclipse.core.runtime.compatibility plug-in.

public interface ILibrary

A runtime library declared in a plug-in. Libraries contribute elements to the search path. These contributions are specified as a path to a directory or Jar file. This path is always considered to be relative to the containing plug-in.

Libraries are typed. The type is used to determine to which search path the library's contribution should be added. The valid types are: CODE and RESOURCE.

See Also:
IPluginDescriptor.getRuntimeLibraries()
Restriction:
This interface is not intended to be implemented by clients.

Field Summary
static  String CODE
          Deprecated. As of Eclipse 3.0 library types are obsolete. There is no replacement.
static  String RESOURCE
          Deprecated. As of Eclipse 3.0 library types are obsolete. There is no replacement.
 
Method Summary
  String[] getContentFilters ()
          Deprecated. As of Eclipse 3.0 content filters are obsolete. There is no replacement.
  String[] getPackagePrefixes ()
          Deprecated. As of Eclipse 3.0 package prefix filtering is obsolete. There is no replacement.
  IPath getPath ()
          Deprecated. Given a manifest element corresponding to a classpath entry, the path for the entry can be accessed by getting the value of the manifest element. For example,
     element.getValue();   // the jar/dir containing the code
 
  String getType ()
          Deprecated. As of Eclipse 3.0 library types are obsolete. There is no replacement.
 boolean isExported ()
          Deprecated. As of Eclipse 3.0 exporting an individual library is obsolete. There is no replacement.
 boolean isFullyExported ()
          Deprecated. As of Eclipse 3.0 exporting an individual library is obsolete. There is no replacement.
 

Field Detail

CODE

static final 
String CODE
Deprecated. As of Eclipse 3.0 library types are obsolete. There is no replacement.
Constant string (value "code") indicating the code library type.

See Also:
Constant Field Values

RESOURCE

static final 
String RESOURCE
Deprecated. As of Eclipse 3.0 library types are obsolete. There is no replacement.
Constant string (value "resource") indicating the resource library type.

See Also:
Constant Field Values
Method Detail

getContentFilters

String[] getContentFilters()
Deprecated. As of Eclipse 3.0 content filters are obsolete. There is no replacement.

Returns the content filters, or null. Each content filter identifies a specific class, or a group of classes, using a notation and matching rules equivalent to Java import declarations (e.g., "java.io.File", or "java.io.*"). Returns null if the library is not exported, or it is fully exported (no filtering).

Returns:
the content filters, or null if none

getPath

IPath getPath()
Deprecated. Given a manifest element corresponding to a classpath entry, the path for the entry can be accessed by getting the value of the manifest element. For example,
     element.getValue();   // the jar/dir containing the code
 

Returns the path of this runtime library, relative to the installation location.

Returns:
the path of the library
See Also:
IPluginDescriptor.getInstallURL()

getType

String getType()
Deprecated. As of Eclipse 3.0 library types are obsolete. There is no replacement.

Returns this library's type.

Returns:
the type of this library. The valid types are: CODE and RESOURCE.
See Also:
CODE, RESOURCE

isExported

boolean isExported()
Deprecated. As of Eclipse 3.0 exporting an individual library is obsolete. There is no replacement.

Returns whether the library is exported. The contents of an exported library may be visible to other plug-ins that declare a dependency on the plug-in containing this library, subject to content filtering. Libraries that are not exported are entirely private to the declaring plug-in.

Returns:
true if the library is exported, false if it is private

isFullyExported

boolean isFullyExported()
Deprecated. As of Eclipse 3.0 exporting an individual library is obsolete. There is no replacement.

Returns whether this library is fully exported. A library is considered fully exported iff it is exported and has no content filters.

Returns:
true if the library is fully exported, and false if it is private or has filtered content

getPackagePrefixes

String[] getPackagePrefixes()
Deprecated. As of Eclipse 3.0 package prefix filtering is obsolete. There is no replacement.

Returns the array of package prefixes that this library declares. This is used in classloader enhancements and is an optional entry in the plugin.xml.

Returns:
the array of package prefixes or null
Since:
2.1

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