url-extension

Extend a java process with multiple URLStreamHandlers. URLStreamHandler can be registered through the service provider pattern or programmatically. This artifact provides support for a 'tcp' scheme.

This jar can also be used as a maven extension to allow maven plugins to use URL schemes not handled by the JRE.

Requirements

• Minimum of Java 7

Maven Coordinates

To include url-extension as a dependency in your maven build, use the following fragment in your pom.

  <build>
    <dependencies>
      <dependency>
        <groupId>org.honton.chas.url</groupId>
        <artifactId>url-extension</artifactId>
        <version>0.0.1</version>
      </dependency>
    </dependencies>
  </build>

To include url-extension as an extension for plugins in your maven build, use the following fragment in your pom.

  <build>
    <extensions>
      <extension>
        <groupId>org.honton.chas.url</groupId>
        <artifactId>url-extension</artifactId>
        <version>0.0.1</version>
      </extension>
    </extensions>
  </build>

UrlExtension

To register a URLStreamHandlerFactory:

    UrlStreamHandlerRegistry registry;
    // ...
    registry.factory(new TcpUrlStreamHandlerFactory());

To add all URLStreamHandlerFactory(s) that implement the service provider pattern:

   UrlStreamHandlerRegistry registry = UrlStreamHandlerRegistry.register();

To package your URLStreamHandlerFactory as a service provider, provide a file named java.net.URLStreamFactory in the META-INF/services directory of the jar.
Each line of this file should contain the name of a class implementing java.net.URLStreamFactory which should be added to the registry. For example, the

org.honton.chas.url.extension.urlhandler.TcpUrlStreamHandlerFactory

Tcp scheme

The TcpUrlStreamHandler supports URLs with the following syntax: tcp://[[<localaddress>][:<localport>]@]<remoteaddress>:<remoteport>. The remote address and remote port values are required. The local address and local port values are optional.