1. Overview
1.概述
In this article, we’re going to run and debug applications on WildFly directly from the Eclipse IDE.
在这篇文章中，我们将直接从 Eclipse IDE 中运行和调试 WildFly 上的应用程序。
We can use the WildFly application server and Eclipse independently to build and run applications. As a first step, we could start and stop the application server on its own. However, when we integrate them both, development will be quicker. For instance, when we change the code in the debug mode the changes are automatically deployed.
我们可以独立使用 WildFly 应用程序服务器和 Eclipse 来构建和运行应用程序。作为第一步，我们可以单独启动和停止应用服务器。然而，当我们将它们两者整合在一起时，开发就会变得更快。例如，当我们在调试模式下修改代码时，所做的修改会自动部署。
Note the screenshots are taken with Eclipse Photon and they might be different in other versions or operating systems.
注意这些截图是用Eclipse Photon拍摄的，在其他版本或操作系统中可能会有所不同。
2. Requirements
2.要求
First, we start by installing the following software:
首先，我们开始安装以下软件。
Then we verify if everything is properly configured. If both, Eclipse and WildFly, work correctly, then we can continue with our configuration.
然后我们验证一切是否配置正确。如果Eclipse和WildFly都能正常工作，那么我们就可以继续进行配置。
3. Installing the JBoss Tools Plugin
3.安装JBoss工具插件
We’re going to use the JBoss Tools Plugin for Eclipse. JBoss Tools provides, among others, integration between Eclipse and WildFly.
我们将使用Eclipse的JBoss Tools Plugin。除其他外，JBoss Tools提供了Eclipse和WildFly之间的集成。
There are two ways to install the plugin:
有两种方法来安装该插件。
- We can install it through the website
- We can install it through the Eclipse Marketplace
- Open Eclipse
- Click on Help and then on Eclipse Marketplace
- Search for JBoss Tools
- Click Install next to the JBoss Tools solution
- Follow the rest of the wizard
4. Configuring the Application Server in Eclipse
4.在Eclipse中配置应用服务器
We start by adding the WildFly server to Eclipse.
我们首先将 WildFly 服务器添加到 Eclipse 中。
First, we add a new View in Eclipse. Please click on the Window/Show View/Other:
首先，我们在Eclipse中添加一个新的View。请点击Window/Show View/Other。
Next, please click Server/Servers. Now Eclipse shows a Servers tab:
接下来，请点击Server/Servers。现在Eclipse显示一个Servers标签。
After that we can add a server by clicking on No servers are available. Click this link to create a new server… in the Servers tab:
之后，我们可以通过点击没有服务器可用来添加一个服务器。点击这个链接，在服务器标签中创建一个新的服务器…。
In the next step, we expand the JBoss Community category and select the WildFly version that matches with the WildFly installation. For the rest we simply follow the wizard:
在下一步，我们展开JBoss Community类别，选择与WildFly安装相匹配的WildFly版本。其余的，我们只需按照向导的提示进行操作。
Select the newest version when your installed version isn’t available. But make sure to upgrade JBoss Tools when they have a new release with support for that specific version:
当你安装的版本不可用时，选择最新的版本。但要确保在他们有新的版本支持该特定版本时，升级JBoss Tools。
5. Add an Application to WildFly
5.向WildFly添加一个应用程序
After configuring the application server we’re going to add an application to the server:
配置完应用服务器后，我们要在服务器上添加一个应用程序。
- Right click on the WildFly instance in the Servers tab
- Click Add and Remove
- Select the application to deploy
- Click Add
- Click Finish
The message ‘There are no resources that can be added or removed from the server’ is shown if there is a Servlet API version mismatch.
如果存在Servlet API版本不匹配，则会显示’没有可以从服务器上添加或删除的资源’信息。
So first we make sure the Servlet API version matches Servlet API version packaged with the WildFly installation:
因此，首先我们要确保Servlet API版本与WildFly安装包中的Servlet API版本一致。
- Right click on the project
- Click on Properties
- Click on Project Facets
- If the project is not yet in the faceted form
- Click on Convert to faceted form…
- Enable ‘Dynamic Web Module’
After the configuration, we can see the application under the WildFly server instance:
配置完成后，我们可以看到WildFly服务器实例下的应用程序。
6. Running the Application
6.运行应用程序
We can finally start WildFly and the application from Eclipse. Right click on the WildFly instance and click on Start. The application is starting and we can use it:
我们终于可以从Eclipse启动WildFly和应用程序了。右击WildFly实例，点击Start。该应用程序正在启动，我们可以使用它。
We could have achieved the same result by manually deploying the application or using a build tool. However, starting the application server from within the IDE has some advantages such as the possibility to debug the application.
我们可以通过手动部署应用程序或使用构建工具达到同样的效果。然而，从集成开发环境中启动应用服务器有一些好处，比如可以调试应用程序。
7. Debugging the Application
7.调试应用程序
First, we hit the ‘Stop the server’ button (red square) on the Servers or Console tab to stop the server:
首先，我们在Servers或Console标签上点击’Stop the server’按钮（红色方块）来停止服务器。
Then we start the application in debugging mode by right-clicking on the WildFly instance and then clicking Debug.
然后我们在调试模式下启动应用程序，右键单击 WildFly 实例，然后单击Debug。
When we change the code it’s deployed automatically. If we make bigger changes then we get a message from Eclipse telling us to restart. We can also restart the application server manually by right-clicking on the instance and then on Restart in Debug.
当我们改变代码时，它就会自动部署。如果我们做了更大的改动，那么我们会从Eclipse得到一条信息，告诉我们重新启动。我们也可以通过右键点击实例，然后点击在调试中重启来手动重启应用服务器。
Often the source code isn’t yet available for the debugger. Resulting in the following message: Source not found. If that’s the case we can simply make the source available:
通常情况下，源代码还不能用于调试器。导致以下信息。未找到源代码。如果是这种情况，我们可以简单地使源代码可用。
- Click Edit Source Lookup Path
- Click Add
- Select Java Project
- Select the project
- Follow the wizard
8. Conclusion
8.结语
In this article, we used the JBoss Tools plugin to integrate WildFly and Eclipse. By combining these tools we can deploy our applications easier.
在这篇文章中，我们使用JBoss工具插件来整合WildFly和Eclipse。通过结合这些工具，我们可以更容易地部署我们的应用程序。
However, the biggest advantage is that with this setup we can start the application in debug mode and code changes are immediately visible. That way we made our development process faster and more efficient.
然而，最大的好处是，通过这种设置，我们可以在调试模式下启动应用程序，代码的变化可以立即看到。这样一来，我们的开发过程就变得更快、更有效率。