Package org.apache.felix.framework.util.manifestparser

Class ManifestParser

java.lang.Object

org.apache.felix.framework.util.manifestparser.ManifestParser

public class ManifestParser
extends Object

Field Summary

Fields

Modifier and Type	Field	Description
private static final int	ARGUMENT
private static final String	BUNDLE_LICENSE_HEADER
private static final Function<Object,Object>	cache
private static final int	CLAUSE_START
private static final int	DIRECTIVE_OR_TYPEDATTRIBUTE
private static final char	EOF
private static final int	KEY
private String	m_activationExcludeDir
private String	m_activationIncludeDir
private int	m_activationPolicy
private String	m_bundleSymbolicName
private Version	m_bundleVersion
private List<BundleCapability>	m_capabilities
private final Map<String,?>	m_configMap
private final Map<String,String>	m_headerMap
private boolean	m_isExtension
private List<NativeLibraryClause>	m_libraryClauses
private boolean	m_libraryHeadersOptional
private final Logger	m_logger
private List<BundleRequirement>	m_requirements
private static final Map<Object,WeakReference<Object>>	objectCache
private static final int	PARAMETER_START
private static final int	VALUE

Constructor Summary

Constructors

Constructor	Description
ManifestParser(Logger logger, Map<String,?> configMap, BundleRevision owner, Map<String,String> headerMap)

Method Summary

Modifier and Type	Method	Description
private static BundleCapabilityImpl	addIdentityCapability(BundleRevision owner, Map<String,String> headerMap, BundleCapabilityImpl bundleCap)
static List<BundleCapability>	aliasSymbolicName(List<BundleCapability> caps, BundleRevision owner)
private static SimpleFilter	buildFilterFromArray(String attributeName, String[] stringArray, int operation)
private static List<ParsedHeaderClause>	calculateImplicitImports(List<BundleCapability> exports, List<ParsedHeaderClause> imports)
private static List<BundleCapability>	calculateImplicitUses(List<BundleCapability> exports, List<ParsedHeaderClause> imports)
private static char	charAt(int pos, String headers, int length)
private static boolean	checkExtensionBundle(Map<String,String> headerMap)
private static List<BundleCapability>	convertExports(List<ParsedHeaderClause> clauses, BundleRevision owner)
private static List<BundleRequirement>	convertImports(List<ParsedHeaderClause> clauses, BundleRevision owner)
(package private) static List<BundleRequirement>	convertNativeCode(BundleRevision owner, List<NativeLibraryClause> nativeLibraryClauses, boolean hasOptionalLibraryDirective)
private static List<BundleCapability>	convertProvideCapabilities(List<ParsedHeaderClause> clauses, BundleRevision owner)
private static List<BundleRequirement>	convertRequireCapabilities(List<ParsedHeaderClause> clauses, BundleRevision owner)
private static List<BundleRequirementImpl>	convertRequires(List<ParsedHeaderClause> clauses, BundleRevision owner)
private int	firstSortedClause(List<NativeLibraryClause> clauseList)
String	getActivationExcludeDirective()
String	getActivationIncludeDirective()
int	getActivationPolicy()
private static String	getBreeVersionClause(Version ver)
Version	getBundleVersion()
List<BundleCapability>	getCapabilities()
List<NativeLibrary>	getLibraries()	This method returns the selected native library metadata from the manifest.
String	getManifestVersion()
private static String	getManifestVersion(Map<String,String> headerMap)
private String	getName(String path)
List<BundleRequirement>	getRequirements()
private NativeLibraryClause	getSelectedLibraryClause()
String	getSymbolicName()
boolean	isExtension()
static void	main(String[] headers)
private static List<ParsedHeaderClause>	normalizeCapabilityClauses(Logger logger, List<ParsedHeaderClause> clauses, String mv)
private static List<ParsedHeaderClause>	normalizeDynamicImportClauses(Logger logger, List<ParsedHeaderClause> clauses, String mv)
private static List<ParsedHeaderClause>	normalizeExportClauses(Logger logger, List<ParsedHeaderClause> clauses, String mv, String bsn, Version bv, boolean connectModule)
private static List<ParsedHeaderClause>	normalizeImportClauses(Logger logger, List<ParsedHeaderClause> clauses, String mv)
private static List<ParsedHeaderClause>	normalizeRequireClauses(Logger logger, List<ParsedHeaderClause> clauses, String mv)
private void	parseActivationPolicy(Map<String,String> headerMap)
private static List<BundleRequirement>	parseBreeHeader(String header, BundleRevision owner)
private static BundleCapabilityImpl	parseBundleSymbolicName(Logger logger, BundleRevision owner, Map<String,String> headerMap)
static List<String>	parseDelimitedString(String value, String delim)
static List<String>	parseDelimitedString(String value, String delim, boolean trim)	Parses delimited string and returns an array containing the tokens.
static List<BundleRequirement>	parseDynamicImportHeader(Logger logger, BundleRevision owner, String header)
static String	parseExtensionBundleHeader(String header)
private static List<BundleRequirementImpl>	parseFragmentHost(Logger logger, BundleRevision owner, Map<String,String> headerMap)
private static List<NativeLibraryClause>	parseLibraryStrings(Logger logger, List<String> libStrs)	Parses native code manifest headers.
private static List<ParsedHeaderClause>	parseStandardHeader(String header)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Details

