Руководство по вводу-выводу по Java — Java Jar API

JAR-API

JAR API включает классы для работы с файлом манифеста. Объект класса Manifest представляет файл манифеста. Вы создаете объект Manifest в своем коде следующим образом:

Manifest manifest = new Manifest();

Мы можем читать записи из файла манифеста и записывать в него записи.

Чтобы добавить запись в основной раздел, получите экземпляр класса Attributes, используя метод getMainAttributes() из класса Manifest, и продолжайте добавлять к нему пару имя-значение, используя его метод put().

Следующий код добавляет некоторые атрибуты в основной раздел объекта манифеста. Известные имена атрибутов определяются как константы в классе Attributes.Name.

Например, константа Attributes.Name.MANIFEST_VERSION представляет имя атрибута Manifest-Version.

Manifest manifest = new Manifest();
Attributes  mainAttribs = manifest.getMainAttributes(); mainAttribs.put(Attributes.Name.MANIFEST_VERSION, "1.0"); mainAttribs.put(Attributes.Name.MAIN_CLASS, "com.java2s.Main"); mainAttribs.put(Attributes.Name.SEALED, "true");

Добавление отдельной записи в файл манифеста немного сложнее, чем добавление основной записи.

В следующем коде показано, как добавить отдельную запись в объект манифеста:

Map<String,Attributes> attribsMap = manifest.getEntries();
Attributes attribs  = new Attributes();
Attributes.Name name = new Attributes.Name("Sealed");
attribs.put(name, "false");
attribsMap.put("com/java2s/archives/", attribs);

Чтобы добавить файл манифеста в файл JAR, укажите его в одном из конструкторов класса JarOutputStream.

Например, следующий код создает поток вывода jar для создания файла test.jar с объектом Manifest:

Manifest manifest = new Manifest();
JarOutputStream jos  = new JarOutputStream(new BufferedOutputStream(
new FileOutputStream("test.jar")), manifest);

Следующий код создает файл JAR, который включает файл манифеста.

import java.io.BufferedInputStream;
import java.io.BufferedOutputStream;
import java.io.File;
import java.io.FileInputStream;
import java.io.FileNotFoundException;
import java.io.FileOutputStream;
import java.io.IOException;
import java.util.Map;
import java.util.jar.Attributes;
import java.util.jar.JarEntry;
import java.util.jar.JarOutputStream;
import java.util.jar.Manifest;
import java.util.zip.Deflater;
//from   w  ww . jav a2  s . c  om
public class Main {
  public static void main(String[] args) throws Exception {
    Manifest manifest = getManifest();
    String jarFileName = "jartest.jar";
    String[] entries = new String[2];
    entries[0] = "images/logo.bmp";
    entries[1] = "com/java2s/Test.class";
    createJAR(jarFileName, entries, manifest);
  }
  public static void createJAR(String jarFileName, String[] jarEntries,
      Manifest manifest) {
    try (JarOutputStream jos = new JarOutputStream(new BufferedOutputStream(
        new FileOutputStream(jarFileName)), manifest)) {
      jos.setLevel(Deflater.BEST_COMPRESSION);
      for (int i = 0; i < jarEntries.length; i++) {
        File entryFile = new File(jarEntries[i]);
        if (!entryFile.exists()) {
          return;
        }
        JarEntry je = new JarEntry(jarEntries[i]);
        jos.putNextEntry(je);
        addEntryContent(jos, jarEntries[i]);
        jos.closeEntry();
      }
    } catch (IOException e) {
      e.printStackTrace();
    }
  }
  public static void addEntryContent(JarOutputStream jos, String entryFileName)
      throws IOException, FileNotFoundException {
    BufferedInputStream bis = new BufferedInputStream(new FileInputStream(
        entryFileName));
    byte[] buffer = new byte[1024];
    int count = -1;
    while ((count = bis.read(buffer)) != -1) {
      jos.write(buffer, 0, count);
    }
    bis.close();
  }
  public static Manifest getManifest() {
    Manifest manifest = new Manifest();
    Attributes mainAttribs = manifest.getMainAttributes();
    mainAttribs.put(Attributes.Name.MANIFEST_VERSION, "1.0");
    mainAttribs.put(Attributes.Name.MAIN_CLASS, "com.java2s.Test");
    mainAttribs.put(Attributes.Name.SEALED, "true");
    Map<String, Attributes> attribsMap = manifest.getEntries();
    Attributes a1 = getAttribute("Sealed", "false");
    attribsMap.put("com/java2s/", a1);
    Attributes a2 = getAttribute("Content-Type", "image/bmp");
    attribsMap.put("images/logo.bmp", a2);
    return manifest;
  }
  public static Attributes getAttribute(String name, String value) {
    Attributes a = new Attributes();
    Attributes.Name attribName = new Attributes.Name(name);
    a.put(attribName, value);
    return a;
  }
}

Чтобы прочитать записи из файла манифеста файла JAR, получите объект класса Manifest, используя класс getManifest() JarInputStream следующим образом:

JarInputStream jis = new JarInputStream(new FileInputStream("jartest.jar"));
Manifest manifest = jis.getManifest();
if (manifest !=  null)  {
    Attributes  mainAttributes = manifest.getMainAttributes(); 
    String  mainClass = mainAttributes.getValue("Main-Class");
    Map<String, Attributes> entries  = manifest.getEntries();
}

Доступ к ресурсам из файла JAR

Вы можете создать объект URL, используя ссылку на ресурс в файле JAR.

Синтаксис URL-адреса JAR-файла:

jar:<url>!/{entry}

Следующий URL-адрес относится к записи JAR images/logo.bmp в файле test.jar на www.java2s.com с использованием протокола HTTP:

jar:http://www.java2s.com/test.jar!/images/logo.bmp

Следующий URL-адрес относится к записи JAR images/logo.bmp в файле test.jar в локальной файловой системе в каталоге c:\jarfiles\ с использованием файлового протокола:

jar:file:/c:/jarfiles/test.jar!/images/logo.bmp

Чтобы прочитать файл images/logo.bmp из файла JAR в пути к классам, вы можете получить объект входного потока, используя объект класса следующим образом:

// Assuming that the   Test   class is in the   CLASSPATH 
Class cls = Test.class;
InputStream in = cls.getResourceAsStream("/images/logo.bmp")

Вы также можете получить объект URL для записи в вашем файле JAR, который находится в вашем пути к классам, следующим образом:

URL  url = cls.getResource("/images/logo.bmp");