ฉันจะทำให้การทดสอบ Maven Integration ของฉันทำงานได้อย่างไร

ฉันมีโครงการหลายโมดูล maven2 และในแต่ละโมดูลลูกของฉันฉันมีการทดสอบ JUnit ที่มีชื่อTest.javaและIntegration.javaสำหรับการทดสอบหน่วยและการทดสอบการรวมตามลำดับ เมื่อฉันรัน:

mvn test

การทดสอบ JUnit ทั้งหมด*Test.javaภายในโมดูลย่อยถูกเรียกใช้งาน เมื่อฉันรัน

mvn test -Dtest=**/*Integration

ไม่มีการIntegration.javaทดสอบใดที่จะดำเนินการภายในโมดูลย่อย

สิ่งเหล่านี้ดูเหมือนคำสั่งเดียวกับฉัน แต่คำสั่งที่รวมกับ-Dtest = / * Integration ** ไม่ทำงานแสดงว่ามีการทดสอบ 0 รายการที่เรียกใช้ในระดับผู้ปกครองซึ่งไม่มีการทดสอบใด ๆ

คุณสามารถตั้งค่า Surefire ของ Maven ให้เรียกใช้การทดสอบหน่วยและการทดสอบการรวมแยกต่างหาก ในขั้นตอนการทดสอบหน่วยมาตรฐานคุณเรียกใช้ทุกสิ่งที่ไม่ตรงกับรูปแบบการทดสอบการรวม จากนั้นคุณสร้างขั้นตอนการทดสอบที่สองที่เรียกใช้เพียงการทดสอบการรวม

นี่คือตัวอย่าง:

    <plugin>
      <groupId>org.apache.maven.plugins</groupId>
      <artifactId>maven-surefire-plugin</artifactId>
      <configuration>
        <excludes>
          <exclude>**/*IntegrationTest.java</exclude>
        </excludes>
      </configuration>
      <executions>
        <execution>
          <id>integration-test</id>
          <goals>
            <goal>test</goal>
          </goals>
          <phase>integration-test</phase>
          <configuration>
            <excludes>
              <exclude>none</exclude>
            </excludes>
            <includes>
              <include>**/*IntegrationTest.java</include>
            </includes>
          </configuration>
        </execution>
      </executions>
    </plugin>

สร้างวงจร Mavenขณะนี้รวมถึง "บูรณาการการทดสอบ" ขั้นตอนสำหรับการทดสอบการทำงานบูรณาการซึ่งจะดำเนินการแยกต่างหากจากการทดสอบหน่วยที่ดำเนินการในช่วง "ทดสอบ" เฟส มันจะทำงานหลังจาก "แพ็คเกจ" ดังนั้นหากคุณเรียกใช้ "mvn ตรวจสอบ", "ติดตั้ง mvn" หรือ "ปรับใช้ mvn" การทดสอบการรวมจะทำงานตลอดทาง

โดยค่าเริ่มต้นบูรณาการการทดสอบวิ่งการเรียนการทดสอบการตั้งชื่อ**/IT*.java, **/*IT.javaและ**/*ITCase.javaแต่สามารถกำหนดค่า

สำหรับรายละเอียดเกี่ยวกับวิธีการสายนี้ขึ้นทั้งหมดให้ดูFailsafe ปลั๊กอินที่หน้าการใช้งานป้องกันความผิดพลาด (ไม่ได้เชื่อมโยงอย่างถูกต้องจากหน้าก่อนหน้านี้ที่ผมเขียนนี้) และยังตรวจสอบนี้โพสต์บล็อก Sonatype

