From 79cd0711c659fd1c10e4153c0df1bfede8bf8bb3 Mon Sep 17 00:00:00 2001 From: ogesaku Date: Fri, 13 Jan 2023 23:17:15 +0100 Subject: [PATCH] init --- .editorconfig | 11 + .github/dependabot.yml | 6 + .github/workflows/build.yml | 48 ++ .github/workflows/release.yml | 173 ++++++ .gitignore | 10 + .idea/codeStyles/Project.xml | 50 ++ .idea/codeStyles/codeStyleConfig.xml | 5 + LICENSE | 21 + README.md | 76 +++ build.gradle | 22 + gradle/publish.gradle | 95 ++++ gradle/wrapper/gradle-wrapper.jar | Bin 0 -> 59821 bytes gradle/wrapper/gradle-wrapper.properties | 5 + gradlew | 234 +++++++++ gradlew.bat | 89 ++++ settings.gradle | 12 + .../java/com/coditory/quark/uri/BitSets.java | 110 ++++ .../java/com/coditory/quark/uri/Hosts.java | 154 ++++++ .../quark/uri/InetAddressValidator.java | 168 ++++++ .../quark/uri/InvalidHttpUrlException.java | 11 + .../quark/uri/InvalidUriException.java | 7 + .../java/com/coditory/quark/uri/Nullable.java | 33 ++ .../com/coditory/quark/uri/PercentCodec.java | 148 ++++++ .../coditory/quark/uri/PercentDecoder.java | 107 ++++ .../coditory/quark/uri/PercentEncoder.java | 137 +++++ .../java/com/coditory/quark/uri/Ports.java | 82 +++ .../com/coditory/quark/uri/Preconditions.java | 62 +++ .../java/com/coditory/quark/uri/Strings.java | 49 ++ .../com/coditory/quark/uri/Throwables.java | 40 ++ .../com/coditory/quark/uri/UriAuthority.java | 97 ++++ .../com/coditory/quark/uri/UriBuilder.java | 494 ++++++++++++++++++ .../com/coditory/quark/uri/UriComponents.java | 424 +++++++++++++++ .../quark/uri/UriComponentsParser.java | 147 ++++++ .../coditory/quark/uri/UriPartValidator.java | 88 ++++ .../java/com/coditory/quark/uri/UriRfc.java | 94 ++++ .../coditory/quark/uri/UriRfcCharacters.java | 28 + .../com/coditory/quark/uri/UrlValidator.java | 185 +++++++ src/main/resources/a/b/c/homepage/i18n.yml | 1 + src/main/resources/a/b/c/other/i18n.yml | 1 + src/main/resources/a/b/d/listing/i18n.yml | 2 + src/main/resources/logback.xml | 14 + .../com/coditory/quark/uri/HostsSpec.groovy | 19 + .../quark/uri/InetAddressValidatorSpec.groovy | 89 ++++ .../quark/uri/PercentCodecSpec.groovy | 68 +++ .../com/coditory/quark/uri/PortsSpec.groovy | 55 ++ .../coditory/quark/uri/UriBuilderSpec.groovy | 108 ++++ .../UriBuilder_parseAndRecreateUriSpec.groovy | 85 +++ .../uri/UriBuilder_parseHttpUrlSpec.groovy | 49 ++ .../uri/UriBuilder_parseUriPartsSpec.groovy | 142 +++++ .../quark/uri/UriBuilder_parseUriSpec.groovy | 123 +++++ .../uri/UriBuilder_queryParamsSpec.groovy | 112 ++++ .../quark/uri/UrlValidatorSpec.groovy | 53 ++ .../coditory/quark/uri/base/Alphabets.groovy | 48 ++ .../quark/uri/base/CapturingAppender.groovy | 102 ++++ src/test/java/readme/ReadmeSamples.java | 47 ++ 55 files changed, 4640 insertions(+) create mode 100644 .editorconfig create mode 100644 .github/dependabot.yml create mode 100644 .github/workflows/build.yml create mode 100644 .github/workflows/release.yml create mode 100755 .gitignore create mode 100644 .idea/codeStyles/Project.xml create mode 100644 .idea/codeStyles/codeStyleConfig.xml create mode 100644 LICENSE create mode 100644 README.md create mode 100644 build.gradle create mode 100644 gradle/publish.gradle create mode 100644 gradle/wrapper/gradle-wrapper.jar create mode 100644 gradle/wrapper/gradle-wrapper.properties create mode 100755 gradlew create mode 100644 gradlew.bat create mode 100644 settings.gradle create mode 100644 src/main/java/com/coditory/quark/uri/BitSets.java create mode 100644 src/main/java/com/coditory/quark/uri/Hosts.java create mode 100644 src/main/java/com/coditory/quark/uri/InetAddressValidator.java create mode 100644 src/main/java/com/coditory/quark/uri/InvalidHttpUrlException.java create mode 100644 src/main/java/com/coditory/quark/uri/InvalidUriException.java create mode 100644 src/main/java/com/coditory/quark/uri/Nullable.java create mode 100644 src/main/java/com/coditory/quark/uri/PercentCodec.java create mode 100644 src/main/java/com/coditory/quark/uri/PercentDecoder.java create mode 100644 src/main/java/com/coditory/quark/uri/PercentEncoder.java create mode 100644 src/main/java/com/coditory/quark/uri/Ports.java create mode 100644 src/main/java/com/coditory/quark/uri/Preconditions.java create mode 100644 src/main/java/com/coditory/quark/uri/Strings.java create mode 100644 src/main/java/com/coditory/quark/uri/Throwables.java create mode 100644 src/main/java/com/coditory/quark/uri/UriAuthority.java create mode 100644 src/main/java/com/coditory/quark/uri/UriBuilder.java create mode 100644 src/main/java/com/coditory/quark/uri/UriComponents.java create mode 100644 src/main/java/com/coditory/quark/uri/UriComponentsParser.java create mode 100644 src/main/java/com/coditory/quark/uri/UriPartValidator.java create mode 100644 src/main/java/com/coditory/quark/uri/UriRfc.java create mode 100644 src/main/java/com/coditory/quark/uri/UriRfcCharacters.java create mode 100644 src/main/java/com/coditory/quark/uri/UrlValidator.java create mode 100644 src/main/resources/a/b/c/homepage/i18n.yml create mode 100644 src/main/resources/a/b/c/other/i18n.yml create mode 100644 src/main/resources/a/b/d/listing/i18n.yml create mode 100644 src/main/resources/logback.xml create mode 100644 src/test/groovy/com/coditory/quark/uri/HostsSpec.groovy create mode 100644 src/test/groovy/com/coditory/quark/uri/InetAddressValidatorSpec.groovy create mode 100644 src/test/groovy/com/coditory/quark/uri/PercentCodecSpec.groovy create mode 100644 src/test/groovy/com/coditory/quark/uri/PortsSpec.groovy create mode 100644 src/test/groovy/com/coditory/quark/uri/UriBuilderSpec.groovy create mode 100644 src/test/groovy/com/coditory/quark/uri/UriBuilder_parseAndRecreateUriSpec.groovy create mode 100644 src/test/groovy/com/coditory/quark/uri/UriBuilder_parseHttpUrlSpec.groovy create mode 100644 src/test/groovy/com/coditory/quark/uri/UriBuilder_parseUriPartsSpec.groovy create mode 100644 src/test/groovy/com/coditory/quark/uri/UriBuilder_parseUriSpec.groovy create mode 100644 src/test/groovy/com/coditory/quark/uri/UriBuilder_queryParamsSpec.groovy create mode 100644 src/test/groovy/com/coditory/quark/uri/UrlValidatorSpec.groovy create mode 100644 src/test/groovy/com/coditory/quark/uri/base/Alphabets.groovy create mode 100644 src/test/groovy/com/coditory/quark/uri/base/CapturingAppender.groovy create mode 100644 src/test/java/readme/ReadmeSamples.java diff --git a/.editorconfig b/.editorconfig new file mode 100644 index 0000000..c8dbe2d --- /dev/null +++ b/.editorconfig @@ -0,0 +1,11 @@ +root = true + +[*] +charset = utf-8 +end_of_line = lf +trim_trailing_whitespace = true +insert_final_newline = true +indent_style = space + +[*.{yml, json}] +indent_size = 2 diff --git a/.github/dependabot.yml b/.github/dependabot.yml new file mode 100644 index 0000000..dfa800a --- /dev/null +++ b/.github/dependabot.yml @@ -0,0 +1,6 @@ +version: 2 +updates: + - package-ecosystem: "gradle" + directory: "/" + schedule: + interval: "monthly" diff --git a/.github/workflows/build.yml b/.github/workflows/build.yml new file mode 100644 index 0000000..acd0f3e --- /dev/null +++ b/.github/workflows/build.yml @@ -0,0 +1,48 @@ +name: Build + +on: + workflow_dispatch: + push: + +jobs: + build: + runs-on: ubuntu-latest + if: github.event_name != 'push' || startsWith(github.ref, 'refs/tags/') == false + steps: + - name: Checkout + uses: actions/checkout@v3 + + - name: Skip duplicates and docs + id: skip + uses: fkirc/skip-duplicate-actions@v5 + with: + paths_ignore: '["**/README.md", "LICENSE", ".gitignore", ".editorconfig", ".idea/**"]' + + - name: Validate gradle wrapper + if: steps.skip.outputs.should_skip != 'true' + uses: gradle/wrapper-validation-action@v1 + + - name: Setup JDK + if: steps.skip.outputs.should_skip != 'true' + uses: actions/setup-java@v3 + with: + java-version: 17 + cache: gradle + distribution: temurin + + - name: Build with gradle + if: steps.skip.outputs.should_skip != 'true' + env: + COVERALLS_REPO_TOKEN: ${{ secrets.COVERALLS_REPO_TOKEN }} + run: ./gradlew build jacocoTestReport coveralls --scan + + dependabot: + needs: [ build ] + runs-on: ubuntu-latest + if: ${{ github.triggering_actor == 'dependabot' && github.event_name == 'pull_request'}} + steps: + - name: Auto-merge Dependabot PRs + run: gh pr merge --auto --merge "$PR_URL" + env: + PR_URL: ${{github.event.pull_request.html_url}} + GITHUB_TOKEN: ${{secrets.GITHUB_TOKEN}} \ No newline at end of file diff --git a/.github/workflows/release.yml b/.github/workflows/release.yml new file mode 100644 index 0000000..10f1ed1 --- /dev/null +++ b/.github/workflows/release.yml @@ -0,0 +1,173 @@ +name: Release + +on: + workflow_dispatch: + inputs: + version: + type: string + description: | + Release version in semantic format (like: 1.2.3). + Default: a version with incremented patch number. + required: false + publish: + type: choice + description: Artifact publication. + options: + - AUTO + - SKIP + - RELEASE + - SNAPSHOT + required: true + default: AUTO + release: + types: [ published ] + +jobs: + release: + runs-on: ubuntu-latest + steps: + - name: Validate build succeeded + env: + GH_TOKEN: ${{ secrets.GITHUB_TOKEN }} + run: | + declare -r BUILD_SUCCESS="$(gh api \ + -H "Accept: application/vnd.github+json" \ + /repos/${{ github.repository }}/actions/runs?status=success\&head_sha=${{ github.sha }} \ + | jq 'limit(1; .workflow_runs[] | select(.name == "Build" and .conclusion == "success"))')" + if [ -z "$BUILD_SUCCESS" ]; then + echo "Commit did not pass Build!" + exit 1 + fi + + - name: Checkout + uses: actions/checkout@v3 + with: + fetch-depth: 0 + token: ${{ secrets.CI_TOKEN }} + + - name: Get versions + id: versions + env: + NEXT_INPUT_VERSION: ${{ inputs.version }} + TAG_NAME: ${{ github.event.release.tag_name }} + run: | + declare -r GIT_VERSION="$(git tag -l 'v[0-9]*.[0-9]*.[0-9]*' | sort -V | tail -n 1 | cut -c2-)" + declare -r VERSION=${GIT_VERSION:-0.0.0} + declare -r MAJOR="$(echo "$VERSION" | cut -d. -f1)" + declare -r MINOR="$(echo "$VERSION" | cut -d. -f2)" + declare -r PATCH="$(echo "$VERSION" | cut -d. -f3)" + declare -r NEXT_TAG_VERSION="$([[ "$TAG_NAME" =~ v.* ]] \ + && (echo "$TAG_NAME" | cut -c2-) \ + || echo "$TAG_NAME")" + declare -r NEXT_MANUAL_VERSION="${NEXT_INPUT_VERSION:-$NEXT_TAG_VERSION}" + declare -r NEXT_PATCH_VERSION="$MAJOR.$MINOR.$(( $PATCH + 1 ))" + declare -r NEXT_VERSION="${NEXT_MANUAL_VERSION:-$NEXT_PATCH_VERSION}" + echo "version=$VERSION" >> $GITHUB_OUTPUT + echo "next_version=$NEXT_VERSION" >> $GITHUB_OUTPUT + echo -e "VERSION: $VERSION\nNEXT_VERSION: $NEXT_VERSION" + + - name: Import GPG key + id: gpg + uses: crazy-max/ghaction-import-gpg@v5 + if: | + github.event_name != 'release' + && github.ref == 'refs/heads/master' + && inputs.publish != 'SNAPSHOT' + with: + gpg_private_key: ${{ secrets.GPG_PRIVATE_KEY }} + passphrase: ${{ secrets.GPG_PASSPHRASE }} + git_user_signingkey: true + git_commit_gpgsign: true + git_committer_name: Coditory Bot + git_committer_email: bot@coditory.com + + - name: Update version in README (master only) + if: steps.gpg.conclusion == 'success' + env: + PREV_VERSION: ${{ steps.versions.outputs.version }} + NEXT_VERSION: ${{ steps.versions.outputs.next_version }} + run: | + declare -r ESC_PREV_VERSION="${PREV_VERSION//./\\.}" + echo "Changing: $PREV_VERSION -> $NEXT_VERSION" + sed -i "s|${ESC_PREV_VERSION}|${NEXT_VERSION}|" README.md + if [ -n "$(git status --porcelain)" ]; then + git add -A + git commit -a -m "Update version $PREV_VERSION -> $NEXT_VERSION" -m "[ci skip]" + git push origin master + else + echo "Nothing changed. Skipping commit." + fi + + - name: Setup JDK + if: inputs.publish != 'SKIP' + uses: actions/setup-java@v3 + with: + java-version: 17 + cache: gradle + distribution: temurin + + - name: Publish release + if: | + github.event_name == 'release' + || inputs.publish == 'RELEASE' + || (inputs.publish == 'AUTO' && github.ref == 'refs/heads/master') + env: + NEXT_VERSION: ${{ steps.versions.outputs.next_version }} + SIGNING_KEY: ${{ secrets.GPG_PRIVATE_KEY }} + SIGNING_PASSWORD: ${{ secrets.GPG_PASSPHRASE }} + NEXUS_USERNAME: ${{ secrets.NEXUS_USERNAME }} + NEXUS_PASSWORD: ${{ secrets.NEXUS_PASSWORD }} + run: | + ./gradlew publishToSonatype closeAndReleaseSonatypeStagingRepository -Pversion=$NEXT_VERSION -Ppublish --info + echo "Published release: $NEXT_VERSION" + + - name: Generate release notes + id: notes + if: | + github.event_name != 'release' + && github.ref == 'refs/heads/master' + && inputs.publish != 'SNAPSHOT' + env: + GH_TOKEN: ${{ secrets.GITHUB_TOKEN }} + PREV_VERSION: ${{ steps.versions.outputs.version }} + NEXT_VERSION: ${{ steps.versions.outputs.next_version }} + run: | + declare -r NOTES="$(gh api \ + --method POST \ + -H "Accept: application/vnd.github+json" \ + /repos/${{ github.repository }}/releases/generate-notes \ + -f tag_name="v$NEXT_VERSION" \ + -f target_commitish='master' \ + -f previous_tag_name="v$PREV_VERSION" \ + | jq -r '.body')" + declare -r ESCAPED="${NOTES//$'\n'/'%0A'}" + echo "notes=$ESCAPED" >> $GITHUB_OUTPUT + + - name: Create github release (master only) + if: steps.notes.conclusion == 'success' + uses: ncipollo/release-action@v1 + with: + allowUpdates: true + body: ${{ steps.notes.outputs.notes }} + draft: ${{ inputs.publish == 'SKIP' }} + tag: v${{ steps.versions.outputs.next_version }} + token: ${{ secrets.GITHUB_TOKEN }} + artifacts: "build/libs/*.jar" + + - name: Publish snapshot + if: | + github.event_name == 'workflow_dispatch' + && ( + inputs.publish == 'SNAPSHOT' + || inputs.publish == 'AUTO' && github.ref != 'refs/heads/master' + ) + env: + NEXT_VERSION: ${{ steps.versions.outputs.next_version }} + SIGNING_KEY: ${{ secrets.GPG_PRIVATE_KEY }} + SIGNING_PASSWORD: ${{ secrets.GPG_PASSPHRASE }} + NEXUS_USERNAME: ${{ secrets.NEXUS_USERNAME }} + NEXUS_PASSWORD: ${{ secrets.NEXUS_PASSWORD }} + run: | + declare -r MIDDLE="$([ "$GITHUB_REF" == "refs/heads/master" ] && echo "" || echo "-${GITHUB_REF#refs/heads/}")" + ./gradlew publishToSonatype -Pversion="${NEXT_VERSION}${MIDDLE}-SNAPSHOT" -Ppublish + echo "Published snapshot: ${NEXT_VERSION}${MIDDLE}-SNAPSHOT" diff --git a/.gitignore b/.gitignore new file mode 100755 index 0000000..861a639 --- /dev/null +++ b/.gitignore @@ -0,0 +1,10 @@ +# Gradle +build +.gradle +!gradle/wrapper/gradle-wrapper.jar + +# IntelliJ +out +*.iml +.idea/* +!.idea/codeStyles diff --git a/.idea/codeStyles/Project.xml b/.idea/codeStyles/Project.xml new file mode 100644 index 0000000..3882c43 --- /dev/null +++ b/.idea/codeStyles/Project.xml @@ -0,0 +1,50 @@ + + + + + + + + + + + + + + + + + + + + + + + + + \ No newline at end of file diff --git a/.idea/codeStyles/codeStyleConfig.xml b/.idea/codeStyles/codeStyleConfig.xml new file mode 100644 index 0000000..0f7bc51 --- /dev/null +++ b/.idea/codeStyles/codeStyleConfig.xml @@ -0,0 +1,5 @@ + + + + diff --git a/LICENSE b/LICENSE new file mode 100644 index 0000000..76c8e2a --- /dev/null +++ b/LICENSE @@ -0,0 +1,21 @@ +MIT License + +Copyright (c) 2020 Paweł Mendelski + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all +copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE +SOFTWARE. diff --git a/README.md b/README.md new file mode 100644 index 0000000..4d4c761 --- /dev/null +++ b/README.md @@ -0,0 +1,76 @@ +# Quark URI + +[![Build](https://github.com/coditory/quark-uri/actions/workflows/build.yml/badge.svg)](https://github.com/coditory/quark-uri/actions/workflows/build.yml) +[![Coverage Status](https://coveralls.io/repos/github/coditory/quark-uri/badge.svg)](https://coveralls.io/github/coditory/quark-uri) +[![Maven Central](https://maven-badges.herokuapp.com/maven-central/com.coditory.quark/quark-uri/badge.svg)](https://mvnrepository.com/artifact/com.coditory.quark/quark-uri) + +**🚧 This library as under heavy development until release of version `1.x.x` 🚧** + +> Just a URI manipulation library for Java. Provides URI builder and parser. + +- lightweight, exactly 1 minimalistic dependency +- single purpose, not part of a framework +- does percent encoding and decoding +- adds option to encode/decode `+` character as a space + +## Installation + +Add to your `build.gradle`: + +```gradle +dependencies { + implementation "com.coditory.quark:quark-uri:0.0.1" +} +``` + +## Basic usage + +Build uri string +```java +UriBuilder.fromUri("https://coditory.com?w=W&a=A") + .addPathSegment("about") + .addQueryParam("a", "X") + .addQueryParam("a", "X") + .addQueryParam("a", "Y") + .addQueryParam("b", "Y") + .addQueryParam("e", "") + .buildUriString(); +// Result: +// https://coditory.com/about?w=W&a=A&a=X&a=X&a=Y&b=Y&e= +``` + +Build uri components +```java +UriComponents uriComponents = UriBuilder.fromUri("https://coditory.com?w=W&a=A") + .addPathSegment("about") + .addQueryParam("a", "X") + .addQueryParam("a", "X") + .addQueryParam("a", "Y") + .addQueryParam("b", "Y") + .addQueryParam("e", "") + .buildUriComponents(); +// uriComponents is a value object, that provides access to all parts of parsed uri +// Result: +// UriComponents{scheme="https", host="coditory.com", pathSegments=[about], queryParams={w=[W], a=[A, X, X, Y], b=[Y], e=[]}} +``` + +Parses encoded spaces and pluses: +``` +UriComponents plusesAsSpaces = UriBuilder.fromUri("/abc?a+b=A+B").buildUriComponents(); +UriComponents encodedSpaces = UriBuilder.fromUri("/abc?a%20b=A%20B").buildUriComponents(); +assert plusesAsSpaces == encodedSpaces +// Result: +// UriComponents{rootPath=true, pathSegments=[abc], queryParams={a b=[A B]}} +``` + +By default encodes spaces as `%20` +``` +UriBuilder.fromUri("https://coditory.com/a+bc/d%20ef/") + .addPathSegment("x y ") + .setFragment("frag ment") + .addQueryParam("f oo", "b ar") + .addQueryParam("x", "y+z") + .buildUriString(); +// Result: +// https://coditory.com/a+bc/d%20ef/x%20y%20?f%20oo=b%20ar&x=y%2Bz#frag%20ment +``` \ No newline at end of file diff --git a/build.gradle b/build.gradle new file mode 100644 index 0000000..0e04d97 --- /dev/null +++ b/build.gradle @@ -0,0 +1,22 @@ +plugins { + id 'java-library' + id 'groovy' + id 'jacoco' + id 'signing' + id 'com.github.kt3k.coveralls' version '2.12.0' + id 'com.coditory.build' version '0.1.19' + id 'io.github.gradle-nexus.publish-plugin' version '1.1.0' apply false +} + +group = 'com.coditory.quark' +description = 'Coditory Quark URI builder library' + +dependencies { + api 'org.jetbrains:annotations:23.1.0' + testImplementation 'ch.qos.logback:logback-classic:1.4.5' + testImplementation 'org.spockframework:spock-core:2.3-groovy-4.0' +} + +if (project.hasProperty('publish')) { + apply from: "gradle/publish.gradle" +} diff --git a/gradle/publish.gradle b/gradle/publish.gradle new file mode 100644 index 0000000..2372783 --- /dev/null +++ b/gradle/publish.gradle @@ -0,0 +1,95 @@ +apply plugin: 'maven-publish' +apply plugin: 'signing' +apply plugin: 'io.github.gradle-nexus.publish-plugin' + +jar { + from(rootProject.projectDir) { + include "LICENSE" + into "META-INF" + } +} + +task javadocJar(type: Jar) { + from javadoc + archiveClassifier = 'javadoc' +} + +task sourcesJar(type: Jar) { + from sourceSets.main.allJava + archiveClassifier = 'sources' +} + +artifacts { + archives javadocJar + archives sourcesJar +} + +publishing { + publications { + mavenJava(MavenPublication) { + artifactId = archivesBaseName + from components.java + artifact sourcesJar + artifact javadocJar + + versionMapping { + usage('java-api') { + fromResolutionOf('runtimeClasspath') + } + usage('java-runtime') { + fromResolutionResult() + } + } + + pom { + name = archivesBaseName + description = project.description + url = 'https://github.com/coditory/quark-uri' + organization { + name = "Coditory" + url = "https://coditory.com" + } + licenses { + license { + name = 'MIT License' + url = 'https://opensource.org/licenses/MIT' + } + } + developers { + developer { + id = 'coditory' + name = 'Coditory' + email = 'admin@coditory.com' + } + } + scm { + connection = 'scm:git@github.com:coditory/quark-uri.git' + developerConnection = 'scm:git@github.com:coditory/quark-uri.git' + url = 'https://github.com/coditory/quark-uri' + } + issueManagement { + system = "GitHub" + url = "https://github.com/coditory/quark-uri/issues" + } + } + } + } +} + +signing { + if (System.getenv('SIGNING_KEY') && System.getenv('SIGNING_PASSWORD')) { + useInMemoryPgpKeys(System.getenv('SIGNING_KEY'), System.getenv('SIGNING_PASSWORD')) + } + sign publishing.publications.mavenJava +} + +nexusPublishing { + connectTimeout = Duration.ofMinutes(5) + clientTimeout = Duration.ofMinutes(5) + repositories { + sonatype { + username = project.findProperty('nexusUsername') ?: System.getenv('NEXUS_USERNAME') + password = project.findProperty('nexusPassword') ?: System.getenv('NEXUS_PASSWORD') + } + } +} diff --git a/gradle/wrapper/gradle-wrapper.jar b/gradle/wrapper/gradle-wrapper.jar new file mode 100644 index 0000000000000000000000000000000000000000..41d9927a4d4fb3f96a785543079b8df6723c946b GIT binary patch literal 59821 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 literal 0 HcmV?d00001 diff --git a/gradle/wrapper/gradle-wrapper.properties b/gradle/wrapper/gradle-wrapper.properties new file mode 100644 index 0000000..f42e62f --- /dev/null +++ b/gradle/wrapper/gradle-wrapper.properties @@ -0,0 +1,5 @@ +distributionBase=GRADLE_USER_HOME +distributionPath=wrapper/dists +distributionUrl=https\://services.gradle.org/distributions/gradle-7.6-all.zip +zipStoreBase=GRADLE_USER_HOME +zipStorePath=wrapper/dists diff --git a/gradlew b/gradlew new file mode 100755 index 0000000..1b6c787 --- /dev/null +++ b/gradlew @@ -0,0 +1,234 @@ +#!/bin/sh + +# +# Copyright © 2015-2021 the original authors. +# +# 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. +# + +############################################################################## +# +# Gradle start up script for POSIX generated by Gradle. +# +# Important for running: +# +# (1) You need a POSIX-compliant shell to run this script. If your /bin/sh is +# noncompliant, but you have some other compliant shell such as ksh or +# bash, then to run this script, type that shell name before the whole +# command line, like: +# +# ksh Gradle +# +# Busybox and similar reduced shells will NOT work, because this script +# requires all of these POSIX shell features: +# * functions; +# * expansions «$var», «${var}», «${var:-default}», «${var+SET}», +# «${var#prefix}», «${var%suffix}», and «$( cmd )»; +# * compound commands having a testable exit status, especially «case»; +# * various built-in commands including «command», «set», and «ulimit». +# +# Important for patching: +# +# (2) This script targets any POSIX shell, so it avoids extensions provided +# by Bash, Ksh, etc; in particular arrays are avoided. +# +# The "traditional" practice of packing multiple parameters into a +# space-separated string is a well documented source of bugs and security +# problems, so this is (mostly) avoided, by progressively accumulating +# options in "$@", and eventually passing that to Java. +# +# Where the inherited environment variables (DEFAULT_JVM_OPTS, JAVA_OPTS, +# and GRADLE_OPTS) rely on word-splitting, this is performed explicitly; +# see the in-line comments for details. +# +# There are tweaks for specific operating systems such as AIX, CygWin, +# Darwin, MinGW, and NonStop. +# +# (3) This script is generated from the Groovy template +# https://github.com/gradle/gradle/blob/master/subprojects/plugins/src/main/resources/org/gradle/api/internal/plugins/unixStartScript.txt +# within the Gradle project. +# +# You can find Gradle at https://github.com/gradle/gradle/. +# +############################################################################## + +# Attempt to set APP_HOME + +# Resolve links: $0 may be a link +app_path=$0 + +# Need this for daisy-chained symlinks. +while + APP_HOME=${app_path%"${app_path##*/}"} # leaves a trailing /; empty if no leading path + [ -h "$app_path" ] +do + ls=$( ls -ld "$app_path" ) + link=${ls#*' -> '} + case $link in #( + /*) app_path=$link ;; #( + *) app_path=$APP_HOME$link ;; + esac +done + +APP_HOME=$( cd "${APP_HOME:-./}" && pwd -P ) || exit + +APP_NAME="Gradle" +APP_BASE_NAME=${0##*/} + +# Add default JVM options here. You can also use JAVA_OPTS and GRADLE_OPTS to pass JVM options to this script. +DEFAULT_JVM_OPTS='"-Xmx64m" "-Xms64m"' + +# Use the maximum available, or set MAX_FD != -1 to use that value. +MAX_FD=maximum + +warn () { + echo "$*" +} >&2 + +die () { + echo + echo "$*" + echo + exit 1 +} >&2 + +# OS specific support (must be 'true' or 'false'). +cygwin=false +msys=false +darwin=false +nonstop=false +case "$( uname )" in #( + CYGWIN* ) cygwin=true ;; #( + Darwin* ) darwin=true ;; #( + MSYS* | MINGW* ) msys=true ;; #( + NONSTOP* ) nonstop=true ;; +esac + +CLASSPATH=$APP_HOME/gradle/wrapper/gradle-wrapper.jar + + +# Determine the Java command to use to start the JVM. +if [ -n "$JAVA_HOME" ] ; then + if [ -x "$JAVA_HOME/jre/sh/java" ] ; then + # IBM's JDK on AIX uses strange locations for the executables + JAVACMD=$JAVA_HOME/jre/sh/java + else + JAVACMD=$JAVA_HOME/bin/java + fi + if [ ! -x "$JAVACMD" ] ; then + die "ERROR: JAVA_HOME is set to an invalid directory: $JAVA_HOME + +Please set the JAVA_HOME variable in your environment to match the +location of your Java installation." + fi +else + JAVACMD=java + which java >/dev/null 2>&1 || die "ERROR: JAVA_HOME is not set and no 'java' command could be found in your PATH. + +Please set the JAVA_HOME variable in your environment to match the +location of your Java installation." +fi + +# Increase the maximum file descriptors if we can. +if ! "$cygwin" && ! "$darwin" && ! "$nonstop" ; then + case $MAX_FD in #( + max*) + MAX_FD=$( ulimit -H -n ) || + warn "Could not query maximum file descriptor limit" + esac + case $MAX_FD in #( + '' | soft) :;; #( + *) + ulimit -n "$MAX_FD" || + warn "Could not set maximum file descriptor limit to $MAX_FD" + esac +fi + +# Collect all arguments for the java command, stacking in reverse order: +# * args from the command line +# * the main class name +# * -classpath +# * -D...appname settings +# * --module-path (only if needed) +# * DEFAULT_JVM_OPTS, JAVA_OPTS, and GRADLE_OPTS environment variables. + +# For Cygwin or MSYS, switch paths to Windows format before running java +if "$cygwin" || "$msys" ; then + APP_HOME=$( cygpath --path --mixed "$APP_HOME" ) + CLASSPATH=$( cygpath --path --mixed "$CLASSPATH" ) + + JAVACMD=$( cygpath --unix "$JAVACMD" ) + + # Now convert the arguments - kludge to limit ourselves to /bin/sh + for arg do + if + case $arg in #( + -*) false ;; # don't mess with options #( + /?*) t=${arg#/} t=/${t%%/*} # looks like a POSIX filepath + [ -e "$t" ] ;; #( + *) false ;; + esac + then + arg=$( cygpath --path --ignore --mixed "$arg" ) + fi + # Roll the args list around exactly as many times as the number of + # args, so each arg winds up back in the position where it started, but + # possibly modified. + # + # NB: a `for` loop captures its iteration list before it begins, so + # changing the positional parameters here affects neither the number of + # iterations, nor the values presented in `arg`. + shift # remove old arg + set -- "$@" "$arg" # push replacement arg + done +fi + +# Collect all arguments for the java command; +# * $DEFAULT_JVM_OPTS, $JAVA_OPTS, and $GRADLE_OPTS can contain fragments of +# shell script including quotes and variable substitutions, so put them in +# double quotes to make sure that they get re-expanded; and +# * put everything else in single quotes, so that it's not re-expanded. + +set -- \ + "-Dorg.gradle.appname=$APP_BASE_NAME" \ + -classpath "$CLASSPATH" \ + org.gradle.wrapper.GradleWrapperMain \ + "$@" + +# Use "xargs" to parse quoted args. +# +# With -n1 it outputs one arg per line, with the quotes and backslashes removed. +# +# In Bash we could simply go: +# +# readarray ARGS < <( xargs -n1 <<<"$var" ) && +# set -- "${ARGS[@]}" "$@" +# +# but POSIX shell has neither arrays nor command substitution, so instead we +# post-process each arg (as a line of input to sed) to backslash-escape any +# character that might be a shell metacharacter, then use eval to reverse +# that process (while maintaining the separation between arguments), and wrap +# the whole thing up as a single "set" statement. +# +# This will of course break if any of these variables contains a newline or +# an unmatched quote. +# + +eval "set -- $( + printf '%s\n' "$DEFAULT_JVM_OPTS $JAVA_OPTS $GRADLE_OPTS" | + xargs -n1 | + sed ' s~[^-[:alnum:]+,./:=@_]~\\&~g; ' | + tr '\n' ' ' + )" '"$@"' + +exec "$JAVACMD" "$@" diff --git a/gradlew.bat b/gradlew.bat new file mode 100644 index 0000000..ac1b06f --- /dev/null +++ b/gradlew.bat @@ -0,0 +1,89 @@ +@rem +@rem Copyright 2015 the original author or authors. +@rem +@rem Licensed under the Apache License, Version 2.0 (the "License"); +@rem you may not use this file except in compliance with the License. +@rem You may obtain a copy of the License at +@rem +@rem https://www.apache.org/licenses/LICENSE-2.0 +@rem +@rem Unless required by applicable law or agreed to in writing, software +@rem distributed under the License is distributed on an "AS IS" BASIS, +@rem WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +@rem See the License for the specific language governing permissions and +@rem limitations under the License. +@rem + +@if "%DEBUG%" == "" @echo off +@rem ########################################################################## +@rem +@rem Gradle startup script for Windows +@rem +@rem ########################################################################## + +@rem Set local scope for the variables with windows NT shell +if "%OS%"=="Windows_NT" setlocal + +set DIRNAME=%~dp0 +if "%DIRNAME%" == "" set DIRNAME=. +set APP_BASE_NAME=%~n0 +set APP_HOME=%DIRNAME% + +@rem Resolve any "." and ".." in APP_HOME to make it shorter. +for %%i in ("%APP_HOME%") do set APP_HOME=%%~fi + +@rem Add default JVM options here. You can also use JAVA_OPTS and GRADLE_OPTS to pass JVM options to this script. +set DEFAULT_JVM_OPTS="-Xmx64m" "-Xms64m" + +@rem Find java.exe +if defined JAVA_HOME goto findJavaFromJavaHome + +set JAVA_EXE=java.exe +%JAVA_EXE% -version >NUL 2>&1 +if "%ERRORLEVEL%" == "0" goto execute + +echo. +echo ERROR: JAVA_HOME is not set and no 'java' command could be found in your PATH. +echo. +echo Please set the JAVA_HOME variable in your environment to match the +echo location of your Java installation. + +goto fail + +:findJavaFromJavaHome +set JAVA_HOME=%JAVA_HOME:"=% +set JAVA_EXE=%JAVA_HOME%/bin/java.exe + +if exist "%JAVA_EXE%" goto execute + +echo. +echo ERROR: JAVA_HOME is set to an invalid directory: %JAVA_HOME% +echo. +echo Please set the JAVA_HOME variable in your environment to match the +echo location of your Java installation. + +goto fail + +:execute +@rem Setup the command line + +set CLASSPATH=%APP_HOME%\gradle\wrapper\gradle-wrapper.jar + + +@rem Execute Gradle +"%JAVA_EXE%" %DEFAULT_JVM_OPTS% %JAVA_OPTS% %GRADLE_OPTS% "-Dorg.gradle.appname=%APP_BASE_NAME%" -classpath "%CLASSPATH%" org.gradle.wrapper.GradleWrapperMain %* + +:end +@rem End local scope for the variables with windows NT shell +if "%ERRORLEVEL%"=="0" goto mainEnd + +:fail +rem Set variable GRADLE_EXIT_CONSOLE if you need the _script_ return code instead of +rem the _cmd.exe /c_ return code! +if not "" == "%GRADLE_EXIT_CONSOLE%" exit 1 +exit /b 1 + +:mainEnd +if "%OS%"=="Windows_NT" endlocal + +:omega diff --git a/settings.gradle b/settings.gradle new file mode 100644 index 0000000..749ca35 --- /dev/null +++ b/settings.gradle @@ -0,0 +1,12 @@ +plugins { + id("com.gradle.enterprise").version("3.5") +} + +rootProject.name = "quark-uri" + +gradleEnterprise { + buildScan { + termsOfServiceUrl = "https://gradle.com/terms-of-service" + termsOfServiceAgree = "yes" + } +} diff --git a/src/main/java/com/coditory/quark/uri/BitSets.java b/src/main/java/com/coditory/quark/uri/BitSets.java new file mode 100644 index 0000000..0033ad4 --- /dev/null +++ b/src/main/java/com/coditory/quark/uri/BitSets.java @@ -0,0 +1,110 @@ +package com.coditory.quark.uri; + +import org.jetbrains.annotations.NotNull; + +import java.util.BitSet; + +import static com.coditory.quark.uri.Preconditions.expectNonNull; + +final class BitSets { + private BitSets() { + throw new UnsupportedOperationException("Do not instantiate utility class"); + } + + public static BitSet of(String text) { + expectNonNull(text, "text"); + if (text.length() == 0) { + return new BitSet(0); + } + int max = text.codePoints().max().getAsInt(); + BitSet bitSet = new BitSet(max + 1); + text.codePoints() + .forEach(bitSet::set); + return bitSet; + } + + public static BitSet set(BitSet bitSet, int bitIndex, boolean value) { + expectNonNull(bitSet, "bitSet"); + BitSet result = new BitSet(Math.max(bitSet.length(), bitIndex + 1)); + result.or(bitSet); + result.set(bitIndex, value); + return result; + } + + public static BitSet unmodifiableBitSet(BitSet bitSet) { + expectNonNull(bitSet, "bitSet"); + return new UnmodifiableBitSet(bitSet); + } + + static final class UnmodifiableBitSet extends BitSet { + public UnmodifiableBitSet(@NotNull BitSet original) { + expectNonNull(original, "original"); + super.or(original); + } + + @Override + public void flip(int bitIndex) { + throw new UnsupportedOperationException(); + } + + @Override + public void flip(int fromIndex, int toIndex) { + throw new UnsupportedOperationException(); + } + + @Override + public void set(int bitIndex) { + throw new UnsupportedOperationException(); + } + + @Override + public void set(int bitIndex, boolean value) { + throw new UnsupportedOperationException(); + } + + @Override + public void set(int fromIndex, int toIndex) { + throw new UnsupportedOperationException(); + } + + @Override + public void set(int fromIndex, int toIndex, boolean value) { + throw new UnsupportedOperationException(); + } + + @Override + public void clear(int bitIndex) { + throw new UnsupportedOperationException(); + } + + @Override + public void clear(int fromIndex, int toIndex) { + throw new UnsupportedOperationException(); + } + + @Override + public void clear() { + throw new UnsupportedOperationException(); + } + + @Override + public void and(@NotNull BitSet set) { + throw new UnsupportedOperationException(); + } + + @Override + public void or(@NotNull BitSet set) { + throw new UnsupportedOperationException(); + } + + @Override + public void xor(@NotNull BitSet set) { + throw new UnsupportedOperationException(); + } + + @Override + public void andNot(@NotNull BitSet set) { + throw new UnsupportedOperationException(); + } + } +} diff --git a/src/main/java/com/coditory/quark/uri/Hosts.java b/src/main/java/com/coditory/quark/uri/Hosts.java new file mode 100644 index 0000000..be967eb --- /dev/null +++ b/src/main/java/com/coditory/quark/uri/Hosts.java @@ -0,0 +1,154 @@ +package com.coditory.quark.uri; + +import org.jetbrains.annotations.NotNull; + +import java.io.BufferedReader; +import java.io.IOException; +import java.io.InputStream; +import java.io.InputStreamReader; +import java.net.InetAddress; +import java.net.UnknownHostException; +import java.util.function.Predicate; +import java.util.function.Supplier; +import java.util.regex.Pattern; + +import static com.coditory.quark.uri.Preconditions.expectNonBlank; +import static com.coditory.quark.uri.Preconditions.expectNonNull; + +public final class Hosts { + private Hosts() { + throw new UnsupportedOperationException("Do not instantiate utility class"); + } + + /** + * @return local host name. Example: john-macbook-pro + */ + @NotNull + public static String getLocalHostName() { + return LocalHostNameResolver.LOCAL_HOST_NAME; + } + + /** + * @return local host ip address. Example: 127.0.1.1 + */ + @NotNull + public static String getLocalHostAddress() { + return LocalHostAddressResolver.LOCAL_HOST_ADDRESS; + } + + /** + * Java Language Specification specifies that a class initialization occurs + * the first time its methods or fields are used. + * Nested static class can be used to implement lazy initialization. + * + * @link https://docs.oracle.com/javase/specs/jls/se7/html/jls-12.html#jls-12.4.2 + */ + private static class LocalHostNameResolver { + private static final Predicate IP_ADDRESS = Pattern.compile("(\\d{1,3}\\.){3}\\d{1,3}").asPredicate(); + static final String LOCAL_HOST_NAME = ResolverWithOsCommandFallback + .resolveWithOsFallback( + "local host name", + LocalHostNameResolver::resolveLocalHostNameUsingJVM, + "hostname -f" + ); + + private LocalHostNameResolver() { + throw new IllegalStateException("This is a utility class and cannot be instantiated"); + } + + private static String resolveLocalHostNameUsingJVM() { + InetAddress localhost = getLocalHost(); + String canonicalHostName = localhost.getCanonicalHostName(); + String hostName = localhost.getHostName(); + return IP_ADDRESS.test(canonicalHostName) + ? hostName + : canonicalHostName; + } + + private static InetAddress getLocalHost() { + try { + return InetAddress.getLocalHost(); + } catch (UnknownHostException e) { + throw new RuntimeException("Could not get localhost address", e); + } + } + } + + private static class LocalHostAddressResolver { + static final String LOCAL_HOST_ADDRESS = ResolverWithOsCommandFallback + .resolveWithOsFallback( + "local host address", + LocalHostAddressResolver::resolveLocalHostAddress, + "hostname -i" + ); + + private LocalHostAddressResolver() { + throw new IllegalStateException("This is a utility class and cannot be instantiated"); + } + + private static String resolveLocalHostAddress() { + InetAddress localhost = getLocalHost(); + return localhost.getHostAddress(); + } + + private static InetAddress getLocalHost() { + try { + return InetAddress.getLocalHost(); + } catch (UnknownHostException e) { + throw new RuntimeException("Could not get localhost address", e); + } + } + } + + private static class ResolverWithOsCommandFallback { + static String resolveWithOsFallback(String name, Supplier jvmSupplier, String systemCommand) { + return new ResolverWithOsCommandFallback(name, jvmSupplier, systemCommand) + .resolve(); + } + + private final String name; + private final Supplier jvmSupplier; + private final String[] systemCommand; + + ResolverWithOsCommandFallback(String name, Supplier jvmSupplier, String systemCommand) { + expectNonBlank(systemCommand, "systemCommand"); + this.name = expectNonBlank(name, "name"); + this.jvmSupplier = expectNonNull(jvmSupplier, "jvmSupplier"); + this.systemCommand = systemCommand.split(" "); + } + + String resolve() { + try { + return resolveUsingJVM(); + } catch (Exception exception) { + return resolveUsingOs(); + } + } + + private String resolveUsingJVM() { + return jvmSupplier.get(); + } + + private String resolveUsingOs() { + try ( + InputStream is = Runtime.getRuntime() + .exec(systemCommand) + .getInputStream(); + BufferedReader reader = new BufferedReader(new InputStreamReader(is)) + ) { + StringBuilder builder = new StringBuilder(); + String line; + while ((line = reader.readLine()) != null) { + builder.append(line).append("\n"); + } + return builder.toString().trim(); + } catch (IOException exception) { + String cmd = String.join(" ", systemCommand); + throw new RuntimeException( + "Could not resolve " + name + ". OS does not support command: " + cmd, + exception + ); + } + } + } +} diff --git a/src/main/java/com/coditory/quark/uri/InetAddressValidator.java b/src/main/java/com/coditory/quark/uri/InetAddressValidator.java new file mode 100644 index 0000000..f42925c --- /dev/null +++ b/src/main/java/com/coditory/quark/uri/InetAddressValidator.java @@ -0,0 +1,168 @@ +package com.coditory.quark.uri; + +import org.jetbrains.annotations.Nullable; + +import java.util.ArrayList; +import java.util.Arrays; +import java.util.List; +import java.util.regex.Matcher; +import java.util.regex.Pattern; + +import static com.coditory.quark.uri.Strings.isNullOrBlank; + +public final class InetAddressValidator { + private InetAddressValidator() { + throw new UnsupportedOperationException("Do not instantiate utility class"); + } + + private static final int MAX_BYTE = 128; + private static final int IPV4_MAX_OCTET_VALUE = 255; + private static final int MAX_UNSIGNED_SHORT = 0xffff; + private static final int BASE_16 = 16; + private static final Pattern IPV4_REGEX = Pattern.compile("^(\\d{1,3})\\.(\\d{1,3})\\.(\\d{1,3})\\.(\\d{1,3})$"); + private static final int IPV6_MAX_HEX_GROUPS = 8; + private static final int IPV6_MAX_HEX_DIGITS_PER_GROUP = 4; + + public static void validateInetAddress(@Nullable String inetAddress) { + if (!isValidInetV4Address(inetAddress) && !isValidInetV6Address(inetAddress)) { + throw new IllegalArgumentException("Expected valid ip address. Got: " + inetAddress); + } + } + + public static void validateInetV4Address(@Nullable String inetAddress) { + if (!isValidInetV4Address(inetAddress)) { + throw new IllegalArgumentException("Expected valid ip v4 address. Got: " + inetAddress); + } + } + + public static void validateInetV6Address(@Nullable String inetAddress) { + if (!isValidInetV6Address(inetAddress)) { + throw new IllegalArgumentException("Expected valid ip v6 address. Got: " + inetAddress); + } + } + + public static boolean isValidInetAddress(@Nullable String inetAddress) { + return isValidInetV4Address(inetAddress) || isValidInetV6Address(inetAddress); + } + + public static boolean isValidInetV4Address(@Nullable String inet4Address) { + if (inet4Address == null || inet4Address.isBlank()) { + return false; + } + Matcher matcher = IPV4_REGEX.matcher(inet4Address); + if (!matcher.matches()) { + return false; + } + for (int j = 0; j < matcher.groupCount(); j++) { + String ipSegment = matcher.group(j + 1); + if (isNullOrBlank(ipSegment)) { + return false; + } + if (ipSegment.length() > 1 && ipSegment.startsWith("0")) { + return false; + } + Integer iIpSegment = parseIntegerOrNull(ipSegment); + if (iIpSegment == null || iIpSegment > IPV4_MAX_OCTET_VALUE) { + return false; + } + } + return true; + } + + private static Integer parseIntegerOrNull(String text) { + if (text == null) { + return null; + } + try { + return Integer.parseInt(text); + } catch (RuntimeException e) { + return null; + } + } + + public static boolean isValidInetV6Address(@Nullable String inet6Address) { + if (inet6Address == null || inet6Address.isBlank()) { + return false; + } + String[] parts; + parts = inet6Address.split("/", -1); + if (parts.length > 2) { + return false; + } + if (parts.length == 2) { + if (parts[1].matches("\\d{1,3}")) { + int bits = Integer.parseInt(parts[1]); + if (bits < 0 || bits > MAX_BYTE) { + return false; + } + } else { + return false; + } + } + parts = parts[0].split("%", -1); + if (parts.length > 2) { + return false; + } else if (parts.length == 2) { + if (!parts[1].matches("[^\\s/%]+")) { + return false; + } + } + inet6Address = parts[0]; + boolean containsCompressedZeroes = inet6Address.contains("::"); + if (containsCompressedZeroes && (inet6Address.indexOf("::") != inet6Address.lastIndexOf("::"))) { + return false; + } + if ((inet6Address.startsWith(":") && !inet6Address.startsWith("::")) + || (inet6Address.endsWith(":") && !inet6Address.endsWith("::"))) { + return false; + } + String[] octets = inet6Address.split(":"); + if (containsCompressedZeroes) { + List octetList = new ArrayList<>(Arrays.asList(octets)); + if (inet6Address.endsWith("::")) { + octetList.add(""); + } else if (inet6Address.startsWith("::") && !octetList.isEmpty()) { + octetList.remove(0); + } + octets = octetList.toArray(new String[0]); + } + if (octets.length > IPV6_MAX_HEX_GROUPS) { + return false; + } + int validOctets = 0; + int emptyOctets = 0; // consecutive empty chunks + for (int index = 0; index < octets.length; index++) { + String octet = octets[index]; + if (octet.length() == 0) { + emptyOctets++; + if (emptyOctets > 1) { + return false; + } + } else { + emptyOctets = 0; + if (index == octets.length - 1 && octet.contains(".")) { + if (!isValidInetV4Address(octet)) { + return false; + } + validOctets += 2; + continue; + } + if (octet.length() > IPV6_MAX_HEX_DIGITS_PER_GROUP) { + return false; + } + int octetInt = 0; + try { + octetInt = Integer.parseInt(octet, BASE_16); + } catch (NumberFormatException e) { + return false; + } + if (octetInt < 0 || octetInt > MAX_UNSIGNED_SHORT) { + return false; + } + } + validOctets++; + } + return validOctets <= IPV6_MAX_HEX_GROUPS + && (validOctets == IPV6_MAX_HEX_GROUPS || containsCompressedZeroes); + } +} diff --git a/src/main/java/com/coditory/quark/uri/InvalidHttpUrlException.java b/src/main/java/com/coditory/quark/uri/InvalidHttpUrlException.java new file mode 100644 index 0000000..d3fe3f9 --- /dev/null +++ b/src/main/java/com/coditory/quark/uri/InvalidHttpUrlException.java @@ -0,0 +1,11 @@ +package com.coditory.quark.uri; + +public final class InvalidHttpUrlException extends RuntimeException { + InvalidHttpUrlException(String message) { + super(message); + } + + InvalidHttpUrlException(String message, Throwable cause) { + super(message, cause); + } +} diff --git a/src/main/java/com/coditory/quark/uri/InvalidUriException.java b/src/main/java/com/coditory/quark/uri/InvalidUriException.java new file mode 100644 index 0000000..79c7245 --- /dev/null +++ b/src/main/java/com/coditory/quark/uri/InvalidUriException.java @@ -0,0 +1,7 @@ +package com.coditory.quark.uri; + +public final class InvalidUriException extends RuntimeException { + InvalidUriException(String message) { + super(message); + } +} diff --git a/src/main/java/com/coditory/quark/uri/Nullable.java b/src/main/java/com/coditory/quark/uri/Nullable.java new file mode 100644 index 0000000..e55370d --- /dev/null +++ b/src/main/java/com/coditory/quark/uri/Nullable.java @@ -0,0 +1,33 @@ +package com.coditory.quark.uri; + +import java.util.function.Consumer; +import java.util.function.Function; + +import static com.coditory.quark.uri.Preconditions.expectNonNull; + +final class Nullable { + private Nullable() { + throw new UnsupportedOperationException("Do not instantiate utility class"); + } + + static R mapNotNull(T object, Function mapper) { + expectNonNull(mapper, "mapper"); + return object != null + ? mapper.apply(object) + : null; + } + + static R mapNotNull(T object, Function mapper, R defaultValue) { + expectNonNull(mapper, "mapper"); + return object != null + ? mapper.apply(object) + : defaultValue; + } + + static void onNotNull(T object, Consumer consumer) { + expectNonNull(consumer, "consumer"); + if (object != null) { + consumer.accept(object); + } + } +} diff --git a/src/main/java/com/coditory/quark/uri/PercentCodec.java b/src/main/java/com/coditory/quark/uri/PercentCodec.java new file mode 100644 index 0000000..16bf4d7 --- /dev/null +++ b/src/main/java/com/coditory/quark/uri/PercentCodec.java @@ -0,0 +1,148 @@ +package com.coditory.quark.uri; + +import org.jetbrains.annotations.NotNull; + +import java.nio.charset.Charset; +import java.util.BitSet; + +import static com.coditory.quark.uri.Preconditions.expectNonNull; +import static com.coditory.quark.uri.UriRfcCharacters.URI_UNRESERVED; +import static java.nio.charset.StandardCharsets.UTF_8; + +public final class PercentCodec { + public static final PercentCodec PERCENT_CODEC = PercentCodec.builder() + .decodeSpaceAsPlus(false) + .charset(UTF_8) + .safeCharactersAsUriUnreserved() + .build(); + + public static final PercentCodec PERCENT_PLUS_CODEC = PercentCodec.builder() + .decodeSpaceAsPlus(true) + .charset(UTF_8) + .safeCharactersAsUriUnreserved() + .build(); + + public static String encodeUriComponent(String component) { + return PERCENT_CODEC.encode(component); + } + + public static String decodeUriComponent(String component) { + return PERCENT_CODEC.decode(component); + } + + public static String encodeUriComponentWithPlusAsSpace(String component) { + return PERCENT_PLUS_CODEC.encode(component); + } + + public static String decodeUriComponentWithPlusAsSpace(String component) { + return PERCENT_PLUS_CODEC.decode(component); + } + + private final PercentEncoder encoder; + private final PercentDecoder decoder; + + PercentCodec(PercentEncoder encoder, PercentDecoder decoder) { + this.encoder = encoder; + this.decoder = decoder; + } + + @NotNull + public String encode(@NotNull String input) { + return encoder.encode(input); + } + + public boolean encode(@NotNull String input, @NotNull StringBuilder out) { + return encoder.encode(input, out); + } + + public boolean encode(@NotNull String input, @NotNull StringBuilder out, @NotNull Charset charset) { + return encoder.encode(input, out, charset); + } + + @NotNull + public String decode(@NotNull String input) { + return decoder.decode(input); + } + + public boolean decode(@NotNull String input, @NotNull StringBuilder out) { + return decoder.decode(input, out); + } + + public boolean decode(@NotNull String input, @NotNull StringBuilder out, @NotNull Charset charset) { + return decoder.decode(input, out, charset); + } + + @NotNull + public static PercentCodecBuilder builder() { + return new PercentCodecBuilder(); + } + + public static class PercentCodecBuilder { + private BitSet safeCharacters = BitSets.of(URI_UNRESERVED); + private boolean decodeSpaceAsPlus = false; + private boolean encodeSpaceAsPlus = false; + private Charset charset = UTF_8; + + @NotNull + public PercentCodecBuilder addSafeCharacters(@NotNull String safeCharacters) { + expectNonNull(safeCharacters, "safeCharacters"); + this.safeCharacters.or(BitSets.of(safeCharacters)); + return this; + } + + @NotNull + public PercentCodecBuilder safeCharacters(@NotNull String safeCharacters) { + expectNonNull(safeCharacters, "safeCharacters"); + this.safeCharacters = BitSets.of(safeCharacters); + return this; + } + + @NotNull + public PercentCodecBuilder safeCharactersAsUriUnreserved() { + return safeCharacters(URI_UNRESERVED); + } + + @NotNull + public PercentCodecBuilder decodeSpaceAsPlus(boolean spaceAsPlus) { + this.decodeSpaceAsPlus = spaceAsPlus; + return this; + } + + @NotNull + public PercentCodecBuilder encodeSpaceAsPlus(boolean spaceAsPlus) { + this.encodeSpaceAsPlus = spaceAsPlus; + return this; + } + + @NotNull + public PercentCodecBuilder spaceAsPlus(boolean spaceAsPlus) { + this.decodeSpaceAsPlus = spaceAsPlus; + this.encodeSpaceAsPlus = spaceAsPlus; + return this; + } + + @NotNull + public PercentCodecBuilder charset(Charset charset) { + expectNonNull(charset, "charset"); + this.charset = charset; + return this; + } + + @NotNull + public PercentCodec build() { + if (encodeSpaceAsPlus || decodeSpaceAsPlus) { + safeCharacters = BitSets.set(safeCharacters, '+', false); + } + PercentEncoder encoder = PercentEncoder.builder() + .safeCharacters(safeCharacters) + .spaceAsPlus(encodeSpaceAsPlus) + .charset(charset) + .build(); + PercentDecoder decoder = PercentDecoder.builder() + .spaceAsPlus(decodeSpaceAsPlus) + .charset(charset) + .build(); + return new PercentCodec(encoder, decoder); + } + } +} diff --git a/src/main/java/com/coditory/quark/uri/PercentDecoder.java b/src/main/java/com/coditory/quark/uri/PercentDecoder.java new file mode 100644 index 0000000..55f9fc3 --- /dev/null +++ b/src/main/java/com/coditory/quark/uri/PercentDecoder.java @@ -0,0 +1,107 @@ +package com.coditory.quark.uri; + +import java.nio.charset.Charset; + +import static com.coditory.quark.uri.Preconditions.expectNonNull; +import static java.nio.charset.StandardCharsets.UTF_8; + +final class PercentDecoder { + private final Charset charset; + private final boolean spaceAsPlus; + + private PercentDecoder(boolean spaceAsPlus, Charset charset) { + this.spaceAsPlus = spaceAsPlus; + this.charset = expectNonNull(charset, "charset"); + } + + String decode(String text) { + StringBuilder dst = new StringBuilder(); + decode(text, dst); + return dst.toString(); + } + + boolean decode(String text, StringBuilder dst) { + return decode(text, dst, charset); + } + + boolean decode(String text, StringBuilder dst, Charset charset) { + expectNonNull(dst, "dst"); + expectNonNull(text, "text"); + expectNonNull(charset, "charset"); + boolean needToChange = false; + int length = text.length(); + StringBuilder sb = new StringBuilder(length > 500 ? length / 2 : length); + int i = 0; + byte[] bytes = null; + while (i < length) { + char c = text.charAt(i); + switch (c) { + case '+' -> { + if (!spaceAsPlus) { + sb.append('+'); + } else { + sb.append(' '); + needToChange = true; + } + i++; + } + case '%' -> { + try { + if (bytes == null) { + bytes = new byte[(length - i) / 3]; + } + int pos = 0; + while ((i + 2) < length && c == '%') { + int v = Integer.parseInt(text, i + 1, i + 3, 16); + if (v < 0) { + throw new IllegalArgumentException("Illegal hex characters in escape (%) pattern - negative value"); + } + bytes[pos++] = (byte) v; + i += 3; + if (i < length) { + c = text.charAt(i); + } + } + if (i < length && c == '%') { + throw new IllegalArgumentException("Incomplete trailing escape (%) pattern"); + } + sb.append(new String(bytes, 0, pos, charset)); + } catch (NumberFormatException e) { + throw new IllegalArgumentException("Illegal hex characters in escape (%) pattern - " + e.getMessage()); + } + needToChange = true; + } + default -> { + sb.append(c); + i++; + } + } + } + dst.append(sb); + return needToChange; + } + + static PercentDecoderBuilder builder() { + return new PercentDecoderBuilder(); + } + + static class PercentDecoderBuilder { + private boolean spaceAsPlus = false; + private Charset charset = UTF_8; + + public PercentDecoderBuilder spaceAsPlus(boolean spaceAsPlus) { + this.spaceAsPlus = spaceAsPlus; + return this; + } + + public PercentDecoderBuilder charset(Charset charset) { + expectNonNull(charset, "charset"); + this.charset = charset; + return this; + } + + public PercentDecoder build() { + return new PercentDecoder(spaceAsPlus, charset); + } + } +} diff --git a/src/main/java/com/coditory/quark/uri/PercentEncoder.java b/src/main/java/com/coditory/quark/uri/PercentEncoder.java new file mode 100644 index 0000000..b98658a --- /dev/null +++ b/src/main/java/com/coditory/quark/uri/PercentEncoder.java @@ -0,0 +1,137 @@ +package com.coditory.quark.uri; + +import java.io.CharArrayWriter; +import java.nio.charset.Charset; +import java.util.BitSet; + +import static com.coditory.quark.uri.BitSets.unmodifiableBitSet; +import static com.coditory.quark.uri.Preconditions.expectNonNull; +import static com.coditory.quark.uri.UriRfcCharacters.URI_UNRESERVED; +import static java.nio.charset.StandardCharsets.UTF_8; + +final class PercentEncoder { + private static final int CASE_DIFF = ('a' - 'A'); + private final boolean spaceAsPlus; + private final Charset charset; + private final BitSet safeCharacters; + + private PercentEncoder(BitSet safeCharacters, boolean spaceAsPlus, Charset charset) { + this.spaceAsPlus = spaceAsPlus; + this.charset = expectNonNull(charset, "charset"); + this.safeCharacters = expectNonNull(safeCharacters, "safeCharacters"); + } + + String encode(String text) { + StringBuilder dst = new StringBuilder(); + encode(text, dst); + return dst.toString(); + } + + boolean encode(String text, StringBuilder dst) { + return encode(text, dst, charset); + } + + boolean encode(String text, StringBuilder dst, Charset charset) { + expectNonNull(dst, "dst"); + expectNonNull(text, "text"); + expectNonNull(charset, "charset"); + boolean needToChange = false; + StringBuilder out = new StringBuilder(text.length()); + CharArrayWriter charArrayWriter = new CharArrayWriter(); + + for (int i = 0; i < text.length(); ) { + int cp = text.codePointAt(i); + if (cp == ' ' && spaceAsPlus) { + out.append('+'); + needToChange = true; + i++; + } else if (safeCharacters.get(cp) && (cp != '+' || !spaceAsPlus)) { + out.appendCodePoint(cp); + i += Character.charCount(cp); + } else { + do { + char c = text.charAt(i); + charArrayWriter.write(c); + if (c >= 0xD800 && c <= 0xDBFF) { + if ((i + 1) < text.length()) { + char d = text.charAt(i + 1); + if (d >= 0xDC00 && d <= 0xDFFF) { + charArrayWriter.write(d); + i++; + } + } + } + i++; + } while (i < text.length() && !safeCharacters.get(text.codePointAt(i))); + charArrayWriter.flush(); + byte[] bytes = new String(charArrayWriter.toCharArray()) + .getBytes(charset); + for (byte aByte : bytes) { + out.append('%'); + char c = Character.forDigit((aByte >> 4) & 0xF, 16); + if (Character.isLetter(c)) { + c -= CASE_DIFF; + } + out.append(c); + c = Character.forDigit(aByte & 0xF, 16); + if (Character.isLetter(c)) { + c -= CASE_DIFF; + } + out.append(c); + } + charArrayWriter.reset(); + needToChange = true; + } + } + dst.append(out); + return needToChange; + } + + static PercentEncoderBuilder builder() { + return new PercentEncoderBuilder(); + } + + static class PercentEncoderBuilder { + private BitSet safeCharacters = BitSets.of(URI_UNRESERVED); + private boolean spaceAsPlus = false; + private Charset charset = UTF_8; + + PercentEncoderBuilder addSafeCharacters(String safeCharacters) { + expectNonNull(safeCharacters, "safeCharacters"); + return safeCharacters(BitSets.of(safeCharacters)); + } + + PercentEncoderBuilder safeCharactersAsUriUnreserved() { + return safeCharacters(URI_UNRESERVED); + } + + PercentEncoderBuilder safeCharacters(BitSet safeCharacters) { + expectNonNull(safeCharacters, "safeCharacters"); + this.safeCharacters = unmodifiableBitSet(safeCharacters); + return this; + } + + PercentEncoderBuilder safeCharacters(String safeCharacters) { + expectNonNull(safeCharacters, "safeCharacters"); + return safeCharacters(BitSets.of(safeCharacters)); + } + + PercentEncoderBuilder spaceAsPlus(boolean spaceAsPlus) { + this.spaceAsPlus = spaceAsPlus; + return this; + } + + PercentEncoderBuilder charset(Charset charset) { + expectNonNull(charset, "charset"); + this.charset = charset; + return this; + } + + PercentEncoder build() { + if (spaceAsPlus) { + safeCharacters = BitSets.set(safeCharacters, '+', false); + } + return new PercentEncoder(safeCharacters, spaceAsPlus, charset); + } + } +} diff --git a/src/main/java/com/coditory/quark/uri/Ports.java b/src/main/java/com/coditory/quark/uri/Ports.java new file mode 100644 index 0000000..5b6e2bb --- /dev/null +++ b/src/main/java/com/coditory/quark/uri/Ports.java @@ -0,0 +1,82 @@ +package com.coditory.quark.uri; + +import java.io.IOException; +import java.net.DatagramSocket; +import java.net.ServerSocket; + +import static com.coditory.quark.uri.Preconditions.expect; + +public final class Ports { + private Ports() { + throw new UnsupportedOperationException("Do not instantiate utility class"); + } + + public final static int SCHEME_DEFAULT_PORT_NUMBER = -1; + public final static int MIN_PORT_VALUE = 0; + public final static int MAX_PORT_VALUE = 65535; + + public static boolean isValidPortNumberOrSchemeDefault(int port) { + return port >= SCHEME_DEFAULT_PORT_NUMBER && port <= MAX_PORT_VALUE; + } + + public static boolean isValidPortNumber(int port) { + return port >= MIN_PORT_VALUE && port <= MAX_PORT_VALUE; + } + + public static boolean isSchemeDefault(int port) { + return port == SCHEME_DEFAULT_PORT_NUMBER; + } + + public static void validatePortNumberOrSchemeDefault(int port) { + if (!isValidPortNumberOrSchemeDefault(port)) { + String message = String.format("Expected port number in range [%d, %d]. Got: %d", + SCHEME_DEFAULT_PORT_NUMBER, MAX_PORT_VALUE, port); + throw new IllegalArgumentException(message); + } + } + + public static void validatePortNumber(int port) { + if (!isValidPortNumber(port)) { + String message = String.format("Expected port number in range [%d, %d]. Got: %d", + MIN_PORT_VALUE, MAX_PORT_VALUE, port); + throw new IllegalArgumentException(message); + } + } + + public static int nextAvailablePort() { + try { + try (ServerSocket socket = new ServerSocket(0)) { + return socket.getLocalPort(); + } + } catch (IOException exception) { + throw new IllegalStateException("Could not get available port", exception); + } + } + + public static int nextAvailablePort(int min, int max) { + expect(min <= max, "Expected min <= max. Got: %d > %d", min, max); + validatePortNumber(min); + validatePortNumber(max); + for (int port = min; port <= max; ++port) { + if (isPortAvailable(port)) { + return port; + } + } + throw new IllegalStateException("Could not get available port between: " + min + " and " + max); + } + + public static boolean isPortAvailable(int port) { + validatePortNumber(port); + try { + try (ServerSocket socket = new ServerSocket(port)) { + socket.setReuseAddress(true); + try (DatagramSocket datagramSocket = new DatagramSocket(port)) { + datagramSocket.setReuseAddress(true); + return true; + } + } + } catch (IOException e) { + return false; + } + } +} diff --git a/src/main/java/com/coditory/quark/uri/Preconditions.java b/src/main/java/com/coditory/quark/uri/Preconditions.java new file mode 100644 index 0000000..9f9642d --- /dev/null +++ b/src/main/java/com/coditory/quark/uri/Preconditions.java @@ -0,0 +1,62 @@ +package com.coditory.quark.uri; + +import org.jetbrains.annotations.Nullable; + +import java.util.Objects; + +final class Preconditions { + private Preconditions() { + throw new UnsupportedOperationException("Do not instantiate utility class"); + } + + static void expect(boolean check, String message, Object... args) { + if (!check) { + throw new IllegalArgumentException(String.format(message, args)); + } + } + + static T expectNonNull(@Nullable T value, String name) { + if (value == null) { + String message = message("Expected non-null value", name); + throw new IllegalArgumentException(message); + } + return value; + } + + static String expectNonEmpty(@Nullable String value, String name) { + if (value == null || value.isEmpty()) { + String message = message("Expected non-null and non-empty value", name, value); + throw new IllegalArgumentException(message); + } + return value; + } + + static String expectNonBlank(@Nullable String value, String name) { + if (value == null || value.isBlank()) { + String message = message("Expected non-null and non-blank value", name, value); + throw new IllegalArgumentException(message); + } + return value; + } + + static String expectNoWhitespaces(@Nullable String value, String name) { + if (value == null || Strings.containsWhitespace(value)) { + String message = message("Expected non-null value with no whitespaces", name, value); + throw new IllegalArgumentException(message); + } + return value; + } + + private static String message(String expectation, String fieldName, Object value) { + String field = fieldName != null ? (": " + fieldName) : ""; + String stringValue = value instanceof String + ? ("\"" + value + "\"") + : Objects.toString(value); + return expectation + field + ". Got: " + stringValue; + } + + private static String message(String expectation, String fieldName) { + String field = fieldName != null ? (": " + fieldName) : ""; + return expectation + field; + } +} diff --git a/src/main/java/com/coditory/quark/uri/Strings.java b/src/main/java/com/coditory/quark/uri/Strings.java new file mode 100644 index 0000000..2b9955e --- /dev/null +++ b/src/main/java/com/coditory/quark/uri/Strings.java @@ -0,0 +1,49 @@ +package com.coditory.quark.uri; + +import java.util.Locale; + +import static com.coditory.quark.uri.Preconditions.expectNonNull; + +final class Strings { + private Strings() { + throw new UnsupportedOperationException("Do not instantiate utility class"); + } + + static boolean isNullOrEmpty(String text) { + return text == null || text.isEmpty(); + } + + static boolean isNotNullOrEmpty(String text) { + return !isNullOrEmpty(text); + } + + static boolean isNullOrBlank(String text) { + return text == null || text.isBlank(); + } + + static boolean isNotNullOrBlank(String text) { + return !isNullOrBlank(text); + } + + static String emptyToNull(String text) { + return text == null || text.isEmpty() + ? null + : text; + } + + static String blankToNull(String text) { + return text == null || text.isBlank() + ? null + : text; + } + + static String lowerCase(String text) { + expectNonNull(text, "text"); + return text.toLowerCase(Locale.ROOT); + } + + public static boolean containsWhitespace(String text) { + expectNonNull(text, "text"); + return text.codePoints().anyMatch(Character::isWhitespace); + } +} diff --git a/src/main/java/com/coditory/quark/uri/Throwables.java b/src/main/java/com/coditory/quark/uri/Throwables.java new file mode 100644 index 0000000..7e3dbb1 --- /dev/null +++ b/src/main/java/com/coditory/quark/uri/Throwables.java @@ -0,0 +1,40 @@ +package com.coditory.quark.uri; + +import java.util.ArrayList; +import java.util.Collections; +import java.util.HashSet; +import java.util.List; +import java.util.Set; + +import static com.coditory.quark.uri.Preconditions.expectNonNull; + +final class Throwables { + private Throwables() { + throw new UnsupportedOperationException("Do not instantiate utility class"); + } + + @SuppressWarnings("unchecked") + static T getRootCauseOfType(Throwable throwable, Class type) { + expectNonNull(throwable, "throwable"); + expectNonNull(type, "type"); + List list = getCauses(throwable); + Collections.reverse(list); + Throwable result = list.stream() + .filter(type::isInstance) + .findFirst() + .orElse(null); + return (T) result; + } + + static List getCauses(Throwable throwable) { + expectNonNull(throwable, "throwable"); + List list = new ArrayList<>(); + Set visited = new HashSet<>(); + while (throwable != null && !visited.contains(throwable)) { + list.add(throwable); + visited.add(throwable); + throwable = throwable.getCause(); + } + return list; + } +} diff --git a/src/main/java/com/coditory/quark/uri/UriAuthority.java b/src/main/java/com/coditory/quark/uri/UriAuthority.java new file mode 100644 index 0000000..a8c68b3 --- /dev/null +++ b/src/main/java/com/coditory/quark/uri/UriAuthority.java @@ -0,0 +1,97 @@ +package com.coditory.quark.uri; + +import org.jetbrains.annotations.NotNull; +import org.jetbrains.annotations.Nullable; + +import java.util.Locale; +import java.util.Objects; + +import static com.coditory.quark.uri.Nullable.mapNotNull; +import static com.coditory.quark.uri.Ports.SCHEME_DEFAULT_PORT_NUMBER; +import static com.coditory.quark.uri.Ports.validatePortNumberOrSchemeDefault; +import static com.coditory.quark.uri.Preconditions.expectNoWhitespaces; +import static com.coditory.quark.uri.Preconditions.expectNonEmpty; + +public final class UriAuthority { + private static final UriAuthority EMPTY = new UriAuthority(null, null, SCHEME_DEFAULT_PORT_NUMBER); + + @NotNull + public static UriAuthority empty() { + return EMPTY; + } + + @NotNull + public static UriAuthority of(@Nullable String userInfo, @Nullable String hostname, int port) { + if (hostname != null) { + expectNoWhitespaces(hostname, "hostname"); + } + if (userInfo != null) { + expectNonEmpty(userInfo, "userInfo"); + } + validatePortNumberOrSchemeDefault(port); + if (userInfo == null && hostname == null && Ports.isSchemeDefault(port)) { + return empty(); + } + return new UriAuthority( + userInfo, + mapNotNull(hostname, h -> h.toLowerCase(Locale.ROOT)), + port + ); + } + + private final String userInfo; + private final String hostname; + private final int port; + + private UriAuthority(@Nullable String userInfo, @Nullable String hostname, int port) { + this.userInfo = userInfo; + this.hostname = hostname; + this.port = port; + } + + @Nullable + public String getUserInfo() { + return userInfo; + } + + @Nullable + public String getHostname() { + return hostname; + } + + public int getPort() { + return port; + } + + public boolean usesSchemeDefaultPort() { + return port == SCHEME_DEFAULT_PORT_NUMBER; + } + + public boolean isEmpty() { + return this.equals(EMPTY); + } + + @Override + public String toString() { + return "UriAuthority{" + + "userInfo='" + userInfo + '\'' + + ", hostname='" + hostname + '\'' + + ", port=" + port + + '}'; + } + + @Override + public boolean equals(Object o) { + if (this == o) return true; + if (o == null || getClass() != o.getClass()) return false; + UriAuthority that = (UriAuthority) o; + return port == that.port + && Objects.equals(userInfo, that.userInfo) + && Objects.equals(hostname, that.hostname); + } + + @Override + public int hashCode() { + return Objects.hash(userInfo, hostname, port); + } +} diff --git a/src/main/java/com/coditory/quark/uri/UriBuilder.java b/src/main/java/com/coditory/quark/uri/UriBuilder.java new file mode 100644 index 0000000..4ae37b9 --- /dev/null +++ b/src/main/java/com/coditory/quark/uri/UriBuilder.java @@ -0,0 +1,494 @@ +package com.coditory.quark.uri; + +import org.jetbrains.annotations.NotNull; +import org.jetbrains.annotations.Nullable; + +import java.net.URI; +import java.net.URL; +import java.util.ArrayList; +import java.util.Arrays; +import java.util.Collection; +import java.util.LinkedHashMap; +import java.util.List; +import java.util.Map; +import java.util.Objects; + +import static com.coditory.quark.uri.Ports.SCHEME_DEFAULT_PORT_NUMBER; +import static com.coditory.quark.uri.Ports.validatePortNumberOrSchemeDefault; +import static com.coditory.quark.uri.Preconditions.expectNonBlank; +import static com.coditory.quark.uri.Preconditions.expectNonNull; +import static com.coditory.quark.uri.Strings.emptyToNull; +import static com.coditory.quark.uri.Strings.isNotNullOrBlank; +import static com.coditory.quark.uri.Strings.isNotNullOrEmpty; +import static com.coditory.quark.uri.Strings.isNullOrEmpty; +import static com.coditory.quark.uri.Strings.lowerCase; +import static com.coditory.quark.uri.UriComponentsParser.parseQuery; +import static com.coditory.quark.uri.UriRfc.PATH_SEGMENT; + +public final class UriBuilder { + @NotNull + public static UriBuilder from(@NotNull UriComponents uriComponents) { + expectNonNull(uriComponents, "uriComponents"); + UriBuilder builder = new UriBuilder(); + builder.scheme = uriComponents.getScheme(); + builder.ssp = uriComponents.getSchemeSpecificPart(); + builder.fragment = uriComponents.getFragment(); + if (!uriComponents.isOpaque()) { + builder.userInfo = uriComponents.getUserInfo(); + builder.protocolRelative = uriComponents.isProtocolRelative(); + builder.host = uriComponents.getHost(); + builder.port = uriComponents.getPort(); + builder.setRootPath(uriComponents.isRootPath()); + builder.setPathSegments(uriComponents.getPathSegments()); + builder.setQueryMultiParams(uriComponents.getQueryParams()); + } + return builder; + } + + @NotNull + public static UriBuilder from(@NotNull URI uri) { + expectNonNull(uri, "uri"); + return new UriBuilder().setUri(uri); + } + + @NotNull + public static UriBuilder from(@NotNull URL url) { + expectNonNull(url, "url"); + URI uri; + try { + uri = url.toURI(); + } catch (Exception e) { + throw new IllegalArgumentException("Could not convert url to uri", e); + } + return new UriBuilder().setUri(uri); + } + + @NotNull + public static UriBuilder fromUri(@NotNull String uri) { + expectNonNull(uri, "uri"); + return UriComponentsParser.parseUri(uri); + } + + @Nullable + public static UriBuilder fromUriOrNull(@Nullable String uri) { + if (uri == null) { + return null; + } + try { + return fromUri(uri); + } catch (RuntimeException e) { + return null; + } + } + + @NotNull + public static UriBuilder fromHttpUrl(@NotNull String url) { + expectNonNull(url, "url"); + return UriComponentsParser.parseHttpUrl(url); + } + + @Nullable + public static UriBuilder fromHttpUrlOrNull(@Nullable String url) { + if (url == null) { + return null; + } + try { + return fromHttpUrl(url); + } catch (RuntimeException e) { + return null; + } + } + + private String scheme; + private String ssp; + private String userInfo; + private String host; + private int port = SCHEME_DEFAULT_PORT_NUMBER; + private boolean protocolRelative = false; + private boolean rootPath = false; + private final List pathSegments = new ArrayList<>(); + private final Map> queryParams = new LinkedHashMap<>(); + private String fragment; + + UriBuilder() { + } + + @NotNull + public UriBuilder setUri(@NotNull URI uri) { + expectNonNull(uri, "uri"); + this.scheme = uri.getScheme(); + if (uri.isOpaque()) { + this.ssp = uri.getRawSchemeSpecificPart(); + resetHierarchicalComponents(); + } else { + if (uri.getRawUserInfo() != null) { + this.userInfo = uri.getRawUserInfo(); + } + if (uri.getHost() != null) { + this.host = uri.getHost(); + } + if (uri.getPort() != -1) { + this.port = uri.getPort(); + } + if (isNotNullOrEmpty(uri.getRawPath())) { + setPath(uri.getRawPath()); + } + if (isNotNullOrEmpty(uri.getRawQuery())) { + this.queryParams.clear(); + setQuery(uri.getRawQuery()); + } + resetSchemeSpecificPart(); + } + if (uri.getRawFragment() != null) { + this.fragment = uri.getRawFragment(); + } + return this; + } + + @NotNull + public UriBuilder copy() { + return from(buildUriComponents()); + } + + @NotNull + public UriComponents buildUriComponents() { + return this.ssp != null + ? UriComponents.buildOpaque(scheme, ssp, fragment) + : UriComponents.buildHierarchical(scheme, userInfo, host, port, protocolRelative, rootPath, pathSegments, queryParams, fragment); + } + + @NotNull + public URI buildUri() { + return buildUriComponents().toUri(); + } + + @NotNull + public String buildUriString() { + return buildUriComponents().toUriString(); + } + + @NotNull + public UriBuilder setScheme(@Nullable String scheme) { + if (isNotNullOrBlank(scheme)) { + if (scheme.equals("//")) { + this.scheme = null; + this.protocolRelative = true; + } else { + this.scheme = lowerCase(scheme); + this.protocolRelative = false; + } + resetSchemeSpecificPart(); + } else { + this.scheme = null; + } + return this; + } + + @NotNull + public UriBuilder setProtocolRelative(boolean protocolRelative) { + this.scheme = null; + this.protocolRelative = protocolRelative; + return this; + } + + @NotNull + public UriBuilder removeScheme() { + this.scheme = null; + return this; + } + + @NotNull + public UriBuilder setSchemeSpecificPart(@Nullable String ssp) { + if (isNotNullOrBlank(ssp)) { + this.ssp = ssp; + resetHierarchicalComponents(); + } else { + this.ssp = null; + } + return this; + } + + @NotNull + public UriBuilder removeSchemeSpecificPart() { + this.ssp = null; + return this; + } + + @NotNull + public UriBuilder setUserInfo(@Nullable String userInfo) { + if (isNotNullOrBlank(userInfo)) { + this.userInfo = userInfo; + resetSchemeSpecificPart(); + } else { + this.userInfo = null; + } + return this; + } + + @NotNull + public UriBuilder removeUserInfo() { + this.userInfo = null; + return this; + } + + @NotNull + public UriBuilder setHost(@Nullable String host) { + if (isNotNullOrBlank(host)) { + this.host = lowerCase(host); + this.rootPath = true; + resetSchemeSpecificPart(); + } else { + this.host = null; + } + return this; + } + + @NotNull + public UriBuilder removeHost() { + this.host = null; + return this; + } + + @NotNull + public UriBuilder setDefaultPort() { + this.port = -1; + return this; + } + + @NotNull + public UriBuilder setPort(int port) { + validatePortNumberOrSchemeDefault(port); + this.port = port; + if (port > -1) { + resetSchemeSpecificPart(); + } + return this; + } + + @NotNull + public UriBuilder setPath(@Nullable String path) { + this.pathSegments.clear(); + this.rootPath = this.host != null; + addSubPath(path); + return this; + } + + @NotNull + public UriBuilder addSubPath(@Nullable String subPath) { + if (isNotNullOrEmpty(subPath)) { + if (this.pathSegments.isEmpty()) { + rootPath = subPath.startsWith("/") || this.host != null; + } + List newSegments = Arrays.stream(subPath.split("/")) + .filter(Strings::isNotNullOrEmpty) + .map(PATH_SEGMENT::validateAndDecode) + .toList(); + this.pathSegments.addAll(newSegments); + if (!newSegments.isEmpty()) { + resetSchemeSpecificPart(); + } + } + return this; + } + + @NotNull + public UriBuilder setRootPath(boolean rootPath) { + this.rootPath = rootPath; + resetSchemeSpecificPart(); + return this; + } + + @NotNull + public UriBuilder setPathSegments(@NotNull List pathSegments) { + expectNonNull(pathSegments, "pathSegments"); + this.pathSegments.clear(); + addPathSegments(pathSegments); + return this; + } + + @NotNull + public UriBuilder addPathSegment(@Nullable String pathSegment) { + if (isNullOrEmpty(pathSegment)) { + return this; + } + addPathSegments(List.of(pathSegment)); + return this; + } + + @NotNull + public UriBuilder addPathSegments(@Nullable List pathSegments) { + expectNonNull(pathSegments, "pathSegments"); + List filtered = pathSegments.stream() + .filter(Strings::isNotNullOrEmpty) + .toList(); + this.pathSegments.addAll(filtered); + if (!filtered.isEmpty()) { + resetSchemeSpecificPart(); + } + return this; + } + + @NotNull + public UriBuilder setQuery(@NotNull String query) { + expectNonNull(query, "query"); + setQueryMultiParams(parseQuery(query)); + return this; + } + + @NotNull + public UriBuilder setQueryParams(@NotNull Map params) { + expectNonNull(params, "params"); + this.queryParams.clear(); + params.forEach(this::putQueryParam); + return this; + } + + @NotNull + public UriBuilder setQueryMultiParams(@NotNull Map> params) { + expectNonNull(params, "params"); + this.queryParams.clear(); + params.forEach(this::putQueryParam); + return this; + } + + @NotNull + public UriBuilder putQueryParams(@NotNull Map params) { + expectNonNull(params, "params"); + params.entrySet().stream() + .filter(e -> isNotNullOrBlank(e.getKey())) + .forEach(entry -> putQueryParam(entry.getKey(), entry.getValue())); + return this; + } + + @NotNull + public UriBuilder putQueryMultiParams(@NotNull Map> params) { + expectNonNull(params, "params"); + params.entrySet().stream() + .filter(e -> isNotNullOrBlank(e.getKey())) + .filter(e -> e.getValue() != null) + .forEach(entry -> putQueryParam(entry.getKey(), entry.getValue())); + return this; + } + + @NotNull + public UriBuilder putQueryParam(@NotNull String name, @NotNull String value) { + expectNonBlank(name, "name"); + expectNonNull(value, "value"); + List values = new ArrayList<>(); + values.add(value); + return putQueryParam(name, values); + } + + @NotNull + public UriBuilder putQueryParam(@NotNull String name, @NotNull Collection values) { + expectNonBlank(name, "name"); + expectNonNull(values, "values"); + if (values.isEmpty()) { + this.queryParams.remove(name); + } else { + this.queryParams.put(name, new ArrayList<>(values)); + } + resetSchemeSpecificPart(); + return this; + } + + @NotNull + public UriBuilder addQueryParams(@NotNull Map params) { + expectNonNull(params, "params"); + params.entrySet().stream() + .filter(e -> isNotNullOrBlank(e.getKey())) + .forEach(entry -> addQueryParam(entry.getKey(), entry.getValue())); + resetSchemeSpecificPart(); + return this; + } + + @NotNull + public UriBuilder addQueryMultiParams(@NotNull Map> params) { + expectNonNull(params, "params"); + params.entrySet().stream() + .filter(e -> isNotNullOrBlank(e.getKey())) + .filter(e -> e.getValue() != null && !e.getValue().isEmpty()) + .forEach(entry -> addQueryParam(entry.getKey(), entry.getValue())); + resetSchemeSpecificPart(); + return this; + } + + @NotNull + public UriBuilder addQueryParam(@NotNull String name, @NotNull String value) { + expectNonBlank(name, "name"); + expectNonNull(value, "value"); + return addQueryParam(name, List.of(value)); + } + + @NotNull + public UriBuilder addQueryParam(@NotNull String name, @NotNull Collection values) { + expectNonBlank(name, "name"); + expectNonNull(values, "values"); + List noNullValues = values.stream() + .filter(Objects::nonNull) + .toList(); + if (noNullValues.isEmpty()) { + return this; + } + this.queryParams.compute(name, (key, prevValues) -> { + List result = prevValues != null + ? prevValues + : new ArrayList<>(); + result.addAll(noNullValues); + return result; + }); + resetSchemeSpecificPart(); + return this; + } + + @NotNull + public UriBuilder removeQueryParams() { + this.queryParams.clear(); + return this; + } + + @NotNull + public UriBuilder removeQueryParam(@NotNull String name) { + expectNonNull(name, "name"); + this.queryParams.remove(name); + return this; + } + + @NotNull + public UriBuilder removeQueryParam(@NotNull String name, @Nullable String value) { + expectNonNull(name, "name"); + List values = this.queryParams.get(name); + if (values != null && value != null) { + values.remove(value); + } + return this; + } + + @NotNull + public UriBuilder setFragment(@Nullable String fragment) { + this.fragment = emptyToNull(fragment); + return this; + } + + @NotNull + public UriBuilder removeFragment() { + this.fragment = null; + return this; + } + + private void resetHierarchicalComponents() { + this.userInfo = null; + this.host = null; + this.port = SCHEME_DEFAULT_PORT_NUMBER; + this.pathSegments.clear(); + this.queryParams.clear(); + } + + private void resetSchemeSpecificPart() { + this.ssp = null; + } + + void validate() { + buildUriComponents(); + } +} diff --git a/src/main/java/com/coditory/quark/uri/UriComponents.java b/src/main/java/com/coditory/quark/uri/UriComponents.java new file mode 100644 index 0000000..f296626 --- /dev/null +++ b/src/main/java/com/coditory/quark/uri/UriComponents.java @@ -0,0 +1,424 @@ +package com.coditory.quark.uri; + +import org.jetbrains.annotations.NotNull; +import org.jetbrains.annotations.Nullable; + +import java.net.URI; +import java.net.URL; +import java.util.LinkedHashMap; +import java.util.List; +import java.util.Map; +import java.util.Objects; +import java.util.stream.Stream; + +import static com.coditory.quark.uri.Nullable.mapNotNull; +import static com.coditory.quark.uri.Nullable.onNotNull; +import static com.coditory.quark.uri.Preconditions.expectNonBlank; +import static com.coditory.quark.uri.Preconditions.expectNonNull; +import static com.coditory.quark.uri.Strings.isNotNullOrEmpty; +import static com.coditory.quark.uri.Strings.isNullOrEmpty; +import static com.coditory.quark.uri.UriPartValidator.checkPort; +import static com.coditory.quark.uri.UriRfc.FRAGMENT; +import static com.coditory.quark.uri.UriRfc.PATH_SEGMENT; +import static com.coditory.quark.uri.UriRfc.QUERY_PARAM; +import static com.coditory.quark.uri.UriRfc.SCHEME; +import static com.coditory.quark.uri.UriRfc.SCHEME_SPECIFIC_PART; +import static com.coditory.quark.uri.UriRfc.USER_INFO; +import static java.util.Collections.unmodifiableMap; +import static java.util.stream.Collectors.joining; +import static java.util.stream.Collectors.toMap; + +public final class UriComponents { + @NotNull + public static UriComponents fromUri(@NotNull String uri) { + expectNonNull(uri, "uri"); + return builderFromUri(uri).buildUriComponents(); + } + + @Nullable + public static UriComponents fromUriOrNull(@Nullable String uri) { + if (uri == null) { + return null; + } + try { + return fromUri(uri); + } catch (RuntimeException e) { + return null; + } + } + + @NotNull + public static UriComponents fromHttpUrl(@NotNull String url) { + expectNonNull(url, "url"); + return builderFromHttpUrl(url).buildUriComponents(); + } + + @Nullable + static UriComponents fromHttpUrlOrNull(@Nullable String url) { + if (url == null) { + return null; + } + try { + return fromHttpUrl(url); + } catch (RuntimeException e) { + return null; + } + } + + @NotNull + public static UriComponents from(@NotNull URI uri) { + expectNonNull(uri, "uri"); + return builderFrom(uri).buildUriComponents(); + } + + @NotNull + public static UriComponents from(@NotNull URL url) { + expectNonNull(url, "url"); + return builderFrom(url).buildUriComponents(); + } + + @NotNull + public static UriBuilder builder() { + return new UriBuilder(); + } + + @NotNull + public static UriBuilder builderFrom(@NotNull UriComponents uriComponents) { + expectNonNull(uriComponents, "uriComponents"); + return UriBuilder.from(uriComponents); + } + + @NotNull + public static UriBuilder builderFrom(@NotNull URL url) { + expectNonNull(url, "url"); + return UriBuilder.from(url); + } + + @NotNull + public static UriBuilder builderFrom(@NotNull URI uri) { + expectNonNull(uri, "uri"); + return UriBuilder.from(uri); + } + + @NotNull + public static UriBuilder builderFromUri(@NotNull String uri) { + expectNonNull(uri, "uri"); + return UriBuilder.fromUri(uri); + } + + @NotNull + public static UriBuilder builderFromHttpUrl(@NotNull String url) { + expectNonNull(url, "url"); + return UriBuilder.fromHttpUrl(url); + } + + static UriComponents buildOpaque( + String scheme, + String ssp, + @Nullable String fragment + ) { + expectNonBlank(scheme, "scheme"); + expectNonBlank(ssp, "ssp"); + return new UriComponents(scheme, ssp, null, null, -1, false, false, null, null, fragment); + } + + static UriComponents buildHierarchical( + @Nullable String scheme, + @Nullable String userInfo, + @Nullable String host, + int port, + boolean protocolRelative, + boolean rootRelative, + @Nullable List pathSegments, + @Nullable Map> queryParams, + @Nullable String fragment + ) { + if (isNullOrEmpty(host)) { + if (isNotNullOrEmpty(userInfo)) { + throw new InvalidUriException("URI with user info must include host"); + } + if (port >= 0) { + throw new InvalidUriException("URI with port must include host"); + } + } + if (scheme != null && protocolRelative) { + throw new InvalidUriException("URI cannot be protocol relative and have a scheme"); + } + onNotNull(scheme, UriPartValidator::checkScheme); + onNotNull(host, UriPartValidator::checkHost); + if (port >= 0) { + checkPort(port); + } + return new UriComponents(scheme, null, userInfo, host, port, protocolRelative, rootRelative, pathSegments, queryParams, fragment); + } + + private final String ssp; + private final String scheme; + private final String userInfo; + private final String host; + private final int port; + private final boolean protocolRelative; + private final boolean rootPath; + private final List pathSegments; + private final Map> queryParams; + private final String fragment; + + private UriComponents( + String scheme, + String ssp, + String userInfo, + String host, + int port, + boolean protocolRelative, + boolean rootPath, List pathSegments, + Map> queryParams, + String fragment + ) { + this.scheme = scheme; + this.ssp = ssp; + this.userInfo = userInfo; + this.host = host; + this.port = port; + this.protocolRelative = protocolRelative; + this.rootPath = rootPath; + this.pathSegments = pathSegments == null ? List.of() : List.copyOf(pathSegments); + this.queryParams = queryParams == null ? Map.of() : unmodifiableMap(new LinkedHashMap<>(queryParams)); + this.fragment = fragment; + } + + public boolean isOpaque() { + return ssp != null; + } + + @Nullable + public String getSchemeSpecificPart() { + return ssp; + } + + @Nullable + public String getScheme() { + return scheme; + } + + @Nullable + public String getUserInfo() { + return userInfo; + } + + @Nullable + public String getHost() { + return host; + } + + public int getPort() { + return port; + } + + public boolean isRootPath() { + return rootPath; + } + + public boolean isProtocolRelative() { + return protocolRelative; + } + + @NotNull + public List getPathSegments() { + return pathSegments; + } + + @NotNull + public Map> getQueryParams() { + return queryParams; + } + + @NotNull + public Map getSingleValueQueryParams() { + return queryParams.entrySet() + .stream() + .collect(toMap(Map.Entry::getKey, e -> e.getValue().get(0))); + } + + @Nullable + public UriAuthority getUriAuthority() { + if (isOpaque()) { + return null; + } + UriAuthority authority = UriAuthority.of(userInfo, host, port); + return authority.isEmpty() ? null : authority; + } + + @Nullable + public String getQueryString() { + if (this.queryParams.isEmpty()) { + return null; + } + StringBuilder queryBuilder = new StringBuilder(); + this.queryParams.forEach((name, values) -> { + if (values == null || values.isEmpty()) { + if (queryBuilder.length() != 0) { + queryBuilder.append('&'); + } + queryBuilder.append(QUERY_PARAM.encode(name)); + } else { + for (Object value : values) { + if (queryBuilder.length() != 0) { + queryBuilder.append('&'); + } + queryBuilder.append(QUERY_PARAM.encode(name)) + .append('=') + .append(QUERY_PARAM.encode(value.toString())); + } + } + }); + return queryBuilder.toString(); + } + + @Nullable + public String getPath() { + if (pathSegments.isEmpty()) { + return null; + } + String path = pathSegments.stream() + .map(PATH_SEGMENT::encode) + .collect(joining("/")); + String prefix = rootPath ? "/" : ""; + return prefix + path; + } + + @Nullable + public String getFragment() { + return fragment; + } + + public boolean isHttpUrl() { + return !isOpaque() && ("http".equals(scheme) || "https".equals(scheme)); + } + + public boolean isValidHttpUrl() { + return UrlValidator.isValidUrl(this); + } + + @NotNull + public URL toUrl() { + try { + return new URL(toUriString()); + } catch (Exception e) { + throw new IllegalStateException("Could not build URI", e); + } + } + + @NotNull + public URI toUri() { + try { + return new URI(toUriString()); + } catch (Exception e) { + throw new IllegalStateException("Could not build URI", e); + } + } + + @NotNull + public String toUriString() { + return ssp != null + ? toOpaqueUriString() + : toHierarchicalUriString(); + } + + private String toOpaqueUriString() { + StringBuilder uriBuilder = new StringBuilder(); + if (scheme != null) { + uriBuilder.append(SCHEME.encode(scheme)) + .append(':'); + } + uriBuilder.append(SCHEME_SPECIFIC_PART.encode(ssp)); + if (fragment != null) { + uriBuilder.append('#') + .append(FRAGMENT.encode(fragment)); + } + return uriBuilder.toString(); + } + + private String toHierarchicalUriString() { + StringBuilder uriBuilder = new StringBuilder(); + if (scheme != null) { + uriBuilder.append(SCHEME.encode(scheme)) + .append("://"); + } else if (protocolRelative) { + uriBuilder.append("//"); + } + if (userInfo != null || host != null) { + if (userInfo != null) { + uriBuilder.append(USER_INFO.encode(this.userInfo)) + .append('@'); + } + if (host != null) { + uriBuilder.append(this.host); + } + if (port != -1) { + uriBuilder.append(':') + .append(this.port); + } + } + String path = getPath(); + String query = getQueryString(); + if (path != null) { + if (!path.equals("/") || query != null || fragment != null || host == null) { + uriBuilder.append(path); + } + } else if (rootPath && host == null) { + uriBuilder.append("/"); + } + if (query != null) { + uriBuilder.append('?') + .append(query); + } + if (fragment != null) { + uriBuilder.append('#') + .append(FRAGMENT.encode(fragment)); + } + return uriBuilder.toString(); + } + + @Override + public boolean equals(Object o) { + if (this == o) return true; + if (o == null || getClass() != o.getClass()) return false; + UriComponents that = (UriComponents) o; + return port == that.port + && protocolRelative == that.protocolRelative + && rootPath == that.rootPath + && Objects.equals(ssp, that.ssp) + && Objects.equals(scheme, that.scheme) + && Objects.equals(userInfo, that.userInfo) + && Objects.equals(host, that.host) + && Objects.equals(pathSegments, that.pathSegments) + && Objects.equals(queryParams, that.queryParams) + && Objects.equals(fragment, that.fragment); + } + + @Override + public int hashCode() { + return Objects.hash( + ssp, scheme, userInfo, host, port, protocolRelative, rootPath, pathSegments, queryParams, fragment + ); + } + + @Override + public String toString() { + String content = Stream.of( + mapNotNull(ssp, it -> "ssp=\"" + it + '"', ""), + mapNotNull(scheme, it -> "scheme=\"" + it + '"', ""), + mapNotNull(userInfo, it -> "userInfo=\"" + it + '"', ""), + mapNotNull(host, it -> "host=\"" + it + '"', ""), + port != Ports.SCHEME_DEFAULT_PORT_NUMBER ? ("port=" + port) : "", + protocolRelative ? "protocolRelative=true" : "", + host == null && rootPath ? "rootPath=true" : "", + !pathSegments.isEmpty() ? "pathSegments=" + pathSegments : "", + !queryParams.isEmpty() ? "queryParams=" + queryParams : "", + mapNotNull(fragment, it -> "fragment=\"" + it + '"', "") + ) + .filter(chunk -> !chunk.isEmpty()) + .collect(joining(", ")); + return "UriComponents{" + content + '}'; + } +} diff --git a/src/main/java/com/coditory/quark/uri/UriComponentsParser.java b/src/main/java/com/coditory/quark/uri/UriComponentsParser.java new file mode 100644 index 0000000..54e714f --- /dev/null +++ b/src/main/java/com/coditory/quark/uri/UriComponentsParser.java @@ -0,0 +1,147 @@ +package com.coditory.quark.uri; + +import java.util.ArrayList; +import java.util.LinkedHashMap; +import java.util.List; +import java.util.Map; +import java.util.regex.Matcher; +import java.util.regex.Pattern; + +import static com.coditory.quark.uri.Nullable.onNotNull; +import static com.coditory.quark.uri.Preconditions.expectNonNull; +import static com.coditory.quark.uri.Strings.isNotNullOrEmpty; + +class UriComponentsParser { + private static final Pattern QUERY_PARAM_PATTERN = Pattern.compile("([^&=]+)(=?)([^&]+)?"); + private static final String SCHEME_PATTERN = "([^:/?#]+):"; + private static final String USERINFO_PATTERN = "([^@\\[/?#]*)"; + private static final String HOST_IPV4_PATTERN = "[^\\[/?#:]*"; + private static final String HOST_IPV6_PATTERN = "\\[[\\p{XDigit}:.]*[%\\p{Alnum}]*]"; + private static final String HOST_PATTERN = "(" + HOST_IPV6_PATTERN + "|" + HOST_IPV4_PATTERN + ")"; + private static final String PORT_PATTERN = "([^/?#]*)"; + private static final String PATH_PATTERN = "([^?#]*)"; + private static final String QUERY_PATTERN = "([^#]*)"; + private static final String LAST_PATTERN = "(.*)"; + + // Regex patterns that matches URIs. See RFC 3986, appendix B + private static final Pattern URI_PATTERN = Pattern.compile( + "^(" + SCHEME_PATTERN + ")?" + + "(//(" + USERINFO_PATTERN + "@)?" + HOST_PATTERN + "(:" + PORT_PATTERN + ")?" + ")?" + + PATH_PATTERN + "(\\?" + QUERY_PATTERN + ")?" + "(#" + LAST_PATTERN + ")?"); + + static UriBuilder parseHttpUrl(String uri) { + expectNonNull(uri, "uri"); + try { + UriBuilder builder = UriComponentsParser.parseUri(uri); + UriComponents components = builder.buildUriComponents(); + if (!components.isHttpUrl()) { + throw new InvalidHttpUrlException("Invalid http url: \"" + uri + "\""); + } + return builder; + } catch (InvalidUriException e) { + InvalidUriException root = Throwables.getRootCauseOfType(e, InvalidUriException.class); + String suffix = root == null ? "" : ". Cause: " + root.getMessage(); + throw new InvalidHttpUrlException("Could not parse http url: \"" + uri + "\"" + suffix, root); + } catch (RuntimeException e) { + throw new InvalidHttpUrlException("Could not parse http url: \"" + uri + "\"", e); + } + } + + static UriBuilder parseHttpUrlOrNull(String uri) { + expectNonNull(uri, "uri"); + UriBuilder builder = UriComponentsParser.parseUriOrNull(uri); + if (builder == null) { + return null; + } + UriComponents components = builder.buildUriComponents(); + if (!components.isHttpUrl()) { + return null; + } + return builder; + } + + static UriBuilder parseUri(String uri) { + expectNonNull(uri, "uri"); + Matcher matcher = URI_PATTERN.matcher(uri); + if (!matcher.matches()) { + throw new InvalidUriException("Could not parse uri: \"" + uri + "\""); + } + try { + return parseUri(uri, matcher); + } catch (InvalidUriException e) { + throw new InvalidUriException("Could not parse uri: \"" + uri + "\". Cause: " + e.getMessage()); + } catch (RuntimeException e) { + throw new InvalidUriException("Could not parse uri: \"" + uri + "\""); + } + } + + static UriBuilder parseUriOrNull(String uri) { + expectNonNull(uri, "uri"); + Matcher matcher = URI_PATTERN.matcher(uri); + if (!matcher.matches()) { + return null; + } + try { + return parseUri(uri, matcher); + } catch (RuntimeException e) { + return null; + } + } + + private static UriBuilder parseUri(String uri, Matcher matcher) { + UriBuilder builder = new UriBuilder(); + String scheme = matcher.group(2); + String userInfo = matcher.group(5); + String host = matcher.group(6); + String port = matcher.group(8); + String path = matcher.group(9); + String query = matcher.group(11); + String fragment = matcher.group(13); + boolean opaque = false; + if (isNotNullOrEmpty(scheme)) { + String rest = uri.substring(scheme.length()); + if (!rest.startsWith(":/")) { + opaque = true; + } + builder.setScheme(UriRfc.SCHEME.validateAndDecode(scheme)); + } else if (uri.startsWith("//")) { + builder.setProtocolRelative(true); + } + if (opaque) { + String ssp = uri.substring(scheme.length()).substring(1); + if (isNotNullOrEmpty(fragment)) { + ssp = ssp.substring(0, ssp.length() - (fragment.length() + 1)); + } + builder.setSchemeSpecificPart(UriRfc.SCHEME_SPECIFIC_PART.validateAndDecode(ssp)); + } else { + onNotNull(userInfo, it -> builder.setUserInfo(UriRfc.USER_INFO.validateAndDecode(it))); + onNotNull(host, it -> builder.setHost(UriRfc.HOST.validateAndDecode(it))); + onNotNull(port, it -> { + String decodedPort = UriRfc.PORT.validateAndDecode(it); + builder.setPort(Integer.parseInt(decodedPort)); + }); + onNotNull(path, builder::setPath); + onNotNull(query, q -> builder.setQueryMultiParams(parseQuery(q))); + } + onNotNull(fragment, it -> builder.setFragment(UriRfc.FRAGMENT.validateAndDecode(it))); + builder.validate(); + return builder; + } + + static Map> parseQuery(String query) { + expectNonNull(query, "query"); + Matcher matcher = QUERY_PARAM_PATTERN.matcher(query); + UriRfc.QUERY.checkValidEncoded(query); + Map> result = new LinkedHashMap<>(); + while (matcher.find()) { + String name = matcher.group(1); + String decodedName = UriRfc.QUERY_PARAM.validateAndDecode(name); + String value = matcher.group(3); + String normalizedValue = value != null ? value : ""; + result + .computeIfAbsent(decodedName, k -> new ArrayList<>()) + .add(UriRfc.QUERY_PARAM.validateAndDecode(normalizedValue)); + } + return result; + } +} diff --git a/src/main/java/com/coditory/quark/uri/UriPartValidator.java b/src/main/java/com/coditory/quark/uri/UriPartValidator.java new file mode 100644 index 0000000..42c014b --- /dev/null +++ b/src/main/java/com/coditory/quark/uri/UriPartValidator.java @@ -0,0 +1,88 @@ +package com.coditory.quark.uri; + +import java.util.regex.Matcher; +import java.util.regex.Pattern; + +import static com.coditory.quark.uri.InetAddressValidator.isValidInetV4Address; + +final class UriPartValidator { + private static final String SPECIAL_CHARS = ";/@&=,.?:+$"; + private static final String VALID_CHARS = "[^\\s" + SPECIAL_CHARS + "]"; + private static final String ATOM = VALID_CHARS + '+'; + private static final Pattern SCHEME_PATTERN = Pattern.compile("^\\p{Alpha}[\\p{Alnum}\\+\\-\\.]*"); + private static final Pattern ATOM_PATTERN = Pattern.compile("^(" + ATOM + ").*?$"); + private static final Pattern DOMAIN_PATTERN = Pattern.compile("^" + ATOM + "(\\." + ATOM + ")*$"); + private static final Pattern ALPHA_PATTERN = Pattern.compile("^[a-zA-Z]"); + + static boolean isValidScheme(String scheme) { + return scheme != null && SCHEME_PATTERN.matcher(scheme).matches(); + } + + static void checkScheme(String scheme) { + if (!isValidScheme(scheme)) { + throw new InvalidUriException("Invalid scheme: " + scheme); + } + } + + static boolean isValidHost(String host) { + boolean hostname = false; + boolean ipV4Address = isValidInetV4Address(host); + if (!ipV4Address) { + hostname = DOMAIN_PATTERN.matcher(host).matches(); + } + if (hostname) { + char[] chars = host.toCharArray(); + int size = 1; + for (char element : chars) { + if (element == '.') { + size++; + } + } + String[] domainSegment = new String[size]; + boolean match = true; + int segmentCount = 0; + int segmentLength = 0; + + while (match) { + Matcher atomMatcher = ATOM_PATTERN.matcher(host); + match = atomMatcher.matches(); + if (match) { + domainSegment[segmentCount] = atomMatcher.group(1); + segmentLength = domainSegment[segmentCount].length() + 1; + host = segmentLength >= host.length() + ? "" + : host.substring(segmentLength); + + segmentCount++; + } + } + String topLevel = domainSegment[segmentCount - 1]; + if (topLevel.length() < 2 || topLevel.length() > 4) { + return false; + } + if (!ALPHA_PATTERN.matcher(topLevel.substring(0, 1)).matches()) { + return false; + } + if (segmentCount < 2) { + return false; + } + } + return hostname || ipV4Address; + } + + static void checkHost(String host) { + if (!isValidHost(host)) { + throw new InvalidUriException("Invalid host: " + host); + } + } + + static boolean isValidPort(int port) { + return Ports.isValidPortNumber(port); + } + + static void checkPort(int port) { + if (!isValidPort(port)) { + throw new InvalidUriException("Invalid port: " + port); + } + } +} diff --git a/src/main/java/com/coditory/quark/uri/UriRfc.java b/src/main/java/com/coditory/quark/uri/UriRfc.java new file mode 100644 index 0000000..b1b4e19 --- /dev/null +++ b/src/main/java/com/coditory/quark/uri/UriRfc.java @@ -0,0 +1,94 @@ +package com.coditory.quark.uri; + +import java.util.BitSet; + +import static com.coditory.quark.uri.Preconditions.expectNonNull; +import static java.util.Locale.ROOT; + +enum UriRfc { + SCHEME(UriRfcCharacters.SCHEME_ALLOWED), + SCHEME_SPECIFIC_PART(UriRfcCharacters.SCHEME_SPECIFIC_PART_ALLOWED), + USER_INFO(UriRfcCharacters.USER_INFO_ALLOWED), + HOST(UriRfcCharacters.HOST_IPV6_ALLOWED), + PORT(UriRfcCharacters.PORT_ALLOWED), + PATH_SEGMENT(UriRfcCharacters.PATH_SEGMENT_ALLOWED), + QUERY(UriRfcCharacters.QUERY_ALLOWED, true), + QUERY_PARAM(UriRfcCharacters.QUERY_PARAM_ALLOWED, true), + FRAGMENT(UriRfcCharacters.FRAGMENT_ALLOWED); + + private final BitSet allowed; + private final PercentCodec codec; + + UriRfc(String allowed) { + this(allowed, false); + } + + UriRfc(String allowed, boolean decodeSpaceAsPlus) { + this.allowed = BitSets.of(allowed); + String encode = decodeSpaceAsPlus + ? allowed.replaceAll("\\+", "") + : allowed; + this.codec = PercentCodec.builder() + .safeCharacters(encode) + .decodeSpaceAsPlus(decodeSpaceAsPlus) + .build(); + } + + String validateAndDecode(String source) { + checkValidEncoded(source); + return decode(source); + } + + String decode(String source) { + StringBuilder builder = new StringBuilder(); + decode(source, builder); + return builder.toString(); + } + + void decode(String source, StringBuilder builder) { + codec.decode(source, builder); + } + + String encode(String source) { + StringBuilder builder = new StringBuilder(); + encode(source, builder); + return builder.toString(); + } + + void encode(String source, StringBuilder builder) { + codec.encode(source, builder); + } + + void checkValidEncoded(String source) { + String error = checkValidEncodedWithErrorMessage(source); + if (error != null) { + throw new InvalidUriException(error); + } + } + + private String checkValidEncodedWithErrorMessage(String source) { + expectNonNull(source, "source"); + int length = source.length(); + for (int i = 0; i < length; i++) { + char ch = source.charAt(i); + if (ch == '%') { + if ((i + 2) < length) { + char hex1 = source.charAt(i + 1); + char hex2 = source.charAt(i + 2); + int u = Character.digit(hex1, 16); + int l = Character.digit(hex2, 16); + if (u == -1 || l == -1) { + return "Invalid encoded sequence \"" + source.substring(i) + "\""; + } + i += 2; + } else { + return "Invalid encoded sequence \"" + source.substring(i) + "\""; + } + } else if (!allowed.get(ch)) { + return "Invalid character '" + ch + "' for " + name().toLowerCase(ROOT) + " in \"" + source + "\""; + } + } + return null; + } + +} diff --git a/src/main/java/com/coditory/quark/uri/UriRfcCharacters.java b/src/main/java/com/coditory/quark/uri/UriRfcCharacters.java new file mode 100644 index 0000000..ab9e684 --- /dev/null +++ b/src/main/java/com/coditory/quark/uri/UriRfcCharacters.java @@ -0,0 +1,28 @@ +package com.coditory.quark.uri; + +final class UriRfcCharacters { + private UriRfcCharacters() { + throw new UnsupportedOperationException("Do not instantiate utility class"); + } + + private static final String ALPHABETIC_UPPER = "ABCDEFGHIJKLMNOPQRSTUVWXYZ"; + private static final String ALPHABETIC_LOWER = "abcdefghijklmnopqrstuvwxyz"; + private static final String ALPHABETIC = ALPHABETIC_UPPER + ALPHABETIC_LOWER; + private static final String NUMERIC = "0123456789"; + private static final String ALPHANUMERIC = ALPHABETIC + NUMERIC; + static final String URI_DELIMITER = ":/?#[]@"; + static final String URI_SUB_DELIMITER = "!$&'()*+,;="; + static final String URI_RESERVED = URI_DELIMITER + URI_SUB_DELIMITER; + static final String URI_UNRESERVED = ALPHABETIC + NUMERIC + "-._~"; + static final String URI_PCHAR = ":@" + URI_UNRESERVED + URI_SUB_DELIMITER; + + static final String SCHEME_ALLOWED = ALPHANUMERIC + "+-."; + static final String SCHEME_SPECIFIC_PART_ALLOWED = SCHEME_ALLOWED + URI_PCHAR + URI_RESERVED; + static final String USER_INFO_ALLOWED = URI_UNRESERVED + URI_SUB_DELIMITER + ":"; + static final String HOST_IPV6_ALLOWED = URI_UNRESERVED + URI_SUB_DELIMITER + "[]:"; + static final String PORT_ALLOWED = NUMERIC; + static final String PATH_SEGMENT_ALLOWED = URI_PCHAR; + static final String QUERY_ALLOWED = URI_PCHAR + "/?"; + static final String QUERY_PARAM_ALLOWED = QUERY_ALLOWED.replaceFirst("=", "").replaceFirst("&", ""); + static final String FRAGMENT_ALLOWED = URI_PCHAR + "/?"; +} diff --git a/src/main/java/com/coditory/quark/uri/UrlValidator.java b/src/main/java/com/coditory/quark/uri/UrlValidator.java new file mode 100644 index 0000000..cb12ca2 --- /dev/null +++ b/src/main/java/com/coditory/quark/uri/UrlValidator.java @@ -0,0 +1,185 @@ +package com.coditory.quark.uri; + +import org.jetbrains.annotations.NotNull; +import org.jetbrains.annotations.Nullable; + +import java.util.Set; +import java.util.regex.Matcher; +import java.util.regex.Pattern; + +import static com.coditory.quark.uri.InetAddressValidator.isValidInetV4Address; +import static com.coditory.quark.uri.Preconditions.expectNonNull; +import static com.coditory.quark.uri.Strings.isNullOrEmpty; + +public final class UrlValidator { + private static final UrlValidator INSTANCE = builder().build(); + + public static UrlValidator instance() { + return INSTANCE; + } + + public static boolean isValidUrl(String url) { + return INSTANCE.isValid(url); + } + + public static boolean isValidUrl(UriComponents uriComponents) { + return INSTANCE.isValid(uriComponents); + } + + private static final String ALPHA_CHARS = "a-zA-Z"; + private static final String SPECIAL_CHARS = ";/@&=,.?:+$"; + private static final String VALID_CHARS = "[^\\s" + SPECIAL_CHARS + "]"; + private static final String ATOM = VALID_CHARS + '+'; + private static final Pattern SCHEME_PATTERN = Pattern.compile("^\\p{Alpha}[\\p{Alnum}\\+\\-\\.]*"); + private static final Pattern PATH_PATTERN = Pattern.compile("^(/[-\\w:@&?=+,.!/~*'%$_;]*)?$"); + private static final Pattern DOMAIN_PATTERN = Pattern.compile("^" + ATOM + "(\\." + ATOM + ")*$"); + private static final Pattern ATOM_PATTERN = Pattern.compile("^(" + ATOM + ").*?$"); + private static final Pattern ALPHA_PATTERN = Pattern.compile("^[" + ALPHA_CHARS + "]"); + private final boolean allowFragments; + private final Set allowedSchemes; + + UrlValidator(boolean allowFragments, Set allowedSchemes) { + this.allowFragments = allowFragments; + this.allowedSchemes = Set.copyOf(allowedSchemes); + } + + public boolean isValid(String url) { + expectNonNull(url, "url"); + UriComponents uriComponents; + try { + uriComponents = UriComponents.fromHttpUrl(url); + } catch (Exception e) { + return false; + } + return isValid(uriComponents); + } + + public boolean isValid(UriComponents uriComponents) { + expectNonNull(uriComponents, "uriComponents"); + if (!isValidScheme(uriComponents.getScheme())) { + return false; + } + if (!isValidHost(uriComponents.getHost())) { + return false; + } + if (!isValidPath(uriComponents.getPath())) { + return false; + } + if (!isValidFragment(uriComponents.getFragment())) { + return false; + } + return true; + } + + boolean isValidScheme(@Nullable String scheme) { + if (scheme == null) { + return false; + } + if (!SCHEME_PATTERN.matcher(scheme).matches()) { + return false; + } + return allowedSchemes == null || allowedSchemes.contains(scheme); + } + + boolean isValidHost(@Nullable String host) { + if (isNullOrEmpty(host)) { + return false; + } + boolean hostname = false; + boolean ipV4Address = isValidInetV4Address(host); + if (!ipV4Address) { + hostname = DOMAIN_PATTERN.matcher(host).matches(); + } + if (hostname) { + char[] chars = host.toCharArray(); + int size = 1; + for (char element : chars) { + if (element == '.') { + size++; + } + } + String[] domainSegment = new String[size]; + boolean match = true; + int segmentCount = 0; + int segmentLength = 0; + while (match) { + Matcher atomMatcher = ATOM_PATTERN.matcher(host); + match = atomMatcher.matches(); + if (match) { + domainSegment[segmentCount] = atomMatcher.group(1); + segmentLength = domainSegment[segmentCount].length() + 1; + host = + (segmentLength >= host.length()) + ? "" + : host.substring(segmentLength); + + segmentCount++; + } + } + String topLevel = domainSegment[segmentCount - 1]; + if (topLevel.length() < 2 || topLevel.length() > 4) { + return false; + } + if (!ALPHA_PATTERN.matcher(topLevel.substring(0, 1)).matches()) { + return false; + } + if (segmentCount < 2) { + return false; + } + } + return hostname || ipV4Address; + } + + boolean isValidPath(@Nullable String path) { + if (isNullOrEmpty(path)) { + return true; + } + if (!PATH_PATTERN.matcher(path).matches()) { + return false; + } + int slashCount = countToken("/", path); + int dot2Count = countToken("..", path); + return dot2Count <= 0 || (slashCount - 2) > dot2Count; + } + + boolean isValidFragment(@Nullable String fragment) { + return fragment == null || allowFragments; + } + + private int countToken(String token, String target) { + int tokenIndex = 0; + int count = 0; + while (tokenIndex != -1) { + tokenIndex = target.indexOf(token, tokenIndex); + if (tokenIndex > -1) { + tokenIndex++; + count++; + } + } + return count; + } + + @NotNull + public static UrlValidatorBuilder builder() { + return new UrlValidatorBuilder(); + } + + public static class UrlValidatorBuilder { + private boolean allowFragments = true; + private Set allowedSchemes = Set.of("http", "https"); + + public UrlValidatorBuilder allowFragments(boolean allowFragments) { + this.allowFragments = allowFragments; + return this; + } + + public UrlValidatorBuilder allowedSchemes(Set allowedSchemes) { + this.allowedSchemes = expectNonNull(allowedSchemes, "allowedSchemes"); + return this; + } + + public UrlValidator build() { + return new UrlValidator(allowFragments, allowedSchemes); + } + } +} diff --git a/src/main/resources/a/b/c/homepage/i18n.yml b/src/main/resources/a/b/c/homepage/i18n.yml new file mode 100644 index 0000000..e276c04 --- /dev/null +++ b/src/main/resources/a/b/c/homepage/i18n.yml @@ -0,0 +1 @@ +hello.pl: HomepageX123 {0 | single (one (detail)) (more {0} ${some.ref})} diff --git a/src/main/resources/a/b/c/other/i18n.yml b/src/main/resources/a/b/c/other/i18n.yml new file mode 100644 index 0000000..8347de1 --- /dev/null +++ b/src/main/resources/a/b/c/other/i18n.yml @@ -0,0 +1 @@ +other.pl: Other diff --git a/src/main/resources/a/b/d/listing/i18n.yml b/src/main/resources/a/b/d/listing/i18n.yml new file mode 100644 index 0000000..37f1485 --- /dev/null +++ b/src/main/resources/a/b/d/listing/i18n.yml @@ -0,0 +1,2 @@ +hello: + pl: "Siema from listing" \ No newline at end of file diff --git a/src/main/resources/logback.xml b/src/main/resources/logback.xml new file mode 100644 index 0000000..946b702 --- /dev/null +++ b/src/main/resources/logback.xml @@ -0,0 +1,14 @@ + + + + %d{HH:mm:ss.SSS} [%thread] %-5level %logger{36} - %msg%n + + + + + + + + + + diff --git a/src/test/groovy/com/coditory/quark/uri/HostsSpec.groovy b/src/test/groovy/com/coditory/quark/uri/HostsSpec.groovy new file mode 100644 index 0000000..f005e40 --- /dev/null +++ b/src/test/groovy/com/coditory/quark/uri/HostsSpec.groovy @@ -0,0 +1,19 @@ +package com.coditory.quark.uri + +import spock.lang.Specification + +class HostsSpec extends Specification { + def "should retrieve non blank localHostAddress"() { + when: + String localHostAddress = Hosts.localHostAddress + then: + !localHostAddress.isBlank() + } + + def "should retrieve non blank localHostName"() { + when: + String localHostName = Hosts.localHostName + then: + !localHostName.isBlank() + } +} diff --git a/src/test/groovy/com/coditory/quark/uri/InetAddressValidatorSpec.groovy b/src/test/groovy/com/coditory/quark/uri/InetAddressValidatorSpec.groovy new file mode 100644 index 0000000..1406b6a --- /dev/null +++ b/src/test/groovy/com/coditory/quark/uri/InetAddressValidatorSpec.groovy @@ -0,0 +1,89 @@ +package com.coditory.quark.uri + +import spock.lang.Specification +import spock.lang.Unroll + +class InetAddressValidatorSpec extends Specification { + private static final List validIpV4 = [ + "127.0.0.1", + "8.8.8.8" + ] + private static final List invalidIpV4 = [ + "127.0.0.1.1", + "127.0.1", + "127.0..1", + "127.888.0.1", + ] + private static final List validIpV6 = [ + "2001:db8:3333:4444:5555:6666:7777:8888", + "2001:db8::1234:5678", + "::1234:5678" + ] + private static final List invalidIpV6 = [ + ":::1234:5678", + "2001:db8:3333:4444:5555:6666:7777:8888:8888", + ] + + @Unroll + def "should validate valid inet address: #address"() { + when: + InetAddressValidator.validateInetAddress(address) + then: + noExceptionThrown() + where: + address << validIpV4 + validIpV6 + } + + @Unroll + def "should validate invalid inet address: #address"() { + when: + InetAddressValidator.validateInetAddress(address) + then: + IllegalArgumentException e = thrown(IllegalArgumentException) + e.message == "Expected valid ip address. Got: " + address + where: + address << invalidIpV4 + invalidIpV6 + } + + @Unroll + def "should validate valid inet v4 address: #address"() { + when: + InetAddressValidator.validateInetV4Address(address) + then: + noExceptionThrown() + where: + address << validIpV4 + } + + @Unroll + def "should validate invalid inet v4 address: #address"() { + when: + InetAddressValidator.validateInetV4Address(address) + then: + IllegalArgumentException e = thrown(IllegalArgumentException) + e.message == "Expected valid ip v4 address. Got: " + address + where: + address << invalidIpV4 + validIpV6 + invalidIpV6 + } + + @Unroll + def "should validate valid inet v6 address: #address"() { + when: + InetAddressValidator.validateInetV6Address(address) + then: + noExceptionThrown() + where: + address << validIpV6 + } + + @Unroll + def "should validate invalid inet v6 address: #address"() { + when: + InetAddressValidator.validateInetV6Address(address) + then: + IllegalArgumentException e = thrown(IllegalArgumentException) + e.message == "Expected valid ip v6 address. Got: " + address + where: + address << invalidIpV6 + validIpV4 + invalidIpV4 + } +} diff --git a/src/test/groovy/com/coditory/quark/uri/PercentCodecSpec.groovy b/src/test/groovy/com/coditory/quark/uri/PercentCodecSpec.groovy new file mode 100644 index 0000000..e60a3d3 --- /dev/null +++ b/src/test/groovy/com/coditory/quark/uri/PercentCodecSpec.groovy @@ -0,0 +1,68 @@ +package com.coditory.quark.uri + +import spock.lang.Specification +import spock.lang.Unroll + +import static com.coditory.quark.uri.base.Alphabets.ASCII_CONTROL_CODES +import static com.coditory.quark.uri.base.Alphabets.ASCII_PRINTABLE +import static com.coditory.quark.uri.base.Alphabets.URI_UNRESERVED + +class PercentCodecSpec extends Specification { + @Unroll + def "should encode and decode string: #input"() { + when: + String encoded = PercentCodec.encodeUriComponent(input) + then: + encoded == expected + + when: + String decoded = PercentCodec.decodeUriComponent(encoded) + then: + decoded == input + + where: + input || expected + "" || "" + " \t\n+" || "%20%20%09%0A%2B" + "a𝄞b" || "a%F0%9D%84%9Eb" + "語" || "%E8%AA%9E" + "®" || "%C2%AE" + "🌉" || "%F0%9F%8C%89" + "語®🌉" || "%E8%AA%9E%C2%AE%F0%9F%8C%89" + URI_UNRESERVED || "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789-._~" + ASCII_PRINTABLE || "%20%21%22%23%24%25%26%27%28%29%2A%2B%2C-.%2F0123456789%3A%3B%3C%3D%3E%3F%40ABCDEFGHIJKLMNOPQRSTUVWXYZ%5B%5C%5D%5E_%60abcdefghijklmnopqrstuvwxyz%7B%7C%7D~" + ASCII_CONTROL_CODES || "%00%01%02%03%04%05%06%07%08%09%0A%0B%0C%0D%0E%0F%10%11%12%13%14%15%16%17%18%19%1A%1B%1C%1D%1E%1F%7F" + } + + def "should encode space with plus when configured"() { + given: + PercentCodec codec = PercentCodec.builder() + .spaceAsPlus(true) + .build() + when: + String encoded = codec.encode(" \t\n") + then: + encoded == "++%09%0A" + + when: + String decoded = codec.decode(encoded) + then: + decoded == " \t\n" + } + + def "should use configured safe characters"() { + given: + PercentCodec codec = PercentCodec.builder() + .safeCharacters("abc語") + .build() + when: + String encoded = codec.encode("ABCabc®語") + then: + encoded == "%41%42%43abc%C2%AE語" + + when: + String decoded = codec.decode(encoded) + then: + decoded == "ABCabc®語" + } +} diff --git a/src/test/groovy/com/coditory/quark/uri/PortsSpec.groovy b/src/test/groovy/com/coditory/quark/uri/PortsSpec.groovy new file mode 100644 index 0000000..fe2530f --- /dev/null +++ b/src/test/groovy/com/coditory/quark/uri/PortsSpec.groovy @@ -0,0 +1,55 @@ +package com.coditory.quark.uri + +import spock.lang.Specification +import spock.lang.Unroll + +class PortsSpec extends Specification { + def "should find two available ports"() { + when: + int port = Ports.nextAvailablePort() + then: + port >= 0 && port < 65535 + } + + @Unroll + def "should validate valid port number: #port"() { + when: + Ports.validatePortNumber(port) + then: + noExceptionThrown() + where: + port << [0, 1, 1024, 65535] + } + + @Unroll + def "should validate invalid port number: #port"() { + when: + Ports.validatePortNumber(port) + then: + IllegalArgumentException e = thrown(IllegalArgumentException) + e.getMessage() == "Expected port number in range [0, 65535]. Got: " + port + where: + port << [-1, 65536] + } + + @Unroll + def "should validate valid port number or scheme default: #port"() { + when: + Ports.validatePortNumberOrSchemeDefault(port) + then: + noExceptionThrown() + where: + port << [-1, 1, 1024, 65535] + } + + @Unroll + def "should validate invalid port number or scheme default: #port"() { + when: + Ports.validatePortNumberOrSchemeDefault(port) + then: + IllegalArgumentException e = thrown(IllegalArgumentException) + e.getMessage() == "Expected port number in range [-1, 65535]. Got: " + port + where: + port << [-2, 65536] + } +} diff --git a/src/test/groovy/com/coditory/quark/uri/UriBuilderSpec.groovy b/src/test/groovy/com/coditory/quark/uri/UriBuilderSpec.groovy new file mode 100644 index 0000000..3759d79 --- /dev/null +++ b/src/test/groovy/com/coditory/quark/uri/UriBuilderSpec.groovy @@ -0,0 +1,108 @@ +package com.coditory.quark.uri + +import spock.lang.Specification +import spock.lang.Unroll + +class UriBuilderSpec extends Specification { + def "should build uri from new builder instance"() { + when: + String result = new UriBuilder() + .setScheme("https") + .setUserInfo("john.doe") + .setHost("coditory.com") + .setPort(8081) + .setPath("/test/test2") + .addPathSegment("test3") + .addQueryParam("a", "a1") + .addQueryParam("a", "a2") + .addQueryParam("b", "b1") + .putQueryParam("b", "b2") + .setFragment("x") + .buildUriString() + then: + result == "https://john.doe@coditory.com:8081/test/test2/test3?a=a1&a=a2&b=b2#x" + } + + def "should normalize path slashes"() { + when: + String result = UriBuilder.fromUri("https://coditory.com/abc//def/") + .addSubPath("//ghi////jkl//") + .addPathSegment("mno/pqr") + .buildUriString() + then: + result == "https://coditory.com/abc/def/ghi/jkl/mno%2Fpqr" + } + + def "should encode spaces"() { + when: + String result = UriBuilder.fromUri("https://coditory.com/a+bc//d%20ef/") + .addPathSegment("x y ") + .setFragment("frag ment") + .addQueryParam("f oo", "b ar") + .addQueryParam("x", "y+z") + .buildUriString() + then: + result == "https://coditory.com/a+bc/d%20ef/x%20y%20?f%20oo=b%20ar&x=y%2Bz#frag%20ment" + } + + def "should replace each uri component"() { + when: + String result = UriBuilder.fromUri("https://john.doe@coditory.com:8081/test/test2/test3?a=a1&a=a2&b=b2#x") + .setScheme("http") + .removeUserInfo() + .setHost("coditory.xyz") + .setDefaultPort() + .setPath("/abc") + .setQueryParams(w: "W") + .setFragment("y") + .buildUriString() + then: + result == "http://coditory.xyz/abc?w=W#y" + } + + @Unroll + def "should build uri without #field"() { + given: + UriBuilder builder = UriBuilder.fromUri("https://john.doe@coditory.com:8081/test/test2/test3?a=a1&a=a2&b=b2#x") + when: + modifier(builder) + then: + builder.buildUriString() == uri + where: + field | modifier || uri + "scheme" | { UriBuilder b -> b.removeScheme() } || "john.doe@coditory.com:8081/test/test2/test3?a=a1&a=a2&b=b2#x" + "scheme - relative" | { UriBuilder b -> b.setProtocolRelative(true) } || "//john.doe@coditory.com:8081/test/test2/test3?a=a1&a=a2&b=b2#x" + "userInfo" | { UriBuilder b -> b.removeUserInfo() } || "https://coditory.com:8081/test/test2/test3?a=a1&a=a2&b=b2#x" + "fragment" | { UriBuilder b -> b.removeFragment() } || "https://john.doe@coditory.com:8081/test/test2/test3?a=a1&a=a2&b=b2" + "queryParams" | { UriBuilder b -> b.removeQueryParams() } || "https://john.doe@coditory.com:8081/test/test2/test3#x" + "queryParam-a" | { UriBuilder b -> b.removeQueryParam("a") } || "https://john.doe@coditory.com:8081/test/test2/test3?b=b2#x" + "queryParam-a-a2" | { UriBuilder b -> b.removeQueryParam("a", "a2") } || "https://john.doe@coditory.com:8081/test/test2/test3?a=a1&b=b2#x" + } + + @Unroll + def "should throw error when building uri without host but with scheme and port or userinfo"() { + when: + UriBuilder.fromUri("https://john.doe@coditory.com/test/test2/test3?a=a1&a=a2&b=b2#x") + .removeHost() + .buildUriComponents() + then: + InvalidUriException e = thrown(InvalidUriException) + e.message == "URI with user info must include host" + when: + UriBuilder.fromUri("https://coditory.com:8008/test/test2/test3?a=a1&a=a2&b=b2#x") + .removeHost() + .buildUriComponents() + then: + e = thrown(InvalidUriException) + e.message == "URI with port must include host" + } + + def "should copy uriBuilder instance"() { + when: + UriBuilder first = UriBuilder.fromUri("https://coditory.com/abc") + UriBuilder second = first.copy().addQueryParam("a", "X") + then: + first.buildUriString() == "https://coditory.com/abc" + second.buildUriString() == "https://coditory.com/abc?a=X" + } +} diff --git a/src/test/groovy/com/coditory/quark/uri/UriBuilder_parseAndRecreateUriSpec.groovy b/src/test/groovy/com/coditory/quark/uri/UriBuilder_parseAndRecreateUriSpec.groovy new file mode 100644 index 0000000..1e58d4e --- /dev/null +++ b/src/test/groovy/com/coditory/quark/uri/UriBuilder_parseAndRecreateUriSpec.groovy @@ -0,0 +1,85 @@ +package com.coditory.quark.uri + +import spock.lang.Specification +import spock.lang.Unroll + +class UriBuilder_parseAndRecreateUriSpec extends Specification { + @Unroll + def "should parse and recreate uri: #uri"() { + when: + UriBuilder result = UriBuilder.fromUri(uri) + then: + expectEquals(result, uri) + where: + uri << [ + "file:///~/calendar", + "coditory.com", + "//coditory.com", + "https://coditory.com", + "http://coditory.com", + "http://john:doe@coditory.com:8080/help?a=a1&a=a2&b=b1#frag", + "http://coditory.com?a=a1&a=a2&b=b1#frag", + "", + "/", + "/abc/def", + "?a=a1&a=a2&b=b1", + "?test=%E8%AA%9E", + "?%E8%AA%9E=test", + "#%E8%AA%9E", + "/%E8%AA%9E", + "../../../demo/jfc/SwingSet2/src/SwingSet2.java", + "../../../demo/../jfc/SwingSet2/src/SwingSet2.java" + ] + } + + @Unroll + def "should normalize path: #uri"() { + when: + UriBuilder result = UriBuilder.fromUri(uri) + then: + result.buildUriString() == expected + where: + uri || expected + "https://coditory.com//test" || "https://coditory.com/test" + "https://coditory.com/test/" || "https://coditory.com/test" + "https://coditory.com/test//" || "https://coditory.com/test" + } + + @Unroll + def "should handle plus sign: #uri"() { + when: + UriBuilder result = UriBuilder.fromUri(uri) + then: + result.buildUriString() == expected + where: + uri || expected + "https://coditory.com/+" || "https://coditory.com/+" + "https://coditory.com?a+b=c+d" || "https://coditory.com?a%20b=c%20d" + "https://coditory.com#a+b" || "https://coditory.com#a+b" + "https://coditory.com/foo+bar?a+b=c+d#x+" || "https://coditory.com/foo+bar?a%20b=c%20d#x+" + "https://coditory.com/foo%2Bbar?a%2Bb=c%2Bd#x%2B" || "https://coditory.com/foo+bar?a%2Bb=c%2Bd#x+" + } + + @Unroll + def "should parse and recreate opaque uri: #uri"() { + when: + UriBuilder result = UriBuilder.fromUri(uri) + then: + expectEquals(result, uri) + where: + uri << [ + "mailto:java-net@java.sun.com", + "news:comp.lang.java", + "urn:isbn:096139210x", + "mailto:someone@yoursite.com?subject=Mail%20from%20Our%20Site", + "mailto:%E8%AA%9Edef@yoursite.com?subject=Mail%20from%20Our%20Site#frag%E8%AA%9E" + ] + } + + private void expectEquals(UriBuilder builder, String expected) { + String uriString = builder.buildUriString() + assert uriString == expected + uriString = builder.buildUri().toString() + assert uriString == expected + } +} diff --git a/src/test/groovy/com/coditory/quark/uri/UriBuilder_parseHttpUrlSpec.groovy b/src/test/groovy/com/coditory/quark/uri/UriBuilder_parseHttpUrlSpec.groovy new file mode 100644 index 0000000..5bcfac9 --- /dev/null +++ b/src/test/groovy/com/coditory/quark/uri/UriBuilder_parseHttpUrlSpec.groovy @@ -0,0 +1,49 @@ +package com.coditory.quark.uri + +import spock.lang.Specification +import spock.lang.Unroll + +class UriBuilder_parseHttpUrlSpec extends Specification { + @Unroll + def "should create URL from valid http url: #input"() { + when: + UriComponents result = UriBuilder.fromUri(input).buildUriComponents() + then: + result.isValidHttpUrl() == true + and: + result.toUrl() == new URL(input) + where: + input << [ + "https://coditory.com", + "http://coditory.com", + "http://john:doe@coditory.com:8080/help?a=a1&a=a2&b=b1#frag", + "http://coditory.com?a=a1&a=a2&b=b1#frag" + ] + } + + @Unroll + def "should detect invalid http url: #input"() { + when: + UriComponents result = UriBuilder.fromUri(input).buildUriComponents() + then: + result.isValidHttpUrl() == false + where: + input << [ + "ftp://coditory.com", + "htttps://coditory.com", + "coditory.com", + "", + "/", + "/abc/def", + "?a=a1&a=a2&b=b1", + "?test=%E8%AA%9E", + "?%E8%AA%9E=test", + "#%E8%AA%9E", + "/%E8%AA%9E", + "../../../demo/jfc/SwingSet2/src/SwingSet2.java", + "mailto:java-net@java.sun.com", + "news:comp.lang.java", + "urn:isbn:096139210x" + ] + } +} diff --git a/src/test/groovy/com/coditory/quark/uri/UriBuilder_parseUriPartsSpec.groovy b/src/test/groovy/com/coditory/quark/uri/UriBuilder_parseUriPartsSpec.groovy new file mode 100644 index 0000000..20fcc08 --- /dev/null +++ b/src/test/groovy/com/coditory/quark/uri/UriBuilder_parseUriPartsSpec.groovy @@ -0,0 +1,142 @@ +package com.coditory.quark.uri + +import spock.lang.Specification +import spock.lang.Unroll + +class UriBuilder_parseUriPartsSpec extends Specification { + @Unroll + def "should parse scheme and host: #input"() { + when: + UriComponents result = UriComponents.fromUri(input) + then: + result.scheme == expected + and: + result.host == "coditory.com" + where: + input || expected + "//coditory.com" || null + "https://coditory.com" || "https" + "http://coditory.com" || "http" + "unknown://coditory.com" || "unknown" + } + + def "should handle plus sign"() { + when: + UriComponents result = UriComponents.fromUri("https://coditory.com/foo+bar?a+b=c+d#x+y") + then: + result.pathSegments == ["foo+bar"] + result.queryParams == ["a b": ["c d"]] + result.fragment == "x+y" + } + + def "should parse protocol relative uri"() { + when: + UriComponents result = UriComponents.fromUri("//coditory.com") + then: + result.protocolRelative == true + result.scheme == null + result.isOpaque() == false + result.schemeSpecificPart == null + } + + @Unroll + def "should parse user info: #input"() { + when: + UriComponents result = UriComponents.fromUri(input) + then: + result.userInfo == expected + where: + input || expected + "https://john@coditory.com" || "john" + "https://user:pass123@coditory.com" || "user:pass123" + } + + @Unroll + def "should parse path segments: #input"() { + when: + UriComponents result = UriComponents.fromUri(input) + then: + result.pathSegments == expected + and: + result.rootPath == rootPath + where: + input || rootPath | expected + "//coditory.com" || true | [] + "https://coditory.com//" || true | [] + "https://////coditory.com/////" || true | ["coditory.com"] + "http://coditory.com///test/////test2//////" || true | ["test", "test2"] + "/test" || true | ["test"] + "../test" || false | ["..", "test"] + "test" || false | ["test"] + "test//test2///" || false | ["test", "test2"] + "/a+b/c%20d" || true | ["a+b", "c d"] + "/%F0%9D%84%9E/%E8%AA%9E/a" || true | ["𝄞", "語", "a"] + } + + @Unroll + def "should parse query params: #query"() { + when: + UriComponents result = UriComponents.fromUri("https://coditory.com" + query) + then: + result.queryParams == expected + + and: + result.singleValueQueryParams == expectedSingleValue + + where: + query | expected | expectedSingleValue + "" | [:] | [:] + "?" | [:] | [:] + "?a" | [a: [""]] | [a: ""] + "?a=" | [a: [""]] | [a: ""] + "?a=&a=" | [a: ["", ""]] | [a: ""] + "?a=b" | [a: ["b"]] | [a: "b"] + "?a=b&a=c" | [a: ["b", "c"]] | [a: "b"] + "?a=b&a=b" | [a: ["b", "b"]] | [a: "b"] + "?a=b&c=d" | [a: ["b"], c: ["d"]] | [a: "b", c: "d"] + "?a+b=c+d" | ["a b": ["c d"]] | ["a b": "c d"] + "?a%20b=c%20d" | ["a b": ["c d"]] | ["a b": "c d"] + "?a=%E8%AA%9E" | [a: ["語"]] | [a: "語"] + } + + @Unroll + def "should parse fragment: #fragment"() { + when: + UriComponents result = UriComponents.fromUri("https://coditory.com" + fragment) + then: + result.fragment == expected + + where: + fragment | expected + "" | null + "#" | null + "#a" | "a" + "#a%20b" | "a b" + "#a%E8%AA%9Eb" | "a語b" + } + + @Unroll + def "should throw error when parsing invalid uri string: #uri"() { + when: + UriBuilder.fromUri(uri) + then: + InvalidUriException e = thrown(InvalidUriException) + e.message == "Could not parse uri: \"$uri\". Cause: $message" + where: + uri | message + "https://john.doe@" | "URI with user info must include host" + "https://john.doe@:8080" | "URI with user info must include host" + "https://coditory.com:80a" | "Invalid character 'a' for port in \"80a\"" + "https://coditory.com:a80" | "Invalid character 'a' for port in \"a80\"" + "https://:8080" | "URI with port must include host" + "https://codi tory.com" | "Invalid character ' ' for host in \"codi tory.com\"" + "ht tps://coditory.com" | "Invalid character ' ' for scheme in \"ht tps\"" + "https://jo hn.doe@coritory.com" | "Invalid character ' ' for user_info in \"jo hn.doe\"" + "/ /" | "Invalid character ' ' for path_segment in \" \"" + "/test?a b=c" | "Invalid character ' ' for query in \"a b=c\"" + "/test?a=b c" | "Invalid character ' ' for query in \"a=b c\"" + "/test?a=b=c" | "Invalid character '=' for query_param in \"b=c\"" + "/test#a b" | "Invalid character ' ' for fragment in \"a b\"" + "/test#a#b" | "Invalid character '#' for fragment in \"a#b\"" + } +} diff --git a/src/test/groovy/com/coditory/quark/uri/UriBuilder_parseUriSpec.groovy b/src/test/groovy/com/coditory/quark/uri/UriBuilder_parseUriSpec.groovy new file mode 100644 index 0000000..75e034a --- /dev/null +++ b/src/test/groovy/com/coditory/quark/uri/UriBuilder_parseUriSpec.groovy @@ -0,0 +1,123 @@ +package com.coditory.quark.uri + +import spock.lang.Specification + +class UriBuilder_parseUriSpec extends Specification { + def "should parse UriComponents from complex http url"() { + when: + UriComponents result = UriComponents.fromUri("https://john:doe@coditory.com:8080/help/test?a=a1&a=a2&b=b1#frag") + then: + result.schemeSpecificPart == null + result.opaque == false + result.scheme == "https" + result.userInfo == "john:doe" + result.uriAuthority == UriAuthority.of("john:doe", "coditory.com", 8080) + result.host == "coditory.com" + result.port == 8080 + result.path == "/help/test" + result.pathSegments == ["help", "test"] + result.protocolRelative == false + result.rootPath == true + result.queryString == "a=a1&a=a2&b=b1" + result.queryParams == [ + a: ['a1', 'a2'], + b: ['b1'] + ] + result.fragment == "frag" + result.isHttpUrl() == true + } + + def "should parse UriComponents from basic http url"() { + when: + UriComponents result = UriBuilder + .fromUri("http://coditory.com/help/test?a=a1&a=a2&b=b1#frag") + .buildUriComponents() + then: + result.schemeSpecificPart == null + result.opaque == false + result.scheme == "http" + result.userInfo == null + result.uriAuthority == UriAuthority.of(null, "coditory.com", -1) + result.host == "coditory.com" + result.port == -1 + result.path == "/help/test" + result.pathSegments == ["help", "test"] + result.rootPath == true + result.queryString == "a=a1&a=a2&b=b1" + result.queryParams == [ + a: ['a1', 'a2'], + b: ['b1'] + ] + result.fragment == "frag" + result.isHttpUrl() == true + } + + def "should parse UriComponents from uri starting with path"() { + when: + UriComponents result = UriBuilder + .fromUri("/help/test?a=a1&a=a2&b=b1#frag") + .buildUriComponents() + then: + result.schemeSpecificPart == null + result.opaque == false + result.scheme == null + result.userInfo == null + result.uriAuthority == null + result.host == null + result.port == -1 + result.path == "/help/test" + result.pathSegments == ["help", "test"] + result.rootPath == true + result.queryString == "a=a1&a=a2&b=b1" + result.queryParams == [ + a: ['a1', 'a2'], + b: ['b1'] + ] + result.fragment == "frag" + result.isHttpUrl() == false + } + + def "should parse UriComponents from uri with scheme and host only"() { + when: + UriComponents result = UriBuilder + .fromUri("https://coditory.com") + .buildUriComponents() + then: + result.schemeSpecificPart == null + result.opaque == false + result.scheme == "https" + result.userInfo == null + result.uriAuthority == UriAuthority.of(null, "coditory.com", -1) + result.host == "coditory.com" + result.port == -1 + result.path == null + result.pathSegments == [] + result.rootPath == true + result.queryString == null + result.queryParams == [:] + result.fragment == null + result.isHttpUrl() == true + } + + def "should parse UriComponents from opaque uri"() { + when: + UriComponents result = UriBuilder + .fromUri("mailto:%E8%AA%9Edef@yoursite.com?subject=Mail%20from%20Our%20Site#frag%E8%AA%9E") + .buildUriComponents() + then: + result.schemeSpecificPart == "語def@yoursite.com?subject=Mail from Our Site" + result.opaque == true + result.scheme == "mailto" + result.userInfo == null + result.uriAuthority == null + result.host == null + result.port == -1 + result.path == null + result.pathSegments == [] + result.rootPath == false + result.queryString == null + result.queryParams == [:] + result.fragment == "frag語" + result.isHttpUrl() == false + } +} diff --git a/src/test/groovy/com/coditory/quark/uri/UriBuilder_queryParamsSpec.groovy b/src/test/groovy/com/coditory/quark/uri/UriBuilder_queryParamsSpec.groovy new file mode 100644 index 0000000..4054aad --- /dev/null +++ b/src/test/groovy/com/coditory/quark/uri/UriBuilder_queryParamsSpec.groovy @@ -0,0 +1,112 @@ +package com.coditory.quark.uri + +import spock.lang.Specification + +class UriBuilder_queryParamsSpec extends Specification { + def "should add query params with addQueryParam"() { + when: + String result = UriBuilder.fromUri("https://coditory.com?w=W&a=A") + .addQueryParam("a", "X") + .addQueryParam("a", "X") + .addQueryParam("a", "Y") + .addQueryParam("b", "Y") + .addQueryParam("e", "") + .buildUriString() + then: + result == "https://coditory.com?w=W&a=A&a=X&a=X&a=Y&b=Y&e=" + } + + def "should add query params with addQueryMultiParams"() { + when: + String result = UriBuilder.fromUri("https://coditory.com?w=W&a=A") + .addQueryMultiParams([ + a : ["X", "X", "Y"], + b : ["Y"], + e1: [], + e2: [""] + ]) + .buildUriString() + then: + result == "https://coditory.com?w=W&a=A&a=X&a=X&a=Y&b=Y&e2=" + } + + def "should add query params with addQueryParams"() { + when: + String result = UriBuilder.fromUri("https://coditory.com?w=W&a=A") + .addQueryParams([ + a: "X", + b: "Y", + e: "" + ]) + .buildUriString() + then: + result == "https://coditory.com?w=W&a=A&a=X&b=Y&e=" + } + + def "should add query params with putQueryParam"() { + when: + String result = UriBuilder.fromUri("https://coditory.com?w=W&a=A") + .putQueryParam("a", "X") + .putQueryParam("a", "X") + .putQueryParam("a", "Y") + .putQueryParam("b", "Y") + .putQueryParam("e", "") + .buildUriString() + then: + result == "https://coditory.com?w=W&a=Y&b=Y&e=" + } + + def "should add query params with putQueryMultiParams"() { + when: + String result = UriBuilder.fromUri("https://coditory.com?w=W&a=A") + .putQueryMultiParams([ + a : ["X", "X", "Y"], + b : ["Y"], + e1: [], + e2: [""] + ]) + .buildUriString() + then: + result == "https://coditory.com?w=W&a=X&a=X&a=Y&b=Y&e2=" + } + + def "should add query params with putQueryParams"() { + when: + String result = UriBuilder.fromUri("https://coditory.com?w=W&a=A") + .putQueryParams([ + a: "X", + b: "Y", + e: "" + ]) + .buildUriString() + then: + result == "https://coditory.com?w=W&a=X&b=Y&e=" + } + + def "should remove query param by name"() { + when: + String result = UriBuilder.fromUri("https://coditory.com?a=X&a=Y&b=Z") + .removeQueryParam("a") + .buildUriString() + then: + result == "https://coditory.com?b=Z" + } + + def "should remove query param by name and value"() { + when: + String result = UriBuilder.fromUri("https://coditory.com?a=X&a=Y&b=Z") + .removeQueryParam("a", "Y") + .buildUriString() + then: + result == "https://coditory.com?a=X&b=Z" + } + + def "should remove all query params"() { + when: + String result = UriBuilder.fromUri("https://coditory.com?a=X&a=Y&b=Z") + .removeQueryParams() + .buildUriString() + then: + result == "https://coditory.com" + } +} diff --git a/src/test/groovy/com/coditory/quark/uri/UrlValidatorSpec.groovy b/src/test/groovy/com/coditory/quark/uri/UrlValidatorSpec.groovy new file mode 100644 index 0000000..7e427f8 --- /dev/null +++ b/src/test/groovy/com/coditory/quark/uri/UrlValidatorSpec.groovy @@ -0,0 +1,53 @@ +package com.coditory.quark.uri + + +import spock.lang.Specification +import spock.lang.Unroll + +class UrlValidatorSpec extends Specification { + @Unroll + def "should pass url validation: #input"() { + expect: + UrlValidator.isValidUrl(input) == true + where: + input << [ + "http://coditory.com", + "http://coditory.com/abc", + "http://coditory.com/a%20b", + "http://coditory.com/a%E8%AA%9Eb", + "http://coditory.com/a/b/c", + "http://coditory.com/test?a=b&a=b&a=c" + ] + } + + @Unroll + def "should fail url validation: #input"() { + expect: + UrlValidator.isValidUrl(input) == false + where: + input << [ + // invalid scheme + "htttp://coditory.com", + "htp://coditory.com", + "://coditory.com", + "1ht://coditory.com", + "coditory.com", + // invalid host + "http://co+ditory.com", + "http://coditory.1co", + "http://coditory.", + "http://.com", + "http://", + // invalid port + "http://coditory.com:-5", + "http://coditory.com:65636", + "http://coditory.com:80a", + "http://coditory.com:a80", + // invalid path + "http://coditory.com/..", + "http://coditory.com/../", + "http://coditory.com/../file", + "http://coditory.com/abc/../../file", + ] + } +} diff --git a/src/test/groovy/com/coditory/quark/uri/base/Alphabets.groovy b/src/test/groovy/com/coditory/quark/uri/base/Alphabets.groovy new file mode 100644 index 0000000..30483dc --- /dev/null +++ b/src/test/groovy/com/coditory/quark/uri/base/Alphabets.groovy @@ -0,0 +1,48 @@ +package com.coditory.quark.uri.base + +class Alphabets { + public static final String ALPHABETIC_UPPER = "ABCDEFGHIJKLMNOPQRSTUVWXYZ" + public static final String ALPHABETIC_LOWER = "abcdefghijklmnopqrstuvwxyz" + public static final String ALPHABETIC = ALPHABETIC_UPPER + ALPHABETIC_LOWER + public static final String NUMERIC = "0123456789" + public static final String ALPHANUMERIC = ALPHABETIC + NUMERIC + public static final String ASCII = asciiAlphabetWithControlCodes(0, 127) + public static final String ASCII_PRINTABLE = asciiAlphabet(32, 127) + public static final String ASCII_CONTROL_CODES = asciiAlphabetWithControlCodes(0, 32) + '\u007F' + + public static final String CYRYLLIC_CHARACTERS = "АБВГДЕЖЗИЙКЛМНОПРСТУФХЦЧШЩЪЫЬЭЮЯабвгдежзийклмнопрстуфхцчшщъыьэюя" + public static final String GREEK_CHARACTERS = "ΑΒΓΔΕΖΗΘΙΚΛΜΝΞΟΠΡΣΤΥΦΧΨΩαβγδεζηθικλμνξοπρςστυφχψωΆΈΉΊΌΎΏάέήόίύώΪΫϊϋΰΐ" + public static final String POLISH_CHARACTERS = "ĄąĆćĘꣳŃńÓ󌜏źŻż" + public static final String CZECH_CHARACTERS = "ÁČĎÉĚÍŇÓŘŠŤÚŮÝŽáčďéěíňóřšťúůýž" + public static final String SLOVAK_CHARACTERS = "ÁÄČĎžÉÍĹĽŇÓÔŔŠŤÚÝŽáäčďžéíĺľňóôŕšťúýž" + public static final String ESPERANTO_CHARACTERS = "ĈĉĜĝĤĥĴĵŜŝŬŭ" + public static final String GERMAN_CHARACTERS = "ÄäÖöÜüẞß" + public static final String NORDIC_CHARACTERS = "åÅæÆøØÄäÖö" + public static final String TURKISH_CHARACTERS = "ğĞçCıIiİöÖŞşüÜ" + + /** + * Unreserved uri characters + * https://tools.ietf.org/html/rfc3986#section-2.3 + */ + public static final String URI_UNRESERVED = ALPHANUMERIC + "-._~"; + /** + * @link https://tools.ietf.org/html/rfc3986#section-3.5 + */ + public static final String URI_SEGMENT_UNRESERVED = URI_UNRESERVED + "!\$&'()*+,;=:@"; + /** + * @link https://tools.ietf.org/html/rfc3986#section-3.5 + */ + public static final String URI_FRAGMENT_UNRESERVED = URI_SEGMENT_UNRESERVED + "+/?"; + + private static String asciiAlphabet(int asciiFromInclusive, int asciiToExclusive) { + return asciiAlphabetWithControlCodes(asciiFromInclusive, asciiToExclusive) + } + + private static String asciiAlphabetWithControlCodes(int asciiFromInclusive, int asciiToExclusive) { + char[] chars = new char[asciiToExclusive - asciiFromInclusive]; + for (int i = asciiFromInclusive; i < asciiToExclusive; ++i) { + chars[i - asciiFromInclusive] = i + } + return String.valueOf(chars); + } +} diff --git a/src/test/groovy/com/coditory/quark/uri/base/CapturingAppender.groovy b/src/test/groovy/com/coditory/quark/uri/base/CapturingAppender.groovy new file mode 100644 index 0000000..3c52ae3 --- /dev/null +++ b/src/test/groovy/com/coditory/quark/uri/base/CapturingAppender.groovy @@ -0,0 +1,102 @@ +package com.coditory.quark.uri.base + +import ch.qos.logback.classic.Level +import ch.qos.logback.classic.spi.LoggingEvent +import ch.qos.logback.core.AppenderBase +import org.slf4j.Marker +import spock.util.concurrent.BlockingVariable + +import java.util.function.Predicate + +class CapturingAppender extends AppenderBase { + private int loggerCalls = 0 + private final List capturedEvents = new ArrayList<>() + private final BlockingVariable called = new BlockingVariable(0.2) // 200ms + + CapturingAppender() { + start() + } + + @Override + protected void append(LoggingEvent event) { + capturedEvents.add(event) + called.set(true) + } + + void waitForFirstLog() { + called.get() + } + + synchronized int getLoggerCalls() { + return loggerCalls + } + + synchronized void reset() { + capturedEvents.clear() + } + + synchronized List getLogsByMessagePrefix(String prefix) { + return capturedEvents + .findAll { it.message.startsWith(prefix) } + .collect { it.toString() } + } + + synchronized int capturedEvents() { + return capturedEvents.size() + } + + synchronized int countCapturedEvents(Predicate predicate) { + return capturedEvents.count { predicate.test(it) } + } + + synchronized int countCapturedEvents(String message) { + return capturedEvents.count { it.message == message } + } + + synchronized int countCapturedEvents(String message, List params) { + return capturedEvents.count { + it.message == message && + it.argumentArray == params.toArray() + } + } + + synchronized int countCapturedEvents(Level level) { + return capturedEvents.count { it.level == level } + } + + synchronized int countCapturedEvents(String message, List params, String exceptionMessage) { + return capturedEvents.count { + it.message == message && + it.argumentArray == params.toArray() && + it.throwableProxy.message == exceptionMessage + } + } + + synchronized int countCapturedEvents(Marker marker) { + return capturedEvents.count { it.marker == marker } + } + + synchronized int countCapturedEvents(Level level, String message, List params, String exceptionMessage) { + return capturedEvents.count { + it.level == level && + it.message == message && + it.argumentArray == params?.toArray() && + it.throwableProxy.message == exceptionMessage + } + } + + synchronized int countCapturedEvents(Level level, String message, List params) { + return capturedEvents.count { + it.level == level && + it.message == message && + it.argumentArray == params.toArray() + } + } + + synchronized int countCapturedEvents(Level level, String message) { + return capturedEvents.count { + it.level == level && + it.message == message + } + } +} diff --git a/src/test/java/readme/ReadmeSamples.java b/src/test/java/readme/ReadmeSamples.java new file mode 100644 index 0000000..a4bada6 --- /dev/null +++ b/src/test/java/readme/ReadmeSamples.java @@ -0,0 +1,47 @@ +package readme; + +import com.coditory.quark.uri.UriBuilder; +import com.coditory.quark.uri.UriComponents; + +public class ReadmeSamples { + public static void main(String[] args) { + String result = UriBuilder.fromUri("https://coditory.com?w=W&a=A") + .addPathSegment("about") + .addQueryParam("a", "X") + .addQueryParam("a", "X") + .addQueryParam("a", "Y") + .addQueryParam("b", "Y") + .addQueryParam("e", "") + .buildUriString(); + System.out.println(result); + + UriComponents uriComponents = UriBuilder.fromUri("https://coditory.com?w=W&a=A") + .addPathSegment("about") + .addQueryParam("a", "X") + .addQueryParam("a", "X") + .addQueryParam("a", "Y") + .addQueryParam("b", "Y") + .addQueryParam("e", "") + .buildUriComponents(); + System.out.println(uriComponents); + + result = UriBuilder.fromUri("https://coditory.com?w=W&a=A") + .addPathSegment("a b") + .addQueryParam("x y", " X Y ") + .buildUriString(); + System.out.println(result); + + result = UriBuilder.fromUri("https://coditory.com/a+bc/d%20ef/") + .addPathSegment("x y ") + .setFragment("frag ment") + .addQueryParam("f oo", "b ar") + .addQueryParam("x", "y+z") + .buildUriString(); + System.out.println(result); + + uriComponents = UriBuilder.fromUri("/abc?a+b=A+B").buildUriComponents(); + System.out.println(uriComponents); + uriComponents = UriBuilder.fromUri("/abc?a%20b=A%20B").buildUriComponents(); + System.out.println(uriComponents); + } +}