Package aQute.bnd.osgi

Class Processor

java.lang.Object

aQute.bnd.osgi.Domain

aQute.bnd.osgi.Processor

All Implemented Interfaces:

Constants, Registry, Report, Reporter, Closeable, AutoCloseable, Iterable<String>

Direct Known Subclasses:

Analyzer, bnd, BuildContext, CommunicationCommands, EclipseCommand, HeaderReader, IndexCommand, JarPrinter, Makefile, MavenCommand, MavenDeployCmd, PomParser, Profiles, Project, ProjectLauncher, ServiceComponent.ComponentMaker, Signer, ToolManager, Verifier, Workspace, XmlRepoDiffCommand, XMLResourceParser

public class Processor
extends Domain
implements Reporter, Registry, Constants, Closeable

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	Processor.CL
static class	Processor.FileLine
(package private) static class	Processor.SetLocationImpl

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

Report.Location

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

Reporter.SetLocation

Field Summary

Fields

Modifier and Type	Field	Description
(package private) static final String	_frangeHelp
(package private) static final String	_uriHelp
private File	base
private URI	baseURI
private final Set<Object>	basicPlugins
(package private) static final int	BUFFER_SIZE
(package private) static final ThreadLocal<Processor>	current
private static final Pattern	DURATION_P
(package private) final List<String>	errors
(package private) boolean	exceptions
private static final Memoize<ExecutorGroup>	executors
(package private) boolean	fileMustExist
(package private) Collection<String>	filter
private boolean	fixup
(package private) boolean	fixupMessages
private final CopyOnWriteArrayList<File>	included
private long	lastModified
static final String	LIST_SPLITTER
(package private) List<Report.Location>	locations	Create a location object and add it to the locations
static Reporter	log
private static final org.slf4j.Logger	logger
private Processor	parent
(package private) boolean	pedantic
private CloseableMemoize<Processor.CL>	pluginLoader
private Memoize<PluginsContainer>	pluginsContainer
(package private) String	profile
(package private) Properties	properties
private File	propertiesFile
private static final Memoize<Random>	random
private Macro	replacer
(package private) Boolean	strict
private final Set<AutoCloseable>	toBeClosed
(package private) boolean	trace
(package private) Version	upto	This method is about compatibility.
(package private) final List<String>	warnings

Fields inherited from class aQute.bnd.osgi.Domain

translation

Fields inherited from interface aQute.bnd.osgi.Constants

