## org.apache.tools.ant.taskdefs
Class ManifestTask

    java.lang.Object
      |
      +--org.apache.tools.ant.ProjectComponent
            |
            +--org.apache.tools.ant.Task
                  |
                  +--org.apache.tools.ant.taskdefs.ManifestTask

public class ManifestTask
extends Task

Creates a manifest file for inclusion in a JAR, Ant task wrapper around `Manifest`. This task can be used to write a Manifest file, optionally replacing or updating an existing file.

Since:
  Ant 1.5
Author:
  Conor MacNeill, Stefan Bodewig, Jose Alberto Fernandez

Nested Class Summary
`static class` `ManifestTask.Mode` Helper class for Manifest's mode attribute.

Field Summary

Fields inherited from class org.apache.tools.ant.Task
`description, location, target, taskName, taskType, wrapper`

Fields inherited from class org.apache.tools.ant.ProjectComponent
`project`

Constructor Summary
`ManifestTask()`

Method Summary
`void` `addConfiguredAttribute(Manifest.Attribute attribute)` Add an attribute to the manifest - it is added to the main section.
`void` `addConfiguredSection(Manifest.Section section)` Add a section to the manifest
`void` `execute()` Create or update the Manifest when used as a task.
`void` `setEncoding(java.lang.String encoding)` The encoding to use for reading in an existing manifest file
`void` `setFile(java.io.File f)` The name of the manifest file to create/update.
`void` `setMode(ManifestTask.Mode m)` Update policy: either "update" or "replace"; default is "replace".

Methods inherited from class org.apache.tools.ant.Task
`getDescription, getLocation, getOwningTarget, getRuntimeConfigurableWrapper, getTaskName, handleErrorFlush, handleErrorOutput, handleFlush, handleOutput, init, isInvalid, log, log, maybeConfigure, perform, setDescription, setLocation, setOwningTarget, setRuntimeConfigurableWrapper, setTaskName`

Methods inherited from class org.apache.tools.ant.ProjectComponent
`getProject, setProject`

Methods inherited from class java.lang.Object
`clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait`

Constructor Detail

### ManifestTask

    public ManifestTask()

Method Detail

### addConfiguredSection

    public void addConfiguredSection(Manifest.Section section)
                              throws ManifestException

  Add a section to the manifest

  Parameters:
    `section` - the manifest section to be added
  Throws:
    `ManifestException` - if the secti0on is not valid.

### addConfiguredAttribute

    public void addConfiguredAttribute(Manifest.Attribute attribute)
                                throws ManifestException

  Add an attribute to the manifest - it is added to the main section.

  Parameters:
    `attribute` - the attribute to be added.
  Throws:
    `ManifestException` - if the attribute is not valid.

### setFile

    public void setFile(java.io.File f)

  The name of the manifest file to create/update. Required if used as a task.

  Parameters:
    `f` - the Manifest file to be written

### setEncoding

    public void setEncoding(java.lang.String encoding)

  The encoding to use for reading in an existing manifest file

  Parameters:
    `encoding` - the maniofets file encoding.

### setMode

    public void setMode(ManifestTask.Mode m)

  Update policy: either "update" or "replace"; default is "replace".

  Parameters:
    `m` - the mode value - update or replace.

### execute

    public void execute()
                 throws BuildException

  Create or update the Manifest when used as a task.

  Overrides:
    `execute` in class `Task`
  Throws:
    `BuildException` - if the manifest cannot be written.

Copyright © 2000-2003 Apache Software Foundation. All Rights Reserved.