Package aQute.bnd.osgi

Class Analyzer

java.lang.Object

aQute.bnd.osgi.Domain

aQute.bnd.osgi.Processor

aQute.bnd.osgi.Analyzer

All Implemented Interfaces:

Constants, Registry, aQute.service.reporter.Report, aQute.service.reporter.Reporter, java.io.Closeable, java.lang.AutoCloseable, java.lang.Iterable<java.lang.String>

Direct Known Subclasses:

Builder

public class Analyzer
extends Processor

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	Analyzer.Check

Nested classes/interfaces inherited from class aQute.bnd.osgi.Processor

Processor.CL, Processor.FileLine

Nested classes/interfaces inherited from interface aQute.service.reporter.Report

aQute.service.reporter.Report.Location

Nested classes/interfaces inherited from interface aQute.service.reporter.Reporter

aQute.service.reporter.Reporter.SetLocation

Field Summary

Fields

Modifier and Type	Field	Description
protected AnalyzerMessages	msgs

Fields inherited from interface aQute.bnd.osgi.Constants

AUGMENT, AUGMENT_CAPABILITY_DIRECTIVE, AUGMENT_RANGE_ATTRIBUTE, AUGMENT_REQUIREMENT_DIRECTIVE, BASELINE, BASELINEREPO, BLUEPRINT_TIMEOUT_ATTRIBUTE, BLUEPRINT_WAIT_FOR_DEPENDENCIES_ATTRIBUTE, BND_ADDXMLTOTEST, BND_LASTMODIFIED, BNDDRIVER, BNDDRIVER_ANT, BNDDRIVER_BND, BNDDRIVER_ECLIPSE, BNDDRIVER_GRADLE, BNDDRIVER_GRADLE_NATIVE, BNDDRIVER_INTELLIJ, BNDDRIVER_MAVEN, BNDDRIVER_OSMORC, BNDDRIVER_SBT, BUILDFILES, BUILDPACKAGES, BUILDPATH, BUILDREPO, BUMPPOLICY, BUNDLE_ACTIVATIONPOLICY, BUNDLE_ACTIVATOR, BUNDLE_BLUEPRINT, BUNDLE_CATEGORY, BUNDLE_CLASSPATH, BUNDLE_CONTACTADDRESS, BUNDLE_CONTRIBUTORS, BUNDLE_COPYRIGHT, BUNDLE_DESCRIPTION, BUNDLE_DEVELOPERS, BUNDLE_DOCURL, BUNDLE_ICON, BUNDLE_LICENSE, BUNDLE_LOCALIZATION, BUNDLE_MANIFESTVERSION, BUNDLE_NAME, BUNDLE_NATIVECODE, BUNDLE_REQUIREDEXECUTIONENVIRONMENT, BUNDLE_SCM, BUNDLE_SPECIFIC_HEADERS, BUNDLE_SYMBOLIC_NAME_ATTRIBUTE, BUNDLE_SYMBOLICNAME, BUNDLE_UPDATELOCATION, BUNDLE_VENDOR, BUNDLE_VERSION, BUNDLE_VERSION_ATTRIBUTE, CACHEDIR, CARDINALITY_DIRECTIVE, CHECK, CLASSPATH, COMMAND_DIRECTIVE, COMPILER_SOURCE, COMPILER_TARGET, COMPONENT_ACTIVATE, COMPONENT_CONFIGURATION_POLICY, COMPONENT_DEACTIVATE, COMPONENT_DESCRIPTORS, COMPONENT_DESIGNATE, COMPONENT_DESIGNATEFACTORY, COMPONENT_DYNAMIC, COMPONENT_ENABLED, COMPONENT_FACTORY, COMPONENT_GREEDY, COMPONENT_IMMEDIATE, COMPONENT_IMPLEMENTATION, COMPONENT_MODIFIED, COMPONENT_MULTIPLE, COMPONENT_NAME, COMPONENT_NAMESPACE, COMPONENT_OPTIONAL, COMPONENT_PROPERTIES, COMPONENT_PROVIDE, COMPONENT_SERVICEFACTORY, COMPONENT_VERSION, componentDirectives, CONDITIONAL_PACKAGE, CONDITIONALPACKAGE, CONDUIT, CONNECTION_SETTINGS, CONSUMER_POLICY, CONTRACT, CREATED_BY, CURRENT_PACKAGE, CURRENT_USES, CURRENT_VERSION, DEBUG, DEFAULT_BAR_EXTENSION, DEFAULT_BND_EXTENSION, DEFAULT_BNDRUN_EXTENSION, DEFAULT_CHARSET, DEFAULT_DO_NOT_COPY, DEFAULT_JAR_EXTENSION, DEFAULT_LAUNCHER_BSN, DEFAULT_PREPROCESSS_MATCHERS, DEFAULT_PROP_BIN_DIR, DEFAULT_PROP_SRC_DIR, DEFAULT_PROP_TARGET_DIR, DEFAULT_PROP_TESTBIN_DIR, DEFAULT_PROP_TESTSRC_DIR, DEFAULT_TESTER_BSN, DEPENDSON, DEPLOY, DEPLOYREPO, DESCRIPTION_ATTRIBUTE, DIFFIGNORE, DIFFPACKAGES, DIGESTS, directives, DISTRO, DONOTCOPY, DSANNOTATIONS, DSANNOTATIONS_OPTIONS, DUPLICATE_MARKER, DYNAMICIMPORT_PACKAGE, EEPROFILE, EEPROFILE_AUTO_ATTRIBUTE, EFFECTIVE_DIRECTIVE, EMBEDDED_REPO, EMPTY, EMPTY_HEADER, EXCLUDE_DIRECTIVE, EXPERIMENTS, EXPORT, EXPORT_CONTENTS, EXPORT_PACKAGE, EXPORT_SERVICE, EXPORTTYPE, EXTENSION, EXTENSION_DIRECTIVE, FAIL_OK, FILTER_DIRECTIVE, FIXUPMESSAGES, FIXUPMESSAGES_IS_DIRECTIVE, FIXUPMESSAGES_IS_ERROR, FIXUPMESSAGES_IS_IGNORE, FIXUPMESSAGES_IS_WARNING, FIXUPMESSAGES_REPLACE_DIRECTIVE, FIXUPMESSAGES_RESTRICT_DIRECTIVE, FRAGMENT_ATTACHMENT_DIRECTIVE, FRAGMENT_HOST, FROM_DIRECTIVE, GESTALT, GESTALT_BATCH, GESTALT_CI, GESTALT_INTERACTIVE, GESTALT_OFFLINE, GESTALT_SHELL, GROUPID, headers, IGNORE_PACKAGE, IGNORE_STANDALONE, IMPORT_DIRECTIVE, IMPORT_PACKAGE, IMPORT_PRIVATE, IMPORT_REFERENCE, IMPORT_SERVICE, importDirectives, INCLUDE, INCLUDE_DIRECTIVE, INCLUDE_RESOURCE, INCLUDERESOURCE, INIT, INTERNAL_EXPORTED_DIRECTIVE, INTERNAL_SOURCE_DIRECTIVE, INVALIDFILENAMES, JAVA, JAVA_DEBUG, JAVAAGENT, JAVAC, JAVAC_PROFILE, JAVAC_SOURCE, JAVAC_TARGET, JIDENTIFIER, KEYSTORE_LOCATION_DIRECTIVE, KEYSTORE_PASSWORD_DIRECTIVE, KEYSTORE_PROVIDER_DIRECTIVE, LANGUAGE_ATTRIBUTE, LAUNCHER_PLUGIN, LIB_DIRECTIVE, LINK_ATTRIBUTE, LITERAL_ATTRIBUTE, MAKE, MANDATORY_DIRECTIVE, MANIFEST, MANIFEST_NAME, MAVEN_RELEASE, META_PERSISTENCE, METAPACKAGES, METATYPE, METATYPE_ANNOTATIONS, METATYPE_ANNOTATIONS_OPTIONS, NAME_ATTRIBUTE, NAMESECTION, NAMESPACE_STEM, NO_IMPORT_DIRECTIVE, NOANNOTATIONS, NOBUILDINCACHE, NOBUNDLES, NODEFAULTVERSION, NOEE, NOEXTRAHEADERS, NOJUNIT, NOJUNITOSGI, NOMANIFEST, NONE, NOUSES, OPTIONAL, options, OSNAME_ATTRIBUTE, OSVERSION_ATTRIBUTE, OUTPUT, OUTPUTMASK, PACKAGE, PACKAGE_JPM, PACKAGEINFOTYPE, PATH_DIRECTIVE, PEDANTIC, PLUGIN, PLUGINPATH, PLUGINPATH_SHA1_ATTR, PLUGINPATH_URL_ATTR, POM, PREPROCESSMATCHERS, PRESENCE_DIRECTIVE, PRIVATE_DIRECTIVE, PRIVATE_PACKAGE, PRIVATEPACKAGE, PROCESSOR_ATTRIBUTE, PROFILE, PROVIDE_CAPABILITY, PROVIDE_DIRECTIVE, PROVIDER_POLICY, PROVIDER_TYPE_DIRECTIVE, RELEASEREPO, REMOVE_ATTRIBUTE_DIRECTIVE, REMOVEHEADERS, REPORTNEWER, REPOSITORIES, REQUIRE_BND, REQUIRE_BUNDLE, REQUIRE_CAPABILITY, RESOLUTION, RESOLUTION_DIRECTIVE, RESOLUTION_DYNAMIC, RESOLVE, RESOURCEONLY, RUNBLACKLIST, RUNBUILDS, RUNBUNDLES, RUNEE, RUNENV, RUNFRAMEWORK, RUNFRAMEWORK_NONE, RUNFRAMEWORK_SERVICES, RUNFW, RUNJDB, RUNKEEP, RUNNOREFERENCES, RUNPATH, RUNPATH_LAUNCHER_DIRECTIVE, RUNPATH_MAIN_DIRECTIVE, RUNPROGRAMARGS, RUNPROPERTIES, RUNPROVIDEDCAPABILITIES, RUNREMOTE, RUNREPOS, RUNREQUIRE, RUNREQUIRES, RUNSTORAGE, RUNSYSTEMCAPABILITIES, RUNSYSTEMPACKAGES, RUNTIMEOUT, RUNTRACE, RUNVM, SAVEMANIFEST, SELECTION_FILTER_ATTRIBUTE, SERVICE_COMPONENT, SET_COMPONENT_DIRECTIVES, SET_COMPONENT_DIRECTIVES_1_1, SET_COMPONENT_DIRECTIVES_1_2, SIGN, SIGN_PASSWORD_DIRECTIVE, SIGNATURE_TEST, SINGLETON_DIRECTIVE, SIZE_ATTRIBUTE, SNAPSHOT, SOURCEPATH, SOURCES, SPECIFICATION_VERSION, SPLIT_PACKAGE_DIRECTIVE, STANDALONE, STRICT, SUB, SYSTEMPROPERTIES, TESTCASES, TESTCONTINUOUS, TESTER, TESTER_PLUGIN, TESTPACKAGES, TESTPATH, TESTREPORT, TESTSOURCES, TESTSUITES, TESTUNRESOLVED, TOOL, TSTAMP, UNDERTEST, UPTO, USES_DIRECTIVE, USES_USES, VALID_PROPERTY_TYPES, VERBOSE, VERSION_ATTR_HASH, VERSION_ATTR_LATEST, VERSION_ATTR_PROJECT, VERSION_ATTR_SNAPSHOT, VERSION_ATTRIBUTE, VERSION_FILTER, VISIBILITY_DIRECTIVE, WAB, WABLIB, WORKINGSET, WORKINGSET_MEMBER