BUNDLE_LICENSE_HEADER

private static final String BUNDLE_LICENSE_HEADER

See Also:

• Constant Field Values

m_logger

private final Logger m_logger

m_configMap

private final Map<String,?> m_configMap

m_headerMap

private final Map<String,String> m_headerMap

m_activationPolicy

private volatile int m_activationPolicy

m_activationIncludeDir

private volatile String m_activationIncludeDir

m_activationExcludeDir

private volatile String m_activationExcludeDir

m_isExtension

private volatile boolean m_isExtension

m_bundleSymbolicName

private volatile String m_bundleSymbolicName

m_bundleVersion

private volatile Version m_bundleVersion

m_capabilities

private volatile List<BundleCapability> m_capabilities

m_requirements

private volatile List<BundleRequirement> m_requirements

m_libraryClauses

private volatile List<NativeLibraryClause> m_libraryClauses

m_libraryHeadersOptional

private volatile boolean m_libraryHeadersOptional

objectCache

private static final Map<Object,WeakReference<Object>> objectCache

cache

private static final Function<Object,Object> cache

EOF

private static final char EOF

See Also:

• Constant Field Values

CLAUSE_START

private static final int CLAUSE_START

See Also:

• Constant Field Values

PARAMETER_START

private static final int PARAMETER_START

See Also:

• Constant Field Values

KEY

private static final int KEY

See Also:

• Constant Field Values

DIRECTIVE_OR_TYPEDATTRIBUTE

private static final int DIRECTIVE_OR_TYPEDATTRIBUTE

See Also:

• Constant Field Values

ARGUMENT

private static final int ARGUMENT

See Also:

• Constant Field Values

VALUE

private static final int VALUE

See Also:

• Constant Field Values

Constructor Details

ManifestParser

public ManifestParser(Logger logger,
 Map<String,?> configMap,
 BundleRevision owner,
 Map<String,String> headerMap)
               throws BundleException

Throws:

BundleException

Method Details

normalizeImportClauses

private static List<ParsedHeaderClause> normalizeImportClauses(Logger logger,
 List<ParsedHeaderClause> clauses,
 String mv)
                                                        throws BundleException

Throws:

BundleException

parseDynamicImportHeader

public static List<BundleRequirement> parseDynamicImportHeader(Logger logger,
 BundleRevision owner,
 String header)
                                                        throws BundleException

Throws:

BundleException

convertImports

private static List<BundleRequirement> convertImports(List<ParsedHeaderClause> clauses,
 BundleRevision owner)

normalizeDynamicImportClauses

private static List<ParsedHeaderClause> normalizeDynamicImportClauses(Logger logger,
 List<ParsedHeaderClause> clauses,
 String mv)
                                                               throws BundleException

Throws:

BundleException

convertRequireCapabilities

private static List<BundleRequirement> convertRequireCapabilities(List<ParsedHeaderClause> clauses,
 BundleRevision owner)
                                                           throws BundleException

Throws:

BundleException

convertNativeCode

static List<BundleRequirement> convertNativeCode(BundleRevision owner,
 List<NativeLibraryClause> nativeLibraryClauses,
 boolean hasOptionalLibraryDirective)

buildFilterFromArray

private static SimpleFilter buildFilterFromArray(String attributeName,
 String[] stringArray,
 int operation)

normalizeCapabilityClauses

private static List<ParsedHeaderClause> normalizeCapabilityClauses(Logger logger,
 List<ParsedHeaderClause> clauses,
 String mv)
                                                            throws BundleException

Throws:

BundleException

convertProvideCapabilities

private static List<BundleCapability> convertProvideCapabilities(List<ParsedHeaderClause> clauses,
 BundleRevision owner)
                                                          throws BundleException

Throws:

BundleException

normalizeExportClauses

private static List<ParsedHeaderClause> normalizeExportClauses(Logger logger,
 List<ParsedHeaderClause> clauses,
 String mv,
 String bsn,
 Version bv,
 boolean connectModule)
                                                        throws BundleException

Throws:

BundleException

convertExports

private static List<BundleCapability> convertExports(List<ParsedHeaderClause> clauses,
 BundleRevision owner)

getManifestVersion

public String getManifestVersion()

