org.gradle.api.plugins.osgi
Interface OsgiManifest

All Superinterfaces:
Manifest

public interface OsgiManifest
extends Manifest

Represents a manifest file for a JAR containing an OSGi bundle.


Method Summary
 File getClassesDir()
          Returns the classes dir.
 FileCollection getClasspath()
          Returns the classpath.
 String getDescription()
          Returns the description.
 String getDocURL()
          Returns the docURL value.
 Map<String,List<String>> getInstructions()
          Returns all exisiting instruction.
 String getLicense()
          Returns the license.
 String getName()
          Returns the name.
 String getSymbolicName()
          Returns the symbolic name.
 String getVendor()
          Returns the vendor.
 String getVersion()
          Returns the version.
 OsgiManifest instruction(String name, String... values)
          Adds arguments to an instruction.
 OsgiManifest instructionFirst(String name, String... values)
          Adds arguments to an instruction.
 List<String> instructionValue(String instructionName)
          Returns the list of arguments for a particular instruction.
 void setClassesDir(File classesDir)
          Sets the classes dir.
 void setClasspath(FileCollection classpath)
          A convenient method for setting a Bundle-Classpath instruction.
 void setDescription(String description)
          A convenient method for setting a Bundle-Description instruction.
 void setDocURL(String docURL)
          A convenient method for setting a Bundle-DocURL instruction.
 void setLicense(String license)
          A convenient method for setting a Bundle-License instruction.
 void setName(String name)
          A convenient method for setting a Bundle-Name instruction.
 void setSymbolicName(String symbolicName)
          A convenient method for setting a Bundle-SymbolicName instruction.
 void setVendor(String vendor)
          A convenient method for setting a Bundle-Vendor instruction.
 void setVersion(String version)
          A convenient method for setting a Bundle-Version instruction.
 
Methods inherited from interface org.gradle.api.java.archives.Manifest
attributes, attributes, from, from, getAttributes, getEffectiveManifest, getSections, writeTo, writeTo
 

Method Detail

instructionValue

List<String> instructionValue(String instructionName)
Returns the list of arguments for a particular instruction.

Parameters:
instructionName -
Returns:
The list of arguments
See Also:
instruction(String, String...)

instruction

OsgiManifest instruction(String name,
                         String... values)
Adds arguments to an instruction. If the instruction does not exists, it is created. If it does exists, the arguments are appended to the existing arguments.

Parameters:
name -
values -
Returns:
this
See Also:
instructionFirst(String, String...)

instructionFirst

OsgiManifest instructionFirst(String name,
                              String... values)
Adds arguments to an instruction. If the instruction does not exists, it is created. If it does exists, the arguments are inserted before the existing arguments.

Parameters:
name -
values -
Returns:
this
See Also:
instructionFirst(String, String...)

getInstructions

Map<String,List<String>> getInstructions()
Returns all exisiting instruction.

Returns:
A map with instructions. The key of the map is the instruction name, the value a list of arguments.

getSymbolicName

String getSymbolicName()
Returns the symbolic name.

See Also:
setSymbolicName(String)

setSymbolicName

void setSymbolicName(String symbolicName)
A convenient method for setting a Bundle-SymbolicName instruction.

Parameters:
symbolicName - the symbolicName to set

getName

String getName()
Returns the name.

See Also:
setName(String)

setName

void setName(String name)
A convenient method for setting a Bundle-Name instruction.

Parameters:
name - the name to set

getVersion

String getVersion()
Returns the version.

See Also:
setVersion(String)

setVersion

void setVersion(String version)
A convenient method for setting a Bundle-Version instruction.

Parameters:
version - the version to set

getDescription

String getDescription()
Returns the description.

See Also:
setDescription(String)

setDescription

void setDescription(String description)
A convenient method for setting a Bundle-Description instruction.

Parameters:
description - the description to set

getLicense

String getLicense()
Returns the license.

See Also:
setLicense(String)

setLicense

void setLicense(String license)
A convenient method for setting a Bundle-License instruction.

Parameters:
license - The license to set

getVendor

String getVendor()
Returns the vendor.

See Also:
setVendor(String)

setVendor

void setVendor(String vendor)
A convenient method for setting a Bundle-Vendor instruction.

Parameters:
vendor - The vendor to set

getDocURL

String getDocURL()
Returns the docURL value.

See Also:
setDocURL(String)

setDocURL

void setDocURL(String docURL)
A convenient method for setting a Bundle-DocURL instruction.

Parameters:
docURL - the docURL to set.

getClassesDir

File getClassesDir()
Returns the classes dir.

See Also:
setClassesDir(java.io.File)

setClassesDir

void setClassesDir(File classesDir)
Sets the classes dir. This directory is the major source of input for generation the OSGi manifest. All classes are analyzed for its packages and package dependencies. Based on this the Import-Package value is set. This auto generated value can be overwritten by explicitly setting an instruction.

Parameters:
classesDir -
See Also:
instruction(String, String...)

getClasspath

FileCollection getClasspath()
Returns the classpath.

See Also:
setClasspath(org.gradle.api.file.FileCollection)

setClasspath

void setClasspath(FileCollection classpath)
A convenient method for setting a Bundle-Classpath instruction. The information of the classpath elements are only used if they are OSGi bundles. In this case for example the version information provided by the bundle is used in the Import-Package of the generated OSGi bundle.

Parameters:
classpath - The classpath elements