Fields inherited from class aQute.bnd.osgi.Processor

LIST_SPLITTER, log

Constructor Summary

Constructors

Constructor	Description
Analyzer()
Analyzer(Jar jar)
Analyzer(Processor parent)

Method Summary

Modifier and Type	Method	Description
java.lang.String	_bsn(java.lang.String[] args)
java.lang.String	_classes(java.lang.String... args)
java.lang.String	_ee(java.lang.String[] args)
java.lang.String	_exporters(java.lang.String[] args)	Get the exporter of a package ...
java.lang.String	_exports(java.lang.String[] args)
java.lang.String	_findname(java.lang.String[] args)
java.lang.String	_findpath(java.lang.String[] args)	Findpath looks through the contents of the JAR and finds paths that end with the given regular expression ${findpath (; reg-expr (; replacement)? )? }
java.lang.String	_imports(java.lang.String[] args)
java.lang.String	_md5(java.lang.String[] args)
java.lang.String	_packageattribute(java.lang.String[] args)	Return an attribute of a package
java.lang.String	_packages(java.lang.String... args)
java.lang.String	_sha1(java.lang.String[] args)
void	addClasspath(Jar jar)
void	addClasspath(java.io.File cp)
void	addClasspath(java.util.Collection<?> jars)
void	analyze()	Calculates the data structures for generating a manifest.
boolean	assignable(Clazz annoServiceClazz, Clazz inferredServiceClazz)
boolean	assignable(java.lang.String annoService, java.lang.String inferredService)
protected void	begin()
java.util.jar.Manifest	calcManifest()	One of the main workhorses of this class.
java.lang.String	calculateExportsFromContents(Jar bundle)	Calculate an export header solely based on the contents of a JAR file
boolean	check(Analyzer.Check key)	Check if we have an a check option
java.util.Map<Descriptors.PackageRef,java.util.List<Descriptors.PackageRef>>	cleanupUses(java.util.Map<Descriptors.PackageRef,java.util.List<Descriptors.PackageRef>> apiUses, boolean removeJava)	Remove the own references and optional java references from the uses lib
static java.lang.String	cleanupVersion(java.lang.String version)
void	clear()
void	close()
protected void	doRequireBnd()	Ensure that we are running on the correct bnd.
protected void	doUses(Descriptors.PackageRef packageRef, Packages exports, java.util.Map<Descriptors.PackageRef,java.util.List<Descriptors.PackageRef>> uses, Packages imports)
Clazz	findClass(Descriptors.TypeRef typeRef)	Find a clazz on the class path.
Resource	findResource(java.lang.String path)	Locate a resource on the class path.
void	forceRefresh()
java.util.Map<Descriptors.PackageRef,java.util.List<Descriptors.PackageRef>>	getAPIUses()
java.lang.String	getBndInfo(java.lang.String key, java.lang.String defaultValue)
long	getBndLastModified()
java.lang.String	getBndVersion()	Get the version for this bnd
java.lang.String	getBsn()	Clear the key part of a header.
java.util.Collection<Clazz>	getClasses(java.lang.String... args)
java.util.List<Jar>	getClasspath()
Packages	getClasspathExports()
java.util.Map<Descriptors.TypeRef,Clazz>	getClassspace()
java.util.Set<Clazz>	getClassspace(Descriptors.PackageRef source)	Return the classes for a given source package.
Packages	getContained()
Descriptors.Descriptor	getDescriptor(java.lang.String descriptor)
java.util.SortedSet<Clazz.JAVA>	getEEs()	Return the EEs
Packages	getExports()
protected Jar	getExtra()
Clazz.JAVA	getHighestEE()
Packages	getImports()
Jar	getJar()
Jar	getJarFromName(java.lang.String name, java.lang.String from)	Try to get a Jar from a file name/path or a url, or in last resort from the classpath name part of their files.
java.util.List<Jar>	getJarsFromName(java.lang.String name, java.lang.String from)
Clazz.JAVA	getLowestEE()
static java.util.Properties	getManifest(java.io.File dirOrJar)	Specifically for Maven
protected java.lang.String	getName(Jar jar)
java.io.File	getOutputFile(java.lang.String output)	Calculate the output file for the given target.
Descriptors.PackageRef	getPackageRef(java.lang.String binaryName)
java.util.Collection<Descriptors.PackageRef>	getPackages(Packages scope, java.lang.String... args)
java.util.Set<Descriptors.PackageRef>	getPrivates()
Packages	getReferred()
java.lang.String	getSourceFileFor(Descriptors.TypeRef type)	Find the source file for this type
java.lang.String	getSourceFileFor(Descriptors.TypeRef type, java.util.Collection<java.io.File> sourcePath)
Jar	getTarget()
Descriptors.TypeRef	getTypeRef(java.lang.String binaryClassName)
Descriptors.TypeRef	getTypeRefFromFQN(java.lang.String fqn)
Descriptors.TypeRef	getTypeRefFromPath(java.lang.String path)
java.util.Set<Descriptors.PackageRef>	getUnreachable()	Return the set of unreachable code depending on exports and the bundle activator.
java.util.Map<Descriptors.PackageRef,java.util.List<Descriptors.PackageRef>>	getUses()
java.lang.String	getVersion()	Answer the bundle version.
java.lang.String	getVersionPolicy(boolean implemented)
java.util.Map<Clazz.Def,java.util.List<Descriptors.TypeRef>>	getXRef(Descriptors.PackageRef source, java.util.Collection<Descriptors.PackageRef> dest, int sourceModifiers)	Create a cross reference from package source, to packages in dest
boolean	isImported(Descriptors.PackageRef packageRef)
boolean	isNoBundle()
void	mergeManifest(java.util.jar.Manifest manifest)	Merge the existing manifest with the instructions but do not override existing properties.
void	putAll(java.util.Map<java.lang.String,java.lang.String> additional, boolean force)
boolean	referred(Descriptors.PackageRef packageName)
void	referTo(Descriptors.TypeRef ref)
void	referToByBinaryName(java.lang.String binaryClassName)
void	report(java.util.Map<java.lang.String,java.lang.Object> table)	Report the details of this analyzer
boolean	save(java.io.File output, boolean force)	Utility function to carefully save the file.
void	setBase(java.io.File file)
void	setClasspath(Jar[] classpath)
void	setClasspath(java.io.File[] classpath)
void	setClasspath(java.lang.String[] classpath)
void	setClasspath(java.util.Collection<?> classpath)	Set the classpath for this analyzer by file.
void	setDefaults(java.lang.String bsn, Version version)	Set default import and export instructions if none are set
void	setDiagnostics(boolean b)
Jar	setJar(Jar jar)	Set the JAR directly we are going to work on.
Jar	setJar(java.io.File file)	Set the JAR file we are going to work in.
void	setTypeLocation(aQute.service.reporter.Reporter.SetLocation location, Descriptors.TypeRef type)	Set location information for a type.
java.lang.String	validResourcePath(java.lang.String name, java.lang.String reportIfWrong)

Methods inherited from class aQute.bnd.osgi.Domain

copyFrom, domain, domain, domain, domain, domain, getBundleActivator, getBundleCategory, getBundleClasspath, getBundleClassPath, getBundleContactAddress, getBundleCopyright, getBundleDescription, getBundleDocURL, getBundleName, getBundleNative, getBundleRequiredExecutionEnvironment, getBundleSymbolicName, getBundleVendor, getBundleVersion, getDynamicImportPackage, getExportContents, getExportPackage, getFragmentHost, getIcon, getImportPackage, getIncludeResource, getParameters, getParameters, getParameters, getParameters, getPrivatePackage, getProvideCapability, getRequireBundle, getRequireCapability, getRunblacklist, getRunee, isSources, setAugment, setBundleActivator, setBundleClasspath, setBundleRequiredExecutionEnvironment, setBundleSymbolicName, setBundleVersion, setBundleVersion, setConditionalPackage, setExportPackage, setFailOk, setImportPackage, setIncludeResource, setPrivatePackage, setRunblacklist, setRunee, setRunfw, setRunRequires, setSources, setTranslation, translate, translate

Methods inherited from interface java.lang.Iterable

forEach, spliterator

Methods inherited from class java.lang.Object

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

Methods inherited from class aQute.bnd.osgi.Processor

