La herramienta Jar te permite mezclar el contenido de un fichero de manifiesto pre-existente con el fichero de manifiesto por defecto que se genera cuando se crea un fichero JAR.
Podr�as querer producir un fichero de menifiesto que no fuera por defecto, por ejemplo, a�adiendo una cabecera de prop�sito especial que permita a tu fichero JAR realizar una funci�n particular. Puedes ver ejemplos de algunas cabeceras de prop�sito especial en la secci�n Entender el Manifiesto.
El comando b�sico tiene este formato.
jar cmf manifest jar-file input-file(s)
Echemos un vistazo a las opciones y argumentos utilizados en este comando.
- La opci�n c indica que quieres crear un fichero JAR.
- La opci�n m indica que quieres mezclar informaci�n de un fichero de manifiesto existente en el fichero de manifiesto del fichero JAR que est�s creando.
- La opci�n f indica que quieres que la salida vaya a un fichero (el fichero Jar que est�s creando), en vez de a stdout.
- manifest es el nombre (o path y nombre) del fichero de manifiesto existente cuyo contenido quieres incluir en el manifiesto del fichero JAR.
- jar-file es el nombre que quieres para el fichero JAR resultante.
- El argumento input-file(s) es una lista delimitada por espacios de los ficherps que quieres a�adir a tu fichero JAR.
Las opciones c, m, y f pueden aparecer en cualquier orden, pero no debe existir ning�n espacio entre ellas.
�Un ejemplo
En la versi�n 1.2 de la plataforma Java, los paquetes dentro de ficheros JAR pueden sellarse opcionalmente, lo que significa que todas las clases definidas en un paquete deben est�s archivadas en el mismo fichero JAR. Por ejemplo, podr�as querer sellar un paquete, para asegurar la consitencia de versiones entre las clases de tu software.
Un paquete puede sellarse a�adiendo la cabecera Sealed.
Name: myCompany/myPackage/ Sealed: true
Para almacenar la cabecera Sealed en el manifiesto de un fichero JAR, primero necesitas escribir un fichero de manifiesto con las cabeceras apropiadas. Realmente, el fichero que escribas no tiene que ser un fichero de manifiesto completo; puede contener s�lo suficiente informaci�n para que la herramienta Jar sepa d�nde y qu� informaci�n mezclar dentro del fichero de manifiesto por defecto.
Supongamos, por ejemplo, que tu fichero JAR es para contener estos cuatro paquetes.
myCompany/firstPackage myCompany/secondPackage myCompany/thirdPackage myCompand/fourthpackage
y que quieres sellar firstPackage y thirdPackage. Para hacer esto, deber�as escribir un fichero de manifiesto parcial con este contenido.
Name: myCompany/firstPackage/ Sealed: true Name: myCompany/thirdPackage/ Sealed: true
Luego supongamos que.
- que has llamado a tu manifiesto parcial myManifest
- el fichero JAR que quieres crear se llamar� myJar.jar
- El directorio actual es el directorio padre de myCompany
Podr�as crear el fichero JAR con este comando.
jar cmf myManifest myJar.jar myCompany
El aspecto resultante del fichero de manifiesto de myJar.jar depender� de la versi�n del JDK que est�s utilizando. En cualquier caso, la informaci�n de sellado, ser� incluida para firstPackage y thirdPackage.