ฉันได้ทำสิ่งที่คุณต้องการแล้วและใช้งานได้ดีมาก หน่วยทดสอบ "* Tests" จะทำงานเสมอและ "* IntegrationTests" จะทำงานเฉพาะเมื่อคุณทำการตรวจสอบ mvn หรือติดตั้ง mvn นี่คือตัวอย่างจาก POM ของฉัน serg10 เกือบจะถูกต้อง .... แต่ไม่มาก

  <plugin>
    <!-- Separates the unit tests from the integration tests. -->
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-surefire-plugin</artifactId>
    <configuration>
       <!-- Skip the default running of this plug-in (or everything is run twice...see below) -->
       <skip>true</skip>
       <!-- Show 100% of the lines from the stack trace (doesn't work) -->
       <trimStackTrace>false</trimStackTrace>
    </configuration>
    <executions>
       <execution>
          <id>unit-tests</id>
          <phase>test</phase>
          <goals>
             <goal>test</goal>
          </goals>
          <configuration>
                <!-- Never skip running the tests when the test phase is invoked -->
                <skip>false</skip>
             <includes>
                   <!-- Include unit tests within integration-test phase. -->
                <include>**/*Tests.java</include>
             </includes>
             <excludes>
               <!-- Exclude integration tests within (unit) test phase. -->
                <exclude>**/*IntegrationTests.java</exclude>
            </excludes>
          </configuration>
       </execution>
       <execution>
          <id>integration-tests</id>
          <phase>integration-test</phase>
          <goals>
             <goal>test</goal>
          </goals>
          <configuration>
            <!-- Never skip running the tests when the integration-test phase is invoked -->
             <skip>false</skip>
             <includes>
               <!-- Include integration tests within integration-test phase. -->
               <include>**/*IntegrationTests.java</include>
             </includes>
          </configuration>
       </execution>
    </executions>
  </plugin>

โชคดี!

คุณสามารถแยกพวกมันออกได้อย่างง่ายดายโดยใช้หมวดหมู่ JUnit และ Maven
นี่แสดงให้เห็นว่าสั้นมากโดยการแยกการทดสอบหน่วยและการรวมเข้าด้วยกัน

กำหนดอินเตอร์เฟสเครื่องหมาย

ขั้นตอนแรกในการจัดกลุ่มการทดสอบโดยใช้หมวดหมู่คือการสร้างส่วนต่อประสานเครื่องหมาย
อินเทอร์เฟซนี้จะใช้เพื่อทำเครื่องหมายการทดสอบทั้งหมดที่คุณต้องการเรียกใช้เป็นการทดสอบรวม

public interface IntegrationTest {}

ทำเครื่องหมายชั้นเรียนทดสอบของคุณ

เพิ่มคำอธิบายประกอบหมวดหมู่ไปด้านบนของชั้นเรียนทดสอบของคุณ ใช้ชื่อของอินเทอร์เฟซใหม่ของคุณ

import org.junit.experimental.categories.Category;

@Category(IntegrationTest.class)
public class ExampleIntegrationTest{

    @Test
    public void longRunningServiceTest() throws Exception {
    }

}

กำหนดค่าการทดสอบหน่วย Maven

ความสวยงามของโซลูชันนี้คือไม่มีอะไรเปลี่ยนแปลงจริง ๆ สำหรับด้านการทดสอบหน่วยของสิ่งต่าง ๆ
เราเพียงเพิ่มการกำหนดค่าบางอย่างลงในปลั๊กอิน maven surefire เพื่อให้ละเว้นการทดสอบการรวมระบบ

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-surefire-plugin</artifactId>
    <version>2.11</version>
    <configuration>
        <includes>
            <include>**/*.class</include>
        </includes>
        <excludedGroups>
            com.test.annotation.type.IntegrationTest
        </excludedGroups>
    </configuration>
</plugin>

เมื่อคุณทำmvn clean testเพียงทดสอบหน่วยที่ไม่ได้ทำเครื่องหมายของคุณจะทำงาน

กำหนดค่าการทดสอบการรวม Maven

อีกครั้งการกำหนดค่าสำหรับเรื่องนี้ง่ายมาก
เราใช้ปลั๊กอินมาตรฐานที่ไม่ปลอดภัยและกำหนดค่าให้เรียกใช้การทดสอบการรวมเท่านั้น

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-failsafe-plugin</artifactId>
    <version>2.19.1</version>
    <configuration>
        <includes>
            <include>**/*.class</include>
        </includes>
        <groups>
            com.test.annotation.type.IntegrationTest
        </groups>
    </configuration>
</plugin>

การกำหนดค่าใช้เป้าหมายการดำเนินการมาตรฐานเพื่อเรียกใช้ปลั๊กอินที่ไม่ปลอดภัยในระหว่างขั้นตอนการทดสอบการรวมระบบของบิลด์

mvn clean installตอนนี้คุณสามารถทำ
เวลานี้เช่นเดียวกับการทดสอบหน่วยการทำงานการทดสอบการรวมจะดำเนินการในระหว่างขั้นตอนการทดสอบการรวมระบบ

คุณควรลองใช้Maven failsafe ปลั๊กอิน คุณสามารถบอกให้รวมชุดการทดสอบบางอย่าง

โดยค่าเริ่มต้น Maven จะเรียกใช้การทดสอบที่มีการทดสอบที่ไหนสักแห่งในชื่อชั้น

เปลี่ยนชื่อเป็น IntegrationTest และอาจใช้งานได้

หรือคุณสามารถเปลี่ยนการตั้งค่า Maven เพื่อรวมไฟล์นั้น แต่อาจง่ายกว่าและดีกว่าเพียงตั้งชื่อการทดสอบของคุณ SomethingTest

จากการรวมและการแยกการทดสอบ :

ตามค่าเริ่มต้นปลั๊กอิน Surefire จะรวมคลาสการทดสอบทั้งหมดด้วยรูปแบบไวด์การ์ดต่อไปนี้โดยอัตโนมัติ:

• \*\*/Test\*.java - รวมไดเรกทอรีย่อยทั้งหมดและชื่อไฟล์ java ทั้งหมดที่ขึ้นต้นด้วย "ทดสอบ"
• \*\*/\*Test.java - รวมไดเรกทอรีย่อยทั้งหมดและชื่อไฟล์ java ทั้งหมดที่ลงท้ายด้วย "Test"
• \*\*/\*TestCase.java - รวมไดเรกทอรีย่อยทั้งหมดและชื่อไฟล์ java ทั้งหมดที่ลงท้ายด้วย "TestCase"

หากคลาสการทดสอบไม่สอดคล้องกับหลักการตั้งชื่อให้กำหนดค่าปลั๊กอิน Surefire และระบุการทดสอบที่คุณต้องการรวม

อีกวิธีหนึ่งในการเรียกใช้การทดสอบการรวมกับ Maven คือการใช้ประโยชน์จากคุณลักษณะโปรไฟล์:

...
<build>
    <plugins>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-surefire-plugin</artifactId>
            <configuration>
                <includes>
                    <include>**/*Test.java</include>
                </includes>
                <excludes>
                    <exclude>**/*IntegrationTest.java</exclude>
                </excludes>
            </configuration>
        </plugin>
    </plugins>
</build>

<profiles>
    <profile>
        <id>integration-tests</id>
        <build>
            <plugins>
                <plugin>
                    <groupId>org.apache.maven.plugins</groupId>
                    <artifactId>maven-surefire-plugin</artifactId>
                    <configuration>
                        <includes>
                            <include>**/*IntegrationTest.java</include>
                        </includes>
                        <excludes>
                            <exclude>**/*StagingIntegrationTest.java</exclude>
                        </excludes>
                    </configuration>
                </plugin>
            </plugins>
        </build>
    </profile>
</profiles>
...

การรัน'mvn clean install'จะเรียกใช้บิลด์ที่เป็นค่าเริ่มต้น ตามที่ระบุข้างต้นการทดสอบการรวมจะถูกละเว้น การรัน'mvn clean install -P Integration-tests'จะรวมถึงการทดสอบการรวม (ฉันยังไม่สนใจการทดสอบการรวมสถานะ) นอกจากนี้ฉันมีเซิร์ฟเวอร์ CI ที่ทำงานบูรณาการของฉันทดสอบทุกคืนและการที่ผมออกคำสั่ง'ทดสอบ mvn -P การบูรณาการทดสอบ'

คุณสามารถทำตามเอกสาร mavenเพื่อรันการทดสอบหน่วยด้วยบิลด์และรันการทดสอบการรวมแยกจากกัน

<project>
    <properties>
        <skipTests>true</skipTests>
    </properties>
    [...]
    <build>
        <plugins>
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-failsafe-plugin</artifactId>
                <version>2.20.1</version>
                <configuration>
                    <skipITs>${skipTests}</skipITs>
                </configuration>
            </plugin>
        </plugins>
    </build>
    [...]
</project>

สิ่งนี้จะช่วยให้คุณเรียกใช้เมื่อปิดการทดสอบการรวมระบบโดยค่าเริ่มต้น หากต้องการเรียกใช้คุณใช้คำสั่งนี้:

mvn install -DskipTests=false

คุณควรใช้ปลั๊กอิน maven surefireเพื่อเรียกใช้การทดสอบหน่วยและปลั๊กอิน maven Failafeเพื่อเรียกใช้การทดสอบการรวม

โปรดปฏิบัติตามด้านล่างหากคุณต้องการสลับการใช้งานการทดสอบโดยใช้ค่าสถานะ

การกำหนดค่า Maven

        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-surefire-plugin</artifactId>
            <configuration>
                <skipTests>${skipUnitTests}</skipTests>
            </configuration>
        </plugin>

        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-failsafe-plugin</artifactId>
            <configuration>
                <includes>
                    <include>**/*IT.java</include>
                </includes>
                <skipTests>${skipIntegrationTests}</skipTests>
            </configuration>
            <executions>
                <execution>
                    <goals>
                        <goal>integration-test</goal>
                        <goal>verify</goal>
                    </goals>
                </execution>
            </executions>
        </plugin>

        <properties>
            <skipTests>false</skipTests>
            <skipUnitTests>${skipTests}</skipUnitTests>
            <skipIntegrationTests>${skipTests}</skipIntegrationTests>
        </properties>

ดังนั้นการทดสอบจะถูกข้ามหรือสลับไปตามกฎด้านล่าง:

การทดสอบสามารถข้ามได้โดยใช้ธงด้านล่าง:

• -DskipTests ข้ามการทดสอบทั้งหน่วยและการรวมเข้าด้วยกัน
• -DskipUnitTests ข้ามการทดสอบหน่วย แต่ดำเนินการทดสอบการรวม
• -DskipIntegrationTests ข้ามการทดสอบการรวม แต่ดำเนินการทดสอบหน่วย

วิ่งทดสอบ

ทำงานด้านล่างเพื่อดำเนินการทดสอบหน่วยเท่านั้น

mvn clean test

คุณสามารถรันคำสั่งด้านล่างเพื่อทำการทดสอบ (ทั้งหน่วยและการรวม)

mvn clean verify

หากต้องการเรียกใช้เฉพาะการทดสอบการรวมให้ทำตาม

mvn failsafe:integration-test

หรือข้ามการทดสอบหน่วย

mvn clean install -DskipUnitTests

นอกจากนี้เพื่อข้ามการทดสอบการรวมระหว่างmvn installทำตาม

mvn clean install -DskipIntegrationTests

คุณสามารถข้ามการทดสอบทั้งหมดโดยใช้

mvn clean install -DskipTests