_basedir, _fileuri, _findfile, _frange, _native_capability, _propertiesdir, _propertiesname, _random, _thisfile, _uri, addBasicPlugin, addClose, addExtensions, addIncluded, addProperties, addProperties, append, appendPath, beginHandleErrors, check, concat, customize, doAttrbutes, doIncludeFile, doIncludeFile, endHandleErrors, error, error, exception, exists, findHeader, findHeader, findHeader, formatArrays, get, get, getBase, getBaseURI, getClass, getDuration, getErrors, getExecutor, getFile, getFile, getFlattenedProperties, getFlattenedProperties, getHeader, getHeader, getHeader, getHeader, getIncluded, getInfo, getInfo, getLine, getLoader, getLocation, getLogger, getMacroDomains, getManifestAsProperties, getMergedParameters, getParent, getPlugin, getPlugins, getPlugins, getProperties, getPropertiesFile, getProperty, getProperty, getProperty, getPropertyKeys, getReplacer, getScheduledExecutor, getSettings, getTop, getUnprocessedProperty, getWarnings, is, isDuplicate, isExceptions, isFailOk, isMissingPlugin, isOk, isPedantic, isPerfect, isTrace, isTrue, iterator, join, join, join, join, join, keySet, lastModified, loadPlugins, loadProperties, makePrintable, merge, mergeLocalProperties, mergeProperties, mergeProperties, mergeProperties, mergeProperties, newHashMap, newList, newList, newMap, newMap, newSet, newSet, normalize, normalize, parseHeader, parseHeader, printClause, printClauses, printClauses, printExceptionSummary, printStackTrace, progress, progress, propertiesChanged, quote, read, refresh, removeBasicPlugin, removeClose, removeDuplicateMarker, replaceAll, replaceExtension, report, set, setExceptions, setFileMustExist, setForceLocal, setParent, setPedantic, setProperties, setProperties, setProperties, setProperties, setProperty, setTrace, setTypeSpecificPlugins, signal, since, split, split, split, toFullHeaderPattern, toString, trace, unsetProperty, updateModified, use, warning

