Implemented #53 (#54)

* Implemented #53

Author: ckunki

.github/workflows/broken_links_checker.yml

@@ -0,0 +1,30 @@
+# Udf Debugging Java 0.6.8, released 2023-02-07
+
+Code name: Improved LocalServiceExposer
+
+## Summary
+
+Enhanced interface `LocalServiceExposer` and simplified usage.
+
+## Features
+
+* #53: Enhanced interface `LocalServiceExposer` and simplified usage.
+
+## Dependency Updates
+
+### Compile Dependency Updates
+
+* Updated `com.exasol:bucketfs-java:2.6.0` to `3.0.0`
+
+### Test Dependency Updates
+
+* Updated `com.exasol:exasol-testcontainers:6.5.0` to `6.5.1`
+* Updated `org.mockito:mockito-junit-jupiter:5.0.0` to `5.1.1`
+
+### Plugin Dependency Updates
+
+* Updated `com.exasol:error-code-crawler-maven-plugin:1.2.1` to `1.2.2`
+* Updated `com.exasol:project-keeper-maven-plugin:2.9.1` to `2.9.3`
+* Updated `org.apache.maven.plugins:maven-failsafe-plugin:3.0.0-M7` to `3.0.0-M8`
+* Updated `org.apache.maven.plugins:maven-surefire-plugin:3.0.0-M7` to `3.0.0-M8`
+* Updated `org.codehaus.mojo:versions-maven-plugin:2.13.0` to `2.14.2`

.github/workflows/ci-build-next-java.yml

@@ -1,10 +1,8 @@
 <?xml version="1.0" encoding="UTF-8" standalone="no"?>
-<project xmlns="http://maven.apache.org/POM/4.0.0"
-    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-    xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
+<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
     <modelVersion>4.0.0</modelVersion>
     <artifactId>udf-debugging-java</artifactId>
-    <version>0.6.7</version>
+    <version>0.6.8</version>
     <name>udf-debugging-java</name>
     <description>Utilities for debugging, profiling and code coverage measure for UDFs.</description>
     <url>https://github.com/exasol/udf-debugging-java/</url>
@@ -55,7 +53,7 @@
         <dependency>
             <groupId>com.exasol</groupId>
             <artifactId>bucketfs-java</artifactId>
-            <version>2.6.0</version>
+            <version>3.0.0</version>
         </dependency>
         <dependency>
             <groupId>com.exasol</groupId>
@@ -95,7 +93,7 @@
         <dependency>
             <groupId>org.mockito</groupId>
             <artifactId>mockito-junit-jupiter</artifactId>
-            <version>5.0.0</version>
+            <version>5.1.1</version>
             <scope>test</scope>
         </dependency>
         <dependency>
@@ -108,7 +106,7 @@
         <dependency>
             <groupId>com.exasol</groupId>
             <artifactId>exasol-testcontainers</artifactId>
-            <version>6.5.0</version>
+            <version>6.5.1</version>
             <scope>test</scope>
         </dependency>
         <dependency>
@@ -153,7 +151,7 @@
             <plugin>
                 <groupId>com.exasol</groupId>
                 <artifactId>project-keeper-maven-plugin</artifactId>
-                <version>2.9.1</version>
+                <version>2.9.3</version>
                 <executions>
                     <execution>
                         <goals>
@@ -187,7 +185,7 @@
     <parent>
         <artifactId>udf-debugging-java-generated-parent</artifactId>
         <groupId>com.exasol</groupId>
-        <version>0.6.7</version>
+        <version>0.6.8</version>
         <relativePath>pk_generated_parent.pom</relativePath>
     </parent>
 </project>

dependencies.md

@@ -8,9 +8,19 @@
 @FunctionalInterface
 public interface LocalServiceExposer {
 
+    /**
+     * Create an instance of {@code LocalServiceExposer} for a host that does not require port mapping.
+     *
+     * @param host host name or IP address of host (but without port) providing the service to expose
+     * @return new instance of {@code LocalServiceExposer}
+     */
+    public static LocalServiceExposer forHost(final String host) {
+        return port -> new InetSocketAddress(host, port);
+    }
+
     /**
      * Get the address for the network scope inside of the Exasol database for a given local service.
-     * 
+     *
      * @param port port number
      * @return proxy
      */

doc/changes/changelog.md

@@ -1,6 +1,5 @@
 package com.exasol.udfdebugging;
 
-import java.net.InetSocketAddress;
 import java.sql.Connection;
 import java.util.List;
 import java.util.stream.Collectors;
@@ -32,12 +31,12 @@ public class UdfTestSetup implements AutoCloseable {
      * @param exasolConnection  connection to the Exasol database. Make sure that your tests use the same connection
      */
     public UdfTestSetup(final String testHostIpAddress, final Bucket bucket, final Connection exasolConnection) {
-        this(port -> new InetSocketAddress(testHostIpAddress, port), bucket, exasolConnection);
+        this(LocalServiceExposer.forHost(testHostIpAddress), bucket, exasolConnection);
     }
 
     /**
      * Create a new instance of {@link UdfTestSetup}.
-     * 
+     *
      * @param localServiceExposer Proxy factory that makes ports of the test host available in the container
      * @param bucket              BucketFS bucket to upload resource to
      * @param exasolConnection    connection to the Exasol database. Make sure that your tests use the same connection
@@ -52,20 +51,17 @@ private UdfTestSetup(final LocalServiceExposer localServiceExposer, final Bucket
 
     /**
      * Create a new instance of {@link UdfTestSetup}.
-     * 
+     *
      * @param testSetup        Exasol test setup
      * @param exasolConnection connection to the Exasol database. Make sure that your tests use the same connection
      */
     public UdfTestSetup(final ExasolTestSetup testSetup, final Connection exasolConnection) {
-        this(port -> {
-            final InetSocketAddress serviceAddress = testSetup.makeLocalTcpServiceAccessibleFromDatabase(port);
-            return new InetSocketAddress(serviceAddress.getHostName(), serviceAddress.getPort());
-        }, testSetup.getDefaultBucket(), exasolConnection);
+        this(testSetup::makeLocalTcpServiceAccessibleFromDatabase, testSetup.getDefaultBucket(), exasolConnection);
     }
 
     /**
      * Get JVM options required for this setup.
-     * 
+     *
      * @return array of JVM options
      */
     public String[] getJvmOptions() {

doc/changes/changes_0.6.8.md

@@ -1,7 +1,6 @@
 package com.exasol.udfdebugging.modules;
 
 import java.io.Closeable;
-import java.net.InetSocketAddress;
 import java.sql.*;
 import java.util.stream.Stream;
 
@@ -27,7 +26,7 @@ public TestSetup() throws SQLException {
     }
 
     public LocalServiceExposer getHostPortProxy() {
-        return port -> new InetSocketAddress(this.exasol.getHostIp(), port);
+        return LocalServiceExposer.forHost(this.exasol.getHostIp());
     }
 
     public Bucket getDefaultBucket() {