JavaVectorHelper工具使用

前提条件

请确保项目文件已构建成功。

基于Maven和Gradle的Java项目，若项目构建失败，扫描后quickfix（快速修改）部分功能受限，无波浪线注解，只能通过复制建议框中的内容进行修改，import语句和需要声明的常量语句需要额外导入。

操作步骤

可通过JavaVectorHelper工具对单个文件/整个项目进行扫描，识别Java源码中可向量化的循环体，并提供改造建议。

1. 在IntelliJ工具中展开项目文件夹，打开Java文件，鼠标右击，选择“Perform Vectorization Analysis on the Current File”或“Perform Vectorization Analysis on the Entire Project”，可分别对当前文件或整个项目进行向量化分析。
   图1 扫描源代码
   
2. 扫描时右下角会有进度条显示，单击进度条展开详细信息。
   图2 进度条显示
   
3. 扫描结束后，工具窗口展示当前文件/整个项目的改造问题数。
   图3 当前文件
   
   图4 整个项目
   
4. 鼠标单击问题，右侧展示详细代码，框中展示循环体可向量化的修改代码。
   图5 代码展示
   
   

   工具窗口位置可根据实际情况进行修改，单击窗口右侧的，可修改视图模式、移动位置、调整大小等。

5. 双击问题，或鼠标右击问题选择“跳转到源”，可打开源文件，源文件中会将分析得到的可向量化For语句加上波浪线注解。
   图6 波浪线注解
   
6. 鼠标移到相应注解上，会弹出向量化提示。
   图7 向量化提示
   
7. 单击“更多操作”，可以预览向量化之后的代码。
   图8 预览代码
   
8. 单击“DevKit vectorization”，可快速修改代码，可将可向量化的代码替换原有代码。
   图9 快速修改
   
   

   代码替换后会导入所需要的import语句和需要声明的常量语句。

9. 若项目是模块化的，即module-info.java文件存在，则需要手动在module-info.java文件中添加内容。
   1. 在src目录下找到module-info.java文件。
   2. 打开文件，添加以下内容。

      module your.module.name {
          requires jdk.incubator.vector;
      }

10. （可选）编译运行时需要使用预览功能，具体操作请参见预览功能设置。