ACCESS_ATTRIBUTE, AUGMENT, AUGMENT_CAPABILITY_DIRECTIVE, AUGMENT_RANGE_ATTRIBUTE, AUGMENT_REQUIREMENT_DIRECTIVE, AUTOMATIC_MODULE_NAME, 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, BSN_SOURCE_SUFFIX, BUILDERIGNORE, BUILDFILES, 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, BUNDLEANNOTATIONS, CARDINALITY_DIRECTIVE, CDIANNOTATIONS, CHECK, CLASS_ATTRIBUTE, CLASSPATH, COMMAND_DIRECTIVE, COMPONENT_ACTIVATE, COMPONENT_CONFIGURATION_POLICY, COMPONENT_DEACTIVATE, COMPONENT_DESCRIPTORS, COMPONENT_DESIGNATE, COMPONENT_DESIGNATEFACTORY, COMPONENT_DIRECTIVES, COMPONENT_DIRECTIVES_1_1, COMPONENT_DIRECTIVES_1_2, 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, COMPRESSION, CONDITIONAL_PACKAGE, CONDITIONALPACKAGE, CONDUIT, CONNECTION_SETTINGS, CONSUMER_POLICY, CONTRACT, CREATED_BY, CURRENT_BUNDLESYMBOLICNAME, CURRENT_BUNDLEVERSION, CURRENT_PACKAGE, CURRENT_USES, CURRENT_VERSION, 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, DEFINE_CONTRACT, DEPENDSON, DEPLOY, DEPLOYREPO, DESCRIPTION_ATTRIBUTE, DIFFIGNORE, DIFFPACKAGES, DIGESTS, directives, DISTRO, DONOTCOPY, DSANNOTATIONS, DSANNOTATIONS_OPTIONS, DUPLICATE_MARKER, DYNAMICIMPORT_PACKAGE, EE_ATTRIBUTE, EEPROFILE, EEPROFILE_AUTO_ATTRIBUTE, EFFECTIVE_DIRECTIVE, EMBEDDED_REPO, EMPTY_HEADER, EXCLUDE_DIRECTIVE, EXECUTABLE, EXPORT, EXPORT_APIGUARDIAN, EXPORT_BSN, EXPORT_CONTENTS, EXPORT_NAME, EXPORT_PACKAGE, EXPORT_SERVICE, EXPORT_TYPE, EXPORT_VERSION, EXPORTS_ATTRIBUTE, 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, GENERATE, GESTALT, GESTALT_BATCH, GESTALT_CI, GESTALT_INTERACTIVE, GESTALT_OFFLINE, GESTALT_SHELL, GROUPID, headers, IDENTITY_INITIAL_RESOURCE, IDENTITY_SYSTEM_RESOURCE, IGNORE_ATTRIBUTE, IGNORE_PACKAGE, IGNORE_STANDALONE, IMPORT_DIRECTIVE, IMPORT_PACKAGE, IMPORT_PRIVATE, IMPORT_REFERENCE, IMPORT_SERVICE, importDirectives, INCLUDE, INCLUDE_DIRECTIVE, INCLUDE_RESOURCE, INCLUDEPACKAGE, INCLUDERESOURCE, INIT, INTERNAL_BUNDLESYMBOLICNAME_DIRECTIVE, INTERNAL_BUNDLEVERSION_DIRECTIVE, INTERNAL_EXPORT_TO_MODULES_DIRECTIVE, INTERNAL_EXPORTED_DIRECTIVE, INTERNAL_MODULE_VERSION_DIRECTIVE, INTERNAL_OPEN_TO_MODULES_DIRECTIVE, INTERNAL_SOURCE_DIRECTIVE, INVALIDFILENAMES, JAVA, JAVA_DEBUG, JAVAAGENT, JAVAC, JAVAC_ENCODING, JAVAC_PROFILE, JAVAC_SOURCE, JAVAC_TARGET, JIDENTIFIER, JPMS_MODULE_INFO, JPMS_MODULE_INFO_OPTIONS, KEYSTORE_LOCATION_DIRECTIVE, KEYSTORE_PASSWORD_DIRECTIVE, KEYSTORE_PROVIDER_DIRECTIVE, LANGUAGE_ATTRIBUTE, LAUNCH_ACTIVATION_EAGER, LAUNCH_ACTIVATORS, LAUNCH_RUNBUNDLES_ATTRS, LAUNCH_STARTLEVEL_DEFAULT, LAUNCH_TRACE, LAUNCHER_PLUGIN, LIB_DIRECTIVE, LIBRARY, LINK_ATTRIBUTE, LITERAL_ATTRIBUTE, MAIN_CLASS, MAKE, MANDATORY_DIRECTIVE, MANIFEST, MANIFEST_NAME, MAVEN_DEPENDENCIES, MAVEN_RELEASE, MAVEN_SCOPE, META_PERSISTENCE, METAPACKAGES, METATYPE, METATYPE_ANNOTATIONS, METATYPE_ANNOTATIONS_OPTIONS, MIME_TYPE_BUNDLE, MIME_TYPE_JAR, MODULE_INFO_CLASS, MODULES_ATTRIBUTE, NAME_ATTRIBUTE, NAMESECTION, NAMESPACE_STEM, NO_IMPORT_DIRECTIVE, NOANNOTATIONS, NOBUILDINCACHE, NOBUNDLES, NOCLASSFORNAME, NODEFAULTVERSION, NOEE, NOEXTRAHEADERS, NOIMPORTJAVA, NOJUNIT, NOJUNITOSGI, NOMANIFEST, NONE, NOT_A_BUNDLE_S, NOUSES, OPTIONAL, options, OSGI_SYNTAX_HEADERS, OSNAME_ATTRIBUTE, OSVERSION_ATTRIBUTE, OUTPUT, OUTPUTMASK, 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, REMOTEWORKSPACE, REMOVE_ATTRIBUTE_DIRECTIVE, REMOVEHEADERS, REPORTNEWER, REPOSITORIES, REPRODUCIBLE, REQUIRE_BND, REQUIRE_BUNDLE, REQUIRE_CAPABILITY, RESOLUTION, RESOLUTION_DIRECTIVE, RESOLUTION_DYNAMIC, RESOLVE, RESOLVE_EFFECTIVE, RESOLVE_EXCLUDESYSTEM, RESOLVE_PREFERENCES, RESOLVEDEBUG, RESOURCEONLY, RUNBLACKLIST, RUNBUILDS, RUNBUNDLES, RUNBUNDLES_STARTLEVEL_ATTRIBUTE, RUNEE, RUNENV, RUNFRAMEWORK, RUNFRAMEWORK_NONE, RUNFRAMEWORK_SERVICES, RUNFRAMEWORKRESTART, RUNFW, RUNJDB, RUNKEEP, RUNNOREFERENCES, RUNOPTIONS, RUNOPTIONS_EAGER, RUNPATH, RUNPROGRAMARGS, RUNPROPERTIES, RUNPROVIDEDCAPABILITIES, RUNREMOTE, RUNREPOS, RUNREQUIRES, RUNSTARTLEVEL, RUNSTARTLEVEL_BEGIN, RUNSTARTLEVEL_ORDER, RUNSTARTLEVEL_STEP, RUNSTORAGE, RUNSYSTEMCAPABILITIES, RUNSYSTEMPACKAGES, RUNTIMEOUT, RUNTRACE, RUNVM, SAVEMANIFEST, SELECTION_FILTER_ATTRIBUTE, SERVICE_COMPONENT, SERVICELOADER_NAMESPACE, SERVICELOADER_REGISTER_DIRECTIVE, SIGN, SIGN_PASSWORD_DIRECTIVE, SIGNATURE_TEST, SINGLETON_DIRECTIVE, SIZE_ATTRIBUTE, SNAPSHOT, SOURCEPATH, SOURCES, SPECIFICATION_VERSION, SPLIT_PACKAGE_DIRECTIVE, STALECHECK, STANDALONE, STATIC_ATTRIBUTE, STRICT, SUB, SUBSTITUTE_ATTRIBUTE, SYSTEMPROPERTIES, TESTCASES, TESTCONTINUOUS, TESTER, TESTER_PLUGIN, TESTPACKAGES, TESTPATH, TESTSOURCES, TESTTERMINATE, TESTUNRESOLVED, TOOL, TRANSITIVE_ATTRIBUTE, TSTAMP, UNDERTEST, UPTO, USES_DIRECTIVE, USES_USES, VALID_PROPERTY_TYPES, VERSION_ATTR_HASH, VERSION_ATTR_LATEST, VERSION_ATTR_PROJECT, VERSION_ATTR_SNAPSHOT, VERSION_ATTRIBUTE, VERSION_FILTER, VERSIONDEFAULTS, VISIBILITY_DIRECTIVE, WAB, WABLIB, WORKINGSET, WORKINGSET_MEMBER

Constructor Summary

Constructors

Constructor	Description
Processor()
Processor(Processor parent)
Processor(Processor parent, Properties props, boolean wrap)
Processor(Properties props)
Processor(Properties props, boolean wrap)

Method Summary