getManifestVersion

private static String getManifestVersion(Map<String,String> headerMap)

getActivationPolicy

public int getActivationPolicy()

getActivationIncludeDirective

public String getActivationIncludeDirective()

getActivationExcludeDirective

public String getActivationExcludeDirective()

isExtension

public boolean isExtension()

getSymbolicName

public String getSymbolicName()

getBundleVersion

public Version getBundleVersion()

getCapabilities

public List<BundleCapability> getCapabilities()

getRequirements

public List<BundleRequirement> getRequirements()

getLibraries

public List<NativeLibrary> getLibraries()

This method returns the selected native library metadata from the manifest. The information is not the raw metadata from the manifest, but is the native library clause selected according to the OSGi native library clause selection policy. The metadata returned by this method will be attached directly to a module and used for finding its native libraries at run time. To inspect the raw native library metadata refer to getLibraryClauses().

This method returns one of three values:

• null - if the are no native libraries for this module; this may also indicate the native libraries are optional and did not match the current platform.
• Zero-length NativeLibrary array - if no matching native library clause was found; this bundle should not resolve.
• Nonzero-length NativeLibrary array - the native libraries associated with the matching native library clause.

Returns:

null if there are no native libraries, a zero-length array if no libraries matched, or an array of selected libraries.

getName

private String getName(String path)

getSelectedLibraryClause

private NativeLibraryClause getSelectedLibraryClause()
                                              throws BundleException

Throws:

BundleException

firstSortedClause

private int firstSortedClause(List<NativeLibraryClause> clauseList)

calculateImplicitImports

private static List<ParsedHeaderClause> calculateImplicitImports(List<BundleCapability> exports,
 List<ParsedHeaderClause> imports)
                                                          throws BundleException

Throws:

BundleException

calculateImplicitUses

private static List<BundleCapability> calculateImplicitUses(List<BundleCapability> exports,
 List<ParsedHeaderClause> imports)
                                                     throws BundleException

Throws:

BundleException

checkExtensionBundle

private static boolean checkExtensionBundle(Map<String,String> headerMap)
                                     throws BundleException

Throws:

BundleException

parseBundleSymbolicName

private static BundleCapabilityImpl parseBundleSymbolicName(Logger logger,
 BundleRevision owner,
 Map<String,String> headerMap)
                                                     throws BundleException

Throws:

BundleException

addIdentityCapability

private static BundleCapabilityImpl addIdentityCapability(BundleRevision owner,
 Map<String,String> headerMap,
 BundleCapabilityImpl bundleCap)
                                                   throws BundleException

Throws:

BundleException

parseFragmentHost

private static List<BundleRequirementImpl> parseFragmentHost(Logger logger,
 BundleRevision owner,
 Map<String,String> headerMap)
                                                      throws BundleException

Throws:

BundleException

parseBreeHeader

private static List<BundleRequirement> parseBreeHeader(String header,
 BundleRevision owner)

getBreeVersionClause

private static String getBreeVersionClause(Version ver)

normalizeRequireClauses

private static List<ParsedHeaderClause> normalizeRequireClauses(Logger logger,
 List<ParsedHeaderClause> clauses,
 String mv)

convertRequires

private static List<BundleRequirementImpl> convertRequires(List<ParsedHeaderClause> clauses,
 BundleRevision owner)

parseExtensionBundleHeader

public static String parseExtensionBundleHeader(String header)
                                         throws BundleException

Throws:

BundleException

parseActivationPolicy

private void parseActivationPolicy(Map<String,String> headerMap)

main

public static void main(String[] headers)

charAt

private static char charAt(int pos,
 String headers,
 int length)

parseStandardHeader

private static List<ParsedHeaderClause> parseStandardHeader(String header)

parseDelimitedString

public static List<String> parseDelimitedString(String value,
 String delim)

parseDelimitedString

public static List<String> parseDelimitedString(String value,
 String delim,
 boolean trim)

Parses delimited string and returns an array containing the tokens. This parser obeys quotes, so the delimiter character will be ignored if it is inside of a quote. This method assumes that the quote character is not included in the set of delimiter characters.

Parameters:

value - the delimited string to parse.

delim - the characters delimiting the tokens.

Returns:

a list of string or an empty list if there are none.

parseLibraryStrings

private static List<NativeLibraryClause> parseLibraryStrings(Logger logger,
 List<String> libStrs)
                                                      throws IllegalArgumentException

Parses native code manifest headers.

Parameters:

libStrs - an array of native library manifest header strings from the bundle manifest.

Returns:

an array of LibraryInfo objects for the passed in strings.

Throws:

IllegalArgumentException

aliasSymbolicName

public static List<BundleCapability> aliasSymbolicName(List<BundleCapability> caps,
 BundleRevision owner)