liberty | 在IDEA整合Springboot与IBM liberty

在IDEA整合Springboot与IBM liberty

简介

WebSphere Liberty是一个快速，动态且易于使用的Java应用程序服务器，构建于开源Open Liberty项目之上。适用于开发人员，也适用于生产，内部部署或云端产品 Liberty是IBM技术和开源软件的组合，具有快速启动时间（<2秒），无需重启服务器以获取更改，以及简单的XML组态。

在本文中，我将描述如何使用Spring模型视图控制器（MVC）端点和使用Spring Boot和Liberty App Accelerator的Spring REST端点创建一个简单的“Hello World”应用程序。

IBM Liberty Vs Tomcat

简单来说，IBM Liberty就是 IBM WebSphere Application Server 的简化版，Liberty是从WebSphere 8.5.5引入的，与传统的WAS不同，Liberty侧重于云应用与微服务的支持，用户可以配置细粒度级别的应用程序所需的组件，所以服务器启动速度非常快，占用空间也很小，跟tomcat一样轻量级，一般都是用于企业级应用比较多，尤其是金融类、或者大型商业应用等，提供很多商业级的扩展组件。

两者区别可以通过以下两篇文章了解:
https://webspherecompetition.files.wordpress.com/2012/11/liberty-vs-tomcat.pdf
https://www.ibm.com/developerworks/community/files/form/anonymous/api/library/ac092234-1cdc-406a-9317-39ee651ffbf6/document/ed0b79c7-09f1-4023-b7ec-31efa730c97f/media/tomcat-liberty.pdf

开始之前

你需要先到以下网址下载最新版的WebSphere Liberty runtime:
https://developer.ibm.com/wasdev/downloads/download-latest-stable-websphere-liberty-runtime/

创建Springboot Rest应用

利用Spring Initializr创建一个Sprignboot项目
选择File->Project->Spring Initizlizr创建项目命名为liberty-demo,依赖包选择Web，然后一直点击Next完成即可，项目结构如下:
liberty | 在IDEA整合Springboot与IBM liberty
配置Pom.xml文件，添加servlet容器依赖:

     <dependency>
            <groupId>javax.servlet</groupId>
            <artifactId>javax.servlet-api</artifactId>
            <version>3.1.0</version>
            <scope>provided</scope>
        </dependency>

如果使用旧版本的应用服务器，还需要添加如下依赖:

<dependency>
    <groupId>javax</groupId>
    <artifactId>javaee-api</artifactId>
    <version>7.0</version>
    <scope>provided</scope>
</dependency>

跟配置外置tomcat一样，我们需要过滤到Springboot里的tomcat模块

    <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
            <exclusions>
                <exclusion>
                    <groupId>org.springframework.boot</groupId>
                    <artifactId>spring-boot-starter-tomcat</artifactId>
                </exclusion>
            </exclusions>
        </dependency>

我项目完整的Pom.xml文件如下:

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>

    <groupId>com.eshare.liberty</groupId>
    <artifactId>demo</artifactId>
    <version>0.0.1-SNAPSHOT</version>
    <packaging>jar</packaging>

    <name>demo</name>
    <description>Demo project for Spring Boot</description>

    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>2.0.6.RELEASE</version>
        <relativePath/> <!-- lookup parent from repository -->
    </parent>

    <properties>
        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
        <project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding>
        <java.version>1.8</java.version>
    </properties>

    <dependencies>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-thymeleaf</artifactId>
        </dependency>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
            <exclusions>
                <exclusion>
                    <groupId>org.springframework.boot</groupId>
                    <artifactId>spring-boot-starter-tomcat</artifactId>
                </exclusion>
            </exclusions>
        </dependency>

        <dependency>
            <groupId>org.projectlombok</groupId>
            <artifactId>lombok</artifactId>
            <optional>true</optional>
        </dependency>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-test</artifactId>
            <scope>test</scope>
        </dependency>

        <dependency>
            <groupId>javax.servlet</groupId>
            <artifactId>javax.servlet-api</artifactId>
            <version>3.1.0</version>
            <scope>provided</scope>
        </dependency>
    </dependencies>
    
    <build>
        <plugins>
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
            </plugin>
        </plugins>
    </build>
</project>

我们要使用传统的WAR发布Sringboot项目方式，需要调整程序入口代码，继承SpringBootServletInitializer类，重写configure方法去告诉容器我们的程序启动入口

@SpringBootApplication
public class DemoApplication extends SpringBootServletInitializer {

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

    @Override
    protected SpringApplicationBuilder configure(SpringApplicationBuilder application) {
        return application.sources(DemoApplication.class);
    }
}

接下来我们实现一个简单的Rest程序，用于测试容器是否启动正常

/**
 * Created by liangyh on 2018/10/20.
 * Email:[email protected]
 */
@RestController
public class IndexController{

        @RequestMapping("/sayHello/{name}")
        public String sayHello(@PathVariable String name) {
            return "hello," + name;
        }

}

记住，Springboot的启动类必须置于其他类的同级或者外层，否则会出现扫描不到类的情况，完成项目结构如下:
liberty | 在IDEA整合Springboot与IBM liberty

配置Liberty应用服务器

设置我们的模块包的打包方式
点击Peroject Structure->Artifacts，如下图所示选择打包方式:
liberty | 在IDEA整合Springboot与IBM liberty
选择完成后，点击Apply完成

选择启动应用服务器
如下图所示，选择liberty作为我们的项目服务器，然后填入相应配置，必须配置请求上下文(如/demo/):
liberty | 在IDEA整合Springboot与IBM liberty

设置Liberty服务器配置
在wlp\usr\servers\defaultServer路径下，找到Liberty启动服务器配置server.xml，添加host="*"，指定拦截任何请求，否则应用服务器不会拦截你的请求: