https://github.com/bhawanihmh/hoverfly-spring-boot-boltdb
Implementations of Hoverfly proxy in Spring Boot using Bolt db.
https://github.com/bhawanihmh/hoverfly-spring-boot-boltdb
bolt boltdb hoverfly hoverfly-boltdb hoverfly-springboot hoverflyexample spring-boot-hoverfly-boltdb spring-hoverfly-boltdb springboot-hoverfly springboot-hoverfly-boltdb springboot-hoverflyexample
Last synced: 3 months ago
JSON representation
Implementations of Hoverfly proxy in Spring Boot using Bolt db.
- Host: GitHub
- URL: https://github.com/bhawanihmh/hoverfly-spring-boot-boltdb
- Owner: bhawanihmh
- Created: 2018-07-18T10:13:06.000Z (almost 8 years ago)
- Default Branch: master
- Last Pushed: 2018-08-29T11:35:46.000Z (almost 8 years ago)
- Last Synced: 2025-02-23T18:31:35.408Z (over 1 year ago)
- Topics: bolt, boltdb, hoverfly, hoverfly-boltdb, hoverfly-springboot, hoverflyexample, spring-boot-hoverfly-boltdb, spring-hoverfly-boltdb, springboot-hoverfly, springboot-hoverfly-boltdb, springboot-hoverflyexample
- Size: 18.6 KB
- Stars: 2
- Watchers: 3
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# SpringBoot Hoverfly BoltDB
Implementations of Hoverfly proxy in Spring Boot using Bolt DB.
## Install Hoverfly on MacOS
**brew install SpectoLabs/tap/hoverfly**
More : http://hoverfly.readthedocs.io/en/latest/pages/introduction/downloadinstallation.html
## Install Bolt DB
**go get github.com/boltdb/bolt/...**
More : https://github.com/boltdb/boltd
## Hoverfly commands
**Hoverfly behind a proxy**
hoverctl start --upstream-proxy http://corp.proxy:8080
**Upstream proxy authentication**
hoverctl start --upstream-proxy http://my-user:my-pass@corp.proxy:8080
**Controlling a remote Hoverfly instance with hoverctl**
hoverfly -ap 8880 -pp 8555
On your local machine, you can create a target named remote using hoverctl. This target will be configured to communicate with Hoverfly.
hoverctl targets create remote \
--host hoverfly.example.com \
--admin-port 8880 \
--proxy-port 8555
Now that hoverctl knows the location of the remote Hoverfly instance, run the following commands on your local machine to capture and simulate a URL using this instance:
hoverctl -t remote mode capture
curl --proxy http://hoverfly.example.com:8555 http://ip.jsontest.com
hoverctl -t remote mode simulate
curl --proxy http://hoverfly.example.com:8555 http://ip.jsontest.com
You will now need to specify the remote target every time you want to interact with this Hoverfly instance. If you are only working with this remote instance, you can set it to be the default target instance for hoverctl.
hoverctl targets default remote
How can I view the Hoverfly logs?
hoverctl logs
**Why am I not able to access my Hoverfly remotely?**
That’s because Hoverfly is bind to loopback interface by default, meaning that you can only access to it on localhost. To access it remotely, you can specify the IP address it listens on. For example, setting 0.0.0.0 to listen on all network interfaces.
hoverfly -listen-on-host 0.0.0.0
**hoverfly -ap 8880 -pp 8555 -listen-on-host XXX.XXX.XXX.XXX -db "boltdb" -db-path ~/sample.db**
INFO[2018-07-18T15:24:22+05:30] Default proxy port has been overwritten port=8555
INFO[2018-07-18T15:24:22+05:30] Default admin port has been overwritten port=8880
INFO[2018-07-18T15:24:22+05:30] Listen on specific interface host=XXX.XXX.XXX.XXX
INFO[2018-07-18T15:24:22+05:30] Initiating database databaseName=/Users/bhawani.s.shekhawat/sample.db
INFO[2018-07-18T15:24:22+05:30] Using boltdb backend
INFO[2018-07-18T15:24:22+05:30] Proxy prepared... Destination=. Mode=simulate ProxyPort=8555
INFO[2018-07-18T15:24:22+05:30] current proxy configuration destination=. mode=simulate port=8555
INFO[2018-07-18T15:24:22+05:30] Admin interface is starting... AdminPort=8880
INFO[2018-07-18T15:24:22+05:30] serving proxy
## SpringBoot changes:
import org.springframework.http.client.SimpleClientHttpRequestFactory;
import java.net.InetSocketAddress;
import java.net.Proxy;
import java.net.Proxy.Type;
RestTemplate restTemplate = new RestTemplate();
SimpleClientHttpRequestFactory requestFactory = new SimpleClientHttpRequestFactory();
Proxy proxy = new Proxy(Type.HTTP, new InetSocketAddress("XXX.XXX.XXX.XXX", 8555));
requestFactory.setProxy(proxy);
restTemplate = new RestTemplate(requestFactory);
Programme programme = restTemplate.getForObject("http://127.0.0.1:8091/programme/{id}", Programme.class, programId);
## Using middleware:
Hoverfly middleware can be written in any language. Middleware modules receive a service data JSON string via the standard input (STDIN) and must return a service data JSON string to the standard output (STDOUT).
To implement more dynamic behaviour, middleware should be combined with Hoverfly's synthesize mode (see the Creating synthetic services section).
### Javascript example
This example will change the response code and body in each response.
Ensure that you have captured some traffic with Hoverfly
Ensure that you have NodeJS installed
Save the following code into a file named example.js and make it executable (chmod +x example.js):
#!/usr/bin/env node
process.stdin.resume();
process.stdin.setEncoding('utf8');
process.stdin.on('data', function(data) {
var parsed_json = JSON.parse(data);
// changing response
parsed_json.response.status = 201;
parsed_json.response.body = "body was replaced by JavaScript middleware\n";
// stringifying JSON response
var newJsonString = JSON.stringify(parsed_json);
process.stdout.write(newJsonString);
});
Restart Hoverfly in simulate mode with the example.js script specified as middleware:
./hoverfly -middleware "./example.js"
Repeat the steps you took to capture the traffic You will notice that every response will have the 201 status code,
and the body will have been replaced by the string specified in the script.
## More about Hoverfly:
https://hoverfly.readthedocs.io/en/latest/pages/tutorials/advanced/advanced.html
## hoverctl commands:
https://hoverfly.readthedocs.io/en/latest/pages/reference/hoverctl/hoverctlcommands.html#hoverctl-commands