Field Detail

msgs

protected final AnalyzerMessages msgs

Constructor Detail

Analyzer

public Analyzer(Jar jar)
         throws java.lang.Exception

Throws:

java.lang.Exception

Analyzer

public Analyzer(Processor parent)

Analyzer

public Analyzer()

Method Detail

getManifest

public static java.util.Properties getManifest(java.io.File dirOrJar)
                                        throws java.lang.Exception

Specifically for Maven

Throws:

java.lang.Exception

analyze

public void analyze()
             throws java.lang.Exception

Calculates the data structures for generating a manifest.

Throws:

java.io.IOException

java.lang.Exception

getName

protected java.lang.String getName(Jar jar)
                            throws java.lang.Exception

Throws:

java.lang.Exception

getExtra

protected Jar getExtra()
                throws java.lang.Exception

Throws:

java.lang.Exception

calcManifest

public java.util.jar.Manifest calcManifest()
                                    throws java.lang.Exception

One of the main workhorses of this class. This will analyze the current setup and calculate a new manifest according to this setup.

Throws:

java.io.IOException

java.lang.Exception

getBsn

public java.lang.String getBsn()

Clear the key part of a header. I.e. remove everything from the first ';'

_bsn

public java.lang.String _bsn(java.lang.String[] args)

calculateExportsFromContents

