使用 boot-clj 创建 war

Create a war with boot-clj

我想创建一个可以用 tomcat 部署的 war。使用 lein uberwar 就可以很好地完成工作,但是对引导执行相同的操作似乎不起作用。我可以构建一个 jar 并 运行 它,但是 war 失败并显示

Dec 09, 2015 12:15:31 AM org.apache.catalina.loader.WebappClassLoader validateJarFile INFO: validateJarFile(/var/lib/tomcat7/sites/geeknow.guru/DEBUG##0.1.7/WEB-INF/lib/javax.servlet-api-3.1.0.jar) - jar not loaded. See Servlet Spec 3.0, section 10.7.2. Offending class: javax/servlet/Servlet.class

我正在使用以下 build.boot

(set-env!
 :source-paths #{"src/clj"}
 :resource-paths #{"resources" "src/clj"}
 :dependencies '[[org.clojure/clojure "1.7.0"]
                 [clj-time "0.9.0"]
                 [org.clojure/java.jdbc "0.3.7"]
                 [org.postgresql/postgresql "9.4-1202-jdbc41"]
                 [yesql "0.5.1"]
                 [migratus "0.8.6"]
                 [markdown-clj "0.9.67"]
                 [jarohen/nomad "0.7.2"]
                 [com.draines/postal "1.11.3"]
                 [compojure "1.4.0"]
                 [ring/ring-core "1.4.0"]
                 [ring/ring-devel "1.4.0"]
                 [ring/ring-defaults "0.1.5"] 
                 [ring/ring-jetty-adapter "1.4.0"]
                 [ring-refresh "0.1.1"]
                 [ring-logger-timbre "0.7.5"]
                 [com.taoensso/timbre "4.1.4"]
                 [hiccup "1.0.5"]
                 [garden "1.3.0"]
                 [danlentz/clj-uuid "0.1.6"]
                 [speclj "3.3.1" :scope "test"]
                 [pandeiro/boot-http "0.7.1-SNAPSHOT"]])

(require '[pandeiro.boot-http :as http])
(require '[ring.middleware.reload :refer [wrap-reload]])
(require '[ring.adapter.jetty :as jetty])
(require '[ring.middleware.refresh :refer [wrap-refresh]])
(require '[blog.handler])

;;;;taken from boot-http.util
(defn resolve-sym [sym]
  (require (symbol (namespace sym)) :reload)
  (resolve sym))

(deftask ring-server
  []
  (comp (jetty/run-jetty (wrap-refresh (wrap-reload (resolve-sym 'blog.handler/app))) {:port 3000}) (wait)))

(deftask uberwar
  []
  (comp (aot) (pom) (web) (uber) (war)))

(deftask uberjar
  []
  (comp (aot) (pom) (uber) (jar)))

(task-options!
 pom {:project 'geeknow
      :version "0.1.7"}
 ;uber {:as-jars true}
 aot {:all true}
 jar {:main 'blog.core
      :manifest {"Description" "blog"}}
 web {:serve 'blog.handler/app}
 war {:main 'blog.core
      :manifest {"Description" "blog"}}
 repl {:init-ns 'blog.core})

Tomcat 抱怨是因为您的 war 文件中包含的一个 jar 包含只有容器环境才能提供的 class。 war 中有问题的 jar 是 WEB-INF/lib/javax.servlet-api-3.1.0.jar.

默认情况下,当 --as-jars 设置为 true 时,uber 任务将所有依赖项(直接和传递)添加到 WEB-INF/lib 处的 war。 --as-jars 是捆绑依赖项以部署到 servlet 容器的首选方式。

问题似乎是您的一个直接依赖项正在引入 javax.servlet-api 并且 uber 正在打包它,导致 Tomcat 问题。

首先我们需要弄清楚是哪个依赖项引入了 javax.servlet-apiboot show 包含许多用于诊断此类依赖性问题的选项。您可以通过 boot show -h 了解它们。我们现在想要的是boot show -d,打印依赖树。

这是相关输出的片段:

[ring/ring-jetty-adapter "1.4.0"]
├── [org.eclipse.jetty/jetty-server "9.2.10.v20150310"]
│   ├── [javax.servlet/javax.servlet-api "3.1.0"]
│   ├── [org.eclipse.jetty/jetty-http "9.2.10.v20150310"]
│   │   └── [org.eclipse.jetty/jetty-util "9.2.10.v20150310"]
│   └── [org.eclipse.jetty/jetty-io "9.2.10.v20150310"]
└── [ring/ring-servlet "1.4.0"]

从这个输出中,我们知道我们对 ring/ring-jetty-adapter 的依赖是导致引入 javax.servlet/javax.servlet-api 的原因。

因为这种依赖对于本地开发是必需的,所以我们不想完全忽略它。相反,我们可以添加范围为 "test" 的依赖项:

[ring/ring-jetty-adapter "1.4.0" :scope "test"]

作用域 Maven concept 用于限制此类场景中依赖项的传递性。 Boot 使用 Maven 作为其底层依赖解析机制。 uber 对 Maven 作用域敏感,可以根据需要配置为包含或排除各种作用域。有关详细信息,请参阅 boot uber -h

默认情况下,uber 任务不会在 "test" 范围内打包依赖项。通过以这种方式标记 ring/ring-jetty-adapter,我们已将其从我们的优步 war.

中排除

"test" 范围对于您可能在测试中使用的依赖项(当然!),或用于部署,或用于您需要依赖项但不想分发它的其他任务也很有用使用您的工件,无论是库 jar 还是 uberwar 网络应用程序。