详解如何将已有项目改造为Spring Boot项目

时间:2021-05-19

快速创建一个springboot web工程

以IntelliJ IDEA为例:

1、首先创建一个项目,创建时选择Spring Initializr,然后Next,如下图:

2、填写项目信息,如下图:

3、勾选web

4、最后一步,填写工程名字点击finish

第一次创建时系统会去下载需要的依赖,耗时稍长,请耐心等待。

创建成功后,目录结构如下:项目的根目录下会有一个artifactId+Application命名规则的入口类,SpringbootLearningApplication

SpringbootLearningApplication这个类有一个@SpringBootApplication注解,这是整个Spring Boot的核心注解,它的目的就是开启Spring Boot的自动配置。

@RestController注解,使之变为一个Controller,然后再在里边提供一个地址转换方法,如下:

main方法中,右击选择run,项目启动完成后,就可以在浏览器中直接访问了。

访问路径是http://localhost:8080。

Tip:

如果是第一次创建会发现,文件上带有红圈,文件内容不可更改,如下进行设置:

如何将已有项目改造为Spring Boot项目

1创建可部署的war文件

生成可部署war文件的第一步是创建一个 SpringBootServletInitializer的子类并重写它的configure方法。这样就可以利用Spring Servlet 3.0的支持,并允许在servlet容器启动时配置你的应用程序。通常,main方法所在的类需要继承

SpringBootServletInitializer:

@SpringBootApplicationpublic class Application extends SpringBootServletInitializer { @Override protected SpringApplicationBuilder configure(SpringApplicationBuilder application) { return application.sources(Application.class); } public static void main(String[] args) throws Exception { SpringApplication.run(Application.class, args); }}

下一步是更新构建配置,以便您的项目生成war文件而不是jar文件。如果你使用Maven并使用spring-boot-starter-parent(它为你配置Maven的war插件),你所需要做的就是修改pom.xml文件把工程更改为war工程:

<packaging> war </ packaging>

如果你使用Gradle,你需要修改build.gradle以将war插件用到项目中:

apply plugin:'war'

最后一步是确保内置servlet容器不会干扰要部署war文件的servlet容器。为此,您需要按给定方式声明内置servlet容器依赖关系。

Maven:

<dependencies> <!-- … --> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-tomcat</artifactId> <scope>provided</scope> </dependency> <!-- … --></dependencies>

Gradle:

dependencies { // ... providedRuntime'org.springframework.boot :spring-boot-starter-tomcat' // ... }

[注意]

如果您使用的Gradle版本仅支持仅编译依赖项(2.12或更高版本),则应继续使用providedRuntime。在其他某些限制条件内, 如果compileOnly依赖不在测试类的路径中,这将导致任何基于Web的集成测试将失败。

如果您使用Spring Boot构建工具,那么将内置Servlet容器依赖关系标记为已提供将产生一个可执行文件,并在目录中打包提供的依赖lib-provided关系。这意味着,除了被部署到一个servlet容器,也可以使用运行应用程序java -jar的命令行上。

看一下Spring Boot的示例应用程序,用于上述配置的基于Maven的示例 。

2为旧的servlet容器创建可部署的war文件

较旧的Servlet容器不支持Servlet 3.0中使用的ServletContextInitializer引导进程。 但你仍可以在这些容器中使用Spring和Spring Boot,只是需要添加一个web.xml到应用程序中,并配置它通过DispatcherServlet加载一个ApplicationContext。

3将现有应用程序转换为Spring Boot

对于非web应用程序应该很容易(ApplicationContext通过调用替换为SpringApplication或 SpringApplicationBuilder)。Spring MVC应用程序通常需要先创建可部署的war应用程序,然后将其迁移到可执行的war或jar。jar转war指南

创建一个继承自SpringBootServletInitializer(例如,在一个叫做类Application)的可部署war包,并添加Spring Boot的

@SpringBootApplication注解。例:@SpringBootApplicationpublic class Application extends SpringBootServletInitializer { @Override protected SpringApplicationBuilder configure(SpringApplicationBuilder application) { //自定义应用程序或调用application.sources(...)添加源 //因为我们的例子本身是一个@Configuration类(通过@SpringBootApplication) //我们实际上不需要重写这个方法。 return application; }}

记住,无论你放在什么sources只是一个Spring ApplicationContext,通常已经运行东西都继续在这里运行。可能有一些bean你可以以后删除,让Spring Boot为它们提供自己的默认值,但某些工作应优先进行。

静态资源可以移动到/public(或/static或)/resources或 /META-INF/resources)在类路径根目录中。messages.properties(Spring Boot在类路径的根目录中自动检测到这一点)也是如此。

Vanilla对Spring DispatcherServlet和Spring Security的使用不需要进一步的修改。如果你的应用程序还有其他特性,如使用其他servlet或过滤器,那么你需要添加一些配置到Application context。web.xml中替换的标签如下:

  • 一个在容器中的Servlet或ServletRegistrationBean类型的带有@Bean注解的类会被构建安装,如果它在web.xml中被或中被配置的话。
  • 一个Filter或FilterRegistrationBean类型的带有@Bean注解的类,其运行方式就像先前被和配置的类。
  • 一个在XML文件中的ApplicationContext添加一个@Import注解就可以添加进Application。或者在已经大量使用注解配置的情况下在几行代码中重新定义@Bean注解。
  • 为使war包运行,便需向应用程序中添加一个可执行的main方法,如

    public static void main(String[] args) { SpringApplication.run(Application.class, args);}

    [注意]

    如果打算将应用程序打为war或可执行应用程序,需要共享建设者的自定义中,可以执行SpringBootServletInitializer回调方法和main方法,就像这样:

    @SpringBootApplicationpublic class Application extends SpringBootServletInitializer { @Override protected SpringApplicationBuilder configure(SpringApplicationBuilder builder) { return configureApplication(builder); } public static void main(String[] args) { configureApplication(new SpringApplicationBuilder()).run(args); } private static SpringApplicationBuilder configureApplication(SpringApplicationBuilder builder) { return builder.sources(Application.class).bannerMode(Banner.Mode.OFF); }}

    应用程序可以分为多个类别:

  • 没有web.xml的Servlet 3.0+应用程序。
  • 带有web.xml的应用程序。
  • 具有上下文层次结构的应用程序。
  • 没有上下文层次结构的应用程序。
  • 所有这些都应该适合转译,但每个可能需要略有不同的技巧。

    如果已经使用Spring Servlet 3.0+初始化程序支持类,Servlet 3.0+应用程序就很容易转译。通常现存在 WebApplicationInitializer上的所有代码都可以迁移到SpringBootServletInitializer。如果现有的应用程序有多个ApplicationContext(例如,使用 AbstractDispatcherServletInitializer),那么可以将所有的上下文源合并为单个SpringApplication。其中可能遇到的问题是,如果程序运行失败,就需要维护上下文层次结构。请参阅 构建一个层次的条目的例子。包含Web特定功能的现有父上下文通常需要分解,以便所有ServletContextAware组件都在子上下文中。

    非Spring应用程序的应用程序会更容易转换为Spring Boot应用程序,上述指导可能会有所帮助,但过程可能会有所不同。

    4将WAR部署到WebLogic

    要将Spring Boot应用程序部署到WebLogic,必须确保您的servlet初始化程序直接实现WebApplicationInitializer(即使您从已实现它的基类扩展)。

    WebLogic的典型初始化方法:

    import org.springframework.boot.autoconfigure.SpringBootApplication;import org.springframework.boot.context.web.SpringBootServletInitializer;import org.springframework.web.WebApplicationInitializer;@SpringBootApplicationpublic class MyApplication extends SpringBootServletInitializer implements WebApplicationInitializer {}

    如果使用logback,您还需要告诉WebLogic更合适打包的版本,而不是预先安装的版本。您可以通过添加一个WEB-INF/weblogic.xml文件来做到这一点 ,内容如下:

    <?xml version="1.0" encoding="UTF-8"?><wls:weblogic-web-app xmlns:wls="http://xmlns.oracle.com/weblogic/weblogic-web-app" xmlns:xsi="http:///xml/ns/javaee/web-app_2_5.xsd"> <context-param> <param-name>contextConfigLocation</param-name> <param-value>demo.Application</param-value> </context-param> <listener> <listener-class>org.springframework.boot.legacy.context.web.SpringBootContextLoaderListener</listener-class> </listener> <filter> <filter-name>metricsFilter</filter-name> <filter-class>org.springframework.web.filter.DelegatingFilterProxy</filter-class> </filter> <filter-mapping> <filter-name>metricsFilter</filter-name> <url-pattern>/*</url-pattern> </filter-mapping> <servlet> <servlet-name>appServlet</servlet-name> <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class> <init-param> <param-name>contextAttribute</param-name> <param-value>org.springframework.web.context.WebApplicationContext.ROOT</param-value> </init-param> <load-on-startup>1</load-on-startup> </servlet> <servlet-mapping> <servlet-name>appServlet</servlet-name> <url-pattern>/</url-pattern> </servlet-mapping></web-app>

    在这个例子中,我们使用的是单个应用程序上下文(由context listener创建的)并将其连接到DispatcherServlet用一个参数初始化。这在Spring Boot应用程序中是很常见的(一般只有一个application context)。

    英文原版地址:http://docs.spring.io/spring-boot/docs/current/reference/html/howto-traditional-deployment.html#howto-convert-an-existing-application-to-spring-boot

    以上就是本文的全部内容,希望对大家的学习有所帮助,也希望大家多多支持。

    声明:本页内容来源网络,仅供用户参考;我单位不保证亦不表示资料全面及准确无误,也不保证亦不表示这些资料为最新信息,如因任何原因,本网内容或者用户因倚赖本网内容造成任何损失或损害,我单位将不会负任何法律责任。如涉及版权问题,请提交至online#300.cn邮箱联系删除。

    相关文章