public java.lang.String calculateExportsFromContents(Jar bundle)

Calculate an export header solely based on the contents of a JAR file

Parameters:

bundle - The jar file to analyze

getContained

public Packages getContained()

getExports

public Packages getExports()

getImports

public Packages getImports()

getPrivates

public java.util.Set<Descriptors.PackageRef> getPrivates()

getJar

public Jar getJar()

getReferred

public Packages getReferred()

getUnreachable

public java.util.Set<Descriptors.PackageRef> getUnreachable()

Return the set of unreachable code depending on exports and the bundle activator.

getUses

public java.util.Map<Descriptors.PackageRef,java.util.List<Descriptors.PackageRef>> getUses()

getAPIUses

public java.util.Map<Descriptors.PackageRef,java.util.List<Descriptors.PackageRef>> getAPIUses()

getClasspathExports

public Packages getClasspathExports()

getBndVersion

public java.lang.String getBndVersion()

Get the version for this bnd

Returns:

version or unknown.

getBndLastModified

public long getBndLastModified()

getBndInfo

public java.lang.String getBndInfo(java.lang.String key,
                                   java.lang.String defaultValue)

mergeManifest

public void mergeManifest(java.util.jar.Manifest manifest)
                   throws java.io.IOException

Merge the existing manifest with the instructions but do not override existing properties.

Parameters:

manifest - The manifest to merge with

Throws:

java.io.IOException

setBase

public void setBase(java.io.File file)

Overrides:

setBase in class Processor

setClasspath

public void setClasspath(java.util.Collection<?> classpath)
                  throws java.io.IOException

Set the classpath for this analyzer by file.

Parameters:

classpath -

Throws:

java.io.IOException

setClasspath

public void setClasspath(java.io.File[] classpath)
                  throws java.io.IOException

Throws:

java.io.IOException

setClasspath

public void setClasspath(Jar[] classpath)

setClasspath

public void setClasspath(java.lang.String[] classpath)

setJar

public Jar setJar(java.io.File file)
           throws java.io.IOException

