https://github.com/slub/urnlib
Java library for representing, parsing and encoding URNs as in RFC2141 and RFC8141 (Maintained by @claussni)
https://github.com/slub/urnlib
code4lib urn
Last synced: 7 months ago
JSON representation
Java library for representing, parsing and encoding URNs as in RFC2141 and RFC8141 (Maintained by @claussni)
- Host: GitHub
- URL: https://github.com/slub/urnlib
- Owner: slub
- License: gpl-3.0
- Created: 2016-02-14T18:01:25.000Z (almost 10 years ago)
- Default Branch: main
- Last Pushed: 2023-05-24T10:46:41.000Z (over 2 years ago)
- Last Synced: 2025-03-25T18:41:04.757Z (8 months ago)
- Topics: code4lib, urn
- Language: Java
- Homepage:
- Size: 182 KB
- Stars: 32
- Watchers: 4
- Forks: 6
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-java-zh - urnlib - 表示、解析和编码urn，如在RFC 2141中。(GPL-3.0-only) (项目 / 联网)
- fucking-awesome-java - urnlib - Represent, parse and encode URNs, as in RFC 2141. (GPL-3.0-only) (Projects / Networking)
- awesome-java - urnlib - Represent, parse and encode URNs, as in RFC 2141. (GPL-3.0-only) (Projects / Networking)
- awesome-java - URNLib
- awesome-java - urnlib - Represent, parse and encode URNs, as in RFC 2141. (GPL-3.0-only) (Projects / Networking)
- awesome-java - urnlib - Java library for representing, parsing and encoding URNs as in RFC 2141. (Networking)
README
# urnlib
[](https://maven-badges.herokuapp.com/maven-central/de.slub-dresden/urnlib)
Java library for representing, parsing and encoding URNs as specified in [RFC 2141] and [RFC 8141].
The initial URN RFC 2141 of May 1997 was superseeded by RFC 8141 in April 2017. RFC 8141 added support for path characters and optional request, query and fragment parts. While URNs look very similiar to URIs and are somewhat related, different equality rules apply for URNs in regard to URN character encoding rules. Also some synactic rules about case-insensitivity are actually to be defined by the implementing system handling the URNs.
This library provides classes for representing, parsing and constructing an Uniform
Resource Name (URN) and its parts Namespace Identifier (NID), Namespace Specific String (NSS) and optional Resolution, Query and Fragment components (RQF). If you don't need RFC 2141 URNs explicitly, always use RFC 8141 URNs because that is the current valid specification and RFC 8141 is backward compatible to RFC 2141.
Further it defines and interface `de.slub.urn.URNResolver` for URN resolving implementations.
The library is compiled for Java 7.
## Usage
```java
import de.slub.urn.URN;
import de.slub.urn.URNSyntaxError;
import de.slub.urn.URN_8141;
import static de.slub.urn.RFC.RFC_8141;
class Demo {
public void foo() throws URNSyntaxException {
// Create a RFC 2141 compliant URN (not recommended)
URN urn1 = URN.rfc2141().parse("urn:examle:1234");
// Create a RFC 8141 compliant URN (recommended)
URN urn2 = URN.rfc8141().parse("urn:examle:foo/1234?=cq=cz#bar");
// Access fragment part of a supposedly RFC 8141 compliant URN
if (urn2.supports(RFC_8141)) {
String fragment = ((URN_8141) urn2).getRQFComponents().fragment();
}
}
}
```
## Where to find releases?
The master branch of the repository contains the latest developments. Releases are tagged.
There are two ways of getting releases of this library. Binaries are obtained through Maven dependencies. Sources via the [GitHub Releases download section].
The recommended way is by declaring a dependency, for example in your projects POM file:
```xml
de.slub-dresden
urnlib
[2.0,2.1)
```
## Licensing
The **source code** is under [GNU GENERAL PUBLIC LICENSE, Version 3] (or later) as stated in the source file headers. So if you want to use the source code or a changed version, the source code and the source code using it is automatically licensed under this license.
The **binaries** (JAR artifacts) however are licensed under [The Apache License, Version 2.0] and can be used in commercial products without any licensing changes to that product.
[RFC 2141]: https://tools.ietf.org/html/rfc2141
[RFC 8141]: https://tools.ietf.org/html/rfc8141
[GitHub Releases download section]: https://github.com/slub/urnlib/releases
[GNU GENERAL PUBLIC LICENSE, Version 3]: https://www.gnu.org/licenses/gpl-3.0.html
[The Apache License, Version 2.0]: http://www.apache.org/licenses/LICENSE-2.0.txt