Interface PackageProperties
- All Known Subinterfaces:
JcrPackageDefinition
,VaultPackage
The package properties provide extra/meta information about the package to install. The properties are usually
stored in the
META-INF/vault/properties.xml
or in the jar's manifest.- Since:
- 3.1
-
Field Summary
FieldsModifier and TypeFieldDescriptionstatic final String
The manifest header key containing all necessary imports for this packagestatic final String
The manifest header key for the package dependencies.static final String
The manifest header key for locations of package dependencies.static final String
The manifest header key for the package description.static final String
The manifest header key for the package id in the form<group>:<name>:<version>
static final String
The manifest header key for all filter roots separated by ','.static final String
The manifest header key which indicates the package typestatic final String
Name of the 'acHandling' by meta-inf property.static final String
Name of the flag that defines if the package is supposed to contains/overwrite Oak index definitions.static final String
Name of the build count meta-inf propertystatic final String
Name of the 'cndPattern' by meta-inf property.static final String
Name of the created meta-inf propertystatic final String
Name of the created by meta-inf propertystatic final String
Name of the dependencies meta-inf propertystatic final String
Name of the meta-inf property for locations of package dependencies.static final String
Name of the description meta-inf propertystatic final String
Name of the flag that indicates to disable intermediate saves.static final String
Name of the generator by meta-inf propertystatic final String
Name of the group propertystatic final String
Name of the last modified meta-inf propertystatic final String
Name of the last modified by meta-inf propertystatic final String
Name of the last wrapped meta-inf propertystatic final String
Name of the last wrapped by meta-inf propertystatic final String
Name of the 'name' propertystatic final String
Name of the package-type propertystatic final String
Name of the flag that indicates that the system needs a restart after package extraction.static final String
Name of the flag that indicates that only admin sessions can extract this package.static final String
Name of the flag that configures the sub package handling.static final String
Name of the flag that configures whether to use binary references instead of actual binarystatic final String
Name of the version meta-inf propertystatic final String
The prefix for an install hook property name. -
Method Summary
Modifier and TypeMethodDescriptionReturns the access control handling defined in this package.long
Returns the build count of this packageReturns the date when this package was built ornull
if n/a.Returns the user that built this package or null if n/a.getDateProperty
(String name) Returns the date property with the given name ornull
if it does not exist or if the value cannot be converted to a date.Returns an unmodifiable list of dependenciesReturns a map of dependency locations where key = package id and value = uri of package dependency with that id.Returns a description of this package ornull
if n/aReturns the name and version of the component that generated the package.getId()
Returns the id of this package ornull
if the id can't be determined.Returns the last modification date ornull
if n/a.Returns the user that last modified the package ornull
if n/a.Returns the date when this package was wrapped ornull
if n/a.Returns the user that wrapped this package or null if n/a.@Nullable PackageType
Returns the package type ornull
if no package type was specified for this package.getProperty
(String name) Returns the property with the given name ornull
if it does not exist.Returns the sub package handling configurationboolean
Returnstrue
if this package requires a restart after installation.boolean
Returnstrue
if this package can only be extracted by a admin session.
-
Field Details
-
NAME_LAST_MODIFIED
Name of the last modified meta-inf property- See Also:
-
NAME_LAST_MODIFIED_BY
Name of the last modified by meta-inf property- See Also:
-
NAME_GROUP
Name of the group property- Since:
- 2.2
- See Also:
-
NAME_NAME
Name of the 'name' property- Since:
- 2.2
- See Also:
-
NAME_BUILD_COUNT
Name of the build count meta-inf property- See Also:
-
NAME_VERSION
Name of the version meta-inf property- See Also:
-
NAME_DEPENDENCIES
Name of the dependencies meta-inf property- See Also:
-
NAME_DEPENDENCIES_LOCATIONS
Name of the meta-inf property for locations of package dependencies. Each location has the format<packageId>=<uri>
. Multiple locations are separated by ",".- See Also:
-
NAME_CREATED
Name of the created meta-inf property- See Also:
-
NAME_CREATED_BY
Name of the created by meta-inf property- See Also:
-
NAME_GENERATOR
Name of the generator by meta-inf property- See Also:
-
NAME_LAST_WRAPPED
Name of the last wrapped meta-inf property- Since:
- 2.2.22
- See Also:
-
NAME_LAST_WRAPPED_BY
Name of the last wrapped by meta-inf property- Since:
- 2.2.22
- See Also:
-
NAME_AC_HANDLING
Name of the 'acHandling' by meta-inf property.- See Also:
-
NAME_CND_PATTERN
Name of the 'cndPattern' by meta-inf property.- Since:
- 2.3.12
- See Also:
-
NAME_DESCRIPTION
Name of the description meta-inf property- See Also:
-
NAME_REQUIRES_ROOT
Name of the flag that indicates that only admin sessions can extract this package.- See Also:
-
NAME_REQUIRES_RESTART
Name of the flag that indicates that the system needs a restart after package extraction.- See Also:
-
NAME_DISABLE_INTERMEDIATE_SAVE
Name of the flag that indicates to disable intermediate saves.- See Also:
-
NAME_SUB_PACKAGE_HANDLING
Name of the flag that configures the sub package handling.- Since:
- 3.1
- See Also:
-
NAME_ALLOW_INDEX_DEFINITIONS
Name of the flag that defines if the package is supposed to contains/overwrite Oak index definitions.- Since:
- 3.2.10
- See Also:
-
NAME_USE_BINARY_REFERENCES
Name of the flag that configures whether to use binary references instead of actual binary- See Also:
-
NAME_PACKAGE_TYPE
Name of the package-type property- See Also:
-
PREFIX_INSTALL_HOOK
The prefix for an install hook property name. The full name may look like this:installhook.test1.class
.- See Also:
-
MF_KEY_PACKAGE_TYPE
The manifest header key which indicates the package type- See Also:
-
MF_KEY_PACKAGE_ID
The manifest header key for the package id in the form<group>:<name>:<version>
- See Also:
-
MF_KEY_PACKAGE_DEPENDENCIES
The manifest header key for the package dependencies.- See Also:
-
MF_KEY_PACKAGE_DEPENDENCIES_LOCATIONS
The manifest header key for locations of package dependencies. Each location has the format<packageId>=<uri>
. Multiple locations are separated by ",".- See Also:
-
MF_KEY_PACKAGE_ROOTS
The manifest header key for all filter roots separated by ','.- See Also:
-
MF_KEY_PACKAGE_DESC
The manifest header key for the package description.- See Also:
-
MF_KEY_IMPORT_PACKAGE
The manifest header key containing all necessary imports for this package- See Also:
-
-
Method Details
-
getId
PackageId getId()Returns the id of this package ornull
if the id can't be determined.- Returns:
- the id of this package.
-
getLastModified
Calendar getLastModified()Returns the last modification date ornull
if n/a.- Returns:
- last modification date or
null
-
getLastModifiedBy
String getLastModifiedBy()Returns the user that last modified the package ornull
if n/a.- Returns:
- the user or
null
-
getCreated
Calendar getCreated()Returns the date when this package was built ornull
if n/a.- Returns:
- the creation date
-
getCreatedBy
String getCreatedBy()Returns the user that built this package or null if n/a.- Returns:
- the creator
-
getGenerator
String getGenerator()Returns the name and version of the component that generated the package.- Returns:
- the generator or
null
if n/a - Since:
- 3.7.0
-
getLastWrapped
Calendar getLastWrapped()Returns the date when this package was wrapped ornull
if n/a.- Returns:
- the wrapped date
- Since:
- 2.2.22
-
getLastWrappedBy
String getLastWrappedBy()Returns the user that wrapped this package or null if n/a.- Returns:
- the wrapper
- Since:
- 2.2.22
-
getDescription
String getDescription()Returns a description of this package ornull
if n/a- Returns:
- a description
-
requiresRoot
boolean requiresRoot()Returnstrue
if this package can only be extracted by a admin session.- Returns:
true
if this package requires an admin session for extraction.
-
requiresRestart
boolean requiresRestart()Returnstrue
if this package requires a restart after installation.- Returns:
true
if this package requires a restart after installation.
-
getDependencies
Dependency[] getDependencies()Returns an unmodifiable list of dependencies- Returns:
- list of dependencies
-
getExternalHooks
- Returns:
- all external hooks registered in a package (key = name, value = fully qualified class name)
-
getACHandling
AccessControlHandling getACHandling()Returns the access control handling defined in this package.- Returns:
- the access control handling.
-
getSubPackageHandling
SubPackageHandling getSubPackageHandling()Returns the sub package handling configuration- Returns:
- the sub package handling configuration.
-
getDateProperty
Returns the date property with the given name ornull
if it does not exist or if the value cannot be converted to a date.- Parameters:
name
- the property name- Returns:
- the property value or
null
-
getProperty
Returns the property with the given name ornull
if it does not exist.- Parameters:
name
- the property name- Returns:
- the property value or
null
-
getPackageType
Returns the package type ornull
if no package type was specified for this package.- Returns:
- the package type
-
getDependenciesLocations
Returns a map of dependency locations where key = package id and value = uri of package dependency with that id.- Returns:
- dependencies locations as map
-
getBuildCount
long getBuildCount()Returns the build count of this package- Returns:
- the build count.
-