Set the JAR file we are going to work in. This will read the JAR in memory.

Parameters:

file -

Throws:

java.io.IOException

setJar

public Jar setJar(Jar jar)

Set the JAR directly we are going to work on.

Parameters:

jar -

begin

protected void begin()

Overrides:

begin in class Processor

getJarFromName

public Jar getJarFromName(java.lang.String name,
                          java.lang.String from)

Try to get a Jar from a file name/path or a url, or in last resort from the classpath name part of their files.

Overrides:

getJarFromName in class Processor

Parameters:

name - URL or filename relative to the base

from - Message identifying the caller for errors

Returns:

null or a Jar with the contents for the name

getJarsFromName

public java.util.List<Jar> getJarsFromName(java.lang.String name,
                                           java.lang.String from)

referred

public boolean referred(Descriptors.PackageRef packageName)

doUses

protected void doUses(Descriptors.PackageRef packageRef,
                      Packages exports,
                      java.util.Map<Descriptors.PackageRef,java.util.List<Descriptors.PackageRef>> uses,
                      Packages imports)

Parameters:

packageRef -

exports -

uses -

imports -

close

public void close()
           throws java.io.IOException

Specified by:

close in interface java.lang.AutoCloseable

Specified by:

close in interface java.io.Closeable

Overrides:

close in class Processor

Throws:

java.io.IOException

_findpath

public java.lang.String _findpath(java.lang.String[] args)

Findpath looks through the contents of the JAR and finds paths that end with the given regular expression ${findpath (; reg-expr (; replacement)? )? }

Parameters:

args -

_findname

public java.lang.String _findname(java.lang.String[] args)

putAll

public void putAll(java.util.Map<java.lang.String,java.lang.String> additional,
                   boolean force)

getClasspath

public java.util.List<Jar> getClasspath()

addClasspath

public void addClasspath(Jar jar)

addClasspath

public void addClasspath(java.util.Collection<?> jars)
                  throws java.io.IOException

Throws:

java.io.IOException

addClasspath

public void addClasspath(java.io.File cp)
                  throws java.io.IOException

Throws:

java.io.IOException

clear

public void clear()

Overrides:

clear in class Processor

forceRefresh

public void forceRefresh()

Overrides:

forceRefresh in class Processor

getTarget

public Jar getTarget()

cleanupVersion

public static java.lang.String cleanupVersion(java.lang.String version)

getVersionPolicy

public java.lang.String getVersionPolicy(boolean implemented)

_classes

public java.lang.String _classes(java.lang.String... args)
                          throws java.lang.Exception

Throws:

java.lang.Exception

getClasses

public java.util.Collection<Clazz> getClasses(java.lang.String... args)
                                       throws java.lang.Exception

Throws:

java.lang.Exception

_packages

public java.lang.String _packages(java.lang.String... args)
                           throws java.lang.Exception

Throws:

java.lang.Exception

getPackages

public java.util.Collection<Descriptors.PackageRef> getPackages(Packages scope,
                                                                java.lang.String... args)
                                                         throws java.lang.Exception

Throws:

java.lang.Exception

_exporters

public java.lang.String _exporters(java.lang.String[] args)
                            throws java.lang.Exception

Get the exporter of a package ...

Throws:

java.lang.Exception

getClassspace

public java.util.Map<Descriptors.TypeRef,Clazz> getClassspace()

_packageattribute

public java.lang.String _packageattribute(java.lang.String[] args)

Return an attribute of a package

findResource

public Resource findResource(java.lang.String path)

Locate a resource on the class path.

Parameters:

path - Path of the reosurce

Returns:

A resource or null

findClass

public Clazz findClass(Descriptors.TypeRef typeRef)
                throws java.lang.Exception

Find a clazz on the class path. This class has been parsed.

Throws:

java.lang.Exception

getVersion

public java.lang.String getVersion()

Answer the bundle version.

isNoBundle

public boolean isNoBundle()

referTo

public void referTo(Descriptors.TypeRef ref)

referToByBinaryName

public void referToByBinaryName(java.lang.String binaryClassName)

doRequireBnd

protected void doRequireBnd()

Ensure that we are running on the correct bnd.

_md5

public java.lang.String _md5(java.lang.String[] args)
                      throws java.lang.Exception

Throws:

java.lang.Exception

_sha1

