Important
The project was moved to vitalijr2/ijhttp-tools on 02-02-2024.
I had started with a Maven plugin to run HTTP requests on the integration-test phase using the IntelliJ HTTP Client. Later I added a Spring Boot Test autoconfiguration, thanks @GoncaloPT for his idea.
Created by gh-md-toc
Originally the IntelliJ HTTP Client plugin allows to create, edit, and execute HTTP requests directly in the IntelliJ IDEA code editor. The IntelliJ HTTP Client is also available as a CLI tool.
The Maven plugin allows to run HTTP requests on the integration-test phase using the IntelliJ HTTP Client. The Spring Boot Test autoconfiguration allows to run them with Spring Boot Test, you don't need to package and run whole application.
The HTTP Request in Editor Specification describes format these files.
Example requests:
GET /api/get HTTP/1.1
Accept: application/json
Host: example.com
### Add an item
POST /api/add HTTP/1.1
Host: example.com
Content-Type: application/json
{
"name": "entity",
"value": "content"
}IntelliJ HTTP Client needs HTTP files to work. With HTTP Client Command Line you can set directories that contain such files.
Important! Both plugin and autoconfiguration do not contain the HTTP client: you need
to install it by yourself then add to PATH. You can also set the full path to the ijhttp
via the parameter executable. The HTTP Client Demo has some examples
how to download the HTTP client.
There is one goal run. To use it add the plugin to your POM.
Example of full configuration:
<plugin>
<groupId>uk.bot-by.ijhttp-tools</groupId>
<artifactId>ijhttp-maven-plugin</artifactId>
<version><!-- search on Maven Central --></version>
<executions>
<execution>
<configuration>
<!-- At least one file or directory is required. -->
<directories>
<directory>src/test/resources</directory>
</directories>
<environmentFile>public-env.json</environmentFile>
<environmentName>dev</environmentName>
<files>
<file>sample-1-queries.http</file>
<file>sample-2-queries.http</file>
</files>
<logLevel>HEADERS</logLevel>
<report>true</report>
<workingDirectory>target</workingDirectory>
</configuration>
<goals>
<goal>run</goal>
</goals>
<id>simple-run-with-report</id>
</execution>
</executions>
</plugin>To manage plugin's output use useMavenLogger, quietLogs and outputFile.
You can set configuration in application.yaml or manually, or combine both ways.
Example of autoconfiguration, full configuration:
ijhttp:
parameters:
connect-timeout: 9000
directories:
- src/test/resources/ijhttp
# docker-mode: false default value
environment-file: public-env.json
environment-name: dev
# executable: ijhttp default value
files:
- orders.http
- products.http
- checkout.http
# insecure: false default value
log-level: verbose
private-environment-file: private-env.json
# proxy: http://localhost:3128/
report: true
report-path: target/ijhttp
socket-timeout: 9000
# timeout: 7000@SpringBootTest(webEnvironment = WebEnvironment.DEFINED_PORT)
@AutoConfigureHttpClientCommandLine(timeout = 7000)
class HttpClientCommandLineApplicationTests {
@Autowired
private Executor executor;
@Autowired
private HttpClientCommandLine httpClientCommandLine;
@Test
void httpClientCommandLine() throws IOException {
// when
var exitCode = executor.execute(httpClientCommandLine.getCommandLine());
// then
assertEquals(0, exitCode);
}
}Please read Contributing.
See Changelog
Copyright 2023-2024 bot-by
Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at
https://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
