No description
Find a file
Jörg Prante 40e34e5fcf
Some checks are pending
CodeQL / Analyze (push) Waiting to run
working on net mail, remove printStackTrace()
2024-08-04 22:53:28 +02:00
.github/workflows make codeql more stable 2022-11-07 23:31:31 +01:00
benchmark lift tests to module path 2024-03-04 13:54:05 +01:00
gradle working on net mail test 2024-08-01 18:09:12 +02:00
net add refresh trigger to user profile 2024-06-10 18:20:20 +02:00
net-bouncycastle clean up module info 2022-11-02 22:03:54 +01:00
net-mail working on net mail, remove printStackTrace() 2024-08-04 22:53:28 +02:00
net-mime add net-mail, based on jakarta mail and eclipse angus mail 2024-07-30 17:54:09 +02:00
net-oauth initial commit 2022-10-20 09:43:33 +02:00
net-path security profile is now an interface 2024-04-17 18:42:50 +02:00
net-resource lift tests to module path 2024-03-04 13:54:05 +01:00
net-security add server certificate chain reader test 2024-07-23 15:36:06 +02:00
net-security-auth/src/main/java add net-mail, based on jakarta mail and eclipse angus mail 2024-07-30 17:54:09 +02:00
net-socket disable systemd notify on Mac 2024-04-20 16:26:54 +02:00
.gitignore initial commit 2022-10-20 09:43:33 +02:00
build.gradle remove clone, fix test server 2024-07-30 19:14:47 +02:00
gradle.properties add refresh trigger to user profile 2024-06-10 18:20:20 +02:00
gradlew fix rebase 2023-10-01 08:27:40 +02:00
gradlew.bat security profile is now an interface 2024-04-17 18:42:50 +02:00
LICENSE.txt initial commit 2022-10-20 09:43:33 +02:00
README.md initial commit 2022-10-20 09:43:33 +02:00
settings.gradle add net-mail, based on jakarta mail and eclipse angus mail 2024-07-30 17:54:09 +02:00

Java Net API for servers and clients

A consolidated Uniform Resource Locator implementation for Java

A Uniform Resource Locator (URL) is a compact representation of the location and access method for a resource available via the Internet.

Historically, there are many different forms of internet resource representations, for example, the URL (RFC 1738 as of 1994), the URI (RFC 2396 as of 1998), and IRI (RFC 3987 as of 2005), and most of them have updated specifications.

This Java implementation serves as a universal point of handling all different forms. It follows the syntax of the Uniform Resource Identifier (RFC 3986) in accordance with the https://url.spec.whatwg.org/[WHATWG URL standard].

This alternative implementation of Uniform Resource Locator combines the features of the vanilla URI/URL Java SDK implementations but removes it peculiarities and deficiencies, such as java.lang.IllegalArgumentException: Illegal character in path at ... at java.net.URI.create()

Normalization, NIO charset encoding/decoding, IPv6, an extensive set of schemes, and path matching have been added.

Fast building and parsing URLs, improved percent decoding/encoding, and URI templating features are included, to make this library also useful in URI and IRI contexts.

While parsing and building, you have better control about address resolving. Only explicit resolveFromhost methods will execute host lookup queries against DNS resolvers, otherwise, no resolving will occur under the hood.

You can build URLs with a fluent API, for example

URL.http().host("foo.com").toUrlString()

And you can parse URLs with a fluent API, for exmaple

URL url = URL.parser().parse("file:///foo/bar?foo=bar#fragment");

There is no external dependency. The size of the jar library is ~118k. The only dependency on java.net are the classes

java.net.IDN
java.net.Inet4Address
java.net.Inet6Address
java.net.InetAddress

which might get re-implemented in another library at a later time, in a project like Netty DNS resolver.

A simple HTTP server

A netty-based HTTP server

License

Copyright (C) 2018 Jörg Prante

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

http://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.