public java.lang.String _sha1(java.lang.String[] args)
                       throws java.lang.Exception

Throws:

java.lang.Exception

getDescriptor

public Descriptors.Descriptor getDescriptor(java.lang.String descriptor)

getTypeRef

public Descriptors.TypeRef getTypeRef(java.lang.String binaryClassName)

getPackageRef

public Descriptors.PackageRef getPackageRef(java.lang.String binaryName)

getTypeRefFromFQN

public Descriptors.TypeRef getTypeRefFromFQN(java.lang.String fqn)

getTypeRefFromPath

public Descriptors.TypeRef getTypeRefFromPath(java.lang.String path)

isImported

public boolean isImported(Descriptors.PackageRef packageRef)

setDiagnostics

public void setDiagnostics(boolean b)

getLowestEE

public Clazz.JAVA getLowestEE()

getHighestEE

public Clazz.JAVA getHighestEE()

_ee

public java.lang.String _ee(java.lang.String[] args)

getOutputFile

public java.io.File getOutputFile(java.lang.String output)

Calculate the output file for the given target. The strategy is:

 parameter given if not null and not directory if directory, this will be
 the output directory based on bsn-version.jar name of the source file if
 exists Untitled-[n]
 

Parameters:

output - may be null, otherwise a file path relative to base

save

public boolean save(java.io.File output,
                    boolean force)
             throws java.lang.Exception

Utility function to carefully save the file. Will create a backup if the source file has the same path as the output. It will also only save if the file was modified or the force flag is true

Parameters:

output - the output file, if null getOutputFile(String) is used.

force - if it needs to be overwritten

Throws:

java.lang.Exception

setDefaults

public void setDefaults(java.lang.String bsn,
                        Version version)

Set default import and export instructions if none are set

cleanupUses

public java.util.Map<Descriptors.PackageRef,java.util.List<Descriptors.PackageRef>> cleanupUses(java.util.Map<Descriptors.PackageRef,java.util.List<Descriptors.PackageRef>> apiUses,
                                                                                                boolean removeJava)

Remove the own references and optional java references from the uses lib

Parameters:

apiUses -

removeJava -

getClassspace

public java.util.Set<Clazz> getClassspace(Descriptors.PackageRef source)

Return the classes for a given source package.

Parameters:

source - the source package

Returns:

a set of classes for the requested package.

getXRef

public java.util.Map<Clazz.Def,java.util.List<Descriptors.TypeRef>> getXRef(Descriptors.PackageRef source,
                                                                            java.util.Collection<Descriptors.PackageRef> dest,
                                                                            int sourceModifiers)
                                                                     throws java.lang.Exception

Create a cross reference from package source, to packages in dest

Parameters:

source -

dest -

sourceModifiers -

Throws:

java.lang.Exception

_exports

public java.lang.String _exports(java.lang.String[] args)

_imports

public java.lang.String _imports(java.lang.String[] args)

report

public void report(java.util.Map<java.lang.String,java.lang.Object> table)
            throws java.lang.Exception

Report the details of this analyzer

Overrides:

report in class Processor

Throws:

java.lang.Exception

getEEs

public java.util.SortedSet<Clazz.JAVA> getEEs()

Return the EEs

validResourcePath

public java.lang.String validResourcePath(java.lang.String name,
                                          java.lang.String reportIfWrong)

Parameters:

name -

check

public boolean check(Analyzer.Check key)

Check if we have an a check option

getSourceFileFor

public java.lang.String getSourceFileFor(Descriptors.TypeRef type)
                                  throws java.lang.Exception

Find the source file for this type

Parameters:

type -

Throws:

java.lang.Exception

getSourceFileFor

public java.lang.String getSourceFileFor(Descriptors.TypeRef type,
                                         java.util.Collection<java.io.File> sourcePath)
                                  throws java.lang.Exception

Throws:

java.lang.Exception

setTypeLocation

public void setTypeLocation(aQute.service.reporter.Reporter.SetLocation location,
                            Descriptors.TypeRef type)
                     throws java.lang.Exception

Set location information for a type.

Throws:

java.lang.Exception

assignable

public boolean assignable(java.lang.String annoService,
                          java.lang.String inferredService)

assignable

public boolean assignable(Clazz annoServiceClazz,
                          Clazz inferredServiceClazz)