Modifier and Type	Method	Description
String	_basedir(String[] args)
String	_fileuri(String[] args)
String	_findfile(String[] args)
String	_frange(String[] args)	Return a range expression for a filter from a version.
String	_native_capability(String... args)	Generates a Capability string, in the format specified by the OSGi Provide-Capability header, representing the current native platform according to OSGi RFC 188.
String	_propertiesdir(String[] args)
String	_propertiesname(String[] args)
String	_random(String[] args)	Generate a random string, which is guaranteed to be a valid Java identifier (first character is an ASCII letter, subsequent characters are ASCII letters or numbers).
String	_thisfile(String[] args)	Return the name of the properties file
String	_uri(String[] args)
private void	addAll(List<String> to, List<String> from, String prefix, Reporter reporter)
void	addBasicPlugin(Object plugin)	These plugins are added to the total list of plugins.
void	addClose(AutoCloseable closeable)
protected void	addExtensions(PluginsContainer pluginsContainer)	Is called after the PluginsContainer is initialized.
void	addIncluded(File file)
private boolean	addIncludedIfAbsent(File file)
void	addProperties(File file)
void	addProperties(Map<?,?> properties)
static String	append(String... strings)
static String	appendPath(String... parts)	Append two strings to for a path in a ZIP or JAR file.
protected void	begin()
protected Processor	beginHandleErrors(String message)	Set the current command thread.
boolean	check(String... pattern)
void	clear()
private void	clearPlugins()
void	close()
<T> T[]	concat(Class<T> type, T[] prefix, T suffix)	Add an element to an array, creating a new one if necessary
private Processor	current()	A processor can mark itself current for a thread.
protected <T> T	customize(T plugin, Attrs map, PluginsContainer pluginsContainer)	Set the initial parameters of a plugin
Parameters	decorated(String key)
Parameters	decorated(String key, boolean literalsIncluded)	Return a parameters that contains the merged properties of the given key and that is decorated by the merged properties of the key + '+'
static Attrs	doAttrbutes(Object[] attrs, Clazz clazz, Macro macro)	Parse the a=b strings and return a map of them.
private void	doFixup(Instructions instrs, List<String> messages, List<String> other, String type)
void	doIncludeFile(File file, boolean overwrite, Properties target)
void	doIncludeFile(File file, boolean overwrite, Properties target, String extensionName)
private void	doIncludes(File ubase, Properties p)	Inspect the properties and if you find -includes parse the line included manifest files or properties files.
protected void	endHandleErrors(Processor previous)	End a command.
Reporter.SetLocation	error(String string, Object... args)	Create an error.
Reporter.SetLocation	error(String format, Throwable t, Object... args)
Reporter.SetLocation	exception(Throwable t, String format, Object... args)	Dedicated message for an exception.
boolean	exists()
private String	fileName(String path)
static Processor.FileLine	findHeader(File f, String header)
static Processor.FileLine	findHeader(File f, Pattern header)
static Processor.FileLine	findHeader(File f, Pattern header, Pattern clause)
private void	fixupMessages()	Move errors and warnings to their proper place by scanning the fixup messages property.
void	forceRefresh()
static String	formatArrays(String string, Object... parms)	This method is the same as String.format but it makes sure that any arrays are transformed to strings.
String	get(String key)	Overrides for the Domain class
String	get(String key, String deflt)
File	getBase()
URI	getBaseURI()
String	getChecksum()	A checksum based on the values of the properties
Class<?>	getClass(String type, File jar)
static long	getDuration(String tm, long dflt)
List<String>	getErrors()	Return the errors.
static Executor	getExecutor()
static File	getFile(File base, String file)
File	getFile(String file)
Properties	getFlattenedProperties()	Return the properties but expand all macros.
Properties	getFlattenedProperties(boolean ignoreInstructions)	Return the properties but expand all macros.
Processor.FileLine	getHeader(String header)	Get a header relative to this processor, taking its parents and includes into account.
Processor.FileLine	getHeader(String header, String clause)
Processor.FileLine	getHeader(Pattern header)
Processor.FileLine	getHeader(Pattern header, Pattern clause)
private Processor.FileLine	getHeader0(Pattern header, Pattern clause)
List<File>	getIncluded()
void	getInfo(Reporter processor)
void	getInfo(Reporter processor, String prefix)
<T> T	getInstructions(Class<T> type)	Return an instance of an interface where each method is mapped to an instruction available from this Processor.
Jar	getJarFromName(String name, 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.
String	getJavaExecutable(String java)
static int	getLine(String s, int index)
private String	getLiteralProperty(String key, String deflt, Processor source, boolean inherit)
protected Processor.CL	getLoader()
Report.Location	getLocation(String msg)	Return the errors for the given error or warning.
org.slf4j.Logger	getLogger()
protected Object[]	getMacroDomains()	This should be overridden by subclasses to add extra macro command domains on the search list.
static Properties	getManifestAsProperties(InputStream in)	Read a manifest but return a properties object.
Parameters	getMergedParameters(String key)	Get a Parameters from merged properties
Parameters	getParameters(String key, boolean allowDuplicates)
Processor	getParent()
<T> T	getPlugin(Class<T> clazz)	Returns the first plugin it can find of the given type.
PluginsContainer	getPlugins()	Return the PluginsContainer.
<T> List<T>	getPlugins(Class<T> clazz)	Return a list of plugins that implement the given class.
String	getProfile()
static org.osgi.util.promise.PromiseFactory	getPromiseFactory()
Properties	getProperties()	Property handling ...
private Properties	getProperties0()
File	getPropertiesFile()
String	getProperty(String key)
String	getProperty(String key, String deflt)	Get a property with preprocessing it with a proper default
String	getProperty(String key, String deflt, String separator)
private String	getProperty(String key, String deflt, String separator, boolean inherit)
Set<String>	getPropertyKeys(boolean inherit)	Return all inherited property keys.
Macro	getReplacer()
static ScheduledExecutorService	getScheduledExecutor()
List<File>	getSelfAndAncestors()	Return a list of all files that provide the properties for this Processor.
private List<File>	getSelfAndAncestors(List<File> l)
void	getSettings(Processor p)	Copy the settings of another processor
Processor	getTop()
String	getUnexpandedProperty(String key)
String	getUnprocessedProperty(String key, String deflt)	Get a property without preprocessing it with a proper default
List<String>	getWarnings()	Return the warnings.
private String	getWildcardProperty(String deflt, String separator, boolean inherit, Instruction ins)
boolean	is(String propertyName)	Simplified way to check booleans
static boolean	isDuplicate(String key)
boolean	isExceptions()
boolean	isFailOk()	Indicates that this run should ignore errors and succeed anyway
boolean	isInteractive()	Return if this is an interactive environment like Eclipse or runs in batch mode.
boolean	isMissingPlugin(String name)	Answer if the name is a missing plugin's command name.
boolean	isOk()	Check if this report has any relevant errors that should make the run associated with this report invalid.
boolean	isPedantic()	The provider of the reporter wants pedantic reporting, meaning every possible warning should be reported.
boolean	isPerfect()
(package private) boolean	isStrict()	If strict is true, then extra verification is done.
boolean	isTrace()
static boolean	isTrue(String value)
private Iterable<String>	iterable(boolean inherit, Predicate<String> keyFilter)
Iterator<String>	iterator()
static String	join(Object[] list, String delimeter)
static String	join(String delimeter, Collection<?>... lists)
static String	join(Collection<?> list)	Join a list.
static String	join(Collection<?>... lists)
static String	join(Collection<?> list, String delimeter)
static <T> String	join(T[] list)
Set<String>	keySet()
long	lastModified()
Properties	loadProperties(File file)	Helper to load a properties file from disk.
(package private) UTF8Properties	loadProperties0(File file)	Load Properties from disk.
private Reporter.SetLocation	location(String s)
static Object	makePrintable(Object object)	Check if the object is an array and turn it into a string if it is, otherwise unchanged.
private static Object[]	makePrintableArray(Object array)
private String	makeWildcard(String key)
static String	merge(String... strings)
String	mergeLocalProperties(String key)
void	mergeProperties(File file, boolean overwrite)
String	mergeProperties(String key)	Return merged properties.
String	mergeProperties(String key, String separator)
void	mergeProperties(Properties properties, boolean overwrite)
static <K, V> Map<K,V>	newHashMap()
<T> List<T>	newList()
<T> List<T>	newList(Collection<T> t)
static <K, V> Map<K,V>	newMap()
<K, V> Map<K,V>	newMap(Map<K,V> t)
private CloseableMemoize<Processor.CL>	newPluginLoader()
private Memoize<PluginsContainer>	newPluginsContainer()	Return a memoizer for the PluginsContainer.
<T> Set<T>	newSet()
<T> Set<T>	newSet(Collection<T> t)
String	normalize(File file)
String	normalize(String file)	Make the file short if it is inside our base directory, otherwise long.
Parameters	parseHeader(String value)
static Parameters	parseHeader(String value, Processor logger)	Standard OSGi header parser.
static void	printClause(Map<?,?> map, StringBuilder sb)
static String	printClauses(Map<?,? extends Map<?,?>> exports)	Print a standard Map based OSGi header.
static String	printClauses(Map<?,? extends Map<?,?>> exports, boolean checkMultipleVersions)
int	printExceptionSummary(Throwable e, PrintStream out)
void	printStackTrace(Throwable e, int count, PrintStream out)
void	progress(float progress, String format, Object... args)	Deprecated. Use SLF4J Logger.info() instead.
void	progress(String format, Object... args)
void	propertiesChanged()
static boolean	quote(Appendable sb, String value)
static String	read(InputStream in)
boolean	refresh()
void	removeBasicPlugin(Object plugin)
void	removeClose(AutoCloseable closeable)
static String	removeDuplicateMarker(String key)
private boolean	removeIncluded(File file)
static Properties	replaceAll(Properties p, String pattern, String replacement)	Replace a string in all the values of the map.
String	replaceExtension(String s, String extension, String newExtension)	Utiltity to replace an extension
protected void	report(Appendable out)
void	report(Map<String,Object> table)	Report the details of this processor.
void	set(String key, String value)
void	setBase(File base)
void	setExceptions(boolean exceptions)
void	setFileMustExist(boolean mustexist)
void	setForceLocal(Collection<String> local)
Reporter.SetLocation	setLocation(String header, String clause, Reporter.SetLocation setLocation)
void	setParent(Processor parent)
void	setPedantic(boolean pedantic)
void	setProperties(File propertiesFile)	Set the properties by file.
void	setProperties(File propertiesFile, File base)
void	setProperties(File base, Properties properties)
void	setProperties(Properties properties)
void	setPropertiesFile(File source)	Set the properties file but do **not** load the properties.
void	setProperty(String key, String value)	Add or overwrite a new property.
void	setTrace(boolean x)
protected void	setTypeSpecificPlugins(PluginsContainer pluginsContainer)
void	signal()
boolean	since(Version introduced)
private static boolean	skipPrint(String key)
static Collection<String>	split(String s)
static Collection<String>	split(String s, String splitter)
static void	split(String s, Collection<String> collection)
Spliterator<String>	spliterator()
(package private) Stream<String>	stream()
private Stream<String>	stream(boolean inherit)
String	system(boolean allowFail, String command, String input)
String	system(String command, String input)
static Pattern	toFullHeaderPattern(String header)
String	toString()	Printout of the status of this processor for toString()
void	trace(String msg, Object... parms)	Used to provide verbose commands
(package private) void	tree(List<String> list, File current, String path, Instruction instr)
void	unsetProperty(String string)
boolean	updateModified(long time, String reason)
void	use(Processor reporter)
Reporter.SetLocation	warning(String string, Object... args)	Create a warning.

Methods inherited from class aQute.bnd.osgi.Domain

copyFrom, domain, domain, 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, normalizeKey, setAugment, setBundleActivator, setBundleClasspath, setBundleRequiredExecutionEnvironment, setBundleSymbolicName, setBundleVersion, setBundleVersion, setConditionalPackage, setExportContents, setExportPackage, setFailOk, setImportPackage, setIncludePackage, setIncludeResource, setPrivatePackage, setRunblacklist, setRunee, setRunfw, setRunRequires, setSources, setTranslation, translate, translate

Methods inherited from class java.lang.Object

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

Methods inherited from interface java.lang.Iterable

forEach

Field Details

logger

private static final org.slf4j.Logger logger

log

public static Reporter log

BUFFER_SIZE

static final int BUFFER_SIZE

See Also:

• Constant Field Values

current

static final ThreadLocal<Processor> current

executors

private static final Memoize<ExecutorGroup> executors

random

private static final Memoize<Random> random

LIST_SPLITTER

public static final String LIST_SPLITTER

See Also:

• Constant Field Values

errors

final List<String> errors

warnings

final List<String> warnings

basicPlugins

private final Set<Object> basicPlugins

toBeClosed

private final Set<AutoCloseable> toBeClosed

pluginLoader

private volatile CloseableMemoize<Processor.CL> pluginLoader

pluginsContainer

private volatile Memoize<PluginsContainer> pluginsContainer

pedantic

boolean pedantic

trace

boolean trace

exceptions

boolean exceptions

fileMustExist

boolean fileMustExist

base

private File base

baseURI

private URI baseURI

properties

Properties properties

profile

String profile

replacer

private Macro replacer

lastModified

private long lastModified

propertiesFile

private File propertiesFile

fixup

private boolean fixup

parent

private Processor parent

included

private final CopyOnWriteArrayList<File> included

filter

Collection<String> filter

strict

Boolean strict

fixupMessages

boolean fixupMessages

_uriHelp

static final String _uriHelp

See Also:

• Constant Field Values

DURATION_P

private static final Pattern DURATION_P

locations

List<Report.Location> locations

Create a location object and add it to the locations

upto

Version upto

This method is about compatibility. New behavior can be conditionally introduced by calling this method and passing what version this behavior was introduced. This allows users of bnd to set the -upto instructions to the version that they want to be compatible with. If this instruction is not set, we assume the latest version.

_frangeHelp

static final String _frangeHelp

See Also:

• Constant Field Values

Constructor Details

Processor

public Processor()

Processor

public Processor(Properties props)

Processor

public Processor(Processor parent)

Processor

public Processor(Properties props,
 boolean wrap)

Processor

public Processor(Processor parent,
 Properties props,
 boolean wrap)

Method Details

setParent

public void setParent(Processor parent)

getParent

public Processor getParent()

getTop

public Processor getTop()

getInfo

public void getInfo(Reporter processor,
 String prefix)

getInfo

public void getInfo(Reporter processor)

addAll

private void addAll(List<String> to,
 List<String> from,
 String prefix,
 Reporter reporter)

current

private Processor current()

A processor can mark itself current for a thread.

warning

public Reporter.SetLocation warning(String string,
 Object... args)

Description copied from interface: Reporter

Create a warning. Implementations must ensure that the given args are not prevented from garbage collecting. The args must have a proper toString method.

Specified by:

warning in interface Reporter

Parameters:

string - The format of the error

args - The arguments of the error

Returns:

a SetLocation to set the location

error

public Reporter.SetLocation error(String string,
 Object... args)

Description copied from interface: Reporter

Create an error. Implementations must ensure that the given args are not prevented from garbage collecting. The args must have a proper toString method.

Specified by:

error in interface Reporter

Parameters:

string - The format of the error

args - The arguments of the error

Returns:

a SetLocation to set the location

progress

@Deprecated
public void progress(float progress,
 String format,
 Object... args)

Deprecated.

Use SLF4J Logger.info() instead.

Description copied from interface: Reporter

Create a warning. Implementations must ensure that the given args are not prevented from garbage collecting. The args must have a proper toString method.

Specified by:

progress in interface Reporter

Parameters:

progress - A value between 0 and 1 indicating the progress. 0 is starting and >=1 is done.

format - The format of the error

args - The arguments of the error

progress

public void progress(String format,
 Object... args)

error

public Reporter.SetLocation error(String format,
 Throwable t,
 Object... args)

exception

public Reporter.SetLocation exception(Throwable t,
 String format,
 Object... args)

Description copied from interface: Reporter

Dedicated message for an exception.

Specified by:

exception in interface Reporter

Parameters:

t - The exception

format - The format of the message

args - The arguments

printExceptionSummary

public int printExceptionSummary(Throwable e,
 PrintStream out)

printStackTrace

public void printStackTrace(Throwable e,
 int count,
 PrintStream out)

signal

public void signal()

getWarnings

public List<String> getWarnings()

Description copied from interface: Report

Return the warnings. This list must not be changed and may be immutable.

Specified by:

getWarnings in interface Report

Returns:

the warnings

getErrors

public List<String> getErrors()

Description copied from interface: Report

Return the errors. This list must not be changed and may be immutable.

Specified by:

getErrors in interface Report

Returns:

the errors

parseHeader

public static Parameters parseHeader(String value,
 Processor logger)

Standard OSGi header parser.

Parameters:

value -

parseHeader

public Parameters parseHeader(String value)

addClose

public void addClose(AutoCloseable closeable)

removeClose

public void removeClose(AutoCloseable closeable)

isPedantic

public boolean isPedantic()

Description copied from interface: Reporter

The provider of the reporter wants pedantic reporting, meaning every possible warning should be reported.

Specified by:

isPedantic in interface Reporter

Returns:

if this is a pedantic reporter.

setPedantic

public void setPedantic(boolean pedantic)

use

public void use(Processor reporter)

getFile

public static File getFile(File base,
 String file)

getFile

public File getFile(String file)

getPlugins

public <T> List<T> getPlugins(Class<T> clazz)

Return a list of plugins that implement the given class.

Specified by:

getPlugins in interface Registry

Parameters:

clazz - Each returned plugin implements this class/interface

Returns:

A list of plugins

getPlugin

public <T> T getPlugin(Class<T> clazz)

Returns the first plugin it can find of the given type.

Specified by:

getPlugin in interface Registry

Type Parameters:

T -

Parameters:

clazz -

getPlugins

public PluginsContainer getPlugins()

Return the PluginsContainer. Plugins are defined with the -plugin command. They are class names, optionally associated with attributes. Plugins can implement the Plugin interface to see these attributes. Any object can be a plugin.

newPluginsContainer

private Memoize<PluginsContainer> newPluginsContainer()

Return a memoizer for the PluginsContainer.

addExtensions

protected void addExtensions(PluginsContainer pluginsContainer)

Is called after the PluginsContainer is initialized.

Parameters:

pluginsContainer -

setTypeSpecificPlugins

protected void setTypeSpecificPlugins(PluginsContainer pluginsContainer)

customize

protected <T> T customize(T plugin,
 Attrs map,
 PluginsContainer pluginsContainer)

Set the initial parameters of a plugin

Parameters:

plugin -

map -

isFailOk

public boolean isFailOk()

Indicates that this run should ignore errors and succeed anyway

Overrides:

isFailOk in class Domain

Returns:

true if this processor should return errors

getBase

public File getBase()

getBaseURI

public URI getBaseURI()

setBase

public void setBase(File base)

clear

public void clear()

getLogger

public org.slf4j.Logger getLogger()

trace

public void trace(String msg,
 Object... parms)

Used to provide verbose commands

Specified by:

trace in interface Reporter

Parameters:

msg - The format of the error

parms - The arguments of the error

newList

public <T> List<T> newList()

newSet

public <T> Set<T> newSet()

newMap

public static <K,
V> Map<K,V> newMap()

newHashMap

public static <K,
V> Map<K,V> newHashMap()

newList

public <T> List<T> newList(Collection<T> t)

newSet

public <T> Set<T> newSet(Collection<T> t)

newMap

public <K,
V> Map<K,V> newMap(Map<K,V> t)

close

public void close()
           throws IOException

Specified by:

close in interface AutoCloseable

Specified by:

close in interface Closeable

Throws:

IOException

clearPlugins

private void clearPlugins()

_basedir

public String _basedir(String[] args)

_propertiesname

public String _propertiesname(String[] args)

_propertiesdir

public String _propertiesdir(String[] args)

_uri

public String _uri(String[] args)
            throws Exception

Throws:

Exception

_fileuri

public String _fileuri(String[] args)
                throws Exception

Throws:

Exception

getProperties

public Properties getProperties()

Property handling ...

getProperties0

private Properties getProperties0()

getProperty

public String getProperty(String key)

getUnexpandedProperty

public String getUnexpandedProperty(String key)

mergeProperties

public void mergeProperties(File file,
 boolean overwrite)

mergeProperties

public void mergeProperties(Properties properties,
 boolean overwrite)

setProperties

public void setProperties(Properties properties)

setProperties

public void setProperties(File base,
 Properties properties)

addProperties

public void addProperties(File file)
                   throws Exception

Throws:

Exception

addProperties

public void addProperties(Map<?,?> properties)

addIncluded

public void addIncluded(File file)

addIncludedIfAbsent

private boolean addIncludedIfAbsent(File file)

removeIncluded

private boolean removeIncluded(File file)

doIncludes

private void doIncludes(File ubase,
 Properties p)

Inspect the properties and if you find -includes parse the line included manifest files or properties files. The files are relative from the given base, this is normally the base for the analyzer.

Parameters:

ubase -

p -

Throws:

IOException

doIncludeFile

public void doIncludeFile(File file,
 boolean overwrite,
 Properties target)
                   throws Exception

Parameters:

file -

overwrite -

Throws:

FileNotFoundException

IOException

Exception

doIncludeFile

public void doIncludeFile(File file,
 boolean overwrite,
 Properties target,
 String extensionName)
                   throws Exception

Parameters:

file -

overwrite -

extensionName -

Throws:

FileNotFoundException

IOException

Exception

unsetProperty

public void unsetProperty(String string)

refresh

public boolean refresh()

isStrict

boolean isStrict()

If strict is true, then extra verification is done.

forceRefresh

public void forceRefresh()

propertiesChanged

public void propertiesChanged()

setProperties

public void setProperties(File propertiesFile)

Set the properties by file. Setting the properties this way will also set the base for this analyzer. After reading the properties, this will call setProperties(Properties) which will handle the includes.

Parameters:

propertiesFile -

setProperties

public void setProperties(File propertiesFile,
 File base)

begin

protected void begin()

isTrue

public static boolean isTrue(String value)

getUnprocessedProperty

public String getUnprocessedProperty(String key,
 String deflt)

Get a property without preprocessing it with a proper default

Parameters:

key -

deflt -

getProperty

public String getProperty(String key,
 String deflt)

Get a property with preprocessing it with a proper default

Parameters:

key -

deflt -

getProperty

public String getProperty(String key,
 String deflt,
 String separator)

getProperty

private String getProperty(String key,
 String deflt,
 String separator,
 boolean inherit)

getWildcardProperty

private String getWildcardProperty(String deflt,
 String separator,
 boolean inherit,
 Instruction ins)

getLiteralProperty

private String getLiteralProperty(String key,
 String deflt,
 Processor source,
 boolean inherit)

loadProperties

public Properties loadProperties(File file)
                          throws IOException

Helper to load a properties file from disk.

Parameters:

file -

Throws:

IOException

loadProperties0

UTF8Properties loadProperties0(File file)
                        throws IOException

Load Properties from disk. The default encoding is ISO-8859-1 but nowadays all files are encoded with UTF-8. So we try to load it first as UTF-8 and if this fails we fail back to ISO-8859-1

Throws:

IOException

replaceAll

public static Properties replaceAll(Properties p,
 String pattern,
 String replacement)

Replace a string in all the values of the map. This can be used to preassign variables that change. I.e. the base directory ${.} for a loaded properties

printClauses

public static String printClauses(Map<?,? extends Map<?,?>> exports)
                           throws IOException

Print a standard Map based OSGi header.

Parameters:

exports - map { name => Map { attribute|directive => value } }

Returns:

the clauses

Throws:

IOException

printClauses

public static String printClauses(Map<?,? extends Map<?,?>> exports,
 boolean checkMultipleVersions)
                           throws IOException

Throws:

IOException

printClause

public static void printClause(Map<?,?> map,
 StringBuilder sb)
                        throws IOException

Throws:

IOException

skipPrint

private static boolean skipPrint(String key)

quote

public static boolean quote(Appendable sb,
 String value)
                     throws IOException

Parameters:

sb -

value -

Throws:

IOException

getReplacer

public Macro getReplacer()

getMacroDomains

protected Object[] getMacroDomains()

This should be overridden by subclasses to add extra macro command domains on the search list.

getFlattenedProperties

public Properties getFlattenedProperties()

Return the properties but expand all macros. This always returns a new Properties object that can be used in any way.

getFlattenedProperties

public Properties getFlattenedProperties(boolean ignoreInstructions)

Return the properties but expand all macros. This always returns a new Properties object that can be used in any way.

getPropertyKeys

public Set<String> getPropertyKeys(boolean inherit)

Return all inherited property keys. The keys are sorted for consistent ordering.

updateModified

public boolean updateModified(long time,
 String reason)

lastModified

public long lastModified()

setProperty

public void setProperty(String key,
 String value)

Add or overwrite a new property.

Parameters:

key -

value -

getManifestAsProperties

public static Properties getManifestAsProperties(InputStream in)
                                          throws IOException

Read a manifest but return a properties object.

Parameters:

in -

Throws:

IOException

getPropertiesFile

public File getPropertiesFile()

setFileMustExist

public void setFileMustExist(boolean mustexist)

read

public static String read(InputStream in)
                   throws Exception

Throws:

Exception

join

public static String join(Collection<?> list)

Join a list.

join

public static String join(Collection<?> list,
 String delimeter)

join

public static String join(Collection<?>... lists)

join

public static String join(String delimeter,
 Collection<?>... lists)

join

public static String join(Object[] list,
 String delimeter)

join

public static <T> String join(T[] list)

split

public static void split(String s,
 Collection<String> collection)

split

public static Collection<String> split(String s)

split

public static Collection<String> split(String s,
 String splitter)

merge

public static String merge(String... strings)

isExceptions

public boolean isExceptions()

setExceptions

public void setExceptions(boolean exceptions)

normalize

public String normalize(String file)

Make the file short if it is inside our base directory, otherwise long.

Parameters:

file -

normalize

public String normalize(File file)

removeDuplicateMarker

public static String removeDuplicateMarker(String key)

isDuplicate

public static boolean isDuplicate(String key)

setTrace

public void setTrace(boolean x)

getLoader

protected Processor.CL getLoader()

newPluginLoader

private CloseableMemoize<Processor.CL> newPluginLoader()

exists

public boolean exists()

isOk

public boolean isOk()

Description copied from interface: Report

Check if this report has any relevant errors that should make the run associated with this report invalid. I.e. if this returns false then the run should be disregarded.

Specified by:

isOk in interface Report

Returns:

true if this run should be disregarded due to errors

fixupMessages

private void fixupMessages()

Move errors and warnings to their proper place by scanning the fixup messages property.

doFixup

private void doFixup(Instructions instrs,
 List<String> messages,
 List<String> other,
 String type)

check

public boolean check(String... pattern)
              throws IOException

Throws:

IOException

report

protected void report(Appendable out)
               throws IOException

Throws:

IOException

isPerfect

public boolean isPerfect()

setForceLocal

public void setForceLocal(Collection<String> local)

isMissingPlugin

public boolean isMissingPlugin(String name)

Answer if the name is a missing plugin's command name. If a bnd file contains the command name of a plugin, and that plugin is not available, then an error is reported during manifest calculation. This allows the plugin to fail to load when it is not needed. We first get the plugins to ensure it is properly initialized.

Parameters:

name -

appendPath

public static String appendPath(String... parts)

Append two strings to for a path in a ZIP or JAR file. It is guaranteed to return a string that does not start, nor ends with a '/', while it is properly separated with slashes. Double slashes are properly removed.

 "/" + "abc/def/" becomes "abc/def"
 @param prefix @param suffix @return

doAttrbutes

public static Attrs doAttrbutes(Object[] attrs,
 Clazz clazz,
 Macro macro)

Parse the a=b strings and return a map of them.

Parameters:

attrs -

clazz -

formatArrays

public static String formatArrays(String string,
 Object... parms)

This method is the same as String.format but it makes sure that any arrays are transformed to strings.

Parameters:

string -

parms -

makePrintable

public static Object makePrintable(Object object)

Check if the object is an array and turn it into a string if it is, otherwise unchanged.

Parameters:

object - the object to make printable

Returns:

a string if it was an array or the original object

makePrintableArray

private static Object[] makePrintableArray(Object array)

append

public static String append(String... strings)

getClass

public Class<?> getClass(String type,
 File jar)
                  throws Exception

Throws:

Exception

isTrace

public boolean isTrace()

getDuration

public static long getDuration(String tm,
 long dflt)

_random

public String _random(String[] args)

Generate a random string, which is guaranteed to be a valid Java identifier (first character is an ASCII letter, subsequent characters are ASCII letters or numbers). Takes an optional parameter for the length of string to generate; default is 8 characters.

_native_capability

public String _native_capability(String... args)
                          throws Exception

Generates a Capability string, in the format specified by the OSGi Provide-Capability header, representing the current native platform according to OSGi RFC 188. For example on Windows7 running on an x86_64 processor it should generate the following:

 osgi.native;osgi.native.osname:List<String>="Windows7,Windows
 7,Win32";osgi.native.osversion:Version=6.1.0;osgi.native.processor:List&
 lt;String>="x86-64,amd64,em64t,x86_64"
 

Parameters:

args - The array of properties. For example: the macro invocation of "${native_capability;osversion=3.2.4;osname=Linux}" results in an args array of [native_capability, osversion=3.2.4, osname=Linux]

Throws:

Exception

beginHandleErrors

protected Processor beginHandleErrors(String message)

Set the current command thread. This must be balanced with the endHandleErrors(Processor) method. The method returns the previous command owner or null. The command owner will receive all warnings and error reports.

endHandleErrors

protected void endHandleErrors(Processor previous)

End a command. Will restore the previous command owner.

Parameters:

previous -

getExecutor

public static Executor getExecutor()

getScheduledExecutor

public static ScheduledExecutorService getScheduledExecutor()

getPromiseFactory

public static org.osgi.util.promise.PromiseFactory getPromiseFactory()

addBasicPlugin

public void addBasicPlugin(Object plugin)

These plugins are added to the total list of plugins. The separation is necessary because the list of plugins is refreshed now and then so we need to be able to add them at any moment in time.

Parameters:

plugin -

removeBasicPlugin

public void removeBasicPlugin(Object plugin)

getIncluded

public List<File> getIncluded()

get

public String get(String key)

Overrides for the Domain class

Specified by:

get in class Domain

get

public String get(String key,
 String deflt)

Overrides:

get in class Domain

set

public void set(String key,
 String value)

Specified by:

set in class Domain

stream

Stream<String> stream()

stream

private Stream<String> stream(boolean inherit)

iterator

public Iterator<String> iterator()

Specified by:

iterator in interface Iterable<String>

spliterator

public Spliterator<String> spliterator()

Specified by:

spliterator in interface Iterable<String>

iterable

private Iterable<String> iterable(boolean inherit,
 Predicate<String> keyFilter)

keySet

public Set<String> keySet()

toString

public String toString()

Printout of the status of this processor for toString()

Overrides:

toString in class Object

replaceExtension

public String replaceExtension(String s,
 String extension,
 String newExtension)

Utiltity to replace an extension

Parameters:

s -

extension -

newExtension -

setLocation

public Reporter.SetLocation setLocation(String header,
 String clause,
 Reporter.SetLocation setLocation)

location

private Reporter.SetLocation location(String s)

getLocation

public Report.Location getLocation(String msg)

Description copied from interface: Report

Return the errors for the given error or warning. Can return null.

Specified by:

getLocation in interface Report

Parameters:

msg - The message

Returns:

null or the location of the message

getHeader

public Processor.FileLine getHeader(String header)
                             throws Exception

Get a header relative to this processor, taking its parents and includes into account.

Parameters:

header -

Throws:

IOException

Exception

toFullHeaderPattern

public static Pattern toFullHeaderPattern(String header)

getHeader

public Processor.FileLine getHeader(Pattern header)
                             throws Exception

Throws:

Exception

getHeader

public Processor.FileLine getHeader(String header,
 String clause)
                             throws Exception

Throws:

Exception

getHeader

public Processor.FileLine getHeader(Pattern header,
 Pattern clause)
                             throws Exception

Throws:

Exception

getHeader0

private Processor.FileLine getHeader0(Pattern header,
 Pattern clause)
                               throws Exception

Throws:

Exception

findHeader

public static Processor.FileLine findHeader(File f,
 String header)
                                     throws IOException

Throws:

IOException

findHeader

public static Processor.FileLine findHeader(File f,
 Pattern header)
                                     throws IOException

Throws:

IOException

findHeader

public static Processor.FileLine findHeader(File f,
 Pattern header,
 Pattern clause)
                                     throws IOException

Throws:

IOException

getLine

public static int getLine(String s,
 int index)

since

public boolean since(Version introduced)

report

public void report(Map<String,Object> table)
            throws Exception

Report the details of this processor. Should in general be overridden

Parameters:

table -

Throws:

Exception

is

public boolean is(String propertyName)

Simplified way to check booleans

mergeProperties

public String mergeProperties(String key)

Return merged properties. The parameters provide a list of property names which are concatenated in the output, separated by a comma. Not only are those property names looked for, also all property names that have that constant as a prefix, a '.', and then whatever (.*). The result is either null if nothing was found or a list of properties

mergeLocalProperties

public String mergeLocalProperties(String key)

mergeProperties

public String mergeProperties(String key,
 String separator)

makeWildcard

private String makeWildcard(String key)

getMergedParameters

public Parameters getMergedParameters(String key)

Get a Parameters from merged properties

concat

public <T> T[] concat(Class<T> type,
 T[] prefix,
 T suffix)

Add an element to an array, creating a new one if necessary

getJarFromName

public Jar getJarFromName(String name,
 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.

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

fileName

private String fileName(String path)

_thisfile

public String _thisfile(String[] args)

Return the name of the properties file

getSettings

public void getSettings(Processor p)

Copy the settings of another processor

_frange

public String _frange(String[] args)

Return a range expression for a filter from a version. By default this is based on consumer compatibility. You can specify a third argument (true) to get provider compatibility.

  ${frange;1.2.3} ->
 (&(version>=1.2.3)(!(version>=2.0.0)) ${frange;1.2.3, true} ->
 (&(version>=1.2.3)(!(version>=1.3.0)) ${frange;[1.2.3,2.3.4)} ->
 (&(version>=1.2.3)(!(version>=2.3.4))
 

_findfile

public String _findfile(String[] args)

tree

void tree(List<String> list,
 File current,
 String path,
 Instruction instr)

getInstructions

public <T> T getInstructions(Class<T> type)

Return an instance of an interface where each method is mapped to an instruction available from this Processor. See SyntaxAnnotation for how to annotate this interface.

isInteractive

public boolean isInteractive()

Return if this is an interactive environment like Eclipse or runs in batch mode. If interactive, things can get refreshed.

getParameters

public Parameters getParameters(String key,
 boolean allowDuplicates)

Overrides:

getParameters in class Domain

system

public String system(boolean allowFail,
 String command,
 String input)
              throws IOException,
InterruptedException

Throws:

IOException

InterruptedException

system

public String system(String command,
 String input)
              throws IOException,
InterruptedException

Throws:

IOException

InterruptedException

getJavaExecutable

public String getJavaExecutable(String java)

decorated

public Parameters decorated(String key,
 boolean literalsIncluded)

Return a parameters that contains the merged properties of the given key and that is decorated by the merged properties of the key + '+'

Parameters:

key - The key of the property

decorated

public Parameters decorated(String key)

getProfile

public String getProfile()

getChecksum

public String getChecksum()

A checksum based on the values of the properties

Returns:

A checksum based on the values of the properties

getSelfAndAncestors

public List<File> getSelfAndAncestors()

Return a list of all files that provide the properties for this Processor. This includes its own properties file, all included files, and the same for its ancestor Processor.

The order of the list is parent?.getSelfAndAncestors(), includes, properties file

Returns:

a list of files that this processor depends on

getSelfAndAncestors

private List<File> getSelfAndAncestors(List<File> l)

setPropertiesFile

public void setPropertiesFile(File source)

Set the properties file but do **not** load the properties.

Parameters:

source - the properties file