转自:http://www.ibm.com/developerworks/cn/java/j-5things6.html
对于大多数 Java 开发人员来说,JAR 文件及其 “近亲” WAR 和 EAR 都只不过是漫长的 Ant 或 Maven 流程的最终结果。标准步骤是将一个 JAR 复制到服务器(或者,少数情况下是用户机)中的合适位置,然后忘记它。
事实上,JAR 能做的不止是存储源代码,您应该了解 JAR 还能做什么,以及如何进行。在这一期的 5 件事 系列中,将向您展示如何最大限度地利用 Java Archive 文件(有时候也可是 WAR 和 EAR),特别是在部署时。
由于有很多 Java 开发人员使用 Spring(因为 Spring 框架给传统的 JAR 使用带来一些特有的挑战),这里有几个具体技巧用于在 Spring 应用程序中处理 JAR 。
我将以一个标准 Java Archive 文件产生过程的简单示例开始,这将作为以下技巧的基础。
通常,在源代码被编译之后,您需要构建一个 JAR 文件,使用 jar
命令行实用工具,或者,更常用的是 Ant jar
任务将 Java 代码(已经被包分离)收集到一个单独的集合中,过程简洁易懂,我不想在这做过多的说明,稍后将继续说明如何构建 JAR。现在,我只需要存档 Hello
,这是一个独立控制台实用工具,对于执行打印消息到控制台这个任务十分有用。如清单 1 所示:
package com.tedneward.jars; public class Hello { public static void main(String[] args) { System.out.println("Howdy!"); } } |
Hello
实用工具内容并不多,但是对于研究 JAR 文件却是一个很有用的 “脚手架”,我们先从执行此代码开始。
.NET 和 C++ 这类语言一直是 OS 友好的,只需要在命令行(helloWorld.exe
)引用其名称,或在 GUI shell 中双击它的图标就可以启动应用程序。然而在 Java 编程中,启动器程序 — java
— 将 JVM 引导入进程中,我们需要传递一个命令行参数(com.tedneward.Hello
)指定想要启动的 main()
方法的类。
这些附加步骤使使用 Java 创建界面友好的应用程序更加困难。不仅终端用户需要在命令行输入所有参数(终端用户宁愿避开),而且极有可能使他或她操作失误以及返回一个难以理解的错误。
这个解决方案使 JAR 文件 “可执行” ,以致 Java 启动程序在执行 JAR 文件时,自动识别哪个类将要启动。我们所要做的是,将一个入口引入 JAR 文件清单文件(MANIFEST.MF
在 JAR 的 META-INF
子目录下),像这样:
Main-Class: com.tedneward.jars.Hello |
这个清单文件只是一个名值对。因为有时候清单文件很难处理回车和空格,然而在构建 JAR 时,使用 Ant 来生成清单文件是很容易的。在清单 3 中,使用 Ant jar
任务的 manifest
元素来指定清单文件:
<target name="jar" depends="build"> <jar destfile="outapp.jar" basedir="classes"> <manifest> <attribute name="Main-Class" value="com.tedneward.jars.Hello" /> </manifest> </jar> </target> |
现在用户在执行 JAR 文件时需要做的就是通过 java -jar outapp.jar
在命令行上指定其文件名。就 GUI shell 来说,双击 JAR 文件即可。
似乎 Hello
实用工具已经展开,改变实现的需求已经出现。Spring 或 Guice 这类依赖项注入(DI)容器可以为我们处理许多细节,但是仍然有点小问题:修改代码使其含有 DI 容器的用法可能导致清单 4 所示的结果,如:
package com.tedneward.jars; import org.springframework.context.*; import org.springframework.context.support.*; public class Hello { public static void main(String[] args) { ApplicationContext appContext = new FileSystemXmlApplicationContext("./app.xml"); ISpeak speaker = (ISpeak) appContext.getBean("speaker"); System.out.println(speaker.sayHello()); } } |
由于启动程序的 -jar
选项将覆盖 -classpath
命令行选项中的所有内容,因此运行这些代码时,Spring 必须是在 CLASSPATH
和 环境变量中。幸运的是,JAR 允许在清单文件中出现其他的 JAR 依赖项声明,这使得无需声明就可以隐式创建 CLASSPATH,如清单 5 所示:
<target name="jar" depends="build"> <jar destfile="outapp.jar" basedir="classes"> <manifest> <attribute name="Main-Class" value="com.tedneward.jars.Hello" /> <attribute name="Class-Path" value="./lib/org.springframework.context-3.0.1.RELEASE-A.jar ./lib/org.springframework.core-3.0.1.RELEASE-A.jar ./lib/org.springframework.asm-3.0.1.RELEASE-A.jar ./lib/org.springframework.beans-3.0.1.RELEASE-A.jar ./lib/org.springframework.expression-3.0.1.RELEASE-A.jar ./lib/commons-logging-1.0.4.jar" /> </manifest> </jar> </target> |
注意 Class-Path
属性包含一个与应用程序所依赖的 JAR 文件相关的引用。您可以将它写成一个绝对引用或者完全没有前缀。这种情况下,我们假设 JAR 文件同应用程序 JAR 在同一个目录下。
不幸的是,value
属性和 Ant Class-Path
属性必须出现在同一行,因为 JAR 清单文件不能处理多个 Class-Path
属性。因此,所有这些依赖项在清单文件中必须出现在一行。当然,这很难看,但为了使 java -jar outapp.jar
可用,还是值得的!
如果有几个不同的命令行实用工具(或其他的应用程序)在使用 Spring 框架,可能更容易将 Spring JAR 文件放在公共位置,使所有实用工具能够引用。这样就避免了文件系统中到处都有 JAR 副本。Java 运行时 JAR 的公共位置,众所周知是 “扩展目录” ,默认位于 lib/ext
子目录,在 JRE 的安装位置之下。
JRE 是一个可定制的位置,但是在一个给定的 Java 环境中很少定制,以至于可以完全假设 lib/ext
是存储 JAR 的一个安全地方,以及它们将隐式地用于 Java 环境的 CLASSPATH
上。
为了避免庞大的 CLASSPATH
环境变量(Java 开发人员几年前就应该抛弃的)和/或命令行 -classpath
参数,Java 6 引入了类路径通配符 的概念。与其不得不启动参数中明确列出的每个 JAR 文件,还不如自己指定 lib/*
,让所有 JAR 文件列在该目录下(不递归),在类路径中。
不幸的是,类路径通配符不适用于之前提到的 Class-Path
属性清单入口。但是这使得它更容易启动 Java 应用程序(包括服务器)开发人员任务,例如 code-gen 工具或分析工具。
Spring,就像许多 Java 生态系统一样,依赖于一个描述构建环境的配置文件,前面提到过,Spring 依赖于一个 app.xml 文件,此文件同 JAR 文件位于同一目录 — 但是开发人员在复制 JAR 文件的同时忘记复制配置文件,这太常见了!
一些配置文件可用 sysadmin 进行编辑,但是其中很大一部分(例如 Hibernate 映射)都位于 sysadmin 域之外,这将导致部署漏洞。一个合理的解决方案是将配置文件和代码封装在一起 — 这是可行的,因为 JAR 从根本上来说就是一个 “乔装的” ZIP 文件。 当构建一个 JAR 时,只需要在 Ant 任务或 jar
命令行包括一个配置文件即可。
JAR 也可以包含其他类型的文件,不仅仅是配置文件。例如,如果我的 SpeakEnglish
部件要访问一个属性文件,我可以进行如下设置,如清单 6 所示:
package com.tedneward.jars; import java.util.*; public class SpeakEnglish implements ISpeak { Properties responses = new Properties(); Random random = new Random(); public String sayHello() { // Pick a response at random int which = random.nextInt(5); return responses.getProperty("response." + which); } } |
可以将 responses.properties
放入 JAR 文件,这意味着部署 JAR 文件时至少可以少考虑一个文件。这只需要在 JAR 步骤中包含 responses.properties 文件即可。
当您在 JAR 中存储属性之后,您可能想知道如何将它取回。如果所需要的数据与 JAR 文件在同一位置,正如前面的例子中提到的那样,不需要费心找出 JAR 文件的位置,使用 JarFile
对象就可将其打开。相反,可以使用类的 ClassLoader
找到它,像在 JAR 文件中寻找 “资源” 那样,使用 ClassLoader getResourceAsStream()
方法,如清单 7 所示:
package com.tedneward.jars; import java.util.*; public class SpeakEnglish implements ISpeak { Properties responses = new Properties(); // ... public SpeakEnglish() { try { ClassLoader myCL = SpeakEnglish.class.getClassLoader(); responses.load( myCL.getResourceAsStream( "com/tedneward/jars/responses.properties")); } catch (Exception x) { x.printStackTrace(); } } // ... } |
您可以按照以上步骤寻找任何类型的资源:配置文件、审计文件、图形文件,等等。几乎任何文件类型都能被捆绑进 JAR 中,作为一个 InputStream
获取(通过 ClassLoader
),并通过您喜欢的方式使用。
本文涵盖了关于 JAR 大多数开发人员所不知道的 5 件最重要的事 — 至少基于历史,有据可查。注意,所有的 JAR 相关技巧对于 WAR 同样可用,一些技巧(特别是 Class-Path
和 Main-Class
属性)对于 WAR 来说不是那么出色,因为 servlet 环境需要全部目录,并且要有一个预先确定的入口点,但是,总体上来看这些技巧可以使我们摆脱 “好的,开始在该目录下复制......” 的模式,这也使得他们部署 Java 应用程序更为简单。
本系列的下一个主题是:关于 Java 应用程序性能监视您不知道的 5 件事。
相关推荐
Java开发过程中,jar(Java Archive)包是必不可少的资源,它们包含了预编译的类、接口、资源和其他元数据,方便开发者在项目中引用。在给出的标题和描述中,提到了几个常用的Java jar包,分别是:activation.jar、...
5. **pop3.jar**:POP3(Post Office Protocol version 3)是另一种常用的邮件协议,主要用于从邮件服务器下载邮件。pop3.jar包含了处理POP3协议所需的类和方法。 6. **smtp.jar**:SMTP(Simple Mail Transfer ...
5) 在注册表编辑器中,找到"HKEY_CLASSES_ROOT\Applications\javaw.exe\shell\open\command",在其中⽂件打开命令中加 ⼊参数"-jar"(⽆引号),修改后的数值类似:""C:\ProgramFiles\Java\jre7\bin\javaw.exe" -jar ...
在Android开发中,有时我们需要集成邮件发送功能,这时就涉及到了“發送郵件工具類”。这个类主要用于帮助应用程序在Android设备上实现电子邮件的发送。通常,为了完成这个任务,开发者会引入特定的库或者依赖,例如...
在了解"alimama LIB包"之前,我们首先需要知道阿里妈妈是什么。阿里妈妈是阿里巴巴集团旗下的一个数字营销平台,它主要提供包括淘宝联盟、广告投放、效果营销等服务,帮助商家推广产品,同时也为网站主和媒体提供...
5. 设置邮件的发件人、收件人和主题。 6. 创建`Multipart`对象,用于存储邮件的多个部分,如纯文本和附件。 7. 创建`MimeBodyPart`对象,设置邮件正文内容,然后添加到`Multipart`中。 8. 最后,通过`Transport`类的...
我们做项目的时候,并不是所有文 件都是要提交的,比如构建的build 文件夹,本地配置文件,每个Module 生成的iml 文件,但是我们每次add,commit 都会不小心把它们添加上去,而gitignore 就是解决这种痛点的,如果你...
JavaMail的依赖库包括`javax.mail`和`javax.mail-api`,以及SMTP服务器所需的协议库,如`mailapi.jar`和` Activation.jar`。 2. **SMTP服务器设置**:JavaMail需要知道如何连接到SMTP服务器来发送邮件。你需要配置...
� Google 提供了一套 Java 核心包 (J2SE 5,J2SE 6) 的有限子集,尚不承诺遵守 Java 任何 Java 规范 , 可能会造 成J ava 阵营的进一步分裂。 � 现有应用完善度不太够,需要的开发工作量较大。--------------------...
通常,这会是`javax.mail`和`javax.mail-api`两个JAR包,或者通过Maven或Gradle添加对应的依赖。 ```xml <!-- Maven依赖 --> <groupId>com.sun.mail</groupId> <artifactId>javax.mail <version>1.6.2 ``` ``...
简而言之:Feign能干Ribbon和Hystrix的事情,但是要用Ribbon和Hystrix自带的注解必须要引入相应的jar包才可以。 3)Spring Cloud Bus Spring Cloud Bus 将分布式系统的节点通过轻量级消息代理连接起来。用于在集群...
除非您访问驱动器有问题,否则不要继续进行。向系统分区写入新的主引导记录可能破坏分区表并导致分区无法访问。 format 将指定的驱动器格式化为指定的文件系统。含有下列参数的 format 命令仅在使用故障恢复...