Login or Register to Ask a Question and Join Our Community

Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

debian::javahelper::manifestsection(3) [debian man page]

Debian::Javahelper::ManifestSection(3)				    Javahelper				    Debian::Javahelper::ManifestSection(3)

NAME

       Debian::Javahelper::ManifestSection - Javahelper representation of a section in a Jar Manifest

SYNOPSIS

	use Debian::Javahelper::Manifest;

	my $main_sec = $manifest->get_section(MAIN_SECTION, 1);
	# set the Main-Class attribute
	$main_sec->set_value('Main-Class', 'org.site.app.AppStarter');
	# read the classpath entry - may return undef if the attribute does not exist.
	my $cp = $main_sec->get_value('Class-Path');
	# same as above except $cp will be '' if the attribute does not exist.
	$cp = $main_sec->get_value('Class-Path',  1);
	# returns a list of [$name, $value] pairs - note $name will be in the original
	# case.
	my @att = $main_sec->get_values();

DESCRIPTION

       This module is used to represent a Section in a Java Manifest.

   Constants
       MAIN_SECTION
	   A constant denoting the main section of the manifest.

	   Exported by default.

   Methods
       Debian::Javahelper::ManifestSection->new($name)
	   Creates a new section - if $name is MAIN_SECTION, then it will set "Manifest-Version" otherwise it will set "Name" to $name.

	   Generally you should not need to use this directly! The Debian::Javahelper::Manifest will create sections as they are needed. There is
	   no support for creating a section and then adding it to a manifest after wards.

       $section->set_value($attr, $value)
	   Sets the value of $attr to $value. If $attr did not exist in this section then it will be created. $value may not contain newlines.

	   Note: $attr exists if an attribute matches $attr ignoring the case of the two. When $attr is created, the original case will be stored
	   for later (for writing). Later updates to $attr will not affect the original case.

       $section->get_value($attr[, $empty])
	   Returns the value of $attr, long values are merged into a single line. $attr is looked up case-insensitively.

	   Returns undef if $attr is not present in the section, unless $empty is a truth-value. In this case it will return ''.

       $section->get_values()
	   Returns all the values in the section in a list of [$attr, $value] pairs. "Manifest-Version" and "Name" will appear first in this list
	   if they appear in this section, the remaining attributes appears in any order and this order may change.

	   Modifying the list or the pairs will not affect the attributes in the section.

	   Note: The $attr part will be the original case of the attribute.

SEE ALSO

       Debian::Javahelper::Manifest(3) - for how to obtain a section.

AUTHOR

       Niels Thykier <niels@thykier.net>

COPYRIGHT AND LICENSE

       Copyright 2010 by Niels Thykier

       This module is free software; you may redistribute it and/or modify it under the terms of GNU GPL 2.

0.43								    2011-02-17				    Debian::Javahelper::ManifestSection(3)

Check Out this Related Man Page

Debian::Javahelper::Manifest(3) 				    Javahelper					   Debian::Javahelper::Manifest(3)

NAME

       Debian::Javahelper::Manifest - Javahelper representation of a Jar Manifest

SYNOPSIS

	use Debian::Javahelper::Java;

	my $manifest = ...;
	my $main_sec = $manifest->get_section(MAIN_SECTION);
	# Create if it does not exist.
	my $file_sec = $manifest->get_section("java/lang/Object.class", 1);

DESCRIPTION

       This module is used to represent a Java Manifest.

   Constants
       MAIN_SECTION
	   A constant denoting the main section of the manifest.

	   Exported by default.

   Methods
       Debian::Javahelper::Manifest->new()
	   Creates a new manifest. It will only contain the main section with the Manifest-Version attribute.

       $manifest->get_section($name[, $create])
	   Returns the section denoted by $name. If this section does not exist, then it will either return undef or (if $create is a truth-value)
	   create a new empty section with that name.

	   Use the MAIN_SECTION constant to access the main section of the manifest.

       $manifest->get_sections()
	   Returns a list of all sections in $manifest. The main section will always be the first in the list, but the remaining sections can come
	   in any order (and this order can change in later invocations).

	   Modifying the list will not change which sections are present in $manifest, but modifying a section in this list will also update the
	   section in the manifest.

       $manifest->merge($other)
	   Merge all entries in $other into $manifest. All sections in $other will be added to $manifest if they are not already present.

	   If an attribute in a given section is only present in one of the two manifests, then that attribute and its value will be in $manifest
	   after merge returns.

	   If the attribute in a given section is present in both manifests, then the value from $other will be used.

	   This can be used to make a deep copy a manifest:

	    my $copy = Debian::Javahelper::Manifest->new();
	    $copy->merge($orig);

SEE ALSO

       Debian::Javahelper::Java(3) - had parse/write methods for manifests.  Debian::Javahelper::ManifestSection(3) - for how sections are
       handled.

AUTHOR

       Niels Thykier <niels@thykier.net>

COPYRIGHT AND LICENSE

       Copyright 2010 by Niels Thykier

       This module is free software; you may redistribute it and/or modify it under the terms of GNU GPL 2.

0.43								    2011-02-17					   Debian::Javahelper::Manifest(3)
Man Page